daoqi/youle_app_ios_v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
148 Commits 1 Branch 0 Tags
04e702a99b8d47eb581e9787f1472c63a8f8ab23
Commit Graph
11 Commits
Author SHA1 Message Date
joywayer 06b7686e17 启动文字提示，h5调试加入 2026-06-24 21:20:05 +08:00
joywayer 5b38456c66 3.B：vendor opencore-amr + AMRCodec Swift wrapper，打通 AMR↔WAV 编解码 
为支撑 H5 的 prepareaudio / mediaTypeAudio 录音上传 + 远端语音播放
（docs/H5-Native-Contract.md §3.1 ［4］［5］ + §3.2 ［9］）接入 AMR-NB
编解码能力。AMR-NB 是跨端（iOS / Android / 旧版本客户端）契约硬约束，
不可换 AAC / Opus。

## 接入路径

直接 vendor daoqi msext 现成的 fat .a（已上线多年），不打 xcframework /
不重编源码：
- Vendor/OpenCoreAMR/v0.1.x/libopencore-amrnb.a：daoqi 同款 5-slice fat
  库（含 2026-06-20 lipo -segalign 8 修过的对齐版本）
- Vendor/OpenCoreAMR/v0.1.x/{interf_dec,interf_enc}.h：amrnb 公开头
- Vendor/OpenCoreAMR/README.md：来源、版本、修复历史、为何不打 xcframework
- ylgamehall/Source/Audio/AMRFileCodec/{amrFileCodec.h,amrFileCodec.mm}：
  daoqi 同款 wrapper（文件级 WAV↔AMR 处理）
- ylgamehall/Source/Audio/AMRCodec.swift：Swift 薄 wrapper（wavToAmr /
  amrToWav 两个纯函数 + AMRCodec.Error）

理由见 Vendor/OpenCoreAMR/README.md「为何不打 xcframework / 不重编源码」
一节，本质是 opencore-amr 整个 iOS 生态没有"现代主流"分发形态，社区无
官方 SPM / xcframework 维护，强行打反而引入新风险。

## 关键技术点：extern "C" 修复 ObjC++ name mangling

amrFileCodec.h 在原项目里没有 extern "C" 包裹函数声明，daoqi 能跑是
因为调用方 VoiceConverter.mm 也是 ObjC++，双方按相同 C++ name mangling
链接能对上。

新外壳从 Swift 通过 bridging-header 调用，Swift 按 C 函数解析，期望符号
_EncodeWAVEFileToAMRFile / _DecodeWAVEFileToWAVEFile（C 链接）；但
.mm 编译时默认 C++ name mangling，符号变成 __Z25Encode...，导致链接器
报 Undefined symbol。

修复：在 amrFileCodec.h 的函数声明外加 #ifdef __cplusplus / extern "C"
包裹。这是标准 C/C++ 头文件兼容写法，对 daoqi 老路径无影响（ObjC++
调用方仍能链接 C-linkage 函数）。

## .gitignore：白名单 Vendor 下的 .a

发现历史遗留问题：原 .gitignore *.a 通配规则把 libWeChatSDK.a 也排除
了，意味着别人 clone 此仓库后链接失败。本次顺带修复：

  !Vendor/**/*.a

让 Vendor 下的 .a 显式纳入跟踪。本提交同时把 libWeChatSDK.a（历史
缺失）+ libopencore-amrnb.a（本次新增）一并加入 git 跟踪。

## 工程改动

pbxproj 改动由用户在 Xcode UI 完成（4 项 Build Settings：Add .a 到
Frameworks group / Header Search Paths +2 / Library Search Paths +1；
EXCLUDED_ARCHS arm64-simulator 因真机调试场景暂未配，需要时再加）。

## 验证

BuildProject 通过，0 错误，符号链接正确。XcodeRefreshCodeIssuesInFile
对 AMRCodec.swift 0 诊断。
 2026-06-24 01:20:30 +08:00
joywayerandClaude Opus 4.7 f6142ced41 完成 WeChat SDK 1.8.2 静态库链接配置 
补齐 commit 05f1396 降级时遗漏的链接条目：libWeChatSDK.a / libz.tbd /
libsqlite3.tbd 加入 Link Binary、Security/CFNetwork framework 补齐、
HEADER/LIBRARY_SEARCH_PATHS + SWIFT_OBJC_BRIDGING_HEADER 配上。

关键：OTHER_LDFLAGS = "-ObjC"，否则静态库内 NSMutableArray(MTAQueue)
category 不被加载，MTA 上报 runtime 调 enqueue: 立即崩
（与 daoqi/msext 的 Pods-msext.*.xcconfig 一致）。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-23 17:22:04 +08:00
joywayerandClaude Opus 4.7 323fb9074b 修复 AMap 真机链接错：补 3 个系统 framework + 永久文档化 
真机首次跑 ylgamehall 时 linker 报 7 个 Undefined symbol：
- _CNCopyCurrentNetworkInfo / _CNCopySupportedInterfaces / _SCNetworkReachability*
  → SystemConfiguration.framework
- _OBJC_CLASS_$_CTTelephonyNetworkInfo → CoreTelephony.framework
- _OBJC_CLASS_$_EAAccessoryManager → ExternalAccessory.framework

根因：AMap 是 fat 静态库（`Vendor/AMap/*.framework`），它内部引用的系统 API
不会被自动带入 transitive 依赖，必须项目方手动 link。CocoaPods 时代由
podspec 自动声明（daoqi msext 走 Pods 故未在 pbxproj 显式 link
ExternalAccessory）；本项目走 Vendor 手动接入路线，必须显式补齐。

工程：pbxproj 加 3 个 PBXBuildFile + PBXFileReference（Xcode UI 操作自动写入）

文档（永久记录避免重蹈）：
- Vendor/AMap/README.md「工程接入步骤」第 5 步补齐 3 个系统 framework
  + 列出每个 framework 对应的 symbol
- Vendor/AMap/README.md 末尾加「如果未来真机链接报 C++ symbol 缺失」
  备用方案（加 libc++.tbd，daoqi 已加；当前 AMap 2.12.0 未触发）
- docs/SDK-Integration-Guide.md §A.2 第 5 步同步

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-23 02:50:29 +08:00
joywayerandClaude Opus 4.7 a3679aba7d 修复 SDK 真实接入后的 Swift 编译错误 + Xcode 链接配置 
实测三个 SDK（微信 / 高德 / 七牛）链接进 Target 后，暴露出 9 个 Swift 编译错误，逐一修正：

代码侧（5 个 Swift 文件）：
- AMapWrapper：updatePrivacyShow / updatePrivacyAgree 是 AMapLocationManager
  类方法（since 2.8.0），不在 AMapServices 上；改为 AMapLocationManager.*
  并补 import AMapLocationKit
- BackGameDataHandler：删 `WXApi.delegate = nil`。新版 SDK 2.x 无 static
  delegate API，delegate 由调用方逐次传给 handleOpenURL/sendAuthReq 并被
  SDK 弱引用；WeChatManager singleton 长生命周期不析构，无需 cleanup
- QiniuConfig / QiniuTokenSigner：所有 static 成员标 nonisolated，让 actor
  QiniuUploader 可直接调，无需 await MainActor.run
- QiniuUploader：QNUploadManager() 在七牛 SDK 8.x 已 kQNDeprecated，改用
  initWithConfiguration: + defaultConfigurationV2

工程侧（pbxproj，Xcode UI 自动写入）：
- 新 Frameworks group 容纳 Vendor/WechatSDK / Vendor/AMap 引用
- WechatOpenSDK-NoPay.xcframework：Embed & Sign（动态库）
- AMapFoundationKit / AMapLocationKit：Do Not Embed（静态 fat .framework）

BuildProject 验证：Swift 全部编译通过；剩余 AMap fat framework arch 冲突
（M Mac iOS-simulator）是工程配置选择，下个 commit 处理。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-23 01:03:29 +08:00
joywayerandClaude Opus 4.7 4e5600a9ee Phase 3.C：Xcode 加入七牛 SPM 依赖 objc-sdk 8.9.2 
按 SDK-Integration-Guide.md §A.3 操作，加入 https://github.com/qiniu/objc-sdk
（传递依赖 happy-dns-objc 1.0.4 自动解析）。canImport(QiniuSDK) 现在
返回 true，QiniuUploader.upload(...) 真实路径激活。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-23 00:02:31 +08:00
joywayer b866ee212c Phase 1.4：引入 ZIPFoundation SPM 依赖（v0.9.20） 
ResourceUnzipper（Phase 1.5）的前置：用 ZIPFoundation 替代旧 ZipArchive
解压 gamehall.zip。ADR-006 纯 SPM + Vendor 策略下的首个 SPM 依赖。

- 引入：https://github.com/weichsel/ZIPFoundation
  - 版本 0.9.20（Up to Next Major，commit 22787ffb59de）
  - License: MIT；纯 Swift 实现，Xcode 26 原生兼容
  - 链接到 target ylgamehall
- pbxproj：XCRemoteSwiftPackageReference + XCSwiftPackageProductDependency
  写入；Package.resolved 锁定版本，多机 / CI 复现
- BuildProject 通过；ZIPFoundation 全部 .swift 由 SwiftCompile 实际
  参与构建，与 ylgamehall target 链接完成
- 附带：ChannelConfig.plist 移除内联说明注释（Phase 1.1 commit 后由
  维护者整理），不影响 plist 数据结构
 2026-06-21 23:56:32 +08:00
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 4e4290ded6 建立 .gitignore，清理误入库的 xcuserdata 
- 标准 iOS/Swift 模板：忽略 build/DerivedData/xcuserdata、
  SPM .build、CocoaPods Pods/、签名证书、本地敏感配置
- 保留 Package.resolved / Podfile.lock / Vendor/ 入库
  以保证多人 + CI 依赖锁定与闭源 SDK 可分发
- 同时把误入库的 xcuserdata/xcschememanagement.plist 从
  版本控制移除（本地文件保留）
 2026-06-21 20:05:21 +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
joywayer 108b359f96 Initial Commit 2026-06-21 19:37:33 +08:00