SDK 选型修正:微信回 Vendor 路径(Tencent 无官方 SPM)

之前文档把 https://github.com/Tencent/WechatOpenSDK-XCFramework 当作
SPM 入口,实际该仓库不存在(404)。Tencent 官方至今未维护 SPM;社区
wrapper(yanyin1986 / anotheren)非官方,按 daoqi CLAUDE.md ADR-006
「闭源 SDK 走 Vendor」否决。微信改回与 AMap 同款 Vendor .xcframework
处置:

- Vendor/WechatSDK/README.md 重写为腾讯开放平台下载页 + Embed & Sign 说明
- docs/SDK-Integration-Guide.md §A / §A.1 / §1.3 同步修正
  - §A 总览:SPM × 1(七牛)+ Vendor × 2(微信 / 高德)
  - §A.1:重写为 Vendor Add Files 流程,强调 Embed & Sign 与 AMap
    静态库 Do Not Embed 的区别
  - §1.3:微信 xcframework 状态标记  等用户从官方下载放置

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
joywayer
2026-06-23 00:02:45 +08:00
co-authored by Claude Opus 4.7
parent 4e5600a9ee
commit 52ad421d22
2 changed files with 42 additions and 16 deletions
+26 -5
View File
@@ -1,14 +1,35 @@
# WechatOpenSDK
**本目录刻意不放二进制**:项目以 **SPM** 接入微信 OpenSDKTencent 官方维护),不走 Vendor xcframework。详见 `docs/SDK-Integration-Guide.md §A.1`
> 闭源 SDK,按 daoqi `CLAUDE.md` ADR-006 走 **Vendor `.xcframework`** 路径
>
> 历史选型对比:曾考虑 Tencent 官方 SPM`https://github.com/Tencent/WechatOpenSDK-XCFramework`),但该仓库**不存在**404);社区 wrapper`yanyin1986/WechatOpenSDK`、`anotheren/WechatOpenSDK`)存在但非 Tencent 官方维护,仓库一旦停更/删除即为定时炸弹,被否决。
## 二进制来源
| 项 | 值 |
|---|---|
| 来源 | Tencent 官方 SPM 仓库 |
| SPM URL | `https://github.com/Tencent/WechatOpenSDK-XCFramework` |
| 推荐版本 | `2.0.5` 或更新(SDK1.x 有 ITMS-90809 历史包袱,避免 |
| 官方下载页 | <https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=215840645315192a89cc59f0f9b4a1ccff0fed81&lang=zh_CN> |
| 推荐版本 | OpenSDK **2.0.5** 或更新(避免 1.x 的 ITMS-90809 历史包袱;新外壳不上 App Store 仍建议用 2.x,与 msext 行为差异最小) |
| 包形态 | `OpenSDK*_NoPay.zip`(不含支付能力,符合本项目需求 |
| 解压产物 | `WechatOpenSDK.xcframework`(含 ios-arm64 + ios-arm64_x86_64-simulator slice |
| 模块名 | `WechatOpenSDK``import WechatOpenSDK` / `#import <WechatOpenSDK/WXApi.h>` |
| 替代二进制 | 项目方曾下载 `WechatOpenSDK-NoPay.xcframework``docs/res/`,**改 SPM 后不再使用**,可保留作为离线备份 |
## 放置路径
```
ylgamehall/
├── Vendor/
│ └── WechatSDK/
│ ├── README.md ← 本文件
│ └── WechatOpenSDK.xcframework/ ← 用户从官方下载后放这里
```
## Xcode 接入
`docs/SDK-Integration-Guide.md §A.1`。要点:
- Target → General → Frameworks, Libraries, and Embedded Content → `+` → Add Files → 选 `Vendor/WechatSDK/WechatOpenSDK.xcframework`
- **Embed 选 `Embed & Sign`**xcframework 是动态库,与 AMap 静态 `.framework``Do Not Embed` 不同)
## 凭证