docs:明确 AMap fat framework 不含 simulator arm64 是项目接受的现状

高德官方至今不提供 xcframework,只发布 fat .framework(含 x86_64 + device
arm64)。M 芯片 Mac iOS-simulator target 链接失败是 fat 库的物理限制,与
daoqi msext 维护实践一致——开发期跑真机即可。

不动 Build Settings、不自造 xcframework、不切 CocoaPods 三条「不要做」也
一并明示,避免未来维护者花时间在这条死路上:
- Vendor/AMap/README.md 新增「已知限制」章节,含决策原因 + 三条「不要做」
- docs/SDK-Integration-Guide.md §A.2 简明提示 + 链回 README

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
joywayer
2026-06-23 01:07:02 +08:00
co-authored by Claude Opus 4.7
parent a3679aba7d
commit 01780704cd
2 changed files with 31 additions and 6 deletions
+5 -3
View File
@@ -32,15 +32,17 @@
### A.2 添加高德定位 framework × 2Vendor 手动,无 SPM 替代)
> ⚠️ 高德官方至今未提供 SPM 包;只发布旧式 fat `.framework`(不是 xcframework),同时含 x86_64 + arm64 — 模拟器和真机都能用,但要 **Do Not Embed**(静态库不能 Embed,否则链接器报 `__OBJC` 段重复符号)。
> ⚠️ 高德官方至今未提供 SPM 包 / 也不提供 xcframework;只发布旧式 fat `.framework`,含 x86_64 + **device** arm64**不含** simulator arm64)。
>
> **结果**:真机 build OKM 芯片 Mac iOS-simulator 链接失败。**这是项目方接受的现状**——开发期跑真机,与 daoqi msext 同款实践。详细决策原因 / 不要做哪些事,见 `Vendor/AMap/README.md` 「已知限制」章节。
1. 选中 `ylgamehall` Target → General → Frameworks, Libraries, and Embedded Content
2.`+` → Add Other → Add Files
3. 一次性选两个:
- `Vendor/AMap/AMapFoundationKit.framework`
- `Vendor/AMap/AMapLocationKit.framework`
4. 两个的 **Embed** 列都选 **Do Not Embed**(关键,别错)
5. ⌘B 编译
4. 两个的 **Embed** 列都选 **Do Not Embed**(关键,别错——静态 fat frameworkEmbed 会触发 `__OBJC` 段重复符号错
5. ⌘B 编译 — **target 必须选真机**或 Generic iOS Device,模拟器 target 会因 simulator-arm64 slice 缺失而链接失败(按设计)
### A.3 添加七牛 SPM 依赖(远程)