 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 |
|