 joywayer
|
8c2ffa3106
|
Phase 1.1：渠道注入用 ChannelConfig.plist 替代 msext 目录树（ADR-007）
契约 §0.3 描述 msext 把 11 个渠道值编码为 Bundle 根的 11 个空目录
子文件夹名（目录名本身就是值）。在 Xcode 26.5 默认的 synchronized
group 下，此机制不兼容（子目录被扁平化、11 个 .gitkeep 撞名；
folder reference 拖入流程失效；Run Script Phase 受 sandbox 阻碍且
默认 Based on dependency analysis 让 clean build 也不跑）。
CLAUDE.md 原则 B 落地——原生内部自由重构，不照搬 msext。改用单一
plist 存储等价语义，H5 端通过 app_data.js 看到的 11 个 JS 全局变量
行为完全不变（契约边界在 BundleConfig.shared.xxx，与底层无关）。
多渠道分发用 plutil -replace + 重签 + 重打包，工作量与 mv 目录名
重签完全相同。
- 新增 ylgamehall/Resources/ChannelConfig.plist：11 个 string key
含母包默认值（沿用 msext 现网值）；synchronized group 自动入 Bundle
- Design §7.0 / §7.2 重写为 plist 方案；BundleConfig 代码骨架改为
PropertyListSerialization + init(bundle:) 可注入式
- Plan §5 Phase 1.1 任务清单从 4 个子项简化为 1 项；ADR-004 文字
同步；新增 ADR-007 完整记录决策背景 / 触发事件 / 工程兼容性分析
/ 理由 / 守护条款
- pbxproj：ENABLE_USER_SCRIPT_SANDBOXING 残留为 NO（前期 Run Script
方案探索时关闭，plist 方案下不再需要，但未恢复以避免再次 UI 操作；
无 Run Script 故无实际安全暴露面，未来可随时改回 YES）
- BuildProject 验证：plist 已落在 .app 根，plutil -p 输出 11 个键值
完整
|
2026-06-21 23:41:25 +08:00 |
|
|
joywayer
|
cabdc1ed42
|
docs：剥离 docs/res/ 为私人素材池，废止仓库根 Resources/ 假设
明确 docs/res/ 是项目维护者的私人原始素材池，与项目架构无关；项目
代码 / 构建脚本 / Xcode 工程都不感知它的存在，需要时从中拷一份到
项目按现代实践规划的位置。原 ADR-004「Resources/ 在仓库根 +
Build Phase 引入」语义已崩塌（gamehall.zip / Images.xcassets / Res/
均被挪入 docs/res/），修订为「项目内资源目录由各 Phase 按需落地」：
静态 Bundle 资源走 ylgamehall/Resources/、原生 Asset Catalog 走
ylgamehall/Assets.xcassets/、渠道注入产物走 ylgamehall/ChannelInjection/
（.gitignore + Scripts/inject_channel.sh 生成）、闭源 SDK 走 Vendor/。
- CLAUDE.md 原「Resources/ 目录约定」节改写为「docs/res/ 与项目
资源的关系」，禁止把 docs/res 当项目资源目录使用
- Design §7.0 整节重写为「项目资源目录约定」三小节（docs/res
与项目无关 / 项目内资源目录在 Phase 实施时按需落地 / 渠道注入
运行时路径）
- Plan ADR-004 修订为「项目资源目录由各 Phase 按需落地」；ADR-002
/ §2.2 / Phase 1.1.a-d / 1.5 同步调整为 docs/res → ylgamehall/Resources
的拷贝模型；Phase 1 任务清单细化渠道注入由 Scripts/inject_channel.sh
生成
- 物理迁移：仓库根 Resources/gamehall.zip / Images.xcassets / Res/
全部 rename 到 docs/res/（git rename detection 自动识别）
|
2026-06-21 22:32:38 +08:00 |
|
|
joywayer
|
17a8b96cf8
|
docs：依赖管理改为纯 SPM + Vendor，移除 CocoaPods（ADR-006）
调研发现 Qiniu SDK 已官方支持 SPM（https://github.com/qiniu/objc-sdk
v8.9.x），AMap 仍仅支持 CocoaPods 或手动 XCFramework；CocoaPods 1.15.2
不兼容 Xcode 26 的 PBXFileSystemSynchronizedRootGroup，需绕道 Bundler
才能升到 1.16+。综合性价比决定不引入 CocoaPods 工具链，所有闭源 SDK
（含 AMap）统一走 Vendor .xcframework 手动接入。
- Design §14.1 三层策略改写为两层（SPM + Vendor），新增 Vendor 接入
标准流程 6 步法
- Design §14.2 AMap 接入方式从 CocoaPods 改为 Vendor，Qiniu 标注 SPM
URL 与版本
- Plan §2.3 / §5 Phase 5.1 / §6.1 / §8 同步 AMap Vendor 化
- Plan 新增 ADR-006 完整决策记录
- CLAUDE.md 新增「依赖管理约定」节，禁止引入 CocoaPods
|
2026-06-21 21:46:19 +08:00 |
|
|
joywayer
|
2a3d985dd7
|
调整极光
|
2026-06-21 20:48:41 +08:00 |
|
|
joywayer
|
d18ea4f1c5
|
新增所需资源，修改优化文档
|
2026-06-21 20:40:46 +08:00 |
|
|
joywayer
|
beb05ab451
|
添加文档和CLAUDE.md
|
2026-06-21 19:39:22 +08:00 |
|