新增所需资源,修改优化文档

This commit is contained in:
joywayer
2026-06-21 20:40:46 +08:00
parent 4e4290ded6
commit d18ea4f1c5
42 changed files with 1244 additions and 0 deletions
+28
View File
@@ -1046,6 +1046,34 @@ public actor ConfigService {
## 7. 资源 & 渠道注入
### 7.0 仓库根 `Resources/` 目录现状(2026-06-21
新外壳运行所需的项目方资源统一存放在仓库根 `Resources/`**不**在 Xcode 工程内的 `ylgamehall/` 源码目录里)。这与 §2.2 的 SPM 包结构里 `Resources/` 是同一份物理目录,后续打包脚本通过 Build Phase 引用。
当前实际内容(可直接展开 Phase 1 开发):
```
Resources/
├── gamehall.zip ← 大厅 H5 资源包 (≈ 11 MB, 2023-12 旧版)
│ 启动时 ResourceUnzipper 解压到
│ Library/Caches/{gamedir}/
│ ⚠️ 上线前必须由 H5 团队提供最新版替换
├── Images.xcassets/ ← 原生 Asset Catalog (AppIcon /
│ LaunchImage / 微信 / QQ / 抖音
│ 分享平台图标)
└── Res/ ← 散落原生资源 (未走 Asset Catalog 的旧文件):
├── sharelogo.png ← 分享缩略图 (友圈/微信链接分享用)
├── shake_sound_male.mp3 ← 摇一摇音效 (SwitchShake 开关控制)
├── BackBT.png ← msext 兼容图,新外壳是否引用待 Phase 1 验证
├── Sistem_back.png ← 同上
├── Icon180.png ← 同上
└── Default-568h@2x~iphone.png ← 同上
```
> **Phase 1 含义**:`gamehall.zip` 实物已就位,虽是旧版但足以跑通"渠道注入 → 解压 → 加载 H5 → 桥消息"全链路,不必等 H5 团队最新版才开始。版本差异不影响契约边界(handler 名 / 参数 / 数据结构)。
后续 11 个**渠道注入目录**(`qiniudomain` / `gameid` / `channel` / `gamedir` / `gamestart` / `gameconfig` / `market` / `agent` / `appversion` / `other` / `appleconfig`)将由 `Scripts/inject_channel.sh` 在打包前于 `Resources/ChannelInjection/` 下动态生成,运行时通过 `BundleConfig.readInjected(_:)` 扫描 Bundle 子目录读取(§7.2)。
### 7.1 SandboxPaths 集中管理
```swift