fallback 链头嵌入根(RemoteConfig 顶层):所有 7 字段真正统一,删字段级特殊兜底
【动机】 上一版"统一接口"虽然合并了 resolve / resolveAudio,但 resolve 内部仍有不对称: - showmessage / audioDomain / audioBucket: pickString(chain) ?? config.xxx - appVersion / appDownload / gameVersion / gameZip: 只 pickInt/String(chain), 顶层声明这 4 个字段也读不到 【方案】 - RemoteConfig 加 4 个 String? 字段(appVersion/appDownload/gameVersion/gameZip) 配齐与节点 struct 同款 7 字段集合 - extension RemoteConfig: RemoteConfigNode(自然 conform) - buildChain 首行 var chain = [config]:根始终作为最浅一层 - resolve() 去掉 ?? config.xxx 三处特殊兜底,全 7 字段一律 pickString/Int(chain) 【效果】 - 节点链 1..5 长(含根);所有字段一视同仁,pickString 倒序找即天然包含顶层 - 任何字段都可以在顶层 / agent / game / channel / market 任一层声明,最深层赢 - 算法对称、代码无字段级特殊分支 【硬约束(Plan ADR-009 同步)】 新增字段:加进协议 + 5 个 struct(含 RemoteConfig)+ ResolvedVersion + resolve() 内一行 pickString/Int(chain, \.xxx);不允许 ?? config.xxx 类回退。 BuildProject 通过。 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.7
parent
485f0c6679
commit
692c849e0d
@@ -1260,10 +1260,11 @@ ResolvedVersion(
|
||||
| 应用级凭证(微信 AppSecret、七牛 AccessKey、七牛 SecretKey) | `AppSecrets.plist` | 跨渠道相同的应用全局凭证;与渠道差异化字段语义分离 |
|
||||
| 七牛 CDN 域名、bucket 名 | RemoteConfig 顶层 / 4 层节点任一处 `audio_domain` / `audio_bucket`(4 层 fallback + 顶层兜底) | 后台运维管理,按渠道差异化下发 |
|
||||
- **远端注入时序**:`WebContainerViewController` 在 `parsed` 分支(即 RemoteConfig 拉到、IPA 校验前)调 `VersionResolver.resolve(...)` 一次得到所有字段(含 `audioDomain` / `audioBucket`),再 `await QiniuConfig.shared.update(cdnDomain:bucketName:)` 注入;缺失抛 `BootError.audioConfigMissing`,与 showmessage 同等致命,弹 modal 永停
|
||||
- **统一接口(硬约束)**:远端 RemoteConfig 所有字段的获取**必须**走 `VersionResolver.resolve(...)` 单一入口、走同一套 4 层 fallback:agent → game → channel → market 倒序找第一个非空,整链空时 fallback 到 RemoteConfig 顶层。不允许新增字段时为它单独写 if 链或 helper —— 加进 `RemoteConfigNode` 协议 + 4 个节点 struct + `ResolvedVersion` + `resolve()` 内一行 `pickString(chain, \.xxx) ?? config.xxx`
|
||||
- **统一接口(硬约束)**:远端 RemoteConfig 所有字段的获取**必须**走 `VersionResolver.resolve(...)` 单一入口、走同一套 5 层 fallback:root(顶层)→ agent → game → channel → market,倒序找第一个非空。`RemoteConfig` 自身 conform `RemoteConfigNode` 协议作为链最浅一层兜底,因此 `pickString(chain, \.xxx)` 一行即包含顶层兜底,无需 `?? config.xxx` 这类特殊写法。新增字段:加进 `RemoteConfigNode` 协议 + 5 个 struct(含 `RemoteConfig`)+ `ResolvedVersion` + `resolve()` 内一行 `pick*`
|
||||
- **2026-06-27 修订**:
|
||||
- 初版 `audio_domain` / `audio_bucket` 只从 RemoteConfig 顶层读取,实测渠道方习惯把这俩字段放 agent 节点下 → 客户端读不到误报"音频服务暂不可用"。改为 4 层 fallback + 顶层兜底(同 `app_version` / `game_zip` 等字段算法)。
|
||||
- 同日二次:曾短暂拆 `resolve()` / `resolveAudio()` 两个公开入口,违反"单一接口"原则。已合并为单一 `resolve()`,所有字段(版本 + 音频 + showmessage)一次返回
|
||||
- 同日三次:把 `RemoteConfig` 顶层也作为节点参与 fallback 链(链头 = 根),删掉 `showmessage / audioDomain / audioBucket` 三处特殊的 `?? config.xxx` 兜底;`appVersion / appDownload / gameVersion / gameZip` 也获得顶层兜底能力。所有字段真正完全统一
|
||||
- **类型设计**:
|
||||
- `AppSecrets`:与 `BundleConfig` 同款 `nonisolated public final class Sendable`,3 个不可变 String 属性
|
||||
- `QiniuConfig`:从 `enum` 改为 `actor`,`accessKey`/`secretKey` 仍 nonisolated(直接读 `AppSecrets.shared`),`cdnDomain`/`bucketName` 进 actor 状态;`update(...)` / `publicURL(...)` async
|
||||
|
||||
Reference in New Issue
Block a user