# WechatOpenSDK

> 闭源 SDK，按 daoqi `CLAUDE.md` ADR-006 走 **Vendor `.xcframework`** 路径。
>
> 历史选型对比：曾考虑 Tencent 官方 SPM（`https://github.com/Tencent/WechatOpenSDK-XCFramework`），但该仓库**不存在**（404）；社区 wrapper（`yanyin1986/WechatOpenSDK`、`anotheren/WechatOpenSDK`）存在但非 Tencent 官方维护，仓库一旦停更/删除即为定时炸弹，被否决。

## 二进制来源

| 项 | 值 |
|---|---|
| 官方下载页 | <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>`） |

## 放置路径

```
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` 不同）

## 凭证

AppID + AppSecret + AuthScope + AuthState 沿用 msext，参 `docs/SDK-Integration-Guide.md §0`。
