docs(plans): 记录 K13 开发服务器地址回执

This commit is contained in:
Zhou Weidong committed 2026-10-17 22:55:10 +08:00
1 parent 6405dff7c5
commit 70b9823d5b
2 files changed
+182 -1

No files matched your search

+24 -1
View File
@@ -20,7 +20,7 @@
---
## [待处理] 2026-10-17 | K13 运行时服务器地址设置(仅 debug)
## [已处理·待用户验收] 2026-10-17 | K13 运行时服务器地址设置(仅 debug)
**用户反馈(2026-10-17,已重复 3 次)**:每次 Codex 门禁构建出的 APK 不带 `--dart-define`,App 就回退到 `http://jiangdeMacBook-Air.local:8081`,真机不可用。
@@ -63,6 +63,29 @@
- 先写 `FruitServer/docs/plans/2026-10-17-K13.md`;每步「叙述 + 命令 + 原始输出 + 解读」追加到 `PROGRESS.md`;完成后停住写回执。
- 提交作者与提交者统一 `Zhou Weidong <502333560@qq.com>`。
### 五、K13 完成回执(2026-10-17)
**结论**:新增 debug-only 运行时服务器地址覆盖。启动优先级为本地设置 >
`--dart-define(API_BASE_URL)` > 现有默认;release 不读取本地覆盖且不显示入口。
未改接口、后端或其他页面业务逻辑;未跑真机。
- 客户端分支 `feature/flutter-k13-dev-server-setting` 从 `b762289` 完成并
`--no-ff` 合并;功能提交 `907562a`,合并提交 `f95325d`,已推送
`b762289..f95325d develop`。
- 新增 `ServerEndpoint`,使用 `SharedPreferencesAsync` key
`dev.api_base_url`;URL 会 trim、校验 http(s) 和 host,并去掉末尾 `/`。
- `main()` 在 `runApp` 前 debug 加载覆盖;ApiClient 创建时读取已解析地址。
- 我的页设置弹窗新增服务器地址行、编辑/保存、非法值提示、重启生效提示和
恢复默认;入口可通过 `debugShowSetting` 注入,默认 `kDebugMode`。
- 新增三语文案;既有语言设置流程保留。
- `dart analyze lib test` 零告警;`flutter test` 为
`00:19 +309 ~1: All tests passed!`;不带 `dart-define` 的 Android debug
APK 在隔离副本中构建成功。
用户真机验证步骤与逐步预期、原始输出见
`docs/plans/PROGRESS.md`「29. K13 运行时服务器地址设置」。
设备侧修改地址、重启和网络连通性验收由用户执行。
---
## [待处理] 2026-10-17 | K12 首页去标题 + 空态视觉重做