66 lines
2.5 KiB
Markdown
66 lines
2.5 KiB
Markdown
# INBOX
|
||
|
||
## [已处理] K68-A 指定 API_BASE_URL 时跳过地址探测
|
||
|
||
### 背景
|
||
|
||
正式包通过 `--dart-define=API_BASE_URL=http://39.162.50.99:8081` 指定接口地址，
|
||
但 `AppConfig.probeAndApplyBaseUrl()` 不支持构建期地址：它只按
|
||
`127.0.0.1 → 192.168.31.187 → 公网` 探测，探测结果又会覆盖 `apiBaseUrl`。
|
||
|
||
后果：正式包启动时仍会去探测局域网；若公网暂时不可达，会回落到开发机地址
|
||
`192.168.31.187`，正式包里所有请求都指向错误服务器。
|
||
|
||
### 目标
|
||
|
||
- `API_BASE_URL` 已指定时，**不再探测**，直接使用该地址。
|
||
- 运行时地址（用户在 App 内手动改的服务器）仍保持最高优先级，不被构建期地址覆盖。
|
||
- 未指定 `API_BASE_URL` 时，探测逻辑保持现状。
|
||
|
||
### 实现
|
||
|
||
1. `lib/core/config/app_config.dart` 的 `probeAndApplyBaseUrl`：
|
||
|
||
```dart
|
||
static Future<void> probeAndApplyBaseUrl({
|
||
Future<bool> Function(String baseUrl)? probe,
|
||
String? fallbackBaseUrl,
|
||
String? compiledOverride, // 仅测试注入用
|
||
}) async {
|
||
final compiled = compiledOverride ?? compiledBaseUrl;
|
||
if (compiled.isNotEmpty) {
|
||
// 构建期已指定接口地址：直接使用，避免正式包回落开发机地址
|
||
if (_runtimeBaseUrl.isEmpty) applyRuntimeBaseUrl(compiled);
|
||
return;
|
||
}
|
||
// …原有探测逻辑不变
|
||
}
|
||
```
|
||
|
||
2. `lib/main.dart` 不改（已 `AppConfig.ready = AppConfig.probeAndApplyBaseUrl()`）。
|
||
3. 测试 `test/config/` 补充：
|
||
- 传 `compiledOverride` 时：`probe` 回调一次都不会被调用，`AppConfig.apiBaseUrl` 等于该地址
|
||
- 已存在运行时地址且传 `compiledOverride` 时：运行时地址不被覆盖
|
||
- 不传 `compiledOverride`（默认空）时：探测逻辑与现有测试保持一致
|
||
- 测试结束复位运行时地址
|
||
|
||
### 验收
|
||
|
||
- 门禁：`dart analyze lib test` 零告警、`flutter test` 全过、`flutter build apk --debug` 成功。
|
||
- 复核用正式包构建命令（Trae 负责重打，不需要 Codex 执行）：
|
||
|
||
```
|
||
flutter build apk --release --target-platform android-arm,android-arm64 \
|
||
--dart-define=API_BASE_URL=http://39.162.50.99:8081
|
||
```
|
||
|
||
### Git
|
||
|
||
- 从 `develop` 拉 `fix/lock-compiled-base-url`。
|
||
- 提交：`fix(config): 指定 API_BASE_URL 时跳过地址探测`，作者 `Zhou Weidong <502333560@qq.com>`。
|
||
- `--no-ff` 合回 `develop` 并 push；`FruitServer/docs/plans/PROGRESS.md` 追加 K68-A 留痕。
|
||
|
||
### 约束
|
||
|
||
- 全程中文；禁止 `git add -A`；不改探测候选顺序与超时；完成后停住等待验收。
|