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:
co-authored by
Claude Opus 4.7
parent
a3679aba7d
commit
01780704cd
@@ -32,15 +32,17 @@
|
||||
|
||||
### A.2 添加高德定位 framework × 2(Vendor 手动,无 SPM 替代)
|
||||
|
||||
> ⚠️ 高德官方至今未提供 SPM 包;只发布旧式 fat `.framework`(不是 xcframework),同时含 x86_64 + arm64 — 模拟器和真机都能用,但要 **Do Not Embed**(静态库不能 Embed,否则链接器报 `__OBJC` 段重复符号)。
|
||||
> ⚠️ 高德官方至今未提供 SPM 包 / 也不提供 xcframework;只发布旧式 fat `.framework`,含 x86_64 + **device** arm64(**不含** simulator arm64)。
|
||||
>
|
||||
> **结果**:真机 build OK;M 芯片 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 framework,Embed 会触发 `__OBJC` 段重复符号错)
|
||||
5. ⌘B 编译 — **target 必须选真机**或 Generic iOS Device,模拟器 target 会因 simulator-arm64 slice 缺失而链接失败(按设计)
|
||||
|
||||
### A.3 添加七牛 SPM 依赖(远程)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user