daoqi/youle_app_ios_v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
32 Commits 1 Branch 0 Tags
0ecfa4fb693eb0fe4054e82f5583e5320879e781
Commit Graph
10 Commits
Author SHA1 Message Date
joywayerandClaude Opus 4.7 f3c66b670d Phase 1.14.c：LobbyZipUpgrader 加 0…1 progress 回调 
- upgradeIfNeeded 新增 onProgress: @escaping @Sendable (Double) -> Void 参数，
  默认 no-op 兼容仅做版本对比的烟雾测试
- 新增文件内私有 DownloadProgressDelegate（URLSessionDownloadDelegate
  + @unchecked Sendable），在 didWriteData 回调里把 totalBytesWritten /
  totalBytesExpectedToWrite 换算成 0…1 上报，clamp 到 [0,1]
- 通过 session.download(from:delegate:) 注入；下载完成后兜底报 1.0
  （部分 server 不发 Content-Length 或末尾片段晚到，避免进度条停在 99%）
- RootViewController 烟雾测试用 ProgressTicker 把回调节流到 10% 阶梯打印，
  避免几百行刷屏（NSLock 保护单 Int 状态，@unchecked Sendable）
- BuildProject 通过

Plan 进度已勾选（§5 Phase 1.14.c + §8）

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-22 02:46:11 +08:00
joywayer 0887088bb8 Phase 1.13：LobbyZipUpgrader 完成 H5 zip 升级端到端链路 
Phase 1 远程配置链路（1.10-1.13）最后一环：把 VersionResolver 解出的
gameZip URL 下载 + 解压 + 原子 rename 到 lobbyRoot，触发条件是远端
gameVersion > 本地 version.xml /game/version@value。

- 新增 ylgamehall/Source/Resource/LobbyZipUpgrader.swift
  - public actor，单例 LobbyZipUpgrader.shared
  - upgradeIfNeeded(resolved:) async throws -> Outcome
    - .noop：远端版本 ≤ 本地，或 gameZip nil / 非法 URL，直接返回
    - .upgraded(from:to:)：完成升级，附前后版本号
  - URLSession.download(from:) 异步下载（60s 请求 / 300s 资源超时），
    HTTP 状态码非 2xx 抛 .httpStatus
  - 解压到 caches/lobby-staging-{UUID}/ 隔离目录（不直接覆盖 lobbyRoot，
    msext "removeItem + ZipArchive overWrite:YES" 半途崩溃会留半残；
    我们 staging 完整解压成功后才 rename）
  - 原子 rename：fm.removeItem(lobbyRoot) → fm.moveItem(staging,
    to: lobbyRoot)；任一步失败抛 .stagingMoveFailed，调用方决定回退
  - 类型化 UpgradeError 5 种：badGameZipURL / downloadFailed /
    httpStatus / unzipFailed / stagingMoveFailed
  - 实现照搬 msext NewRootVC.m:1789-1869 downFileFromServer + unzip
    + unzipDone 的语义，但用现代 async + 原子 rename 替代 ASIHTTPRequest
    + detachNewThreadSelector + ZipArchive overWrite:YES
- RootViewController 烟雾测试串接 LobbyZipUpgrader：
  调 upgradeIfNeeded → switch outcome → 升级后重新读 version.xml 验证
- 真机实测端到端链路：
  第一次：本地 260 vs 远端 261 → 升级完成 261，耗时 2.007s
    （下载 11.5 MB HTTP zip + ZIPFoundation 解压 + 原子 rename）
    重新读 version.xml = 261 ✓ lobbyIndex 仍存在 ✓
  第二次：本地 261 vs 远端 261 → .noop，耗时 0.001s（幂等验证）

Phase 1 远程配置链路（1.10-1.13）完整闭环。下一步 Phase 1.14
WebContainer 把这条链路插到 viewDidLoad 之前 + 16:9 letterbox 加载
lobbyIndex，第一次让真实大厅 H5 渲染出来。
 2026-06-22 02:27:48 +08:00
joywayer 9e50c38323 Phase 1.12：LocalVersionReader 读 version.xml + ATS 全局放行 
新增 LocalVersionReader 读两个本地版本号 + Info.plist 加
NSAllowsArbitraryLoads 全局放行 HTTP（为 Phase 1.13 zip 下载链路准备）。

- 新增 ylgamehall/Source/Resource/LocalVersionReader.swift
  - public enum LocalVersionReader，nonisolated static 命名空间
  - localAppVersion: Int 从 BundleConfig.shared.appVersion 转 Int
    （沿用 ChannelConfig.plist 注入），解析失败返回 0
  - localGameVersion: Int 用 Foundation XMLParser SAX 风格解析
    SandboxPaths.lobbyVersionXML 的 /game/version@value 节点，
    缺失 / 损坏返回 0（msext NewRootVC.m:664-682 `[nil intValue]=0`
    兜底语义，是首装后首次升级的关键机制）
  - subGameVersion(dir:start:) 子游戏版本号读取，Phase 6 用
  - 内部 VersionXMLHandler 标 nonisolated（Swift 6 严格并发下
    XMLParserDelegate 跨边界），SAX 风格只在 didStartElement 抓
    version 节点的 value 属性
- Info.plist 加 NSAppTransportSecurity / NSAllowsArbitraryLoads = true
  - 企业签 / 超签分发场景，后端域名易变（zip CDN / 配置服 /
    七牛 / 错误日志上报等），白名单维护成本高于安全收益
  - 全局放行的副作用主要影响第三方 SDK 流量；本项目无意外引入未审计
    SDK，且第三方 SDK 自身一般也走 HTTPS，不受影响
  - 详见 ADR-008 决策上下文与 CLAUDE.md「不上架 App Store，企业签 /
    超签 / TF 分发」契约
- RootViewController 烟雾测试串接 LocalVersionReader：打印本地 vs 远端
  对比 + IPA / zip 升级判定
- 真机实测（现网 .txt 本地 + 当前 IPA 内 gamehall.zip 解压物）：
  - 本地 appVersion = 43, 远端 = 43 → 不升级
  - 本地 gameVersion = 260（IPA 内 2023-12 zip 的 version.xml），
    远端 = 261 → 需要 zip 升级。Phase 1.13 将实现下载 +
    解压 + 替换链路
 2026-06-22 02:24:22 +08:00
joywayer dfbc26a024 Phase 1.11：VersionResolver chulishengji 双子树合并算法 
实现 msext NewRootVC.m:1372-1538 的 chulishengji 双子树合并算法的纯
函数 Swift 版本，把远端 RemoteConfig 化简为 5 个目标字段决策结果
（appVersion / appDownload / gameVersion / gameZip / showmessage）。

- 新增 ylgamehall/Source/Network/VersionResolver.swift
  - public enum VersionResolver + 纯函数 static func resolve
  - public struct ResolvedVersion: Sendable 含 5 字段
  - 内部 SubtreeExtract 中转 4 字段累加结果（每层非空才覆盖）
  - extractAgentSubtree 4 层（agent → channel → market → game 嵌
    market 命中后）按 NewRootVC.m:885-1013 复刻
  - extractGameSubtree 4 层（game → game-self → channel → market）
    按 NewRootVC.m:1015-1180 复刻
  - mergeIPA 默认 agent 赢；game.appVersion > agent.appVersion 时
    game 赢（NewRootVC.m:1416）
  - mergeZip 默认 game 赢；agent.gameVersion > game.gameVersion 时
    agent 赢（NewRootVC.m:1456）
  - showmessage 任意子树非空就用，最后写赢；回退到 config.showmessage
- 字段名 game_download vs game_zip 由 SubtreeExtract.gameZip 统一吸收，
  Codable 模型已用 gameZip 命名，故无需重复查两个 key
- RootViewController 烟雾测试串接 RemoteConfigClient + VersionResolver，
  打印 chulishengji 合并后的 5 字段
- 真机实测（现网 .txt JSON）：
  - appVersion = 43 → 等于本地 BundleConfig.appVersion，不触发 IPA 升级
  - gameVersion = 261 → 远端最新版（本地 version.xml 待 Phase 1.12 读取
    后对比；首装后 version.xml 实测 261 等于本地）
  - gameZip = http://tsgames.daoqi88.cn/zip2/gamehall.zip
    （HTTP，Phase 1.13 下载需 ATS NSExceptionDomains daoqi88.cn）
  - appDownload = itms-services://... 企业签 manifest URL
  - showmessage = ""（无运营公告）
- 单测目前未写（等 Phase 0.2 单测 target 建立后补齐），但生产数据
  已验证算法正确
 2026-06-22 02:18:27 +08:00
joywayer 1bc287bafc Phase 1.10：RemoteConfigClient 完整版（HTTPS + cache-busting + 短文本 + FlexibleString） 
第二轮调研 daoqi/NewRootVC.m 全文核对后，把对原项目远程配置流程的精确
理解固化进 ADR-008 + Design §6.3.2，并补齐 RemoteConfigClient 缺失的
3 个契约（cache-busting query、短文本响应识别、字段类型混乱兼容）。

核心修正：线上热路径是 chulishengji 双子树合并算法（NewRootVC.m:1372-1538），
不是 onnet 简单 4 层覆盖。viewWillAppear 与 gonet 都会强制把当前 agent 的
gamelist 提到 self.gamelist，只要服务器 JSON 含 agent.gamelist（线上 100% 都有），
self.gamelist 就非 nil，走 else 分支 → chulishengji。本次烟雾测试实测：
agent[0].gamelist = 7 个，完美印证 chulishengji 必要性。

- RemoteConfigClient 新增 cache-busting query：?vXXXXXXXXYYYYYYYY（两段 8 位 hex
  连写，无 =，照搬 msext NewRootVC.m:1226 契约），每次重试都重新生成
- 新增 RemoteConfigOutcome enum：.parsed(RemoteConfig) 与 .shortText(String)
  两种成功状态。短文本响应（trim 后 utf16.count ≤ 100）是服务端运营杀手锏 #1，
  msext 当 alert 文本弹窗 + 停止重试（NewRootVC.m:1239-1243）
- UTF-8 解码 + trim 跟 msext NewRootVC.m:1237-1238 严格对齐
- 所有 String? 字段改用 decodeFlexibleStringIfPresent 扩展（兼容 number-as-string）：
  agentid / channelid / marketid / gameid / showmessage / appVersion / appDownload
  / gameVersion / gameZip 全部 9 字段。msext 用 NSNumber.intValue/description 静默
  吞下 number，新外壳 Codable 严格类型必须显式处理
- 远端 URL 从 http 改为 https（后台已切，无需 ATS 例外）
- Plan ADR-008 修订为含 9 个子节（A-I）的精确决策记录，含 chulishengji
  双子树算法、agent 子树结构、game 子树结构、字段级合并优先级、决策顺序、
  与 msext 差异表
- Design §6.3.2 VersionResolver 重写：从"简单 4 层 reduce"改为"chulishengji
  双子树合并 + 字段级合并"，附 13 项单测覆盖矩阵
- RootViewController 烟雾测试切换为 outcome enum switch case，覆盖 .parsed
  与 .shortText 两条路径
- 实测烟雾：HTTPS 拉到 30 KB JSON 解析 .parsed 成功（耗时 2.7s 含 TLS 握手），
  agent[0].gamelist 含 7 个 game 节点，证明 chulishengji 路径是热路径
 2026-06-22 02:14:57 +08:00
joywayer af1a2028e5 Phase 1.8：WebViewJavascriptBridge.js 协议源码入 Bundle 
H5 端桥协议实现，与 BridgeBus 的消息格式 1:1 对齐：
H5 → Native 走 window.webkit.messageHandlers.WVJBHandler.postMessage(...)，
Native → H5 走 window.WebViewJavascriptBridge._handleMessageFromObjC(base64)。

- 新增 ylgamehall/Resources/JS/WebViewJavascriptBridge.js（~130 行）
  - bridge.registerHandler(name, fn)：H5 注册等待 Native callHandler
  - bridge.callHandler(name, data, responseCallback)：H5 主动调 Native
  - bridge._handleMessageFromObjC(b64)：Native 入口，base64 → JSON parse
    → 派发到 H5 handler 或匹配响应 responseCallbacks
  - base64 解码用 decodeURIComponent + atob 处理 UTF-8 多字节字符
  - 兼容 marcuswestin 旧式 window.WVJBCallbacks 队列握手：注入后
    立即 flush 队列（H5 业务代码无需修改）
- RootViewController 加 Phase 1.8 烟雾测试：Bundle.main.url 找到 JS 文件
  并打印 bytes / head；synchronized group 会把 Resources/JS/ 子目录
  扁平化到 bundle 根，注释里说明此约束
- BuildProject 通过，bundle/WebViewJavascriptBridge.js 实际存在
- 下一步 Phase 1.9 BridgedWebView 用 WKUserScript(.atDocumentStart) 注入
  本文件到所有 H5 页面，桥真正生效
 2026-06-22 00:16:55 +08:00
joywayer 463f0fc6fe Phase 1.5：ResourceUnzipper 解压 gamehall.zip 到 Caches 全链路打通 
启动期完成「ChannelConfig.plist 读 → SandboxPaths 算路径 →
gamehall.zip 解压」三步，lobbyIndex 真实存在于沙盒 Caches，
为 Phase 1.10 WebContainer file:// 加载就绪。

- 新增 ylgamehall/Source/Resource/ResourceUnzipper.swift
  - public actor，全局单例 ResourceUnzipper.shared
  - ensureReady() async throws：检查 lobbyVersionXML 不存在则调
    FileManager.unzipItem (ZIPFoundation 扩展) 解压 Bundle 内
    gamehall.zip 到 SandboxPaths.lobbyRoot
  - UnzipError 类型化错误（bundleZipNotFound / unzipFailed）
  - 幂等：已就绪直接 return，并发调用安全（actor 串行）
- 新增 ylgamehall/Resources/gamehall.zip：从 docs/res 拷一份入
  Bundle（11.5 MB，2023-12 旧版；上线前由 H5 团队替换最新版，
  ADR-002 已记录）
- Swift 6 严格并发适配：
  - SandboxPaths：所有 static 成员标 nonisolated（无状态命名空间，
    从 actor / 非 MainActor 上下文都能直接读 caches/documents/bundle
    及 lobby 路径计算）
  - BundleConfig：class 整体 nonisolated（Sendable + all-let 属性，
    跨 actor 边界安全），允许 ResourceUnzipper actor 读 channel 配置
- RootViewController 补 ResourceUnzipper 烟雾测试 Task：
  await ensureReady() 后打印耗时 + lobbyIndex 是否真实存在
- 真机验证（iOS Simulator）：首次 1.266s 解压成功，二次启动 0s 跳过
 2026-06-22 00:01:08 +08:00
joywayer 730574a2e2 Phase 1.3：SandboxPaths 统一沙盒 / Bundle / H5 路径入口 
集中管理 NSSearchPathFor... 调用，避免散落，方便后续 ResourceUnzipper
（Phase 1.5）与 WebView 加载（Phase 1.10）复用。

- 新增 ylgamehall/Source/Resource/SandboxPaths.swift
  - 基础：caches / documents / bundle
  - 大厅 H5：lobbyRoot / lobbyIndex / lobbyVersionXML（基于 BundleConfig
    当前渠道值动态拼接）
  - 子游戏 H5：subGameRoot(_:) / subGameIndex(_:_:)（Phase 6 调用，
    入参传 SwitchOverGameData 解出的 dir/start）
  - 全部 enum + static，无状态，Swift 6 严格并发零负担
- RootViewController.viewDidLoad 补 SandboxPaths 烟雾打印 6 项路径，
  便于首次启动 console 校验：
  - lobbyIndex 应为 {Caches}/FtJf073.../gamehall/index.html
  - lobbyVersionXML 应为 {Caches}/FtJf073.../gamehall/version.xml
- BuildProject 通过，synchronized group 自动收编新文件
 2026-06-21 23:52:23 +08:00
joywayer dcc12bb76d Phase 1.2：BundleConfig 读 ChannelConfig.plist 完成 11 项渠道注入加载 
- 新增 ylgamehall/Source/Resource/BundleConfig.swift
  - 11 个 public let 属性（qiniuDomain / gameId / channel / gameDir
    / gameStart / gameConfig / market / agent / appVersion / other
    / appleConfig）
  - public init(bundle: Bundle = .main) —— 默认走 main bundle，单测
    可注入 mock bundle 验证不同 plist fixture
  - PropertyListSerialization 反序列化 ChannelConfig.plist
  - final class + Sendable（all-let，String 是 Sendable，Swift 6
    严格并发下编译器静态校验通过）
  - 单例 BundleConfig.shared，业务统一通过此访问
- RootViewController.viewDidLoad 加烟雾测试 print 11 项值，首次运行
  真机/模拟器即可在 console 验证读取正确
- BuildProject 通过，synchronized group 自动收编 BundleConfig.swift
  为 source（.swift 文件类型走 SwiftCompile，不再卡 plist 那样的
  resource 扁平化问题）
- 单元测试待 Phase 0.2 单测 target 建立后补齐
 2026-06-21 23:47:23 +08:00
joywayer 7a84223841 M0：项目基础配置就绪（横屏锁定、Swift 6、代码启动） 
- 锁定 iPhone/iPad 仅横屏（LandscapeLeft/Right），契合 H5 端
  1280×720 设计分辨率；UIRequiresFullScreen=true 防 iPad
  多任务下方向不锁
- Swift Language Version 升到 6.0（配合已启用的
  Approachable Concurrency + MainActor 默认隔离）
- 删除默认 Main.storyboard / ViewController.swift 模板，
  改用 SceneDelegate 代码创建 RootViewController 启动，
  Build Settings 同步清空 INFOPLIST_KEY_UIMainStoryboardFile
- Info.plist 补齐契约项 UIStatusBarHidden=NO、
  UIViewControllerBasedStatusBarAppearance=YES，配合
  AppDelegate 启动时设置 applicationSupportsShakeToEdit=true
  覆盖契约 §4.2.1 摇一摇前置
- BuildProject 通过验证
 2026-06-21 20:03:33 +08:00