Gopeed 贡献指南分支流程、本地开发、国际化翻译与 Flutter 工程规范【免费下载链接】gopeedA fast, modern download manager for HTTP, BitTorrent, Magnet, and ed2k. Cross-platform, built with Golang and Flutter.项目地址: https://gitcode.com/GitHub_Trending/go/gopeed本篇指南围绕 Gopeed 开源仓库的官方贡献文档 CONTRIBUTING_zh-CN.md 展开系统讲解参与 Gopeed 开发的全流程从 fork 与 PR 分支模型、基于 Web 端的本地调试环境搭建到 Flutter 国际化ARB 翻译的完整规范与 CI 校验机制再到提交前的代码格式化与代码生成工具链。读完本文你将掌握向 Gopeed 提交高质量 PR 所需的全部操作步骤与工程约定并能借助仓库源码理解每一步背后的实现原理。一、分支模型基于main的 fork 工作流Gopeed 采用单一主干分支的开发模型仓库只保留一个主分支main。所有代码变更都遵循标准的 GitHub fork 协作流程fork 本项目到自己的账号下在 fork 出的仓库中新建分支进行开发开发完成后向本仓库的main分支提交 Pull RequestPR由维护者审核并合并。从仓库工作流配置可以印证这一约定.github/workflows/l10n.yml 与 .github/workflows/build.yml 的触发条件均限定在main分支的push与pull_request事件上说明所有功能代码最终都会汇入main。二、本地开发通过 Web 端快速调试官方文档推荐通过Web 端进行开发调试这也是启动门槛最低的方式因为 Flutter 的 Web 目标不依赖移动端模拟器或桌面窗口环境。1. 启动后端服务在仓库根目录执行go run cmd/api/main.go服务启动后默认监听9999端口。这个命令之所以专用于本地开发可以看 cmd/api/main.go 的源码注释 only for local development它硬编码了一份本地开发配置cfg : model.StartConfig{ Network: tcp, Address: 127.0.0.1:9999, Storage: model.StorageBolt, WebEnable: true, } cmd.Start(cfg)也就是说该入口默认只监听127.0.0.1:9999回环地址不对局域网暴露使用 Bolt 作为本地存储引擎直接启用内置 Web 界面WebEnable: true因此浏览器访问http://127.0.0.1:9999即可看到管理页面。后端启动后会打印内置 banner随后进入 cmd/server.go 的Start流程构建 REST 服务、加载下载器配置并在首次启动downloadCfg.FirstLoad时初始化默认下载目录Docker 环境下为存储目录旁的Downloads普通环境为当前用户的Downloads目录最后监听SIGINT/SIGTERM信号做优雅退出。2. 以 debug 模式启动前端保持后端运行另开终端在ui/flutter目录下以 debug 模式启动 Flutter 项目flutter run -d chrome或使用你常用的 Web 设备标识。Flutter 前端在 debug 模式下会连接本地后端即可在浏览器中完成 UI 与后端联调。3. 端口与配置的延伸说明如果你想调整服务端口或绑定地址可以参考正式服务入口 cmd/web/flags.go 暴露的命令行参数本地开发入口未解析这些参数-A/--address绑定地址默认0.0.0.0-P/--port绑定端口默认9999-u/--username、-p/--passwordWeb 认证账号与密码未设置密码时不启用认证-T/--api-token启用 Web 认证后调用 HTTP API 所需的 Token-d/--storage-dir存储目录-c/--config配置文件路径默认./config.json。此外配置还支持GOPEED_前缀的环境变量覆盖如GOPEED_PORT、GOPEED_ADDRESS解析顺序为命令行参数 环境变量 配置文件 默认值见 loadEnvVars 的实现。这些能力在正式部署docker、桌面打包时非常有用本地开发直接用默认9999端口即可。三、翻译Flutter 国际化ARB规范Gopeed 的多语言支持基于 Flutter 官方的 ARBApplication Resource Bundle机制国际化文件统一存放于ui/flutter/lib/l10n目录该目录的生成配置见 ui/flutter/l10n.yamltemplate-arb-file指向英文模板app_en.arb输出类名为AppLocalizations。1. 基本规则以app_en.arb为源模板修改或新增app_locale.arb例如app_de.arb、app_zh_TW.arb每个语种必须与英文模板包含完全相同的文案 key不能多也不能少只翻译文案值不得修改{count}、{name}等花括号中的变量名以开头的元数据 key如items的placeholders声明不需要翻译提交 PR 时只包含修改过的 ARB 源文件不要生成或提交app_localizations*.dart——国际化代码由 PR 的 CI 自动生成并校验。2. 翻译示例一在文案中插入变量ARB 定义以中文为例welcomeUser: 你好{name}程序传入name 小明后用户看到的是“你好小明”。翻译时可以调整整句话的语序但必须保留{name}这个占位符。仓库中实际存在大量这类用法例如 app_zh.arb 的lastUpdate: 上次更新time以及英文模板 app_en.arb 的items: {count} items。3. 翻译示例二根据数量显示不同文案pluralARB 定义fileCount: {count, plural, 0{没有文件} 1{1 个文件} other{{count} 个文件}}最终显示效果count 0→ “没有文件”count 1→ “1 个文件”count 3→ “3 个文件”其中0、1、other分别表示数量为 0、数量为 1 和其他数量。翻译时只翻译每个分支花括号内显示给用户的文字plural关键字与0/1/other分支标记必须原样保留。4. 翻译示例三根据变量值显示不同文案selectARB 定义taskState: {state, select, running{运行中} paused{已暂停} other{未知状态}}最终显示效果state running→ “运行中”state paused→ “已暂停”其他值 → “未知状态”running、paused、other是程序传入的分支值不能翻译只翻译它们后面花括号内的显示文字。5. CI 自动校验机制源码级解读官方文档承诺“PR 的 CI 会自动校验所有语种、生成国际化代码并检查集成结果”仓库中的两条证据可以验证这一点工作流 .github/workflows/l10n.yml 在main分支的 PR/push 且路径涉及ui/flutter/lib/l10n/**或ui/flutter/l10n.yaml时触发依次执行flutter pub get→dart run ../../.github/workflows/scripts/check_l10n.dart→flutter gen-l10n→flutter analyze校验失败即 CI 失败校验脚本 .github/workflows/scripts/check_l10n.dart 具体检查五项内容每个 ARB 文件是否使用仓库统一的两空格 JSON 缩进格式每个app_locale.arb声明的locale是否与文件名匹配文案值是否为空每个语种的 key 集合是否与app_en.arb完全一致缺 key 或多余 key 都会报错每个翻译是否完整保留英文模板中的占位符变量脚本通过正则提取{name}与 ICU 的plural/select选择器变量并做集合比对。因此本地提交前建议自行运行同样的校验命令在ui/flutter目录下dart run ../../.github/workflows/scripts/check_l10n.dart再执行flutter gen-l10n生成并检查集成结果确保 CI 一次通过。四、Flutter 开发规范1. 提交前格式化每次提交前务必执行dart format ./ui/flutter该命令会将ui/flutter目录下的 Dart 代码统一为标准格式。这一要求也与 CI 中的flutter analyze环节呼应——未格式化的代码会在静态分析中暴露 lint 问题。2. 编辑 api/models 时开启代码生成如果改动涉及 API 模型位于ui/flutter/lib/api/model例如create_task.dart、task.dart、options.dart等需要先打开 build_runner watcher 持续监听文件变化、自动重新生成对应的.g.dart文件flutter pub run build_runner watch这也是为什么仓库中每个模型文件旁边都成对存在*.g.dart文件如create_task.g.dart、options.g.dart——它们由 build_runner 基于json_serializable等注解自动生成不应手工修改。生成完成后配合dart format ./ui/flutter一起提交即可。五、提交 PR 前自检清单综合以上规范向 Gopeed 提交 PR 前请逐项确认分支基于 fork 的新分支开发PR 目标为上游main本地验证go run cmd/api/main.go能正常启动后端端口9999Flutter Web 端 debug 模式可联调翻译所有语种 ARB 与app_en.arbkey 完全一致占位符变量未改名只提交 ARB 源文件不提交app_localizations*.dart格式化dart format ./ui/flutter已执行代码生成改动 API 模型后已运行flutter pub run build_runner watch并提交生成的.g.dart文件CI可在本地先行复跑 check_l10n.dart 与flutter analyze保证提交即通过。按照这份指南操作你就能顺畅地参与到 Gopeed 的国际化翻译与 Flutter 端开发中为这个跨平台下载工具贡献高质量代码。【免费下载链接】gopeedA fast, modern download manager for HTTP, BitTorrent, Magnet, and ed2k. Cross-platform, built with Golang and Flutter.项目地址: https://gitcode.com/GitHub_Trending/go/gopeed创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Gopeed 贡献指南：分支流程、本地开发、国际化翻译与 Flutter 工程规范
Gopeed 贡献指南分支流程、本地开发、国际化翻译与 Flutter 工程规范【免费下载链接】gopeedA fast, modern download manager for HTTP, BitTorrent, Magnet, and ed2k. Cross-platform, built with Golang and Flutter.项目地址: https://gitcode.com/GitHub_Trending/go/gopeed本篇指南围绕 Gopeed 开源仓库的官方贡献文档 CONTRIBUTING_zh-CN.md 展开系统讲解参与 Gopeed 开发的全流程从 fork 与 PR 分支模型、基于 Web 端的本地调试环境搭建到 Flutter 国际化ARB 翻译的完整规范与 CI 校验机制再到提交前的代码格式化与代码生成工具链。读完本文你将掌握向 Gopeed 提交高质量 PR 所需的全部操作步骤与工程约定并能借助仓库源码理解每一步背后的实现原理。一、分支模型基于main的 fork 工作流Gopeed 采用单一主干分支的开发模型仓库只保留一个主分支main。所有代码变更都遵循标准的 GitHub fork 协作流程fork 本项目到自己的账号下在 fork 出的仓库中新建分支进行开发开发完成后向本仓库的main分支提交 Pull RequestPR由维护者审核并合并。从仓库工作流配置可以印证这一约定.github/workflows/l10n.yml 与 .github/workflows/build.yml 的触发条件均限定在main分支的push与pull_request事件上说明所有功能代码最终都会汇入main。二、本地开发通过 Web 端快速调试官方文档推荐通过Web 端进行开发调试这也是启动门槛最低的方式因为 Flutter 的 Web 目标不依赖移动端模拟器或桌面窗口环境。1. 启动后端服务在仓库根目录执行go run cmd/api/main.go服务启动后默认监听9999端口。这个命令之所以专用于本地开发可以看 cmd/api/main.go 的源码注释 only for local development它硬编码了一份本地开发配置cfg : model.StartConfig{ Network: tcp, Address: 127.0.0.1:9999, Storage: model.StorageBolt, WebEnable: true, } cmd.Start(cfg)也就是说该入口默认只监听127.0.0.1:9999回环地址不对局域网暴露使用 Bolt 作为本地存储引擎直接启用内置 Web 界面WebEnable: true因此浏览器访问http://127.0.0.1:9999即可看到管理页面。后端启动后会打印内置 banner随后进入 cmd/server.go 的Start流程构建 REST 服务、加载下载器配置并在首次启动downloadCfg.FirstLoad时初始化默认下载目录Docker 环境下为存储目录旁的Downloads普通环境为当前用户的Downloads目录最后监听SIGINT/SIGTERM信号做优雅退出。2. 以 debug 模式启动前端保持后端运行另开终端在ui/flutter目录下以 debug 模式启动 Flutter 项目flutter run -d chrome或使用你常用的 Web 设备标识。Flutter 前端在 debug 模式下会连接本地后端即可在浏览器中完成 UI 与后端联调。3. 端口与配置的延伸说明如果你想调整服务端口或绑定地址可以参考正式服务入口 cmd/web/flags.go 暴露的命令行参数本地开发入口未解析这些参数-A/--address绑定地址默认0.0.0.0-P/--port绑定端口默认9999-u/--username、-p/--passwordWeb 认证账号与密码未设置密码时不启用认证-T/--api-token启用 Web 认证后调用 HTTP API 所需的 Token-d/--storage-dir存储目录-c/--config配置文件路径默认./config.json。此外配置还支持GOPEED_前缀的环境变量覆盖如GOPEED_PORT、GOPEED_ADDRESS解析顺序为命令行参数 环境变量 配置文件 默认值见 loadEnvVars 的实现。这些能力在正式部署docker、桌面打包时非常有用本地开发直接用默认9999端口即可。三、翻译Flutter 国际化ARB规范Gopeed 的多语言支持基于 Flutter 官方的 ARBApplication Resource Bundle机制国际化文件统一存放于ui/flutter/lib/l10n目录该目录的生成配置见 ui/flutter/l10n.yamltemplate-arb-file指向英文模板app_en.arb输出类名为AppLocalizations。1. 基本规则以app_en.arb为源模板修改或新增app_locale.arb例如app_de.arb、app_zh_TW.arb每个语种必须与英文模板包含完全相同的文案 key不能多也不能少只翻译文案值不得修改{count}、{name}等花括号中的变量名以开头的元数据 key如items的placeholders声明不需要翻译提交 PR 时只包含修改过的 ARB 源文件不要生成或提交app_localizations*.dart——国际化代码由 PR 的 CI 自动生成并校验。2. 翻译示例一在文案中插入变量ARB 定义以中文为例welcomeUser: 你好{name}程序传入name 小明后用户看到的是“你好小明”。翻译时可以调整整句话的语序但必须保留{name}这个占位符。仓库中实际存在大量这类用法例如 app_zh.arb 的lastUpdate: 上次更新time以及英文模板 app_en.arb 的items: {count} items。3. 翻译示例二根据数量显示不同文案pluralARB 定义fileCount: {count, plural, 0{没有文件} 1{1 个文件} other{{count} 个文件}}最终显示效果count 0→ “没有文件”count 1→ “1 个文件”count 3→ “3 个文件”其中0、1、other分别表示数量为 0、数量为 1 和其他数量。翻译时只翻译每个分支花括号内显示给用户的文字plural关键字与0/1/other分支标记必须原样保留。4. 翻译示例三根据变量值显示不同文案selectARB 定义taskState: {state, select, running{运行中} paused{已暂停} other{未知状态}}最终显示效果state running→ “运行中”state paused→ “已暂停”其他值 → “未知状态”running、paused、other是程序传入的分支值不能翻译只翻译它们后面花括号内的显示文字。5. CI 自动校验机制源码级解读官方文档承诺“PR 的 CI 会自动校验所有语种、生成国际化代码并检查集成结果”仓库中的两条证据可以验证这一点工作流 .github/workflows/l10n.yml 在main分支的 PR/push 且路径涉及ui/flutter/lib/l10n/**或ui/flutter/l10n.yaml时触发依次执行flutter pub get→dart run ../../.github/workflows/scripts/check_l10n.dart→flutter gen-l10n→flutter analyze校验失败即 CI 失败校验脚本 .github/workflows/scripts/check_l10n.dart 具体检查五项内容每个 ARB 文件是否使用仓库统一的两空格 JSON 缩进格式每个app_locale.arb声明的locale是否与文件名匹配文案值是否为空每个语种的 key 集合是否与app_en.arb完全一致缺 key 或多余 key 都会报错每个翻译是否完整保留英文模板中的占位符变量脚本通过正则提取{name}与 ICU 的plural/select选择器变量并做集合比对。因此本地提交前建议自行运行同样的校验命令在ui/flutter目录下dart run ../../.github/workflows/scripts/check_l10n.dart再执行flutter gen-l10n生成并检查集成结果确保 CI 一次通过。四、Flutter 开发规范1. 提交前格式化每次提交前务必执行dart format ./ui/flutter该命令会将ui/flutter目录下的 Dart 代码统一为标准格式。这一要求也与 CI 中的flutter analyze环节呼应——未格式化的代码会在静态分析中暴露 lint 问题。2. 编辑 api/models 时开启代码生成如果改动涉及 API 模型位于ui/flutter/lib/api/model例如create_task.dart、task.dart、options.dart等需要先打开 build_runner watcher 持续监听文件变化、自动重新生成对应的.g.dart文件flutter pub run build_runner watch这也是为什么仓库中每个模型文件旁边都成对存在*.g.dart文件如create_task.g.dart、options.g.dart——它们由 build_runner 基于json_serializable等注解自动生成不应手工修改。生成完成后配合dart format ./ui/flutter一起提交即可。五、提交 PR 前自检清单综合以上规范向 Gopeed 提交 PR 前请逐项确认分支基于 fork 的新分支开发PR 目标为上游main本地验证go run cmd/api/main.go能正常启动后端端口9999Flutter Web 端 debug 模式可联调翻译所有语种 ARB 与app_en.arbkey 完全一致占位符变量未改名只提交 ARB 源文件不提交app_localizations*.dart格式化dart format ./ui/flutter已执行代码生成改动 API 模型后已运行flutter pub run build_runner watch并提交生成的.g.dart文件CI可在本地先行复跑 check_l10n.dart 与flutter analyze保证提交即通过。按照这份指南操作你就能顺畅地参与到 Gopeed 的国际化翻译与 Flutter 端开发中为这个跨平台下载工具贡献高质量代码。【免费下载链接】gopeedA fast, modern download manager for HTTP, BitTorrent, Magnet, and ed2k. Cross-platform, built with Golang and Flutter.项目地址: https://gitcode.com/GitHub_Trending/go/gopeed创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考