新增所需资源,修改优化文档
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user