gopeed/CONTRIBUTING_zh-CN.md

Gopeed 贡献指南

首先感谢您对贡献代码感兴趣，这份指南将帮助您更好的参与到 Gopeed 的开发中来。

分支说明

本项目只有一个主分支，即 main 分支，如果您想要参与到 Gopeed 的开发中来，请先 fork 本项目，然后在您的 fork 项目中进行开发，开发完成后再向本项目提交 PR，合并到 main 分支。

本地开发

建议通过 web 端进行开发调试，首先启动后端服务，通过命令行 go run cmd/api/main.go 启动 ，服务启动默认端口为 9999，然后以 debug 模式启动前端 flutter 项目即可运行。

翻译

Flutter 国际化文件位于 ui/flutter/lib/l10n，请以 app_en.arb 为源模板，修改或新增 app_<locale>.arb（例如 app_de.arb 或 app_zh_TW.arb）。每个语种必须与英文模板包含相同的文案 key。

只翻译文案值，不要修改 {count}、{name} 等花括号中的变量名。以 @ 开头的元数据 key 不需要翻译。 提交时只包含修改过的 ARB 源文件，不需要生成或提交 app_localizations*.dart。PR 的 CI 会自动校验所有语种、 生成国际化代码并检查集成结果。

下面的例子同时给出 ARB 中填写的文案定义，以及程序传值后用户最终看到的内容。

1. 在文案中插入变量

   ARB 定义：

   "welcomeUser": "你好，{name}"
   

   最终显示：当 name = 小明 时，显示“你好，小明”。翻译时可以调整整句话，但必须保留 {name}。

2. 根据数量显示不同文案

   ARB 定义：

   "fileCount": "{count, plural, =0{没有文件} =1{1 个文件} other{{count} 个文件}}"
   

   最终显示：

   • count = 0 → “没有文件”
   • count = 1 → “1 个文件”
   • count = 3 → “3 个文件”

   =0、=1、other 分别表示数量为 0、数量为 1 和其他数量。只翻译每个分支花括号内显示给用户的文字。

3. 根据变量值显示不同文案

   ARB 定义：

   "taskState": "{state, select, running{运行中} paused{已暂停} other{未知状态}}"
   

   最终显示：

   • state = running → “运行中”
   • state = paused → “已暂停”
   • 其他值 → “未知状态”

   running、paused、other 是程序传入的分支值，不能翻译；只翻译它们后面花括号内的显示文字。

flutter开发

每次提交前请务必dart format ./ui/flutter

如果要编辑api/models，请打开build_runner watcher:

flutter pub run build_runner watch