微信 SDK 降级 2.0.5 → 1.8.2(与 daoqi msext 同款,避开 UL 强制)

H5 调 accreditlogin 后 sendAuthReq success=false,根因:微信 OpenSDK
2.0.x 强制 Universal Link,传空串被 SDK 拒绝;daoqi msext 用 1.8.x 不强制
UL,多年稳定上线。沿用 1.8.2 避免无谓的 UL 运维负担(HTTPS 域名 + AASA +
微信开放平台审核 30min-1d)。

文件改动:
- 新增 Vendor/WechatSDK/v1.8.2/{WXApi,WXApiObject,WechatAuthSDK}.h +
  libWeChatSDK.a(16MB,fat: i386+armv7+armv7s+x86_64+arm64,从 daoqi
  msext/Class/SDKExport/ 直接拷贝)
- 删除 Vendor/WechatSDK/WechatOpenSDK-NoPay.xcframework(2.0.5)
- 新增 ylgamehall/ylgamehall-Bridging-Header.h(1.x .a 无 Swift module,
  必须通过 Bridging Header 导入 WXApi.h / WXApiObject.h)

代码侧(5 个 Swift 文件):
- WeChatSDK.swift:register() 改为 1.x 单参数 WXApi.registerApp(appID),
  去掉 universalLink 参数;handleOpenURL 不变(1.x/2.x 同款)
- WeChatManager.swift:去掉 #if canImport(WechatOpenSDK) 守卫(Bridging
  Header 直接导入,符号编译期必在);authorize sendAuthReq 改 1.x BOOL
  返回(无 completion);shareLink/shareImage 改 WXApi.sendReq(req)
  (1.x BOOL 返回,无 completion);getVersion → getApiVersion
- AccreditLoginHandler / WechatShare:同样去掉 canImport 守卫和 stub 分支
- BackGameDataHandler:更新注释说明 1.x WXApi delegate 由 sendAuthReq
  逐次传入,WeChatManager singleton 持有不需要清理(1.x 早期 setDelegate:
  API 已废弃)

文档:
- Vendor/WechatSDK/README.md 重写,说明 1.8.2 决策原因 + 文件结构 +
  Xcode 接入 5 步 + M Mac simulator 已知限制
- docs/SDK-Integration-Guide.md §A.1 同步重写

⚠️ **本 commit 后 BuildProject 会失败**,需要用户在 Xcode UI 完成 5 步:
1. 删 Frameworks 里旧 WechatOpenSDK-NoPay.xcframework 引用
2. Add Vendor/WechatSDK/v1.8.2/libWeChatSDK.a(Do Not Embed)
3. Add 4 个系统库:libz.tbd / libsqlite3.tbd / Security.framework /
   CFNetwork.framework(Do Not Embed)
4. Build Settings → Header Search Paths += $(PROJECT_DIR)/Vendor/WechatSDK/v1.8.2
5. Build Settings → Objective-C Bridging Header = ylgamehall/ylgamehall-Bridging-Header.h

详细操作步骤见 Vendor/WechatSDK/README.md「Xcode 接入步骤」。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
joywayer
2026-06-23 08:27:40 +08:00
co-authored by Claude Opus 4.7
parent a060f29070
commit 05f1396645
26 changed files with 1076 additions and 3530 deletions
+45 -19
View File
@@ -1,36 +1,62 @@
# WechatOpenSDK # WechatOpenSDK 1.8.2(与 daoqi msext 同款)
> 闭源 SDK,按 daoqi `CLAUDE.md` ADR-006 走 **Vendor `.xcframework`** 路径。 > **决策原因**:微信 OpenSDK 2.0.x 强制 Universal Link,需要项目方配合:
> HTTPS 域名 + AASA 部署 + Xcode Associated Domains entitlement + 微信
> 开放平台后台审核(30min1d)。daoqi msext 多年使用 1.8.2 上线稳定,
> ylgamehall 沿用同款避免无谓运维负担。1.x 不强制 UL,URL Scheme 即可。
> >
> 历史选型对比:曾考虑 Tencent 官方 SPM`https://github.com/Tencent/WechatOpenSDK-XCFramework`),但该仓库**不存在**404);社区 wrapper`yanyin1986/WechatOpenSDK`、`anotheren/WechatOpenSDK`)存在但非 Tencent 官方维护,仓库一旦停更/删除即为定时炸弹,被否决。 > 历史记录:曾尝试 SDK 2.0.5 + 空 universalLink,结果 `sendAuthReq`
> 直接 `success=false`SDK 拒绝),无法授权。改回 1.8.2 后行为与 msext 等价。
## 二进制来源 ## 二进制来源
| 项 | 值 | | 项 | 值 |
|---|---| |---|---|
| 官方下载页 | <https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=215840645315192a89cc59f0f9b4a1ccff0fed81&lang=zh_CN> | | 来源 | 直接从 daoqi/msext/Class/SDKExport/ 拷贝(与现网 msext 同版本) |
| 推荐版本 | OpenSDK **2.0.5** 或更新(避免 1.x 的 ITMS-90809 历史包袱;新外壳不上 App Store 仍建议用 2.x,与 msext 行为差异最小) | | 版本 | 1.8.2 |
| 形态 | `OpenSDK*_NoPay.zip`(不含支付能力,符合本项目需求 | | 形态 | fat 静态库 `.a` + 头文件(无 Swift module,需 Bridging Header |
| 解压产物 | `WechatOpenSDK.xcframework`(含 ios-arm64 + ios-arm64_x86_64-simulator slice | | 架构 | i386 + armv7 + armv7s + x86_64 + arm64**不含 ios-arm64-simulator** |
| 模块名 | `WechatOpenSDK``import WechatOpenSDK` / `#import <WechatOpenSDK/WXApi.h>` |
## 放置路径 ## 文件结构
``` ```
ylgamehall/ Vendor/WechatSDK/
├── Vendor/ ├── README.md ← 本文件
│ └── WechatSDK/ └── v1.8.2/
├── README.md ← 本文件 ├── README.txt ← Tencent 官方版本历史
│ └── WechatOpenSDK.xcframework/ ← 用户从官方下载后放这里 ├── WXApi.h ← 主 APIregisterApp/sendAuthReq/sendReq/handleOpenURL
├── WXApiObject.h ← 数据对象(SendAuthReq/SendMessageToWXReq/WXMediaMessage 等)
├── WechatAuthSDK.h ← 扫码授权扩展(项目未用)
└── libWeChatSDK.a ← fat 静态库
``` ```
## Xcode 接入 ## Xcode 接入步骤(用户在 Xcode 手动)
`docs/SDK-Integration-Guide.md §A.1`。要点: 1. **删除当前 xcframework 引用**Project Navigator → 选中 ylgamehall target → General →
Frameworks, Libraries, and Embedded Content → 选中 `WechatOpenSDK-NoPay.xcframework`
`-` 删除(文件本身已在上次 commit 从 git 移除)
2. **加 `.a` 静态库**:同位置点 `+` → Add Other → Add Files → 选
`Vendor/WechatSDK/v1.8.2/libWeChatSDK.a`**Do Not Embed**(静态库不能 embed
3. **加 4 个微信 1.x 依赖的系统库**(同位置点 `+` 搜索):
- **libz.tbd**
- **libsqlite3.tbd**(旧的 `libsqlite3.0.tbd` 也可)
- **Security.framework**
- **CFNetwork.framework**
全部 Do Not Embed
4. **配置 Build Settings**
- **Header Search Paths**:加 `$(PROJECT_DIR)/Vendor/WechatSDK/v1.8.2`recursive 不必要)
- **Objective-C Bridging Header**:设为 `ylgamehall/ylgamehall-Bridging-Header.h`
5. **确认 Info.plist 已配**(之前 SDK 2.0.5 时已加,沿用即可):
- `CFBundleURLTypes``wx586a9b321e56efb7`
- `LSApplicationQueriesSchemes``weixin` / `weixinULAPI` / `weixinURLParamsAPI`
6. Clean Build Folder + ⌘B
- Target → General → Frameworks, Libraries, and Embedded Content → `+` → Add Files → 选 `Vendor/WechatSDK/WechatOpenSDK.xcframework` ## 已知限制:M Mac 模拟器无法链接
- **Embed 选 `Embed & Sign`**xcframework 是动态库,与 AMap 静态 `.framework``Do Not Embed` 不同)
fat 库不含 `ios-arm64-simulator` slice,M 芯片 Mac 模拟器链接会报与 AMap 相同的
arch 冲突错。**接受现状,开发期跑真机**(与 AMap 同款决策,详见
`Vendor/AMap/README.md` 「已知限制」)。
## 凭证 ## 凭证
AppID + AppSecret + AuthScope + AuthState 沿用 msext,参 `docs/SDK-Integration-Guide.md §0` AppID + AppSecret + AuthScope 沿用 msext,参 `docs/SDK-Integration-Guide.md §0`
@@ -1,44 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>AvailableLibraries</key>
<array>
<dict>
<key>BinaryPath</key>
<string>WechatOpenSDK.framework/WechatOpenSDK</string>
<key>LibraryIdentifier</key>
<string>ios-arm64</string>
<key>LibraryPath</key>
<string>WechatOpenSDK.framework</string>
<key>SupportedArchitectures</key>
<array>
<string>arm64</string>
</array>
<key>SupportedPlatform</key>
<string>ios</string>
</dict>
<dict>
<key>BinaryPath</key>
<string>WechatOpenSDK.framework/WechatOpenSDK</string>
<key>LibraryIdentifier</key>
<string>ios-arm64_x86_64-simulator</string>
<key>LibraryPath</key>
<string>WechatOpenSDK.framework</string>
<key>SupportedArchitectures</key>
<array>
<string>arm64</string>
<string>x86_64</string>
</array>
<key>SupportedPlatform</key>
<string>ios</string>
<key>SupportedPlatformVariant</key>
<string>simulator</string>
</dict>
</array>
<key>CFBundlePackageType</key>
<string>XFWK</string>
<key>XCFrameworkFormatVersion</key>
<string>1.0</string>
</dict>
</plist>
@@ -1,17 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSPrivacyAccessedAPITypes</key>
<array>
<dict>
<key>NSPrivacyAccessedAPIType</key>
<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
<key>NSPrivacyAccessedAPITypeReasons</key>
<array>
<string>CA92.1</string>
</array>
</dict>
</array>
</dict>
</plist>
@@ -1,231 +0,0 @@
//
// WXApi.h
// 所有Api接口
//
// Created by Wechat on 12-2-28.
// Copyright (c) 2012年 Tencent. All rights reserved.
//
#import <Foundation/Foundation.h>
#import "WXApiObject.h"
NS_ASSUME_NONNULL_BEGIN
typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
#pragma mark - WXApiDelegate
/*! @brief 接收并处理来自微信终端程序的事件消息
*
* 接收并处理来自微信终端程序的事件消息,期间微信界面会切换到第三方应用程序。
* WXApiDelegate 会在handleOpenURL:delegate:中使用并触发。
*/
@protocol WXApiDelegate <NSObject>
@optional
/*! @brief 收到一个来自微信的请求,第三方应用程序处理完后调用sendResp向微信发送结果
*
* 收到一个来自微信的请求,异步处理完成后必须调用sendResp发送处理结果给微信。
* 可能收到的请求有GetMessageFromWXReq、ShowMessageFromWXReq等。
* @param req 具体请求内容,是自动释放的
*/
- (void)onReq:(BaseReq*)req;
/*! @brief 发送一个sendReq后,收到微信的回应
*
* 收到一个来自微信的处理结果。调用一次sendReq后会收到onResp。
* 可能收到的处理结果有SendMessageToWXResp、SendAuthResp等。
* @param resp具体的回应内容,是自动释放的
*/
- (void)onResp:(BaseResp*)resp;
/* ! @brief 用于在iOS16以及以上系统上,控制OpenSDK是否读取剪切板中微信传递的数据以及读取的时机
* 在iOS16以及以上系统,在SDK需要读取剪切板中微信写入的数据时,会回调该方法。没有实现默认会直接读取微信通过剪切板传递过来的数据
* 注意:
* 1. 只在iOS16以及以上的系统版本上回调;
* 2. 不实现时,OpenSDK会直接调用读取剪切板接口,读取微信传递过来的数据;
* 3. 若实现该方法:开发者需要通过调用completion(), 支持异步,通知SDK允许读取剪切板中微信传递的数据,
* 不调用completion()则代表不授权OpenSDK读取剪切板,会导致收不到onReq:, onResp:回调,无法后续业务流程。请谨慎使用
* 4. 不要长时间持有completion不释放,可能会导致内存泄漏。
*/
- (void)onNeedGrantReadPasteBoardPermissionWithURL:(nonnull NSURL *)openURL completion:(nonnull WXGrantReadPasteBoardPermissionCompletion)completion;
@end
#pragma mark - WXApiLogDelegate
@protocol WXApiLogDelegate <NSObject>
- (void)onLog:(NSString*)log logLevel:(WXLogLevel)level;
@end
#pragma mark - WXApi
/*! @brief 微信Api接口函数类
*
* 该类封装了微信终端SDK的所有接口
*/
@interface WXApi : NSObject
/*! @brief WXApi的成员函数,向微信终端程序注册第三方应用。
*
* 需要在每次启动第三方应用程序时调用。
* @attention 请保证在主线程中调用此函数
* @param appid 微信开发者ID
* @param universalLink 微信开发者Universal Link
* @return 成功返回YES,失败返回NO。
*/
+ (BOOL)registerApp:(NSString *)appid universalLink:(NSString *)universalLink;
/*! @brief 处理旧版微信通过URL启动App时传递的数据
*
* 需要在 application:openURL:sourceApplication:annotation:或者application:handleOpenURL中调用。
* @param url 微信启动第三方应用时传递过来的URL
* @param delegate WXApiDelegate对象,用来接收微信触发的消息。
* @return 成功返回YES,失败返回NO。
*/
+ (BOOL)handleOpenURL:(NSURL *)url delegate:(nullable id<WXApiDelegate>)delegate;
/*! @brief 处理微信通过Universal Link启动App时传递的数据
*
* 需要在 application:continueUserActivity:restorationHandler:中调用。
* @param userActivity 微信启动第三方应用时系统API传递过来的userActivity
* @param delegate WXApiDelegate对象,用来接收微信触发的消息。
* @return 成功返回YES,失败返回NO。
*/
+ (BOOL)handleOpenUniversalLink:(NSUserActivity *)userActivity delegate:(nullable id<WXApiDelegate>)delegate;
/*! @brief 检查微信是否已被用户安装
*
* @return 微信已安装返回YES,未安装返回NO。
*/
+ (BOOL)isWXAppInstalled;
/*! @brief 判断当前微信的版本是否支持OpenApi
*
* @return 支持返回YES,不支持返回NO。
*/
+ (BOOL)isWXAppSupportApi;
/*! @brief 判断当前微信的版本是否支持分享微信状态功能
*
* @attention 需在工程LSApplicationQueriesSchemes配置中添加weixinStateAPI
* @return 支持返回YES,不支持返回NO。
*/
+ (BOOL)isWXAppSupportStateAPI;
#ifndef BUILD_WITHOUT_PAY
/*! @brief 判断当前微信的版本是否支持二维码拉起微信支付
*
* @attention 需在工程LSApplicationQueriesSchemes配置中添加weixinQRCodePayAPI
* @return 支持返回YES,不支持返回NO。
*/
+ (BOOL)isWXAppSupportQRCodePayAPI;
#endif
/*! @brief 获取微信的itunes安装地址
*
* @return 微信的安装地址字符串。
*/
+ (NSString *)getWXAppInstallUrl;
/*! @brief 获取当前微信SDK的版本号
*
* @return 返回当前微信SDK的版本号
*/
+ (NSString *)getApiVersion;
/*! @brief 打开微信
*
* @return 成功返回YES,失败返回NO。
*/
+ (BOOL)openWXApp;
/*! @brief 发送请求到微信,等待微信返回onResp
*
* 函数调用后,会切换到微信的界面。第三方应用程序等待微信返回onResp。微信在异步处理完成后一定会调用onResp。支持以下类型
* SendAuthReq、SendMessageToWXReq、PayReq等。
* @param req 具体的发送请求。
* @param completion 调用结果回调block
*/
+ (void)sendReq:(BaseReq *)req completion:(void (^ __nullable)(BOOL success))completion;
/*! @brief 收到微信onReq的请求,发送对应的应答给微信,并切换到微信界面
*
* 函数调用后,会切换到微信的界面。第三方应用程序收到微信onReq的请求,异步处理该请求,完成后必须调用该函数。可能发送的相应有
* GetMessageFromWXResp、ShowMessageFromWXResp等。
* @param resp 具体的应答内容
* @param completion 调用结果回调block
*/
+ (void)sendResp:(BaseResp*)resp completion:(void (^ __nullable)(BOOL success))completion;
/*! @brief 发送Auth请求到微信,支持用户没安装微信,等待微信返回onResp
*
* 函数调用后,会切换到微信的界面。第三方应用程序等待微信返回onResp。微信在异步处理完成后一定会调用onResp。支持SendAuthReq类型。
* @param req 具体的发送请求。
* @param viewController 当前界面对象。
* @param delegate WXApiDelegate对象,用来接收微信触发的消息。
* @param completion 调用结果回调block
*/
+ (void)sendAuthReq:(SendAuthReq *)req viewController:(UIViewController*)viewController delegate:(nullable id<WXApiDelegate>)delegate completion:(void (^ __nullable)(BOOL success))completion;
/*! @brief 测试函数,用于排查当前App通过Universal Link方式分享到微信的流程
注意1: 调用自检函数之前必须要先调用registerApp:universalLink接口, 并确认调用成功
注意2: 自检过程中会有Log产生,可以先调用startLogByLevel函数,根据Log排查问题
注意3: 会多次回调block
注意4: 仅用于新接入SDK时调试使用,请勿在正式环境的调用
*
* 当completion回调的step为WXULCheckStepFinal时,表示检测通过,Universal Link接入成功
* @param completion 回调Block
*/
+ (void)checkUniversalLinkReady:(nonnull WXCheckULCompletion)completion;
/*! @brief WXApi的成员函数,接受微信的log信息。byBlock
注意1:SDK会强引用这个block,注意不要导致内存泄漏,注意不要导致内存泄漏
注意2:调用过一次startLog by block之后,如果再调用一次任意方式的startLoad,会释放上一次logBlock,不再回调上一个logBlock
*
* @param level 打印log的级别
* @param logBlock 打印log的回调block
*/
+ (void)startLogByLevel:(WXLogLevel)level logBlock:(WXLogBolock)logBlock;
/*! @brief WXApi的成员函数,接受微信的log信息。byDelegate
注意1:sdk会弱引用这个delegate,这里可加任意对象为代理,不需要与WXApiDelegate同一个对象
注意2:调用过一次startLog by delegate之后,再调用一次任意方式的startLoad,不会再回调上一个logDelegate对象
* @param level 打印log的级别
* @param logDelegate 打印log的回调代理,
*/
+ (void)startLogByLevel:(WXLogLevel)level logDelegate:(id<WXApiLogDelegate>)logDelegate;
/*! @brief 停止打印log,会清理block或者delegate为空,释放block
* @param
*/
+ (void)stopLog;
@end
NS_ASSUME_NONNULL_END
@@ -1,9 +0,0 @@
// WechatOpenSDK.h
//
// Created by Wechat.
// Copyright (c) 2012年 Tencent. All rights reserved.
//
#import <WechatOpenSDK/WXApi.h>
#import <WechatOpenSDK/WXApiObject.h>
#import <WechatOpenSDK/WechatAuthSDK.h>
@@ -1,15 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
<key>CFBundleIdentifier</key>
<string>com.tencent.WechatOpenSDK</string>
<key>CFBundleVersion</key>
<string>1.0.0</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>MinimumOSVersion</key>
<string>12.0</string>
<key>CFBundleExecutable</key>
<string>WechatOpenSDK</string>
</dict>
</plist>
@@ -1,5 +0,0 @@
framework module WechatOpenSDK {
umbrella header "WechatOpenSDK.h"
export *
link "WechatOpenSDK"
}
@@ -1,68 +0,0 @@
//
// WechatAuthSDK.h
// WechatAuthSDK
//
// Created by 李凯 on 13-11-29.
// Copyright (c) 2013年 Tencent. All rights reserved.
//
#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
NS_ASSUME_NONNULL_BEGIN
enum AuthErrCode {
WechatAuth_Err_Ok = 0, //Auth成功
WechatAuth_Err_NormalErr = -1, //普通错误
WechatAuth_Err_NetworkErr = -2, //网络错误
WechatAuth_Err_GetQrcodeFailed = -3, //获取二维码失败
WechatAuth_Err_Cancel = -4, //用户取消授权
WechatAuth_Err_Timeout = -5, //超时
};
@protocol WechatAuthAPIDelegate<NSObject>
@optional
- (void)onAuthGotQrcode:(UIImage *)image; //得到二维码
- (void)onQrcodeScanned; //二维码被扫描
- (void)onAuthFinish:(int)errCode AuthCode:(nullable NSString *)authCode; //成功登录
@end
@interface WechatAuthSDK : NSObject{
NSString *_sdkVersion;
__weak id<WechatAuthAPIDelegate> _delegate;
}
@property(nonatomic, weak, nullable) id<WechatAuthAPIDelegate> delegate;
@property(nonatomic, readonly) NSString *sdkVersion; //authSDK版本号
/*! @brief 发送登录请求,等待WechatAuthAPIDelegate回调
*
* @param appId 微信开发者ID
* @param nonceStr 一个随机的尽量不重复的字符串,用来使得每次的signature不同
* @param timeStamp 时间戳
* @param scope 应用授权作用域,拥有多个作用域用逗号(,)分隔
* @param signature 签名
* @param schemeData 会在扫码后拼在scheme后
* @return 成功返回YES,失败返回NO
注:该实现只保证同时只有一个Auth在运行,Auth未完成或未Stop再次调用Auth接口时会返回NO。
*/
- (BOOL)Auth:(NSString *)appId
nonceStr:(NSString *)nonceStr
timeStamp:(NSString *)timeStamp
scope:(NSString *)scope
signature:(NSString *)signature
schemeData:(nullable NSString *)schemeData;
/*! @brief 暂停登录请求
*
* @return 成功返回YES,失败返回NO。
*/
- (BOOL)StopAuth;
@end
NS_ASSUME_NONNULL_END
@@ -1,9 +0,0 @@
// WechatOpenSDK.h
//
// Created by Wechat.
// Copyright (c) 2012年 Tencent. All rights reserved.
//
#import <WechatOpenSDK/WXApi.h>
#import <WechatOpenSDK/WXApiObject.h>
#import <WechatOpenSDK/WechatAuthSDK.h>
@@ -1,15 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
<key>CFBundleIdentifier</key>
<string>com.tencent.WechatOpenSDK</string>
<key>CFBundleVersion</key>
<string>1.0.0</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>MinimumOSVersion</key>
<string>12.0</string>
<key>CFBundleExecutable</key>
<string>WechatOpenSDK</string>
</dict>
</plist>
@@ -1,5 +0,0 @@
framework module WechatOpenSDK {
umbrella header "WechatOpenSDK.h"
export *
link "WechatOpenSDK"
}
@@ -1,82 +1,4 @@
重要! 重要!
SDK2.0.5
1. 支持模块化集成​:XCFramework 头文件引用改为标准化格式 #import <WechatOpenSDK/WXApi.h>,解决路径冲突并支持 Swift/ObjC 混合开发
2. 修复openWXApp偶现失败的问题
SDK2.0.4
1.增加privacy manifest文件
2.修复跳微信时可能卡顿的问题
SDK2.0.2
1. 优化XCFramework打包方式
SDK2.0.1
1. SDK支持XCFramework
SDK2.0.0
1. 分享能力支持内容防篡改校验
SDK1.9.9
1. 授权登录支持关闭自动授权
2. 分享支持添加签名,防止篡改
SDK1.9.7
1. 适配CocoaPods
SDK1.9.6
1. 适配iOS 16,减少读写剪切板
SDK1.9.4
1. 修复授权登录取消/拒绝时state字段没有带回
SDK1.9.3
1. 新增发起二维码支付能力
SDK1.9.2
1. 新增发起企微客服会话能力
SDK1.9.1
1. 音乐视频分享类型增加运营H5字段
SDK1.8.9
1. 增加音乐视频分享类型
SDK1.8.8
1. 增加游戏直播消息类型
SDK1.8.7.1
1. 修复Xcode11以下编译不通过
SDK1.8.7
1. 修复iPadOS,未安装微信的情况下,因为UA问题无法授权登录
2. 修复未安装微信的情况下, 适配了UIScene的App因为UIAlertView Crash
3. 增加Universal Link检测函数
SDK1.8.6.2
1. 修改包含"UIWebView"字符的类名
SDK1.8.6.1
1.短信授权登录使用的UIWebview切换成WKWebview
SDK1.8.6
1. 支持Universal Link拉起微信以及返回App
2. SDK移除MTA库
SDK1.8.5
1. 更换MTA库:取消对剪切板的访问, 防止和其他SDK竞争导致crash
2. NSMutableArray的MTA分类方法改名,减少命名冲突
3. 不含支付功能版本移除非税支付和医保支付接口
4. 分享音乐支持填写歌词和高清封面图
SDK1.8.4
1. 调整分享图片大小限制
2. 新增openBusinessView接口
SDK1.8.3
1. SDK增加调起微信刷卡支付接口
2. SDK增加小程序订阅消息接口
3. 修复小程序订阅消息接口没有resp的问题
SDK1.8.2 SDK1.8.2
1. SDK增加开发票授权 WXInvoiceAuthInsert 1. SDK增加开发票授权 WXInvoiceAuthInsert
2. SDK增加非税接口 WXNontaxPay 2. SDK增加非税接口 WXNontaxPay
@@ -9,11 +9,6 @@
#import <Foundation/Foundation.h> #import <Foundation/Foundation.h>
#import "WXApiObject.h" #import "WXApiObject.h"
NS_ASSUME_NONNULL_BEGIN
typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
#pragma mark - WXApiDelegate #pragma mark - WXApiDelegate
/*! @brief 接收并处理来自微信终端程序的事件消息 /*! @brief 接收并处理来自微信终端程序的事件消息
@@ -30,7 +25,7 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
* GetMessageFromWXReqShowMessageFromWXReq等 * GetMessageFromWXReqShowMessageFromWXReq等
* @param req * @param req
*/ */
- (void)onReq:(BaseReq*)req; -(void) onReq:(BaseReq*)req;
@@ -40,18 +35,7 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
* SendMessageToWXRespSendAuthResp等 * SendMessageToWXRespSendAuthResp等
* @param resp具体的回应内容 * @param resp具体的回应内容
*/ */
- (void)onResp:(BaseResp*)resp; -(void) onResp:(BaseResp*)resp;
/* ! @brief 用于在iOS16以及以上系统上,控制OpenSDK是否读取剪切板中微信传递的数据以及读取的时机
* iOS16以及以上系统SDK需要读取剪切板中微信写入的数据时
*
* 1. iOS16以及以上的系统版本上回调;
* 2. OpenSDK会直接调用读取剪切板接口;
* 3. completion(), SDK允许读取剪切板中微信传递的数据,
* completion()OpenSDK读取剪切板onReq:, onResp:使
* 4. completion不释放
*/
- (void)onNeedGrantReadPasteBoardPermissionWithURL:(nonnull NSURL *)openURL completion:(nonnull WXGrantReadPasteBoardPermissionCompletion)completion;
@end @end
@@ -59,11 +43,10 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
@protocol WXApiLogDelegate <NSObject> @protocol WXApiLogDelegate <NSObject>
- (void)onLog:(NSString*)log logLevel:(WXLogLevel)level; -(void) onLog:(NSString*)log logLevel:(WXLogLevel)level;
@end @end
#pragma mark - WXApi #pragma mark - WXApi
/*! @brief 微信Api接口函数类 /*! @brief 微信Api接口函数类
@@ -74,40 +57,53 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
/*! @brief WXApi的成员函数,向微信终端程序注册第三方应用。 /*! @brief WXApi的成员函数,向微信终端程序注册第三方应用。
* *
* * MTA数据上报
* iOS7及以上系统需要调起一次微信才会出现在微信的可用应用列表中
* @attention 线 * @attention 线
* @param appid ID * @param appid ID
* @param universalLink Universal Link * @param typeFlag
* @return YESNO * @return YESNO
*/ */
+ (BOOL)registerApp:(NSString *)appid universalLink:(NSString *)universalLink; +(BOOL) registerApp:(NSString *)appid;
/*! @brief WXApi的成员函数,向微信终端程序注册第三方应用。
*
*
* iOS7及以上系统需要调起一次微信才会出现在微信的可用应用列表中
* @attention 线
* @param appid ID
* @param isEnableMTA MTA数据上报
* @return YESNO
*/
+(BOOL) registerApp:(NSString *)appid enableMTA:(BOOL)isEnableMTA;
/*! @brief 处理旧版微信通过URL启动App时传递的数据 /*! @brief WXApi的成员函数,向微信终端程序注册应用支持打开的文件类型。
*
*
* @see registerApp
* @param typeFlag , enAppSupportContentFlag枚举类型 |
*/
+(void) registerAppSupportContentFlag:(UInt64)typeFlag;
/*! @brief 处理微信通过URL启动App时传递的数据
* *
* application:openURL:sourceApplication:annotation:application:handleOpenURL中调用 * application:openURL:sourceApplication:annotation:application:handleOpenURL中调用
* @param url URL * @param url URL
* @param delegate WXApiDelegate对象 * @param delegate WXApiDelegate对象
* @return YESNO * @return YESNO
*/ */
+ (BOOL)handleOpenURL:(NSURL *)url delegate:(nullable id<WXApiDelegate>)delegate; +(BOOL) handleOpenURL:(NSURL *) url delegate:(id<WXApiDelegate>) delegate;
/*! @brief 处理微信通过Universal Link启动App时传递的数据
*
* application:continueUserActivity:restorationHandler:
* @param userActivity API传递过来的userActivity
* @param delegate WXApiDelegate对象
* @return YESNO
*/
+ (BOOL)handleOpenUniversalLink:(NSUserActivity *)userActivity delegate:(nullable id<WXApiDelegate>)delegate;
/*! @brief 检查微信是否已被用户安装 /*! @brief 检查微信是否已被用户安装
* *
* @return YESNO * @return YESNO
*/ */
+ (BOOL)isWXAppInstalled; +(BOOL) isWXAppInstalled;
@@ -115,33 +111,15 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
* *
* @return YESNO * @return YESNO
*/ */
+ (BOOL)isWXAppSupportApi; +(BOOL) isWXAppSupportApi;
/*! @brief 判断当前微信的版本是否支持分享微信状态功能
*
* @attention LSApplicationQueriesSchemes配置中添加weixinStateAPI
* @return YESNO
*/
+ (BOOL)isWXAppSupportStateAPI;
#ifndef BUILD_WITHOUT_PAY
/*! @brief 判断当前微信的版本是否支持二维码拉起微信支付
*
* @attention LSApplicationQueriesSchemes配置中添加weixinQRCodePayAPI
* @return YESNO
*/
+ (BOOL)isWXAppSupportQRCodePayAPI;
#endif
/*! @brief 获取微信的itunes安装地址 /*! @brief 获取微信的itunes安装地址
* *
* @return * @return
*/ */
+ (NSString *)getWXAppInstallUrl; +(NSString *) getWXAppInstallUrl;
@@ -149,7 +127,7 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
* *
* @return SDK的版本号 * @return SDK的版本号
*/ */
+ (NSString *)getApiVersion; +(NSString *) getApiVersion;
@@ -157,7 +135,7 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
* *
* @return YESNO * @return YESNO
*/ */
+ (BOOL)openWXApp; +(BOOL) openWXApp;
@@ -165,42 +143,30 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
* *
* onResponResp * onResponResp
* SendAuthReqSendMessageToWXReqPayReq等 * SendAuthReqSendMessageToWXReqPayReq等
* @param req * @param req
* @param completion block * @return YESNO
*/ */
+ (void)sendReq:(BaseReq *)req completion:(void (^ __nullable)(BOOL success))completion; +(BOOL) sendReq:(BaseReq*)req;
/*! @brief 发送Auth请求到微信,支持用户没安装微信,等待微信返回onResp
*
* onResponRespSendAuthReq类型
* @param req
* @param viewController
* @param delegate WXApiDelegate对象
* @return YESNO
*/
+(BOOL) sendAuthReq:(SendAuthReq*)req viewController:(UIViewController*)viewController delegate:(id<WXApiDelegate>)delegate;
/*! @brief 收到微信onReq的请求,发送对应的应答给微信,并切换到微信界面 /*! @brief 收到微信onReq的请求,发送对应的应答给微信,并切换到微信界面
* *
* onReq的请求 * onReq的请求
* GetMessageFromWXRespShowMessageFromWXResp等 * GetMessageFromWXRespShowMessageFromWXResp等
* @param resp * @param resp
* @param completion block * @return YESNO
*/ */
+ (void)sendResp:(BaseResp*)resp completion:(void (^ __nullable)(BOOL success))completion; +(BOOL) sendResp:(BaseResp*)resp;
/*! @brief 发送Auth请求到微信,支持用户没安装微信,等待微信返回onResp
*
* onResponRespSendAuthReq类型
* @param req
* @param viewController
* @param delegate WXApiDelegate对象
* @param completion block
*/
+ (void)sendAuthReq:(SendAuthReq *)req viewController:(UIViewController*)viewController delegate:(nullable id<WXApiDelegate>)delegate completion:(void (^ __nullable)(BOOL success))completion;
/*! @brief 测试函数,用于排查当前App通过Universal Link方式分享到微信的流程
1: registerApp:universalLink接口,
2: Log产生startLogByLevel函数Log排查问题
3: block
4: SDK时调试使用
*
* completion回调的step为WXULCheckStepFinal时Universal Link接入成功
* @param completion Block
*/
+ (void)checkUniversalLinkReady:(nonnull WXCheckULCompletion)completion;
/*! @brief WXApi的成员函数,接受微信的log信息。byBlock /*! @brief WXApi的成员函数,接受微信的log信息。byBlock
@@ -210,8 +176,7 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
* @param level log的级别 * @param level log的级别
* @param logBlock log的回调block * @param logBlock log的回调block
*/ */
+(void) startLogByLevel:(WXLogLevel)level logBlock:(WXLogBolock)logBlock;
+ (void)startLogByLevel:(WXLogLevel)level logBlock:(WXLogBolock)logBlock;
/*! @brief WXApi的成员函数,接受微信的log信息。byDelegate /*! @brief WXApi的成员函数,接受微信的log信息。byDelegate
1:sdk会弱引用这个delegateWXApiDelegate同一个对象 1:sdk会弱引用这个delegateWXApiDelegate同一个对象
@@ -225,7 +190,4 @@ typedef BOOL(^WXGrantReadPasteBoardPermissionCompletion)(void);
* @param * @param
*/ */
+ (void)stopLog; + (void)stopLog;
@end @end
NS_ASSUME_NONNULL_END
+914
View File
@@ -0,0 +1,914 @@
//
// MMApiObject.h
// Api对象,包含所有接口和对象数据定义
//
// Created by Wechat on 12-2-28.
// Copyright (c) 2012年 Tencent. All rights reserved.
//
#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
/*! @brief 错误码
*
*/
enum WXErrCode {
WXSuccess = 0, /**< 成功 */
WXErrCodeCommon = -1, /**< 普通错误类型 */
WXErrCodeUserCancel = -2, /**< 用户点击取消并返回 */
WXErrCodeSentFail = -3, /**< 发送失败 */
WXErrCodeAuthDeny = -4, /**< 授权失败 */
WXErrCodeUnsupport = -5, /**< 微信不支持 */
};
/*! @brief 请求发送场景
*
*/
enum WXScene {
WXSceneSession = 0, /**< 聊天界面 */
WXSceneTimeline = 1, /**< 朋友圈 */
WXSceneFavorite = 2, /**< 收藏 */
};
enum WXAPISupport {
WXAPISupportSession = 0,
};
/*! @brief 跳转profile类型
*
*/
enum WXBizProfileType{
WXBizProfileType_Normal = 0, //**< 普通公众号 */
WXBizProfileType_Device = 1, //**< 硬件公众号 */
};
/*! @brief 分享小程序类型
*
*/
typedef NS_ENUM(NSUInteger, WXMiniProgramType){
WXMiniProgramTypeRelease = 0, //**< 正式版 */
WXMiniProgramTypeTest = 1, //**< 开发版 */
WXMiniProgramTypePreview = 2, //**< 体验版 */
};
/*! @brief 跳转mp网页类型
*
*/
enum WXMPWebviewType {
WXMPWebviewType_Ad = 0, /**< 广告网页 **/
};
/*! @brief 应用支持接收微信的文件类型
*
*/
typedef NS_ENUM(UInt64, enAppSupportContentFlag)
{
MMAPP_SUPPORT_NOCONTENT = 0x0,
MMAPP_SUPPORT_TEXT = 0x1,
MMAPP_SUPPORT_PICTURE = 0x2,
MMAPP_SUPPORT_LOCATION = 0x4,
MMAPP_SUPPORT_VIDEO = 0x8,
MMAPP_SUPPORT_AUDIO = 0x10,
MMAPP_SUPPORT_WEBPAGE = 0x20,
// Suport File Type
MMAPP_SUPPORT_DOC = 0x40, // doc
MMAPP_SUPPORT_DOCX = 0x80, // docx
MMAPP_SUPPORT_PPT = 0x100, // ppt
MMAPP_SUPPORT_PPTX = 0x200, // pptx
MMAPP_SUPPORT_XLS = 0x400, // xls
MMAPP_SUPPORT_XLSX = 0x800, // xlsx
MMAPP_SUPPORT_PDF = 0x1000, // pdf
};
/*! @brief log的级别
*
*/
typedef NS_ENUM(NSInteger,WXLogLevel){
WXLogLevelNormal = 0, // 打印日常的日志
WXLogLevelDetail = 1, // 打印详细的日志
};
/*! @brief 打印回调的block
*
*/
typedef void(^WXLogBolock)(NSString * log);
#pragma mark - BaseReq
/*! @brief 该类为微信终端SDK所有请求类的基类
*
*/
@interface BaseReq : NSObject
/** 请求类型 */
@property (nonatomic, assign) int type;
/** 由用户微信号和AppID组成的唯一标识,发送请求时第三方程序必须填写,用于校验微信用户是否换号登录*/
@property (nonatomic, retain) NSString* openID;
@end
#pragma mark - BaseResp
/*! @brief 该类为微信终端SDK所有响应类的基类
*
*/
@interface BaseResp : NSObject
/** 错误码 */
@property (nonatomic, assign) int errCode;
/** 错误提示字符串 */
@property (nonatomic, retain) NSString *errStr;
/** 响应类型 */
@property (nonatomic, assign) int type;
@end
#pragma mark - WXMediaMessage
@class WXMediaMessage;
#pragma mark - SendAuthReq
/*! @brief 第三方程序向微信终端请求认证的消息结构
*
* 第三方程序要向微信申请认证,并请求某些权限,需要调用WXApi的sendReq成员函数,
* 向微信终端发送一个SendAuthReq消息结构。微信终端处理完后会向第三方程序发送一个处理结果。
* @see SendAuthResp
*/
@interface SendAuthReq : BaseReq
/** 第三方程序要向微信申请认证,并请求某些权限,需要调用WXApi的sendReq成员函数,向微信终端发送一个SendAuthReq消息结构。微信终端处理完后会向第三方程序发送一个处理结果。
* @see SendAuthResp
* @note scope字符串长度不能超过1K
*/
@property (nonatomic, retain) NSString* scope;
/** 第三方程序本身用来标识其请求的唯一性,最后跳转回第三方程序时,由微信终端回传。
* @note state字符串长度不能超过1K
*/
@property (nonatomic, retain) NSString* state;
@end
#pragma mark - SendAuthResp
/*! @brief 微信处理完第三方程序的认证和权限申请后向第三方程序回送的处理结果。
*
* 第三方程序要向微信申请认证,并请求某些权限,需要调用WXApi的sendReq成员函数,向微信终端发送一个SendAuthReq消息结构。
* 微信终端处理完后会向第三方程序发送一个SendAuthResp。
* @see onResp
*/
@interface SendAuthResp : BaseResp
@property (nonatomic, retain) NSString* code;
/** 第三方程序发送时用来标识其请求的唯一性的标志,由第三方程序调用sendReq时传入,由微信终端回传
* @note state字符串长度不能超过1K
*/
@property (nonatomic, retain) NSString* state;
@property (nonatomic, retain) NSString* lang;
@property (nonatomic, retain) NSString* country;
@end
#pragma mark - SendMessageToWXReq
/*! @brief 第三方程序发送消息至微信终端程序的消息结构体
*
* 第三方程序向微信发送信息需要传入SendMessageToWXReq结构体,信息类型包括文本消息和多媒体消息,
* 分别对应于text和message成员。调用该方法后,微信处理完信息会向第三方程序发送一个处理结果。
* @see SendMessageToWXResp
*/
@interface SendMessageToWXReq : BaseReq
/** 发送消息的文本内容
* @note 文本长度必须大于0且小于10K
*/
@property (nonatomic, retain) NSString* text;
/** 发送消息的多媒体内容
* @see WXMediaMessage
*/
@property (nonatomic, retain) WXMediaMessage* message;
/** 发送消息的类型,包括文本消息和多媒体消息两种,两者只能选择其一,不能同时发送文本和多媒体消息 */
@property (nonatomic, assign) BOOL bText;
/** 发送的目标场景,可以选择发送到会话(WXSceneSession)或者朋友圈(WXSceneTimeline)。 默认发送到会话。
* @see WXScene
*/
@property (nonatomic, assign) int scene;
@end
#pragma mark - SendMessageToWXResp
/*! @brief 微信终端向第三方程序返回的SendMessageToWXReq处理结果。
*
* 第三方程序向微信终端发送SendMessageToWXReq后,微信发送回来的处理结果,该结果用SendMessageToWXResp表示。
*/
@interface SendMessageToWXResp : BaseResp
@property(nonatomic, retain) NSString* lang;
@property(nonatomic, retain) NSString* country;
@end
#pragma mark - GetMessageFromWXReq
/*! @brief 微信终端向第三方程序请求提供内容的消息结构体。
*
* 微信终端向第三方程序请求提供内容,微信终端会向第三方程序发送GetMessageFromWXReq消息结构体,
* 需要第三方程序调用sendResp返回一个GetMessageFromWXResp消息结构体。
*/
@interface GetMessageFromWXReq : BaseReq
@property (nonatomic, retain) NSString* lang;
@property (nonatomic, retain) NSString* country;
@end
#pragma mark - GetMessageFromWXResp
/*! @brief 微信终端向第三方程序请求提供内容,第三方程序向微信终端返回的消息结构体。
*
* 微信终端向第三方程序请求提供内容,第三方程序调用sendResp向微信终端返回一个GetMessageFromWXResp消息结构体。
*/
@interface GetMessageFromWXResp : BaseResp
/** 向微信终端提供的文本内容
@note 文本长度必须大于0且小于10K
*/
@property (nonatomic, retain) NSString* text;
/** 向微信终端提供的多媒体内容。
* @see WXMediaMessage
*/
@property (nonatomic, retain) WXMediaMessage* message;
/** 向微信终端提供内容的消息类型,包括文本消息和多媒体消息两种,两者只能选择其一,不能同时发送文本和多媒体消息 */
@property (nonatomic, assign) BOOL bText;
@end
#pragma mark - ShowMessageFromWXReq
/*! @brief 微信通知第三方程序,要求第三方程序显示的消息结构体。
*
* 微信需要通知第三方程序显示或处理某些内容时,会向第三方程序发送ShowMessageFromWXReq消息结构体。
* 第三方程序处理完内容后调用sendResp向微信终端发送ShowMessageFromWXResp。
*/
@interface ShowMessageFromWXReq : BaseReq
/** 微信终端向第三方程序发送的要求第三方程序处理的多媒体内容
* @see WXMediaMessage
*/
@property (nonatomic, retain) WXMediaMessage* message;
@property (nonatomic, retain) NSString* lang;
@property (nonatomic, retain) NSString* country;
@end
#pragma mark - ShowMessageFromWXResp
/*! @brief 微信通知第三方程序,要求第三方程序显示或处理某些消息,第三方程序处理完后向微信终端发送的处理结果。
*
* 微信需要通知第三方程序显示或处理某些内容时,会向第三方程序发送ShowMessageFromWXReq消息结构体。
* 第三方程序处理完内容后调用sendResp向微信终端发送ShowMessageFromWXResp。
*/
@interface ShowMessageFromWXResp : BaseResp
@end
#pragma mark - LaunchFromWXReq
/*! @brief 微信终端打开第三方程序携带的消息结构体
*
* 微信向第三方发送的结构体,第三方不需要返回
*/
@interface LaunchFromWXReq : BaseReq
@property (nonatomic, retain) WXMediaMessage* message;
@property (nonatomic, retain) NSString* lang;
@property (nonatomic, retain) NSString* country;
@end
#pragma mark - OpenTempSessionReq
/* ! @brief 第三方通知微信,打开临时会话
*
* 第三方通知微信,打开临时会话
*/
@interface OpenTempSessionReq : BaseReq
/** 需要打开的用户名
* @attention 长度不能超过512字节
*/
@property (nonatomic, retain) NSString* username;
/** 开发者自定义参数,拉起临时会话后会发给开发者后台,可以用于识别场景
* @attention 长度不能超过32位
*/
@property (nonatomic, retain) NSString* sessionFrom;
@end
#pragma mark - OpenTempSessionResp
/*! @brief 微信终端向第三方程序返回的OpenTempSessionReq处理结果。
*
* 第三方程序向微信终端发送OpenTempSessionReq后,微信发送回来的处理结果,该结果用OpenTempSessionResp表示。
*/
@interface OpenTempSessionResp : BaseResp
@end
#pragma mark - OpenWebviewReq
/* ! @brief 第三方通知微信启动内部浏览器,打开指定网页
*
* 第三方通知微信启动内部浏览器,打开指定Url对应的网页
*/
@interface OpenWebviewReq : BaseReq
/** 需要打开的网页对应的Url
* @attention 长度不能超过1024
*/
@property(nonatomic,retain)NSString* url;
@end
#pragma mark - OpenWebviewResp
/*! @brief 微信终端向第三方程序返回的OpenWebviewReq处理结果
*
* 第三方程序向微信终端发送OpenWebviewReq后,微信发送回来的处理结果,该结果用OpenWebviewResp表示
*/
@interface OpenWebviewResp : BaseResp
@end
#pragma mark - OpenRankListReq
/* ! @brief 第三方通知微信,打开硬件排行榜
*
* 第三方通知微信,打开硬件排行榜
*/
@interface OpenRankListReq : BaseReq
@end
#pragma mark - OpenRanklistResp
/*! @brief 微信终端向第三方程序返回的OpenRankListReq处理结果。
*
* 第三方程序向微信终端发送OpenRankListReq后,微信发送回来的处理结果,该结果用OpenRankListResp表示。
*/
@interface OpenRankListResp : BaseResp
@end
#pragma mark - JumpToBizProfileReq
/* ! @brief 第三方通知微信,打开指定微信号profile页面
*
* 第三方通知微信,打开指定微信号profile页面
*/
@interface JumpToBizProfileReq : BaseReq
/** 跳转到该公众号的profile
* @attention 长度不能超过512字节
*/
@property (nonatomic, retain) NSString* username;
/** 如果用户加了该公众号为好友,extMsg会上传到服务器
* @attention 长度不能超过1024字节
*/
@property (nonatomic, retain) NSString* extMsg;
/**
* 跳转的公众号类型
* @see WXBizProfileType
*/
@property (nonatomic, assign) int profileType;
@end
#pragma mark - JumpToBizWebviewReq
/* ! @brief 第三方通知微信,打开指定usrname的profile网页版
*
*/
@interface JumpToBizWebviewReq : BaseReq
/** 跳转的网页类型,目前只支持广告页
* @see WXMPWebviewType
*/
@property(nonatomic, assign) int webType;
/** 跳转到该公众号的profile网页版
* @attention 长度不能超过512字节
*/
@property(nonatomic, retain) NSString* tousrname;
/** 如果用户加了该公众号为好友,extMsg会上传到服务器
* @attention 长度不能超过1024字节
*/
@property(nonatomic, retain) NSString* extMsg;
@end
#pragma mark - WXCardItem
@interface WXCardItem : NSObject
/** 卡id
* @attention 长度不能超过1024字节
*/
@property (nonatomic,retain) NSString* cardId;
/** ext信息
* @attention 长度不能超过2024字节
*/
@property (nonatomic,retain) NSString* extMsg;
/**
* @attention 卡的状态,req不需要填。resp:0为未添加,1为已添加。
*/
@property (nonatomic,assign) UInt32 cardState;
/**
* @attention req不需要填,chooseCard返回的。
*/
@property (nonatomic,retain) NSString* encryptCode;
/**
* @attention req不需要填,chooseCard返回的。
*/
@property (nonatomic,retain) NSString* appID;
@end;
#pragma mark - WXInvoiceItem
@interface WXInvoiceItem : NSObject
/** 卡id
* @attention 长度不能超过1024字节
*/
@property (nonatomic,retain) NSString* cardId;
/** ext信息
* @attention 长度不能超过2024字节
*/
@property (nonatomic,retain) NSString* extMsg;
/**
* @attention 卡的状态,req不需要填。resp:0为未添加,1为已添加。
*/
@property (nonatomic,assign) UInt32 cardState;
/**
* @attention req不需要填,chooseCard返回的。
*/
@property (nonatomic,retain) NSString* encryptCode;
/**
* @attention req不需要填,chooseCard返回的。
*/
@property (nonatomic,retain) NSString* appID;
@end
#pragma mark - AddCardToWXCardPackageReq
/* ! @brief 请求添加卡券至微信卡包
*
*/
@interface AddCardToWXCardPackageReq : BaseReq
/** 卡列表
* @attention 个数不能超过40个 类型WXCardItem
*/
@property (nonatomic,retain) NSArray* cardAry;
@end
#pragma mark - AddCardToWXCardPackageResp
/** ! @brief 微信返回第三方添加卡券结果
*
*/
@interface AddCardToWXCardPackageResp : BaseResp
/** 卡列表
* @attention 个数不能超过40个 类型WXCardItem
*/
@property (nonatomic,retain) NSArray* cardAry;
@end
#pragma mark - WXChooseCardReq
/* ! @brief 请求从微信选取卡券
*
*/
@interface WXChooseCardReq : BaseReq
@property(nonatomic, strong) NSString *appID;
@property(nonatomic, assign) UInt32 shopID;
@property(nonatomic, assign) UInt32 canMultiSelect;
@property(nonatomic, strong) NSString *cardType;
@property(nonatomic, strong) NSString *cardTpID;
@property(nonatomic, strong) NSString *signType;
@property(nonatomic, strong) NSString *cardSign;
@property(nonatomic, assign) UInt32 timeStamp;
@property(nonatomic, strong) NSString *nonceStr;
@end
#pragma mark - WXChooseCardResp
/** ! @brief 微信返回第三方请求选择卡券结果
*
*/
@interface WXChooseCardResp : BaseResp
@property (nonatomic,retain) NSArray* cardAry;
@end
#pragma mark - WXChooseInvoiceReq
/* ! @brief 请求从微信选取发票
*
*/
@interface WXChooseInvoiceReq : BaseReq
@property (nonatomic, strong) NSString *appID;
@property (nonatomic, assign) UInt32 shopID;
@property (nonatomic, strong) NSString *signType;
@property (nonatomic, strong) NSString *cardSign;
@property (nonatomic, assign) UInt32 timeStamp;
@property (nonatomic, strong) NSString *nonceStr;
@end
#pragma mark - WXChooseInvoiceResp
/** ! @brief 微信返回第三方请求选择发票结果
*
*/
@interface WXChooseInvoiceResp : BaseResp
@property (nonatomic, strong) NSArray* cardAry;
@end
#pragma mark - WXSubscriptionReq
@interface WXSubscribeMsgReq : BaseReq
@property (nonatomic, assign) UInt32 scene;
@property (nonatomic, strong) NSString * templateId;
@property (nonatomic, strong) NSString * reserved;
@end
#pragma mark - WXSubscriptionReq
@interface WXSubscribeMsgResp : BaseResp
@property (nonatomic, strong) NSString *templateId;
@property (nonatomic, assign) UInt32 scene;
@property (nonatomic, strong) NSString *action;
@property (nonatomic, strong) NSString * reserved;
@property (nonatomic, strong) NSString * openId;
@end
#pragma mark - WXinvoiceAuthInsertReq
@interface WXInvoiceAuthInsertReq : BaseReq
@property (nonatomic, strong) NSString *urlString;
@end
#pragma mark - WXinvoiceAuthInsertResp
@interface WXInvoiceAuthInsertResp : BaseResp
@property (nonatomic, strong) NSString * wxOrderId;
@end
#pragma mark - WXNontaxPayReq
@interface WXNontaxPayReq:BaseReq
@property (nonatomic, strong) NSString *urlString;
@end
#pragma mark - WXNontaxPayResp
@interface WXNontaxPayResp : BaseResp
@property (nonatomic, strong) NSString *wxOrderId;
@end
#pragma mark - WXPayInsuranceReq
@interface WXPayInsuranceReq : BaseReq
@property (nonatomic, strong) NSString *urlString;
@end
#pragma mark - WXPayInsuranceResp
@interface WXPayInsuranceResp : BaseResp
@property (nonatomic, strong) NSString *wxOrderId;
@end
#pragma mark - WXMediaMessage
#pragma mark - WXMediaMessage
/*! @brief 多媒体消息结构体
*
* 用于微信终端和第三方程序之间传递消息的多媒体消息内容
*/
@interface WXMediaMessage : NSObject
+(WXMediaMessage *) message;
/** 标题
* @note 长度不能超过512字节
*/
@property (nonatomic, retain) NSString *title;
/** 描述内容
* @note 长度不能超过1K
*/
@property (nonatomic, retain) NSString *description;
/** 缩略图数据
* @note 大小不能超过32K
*/
@property (nonatomic, retain) NSData *thumbData;
/**
* @note 长度不能超过64字节
*/
@property (nonatomic, retain) NSString *mediaTagName;
/**
*
*/
@property (nonatomic, retain) NSString *messageExt;
@property (nonatomic, retain) NSString *messageAction;
/**
* 多媒体数据对象,可以为WXImageObjectWXMusicObjectWXVideoObjectWXWebpageObject等。
*/
@property (nonatomic, retain) id mediaObject;
/*! @brief 设置消息缩略图的方法
*
* @param image 缩略图
* @note 大小不能超过32K
*/
- (void) setThumbImage:(UIImage *)image;
@end
#pragma mark - WXImageObject
/*! @brief 多媒体消息中包含的图片数据对象
*
* 微信终端和第三方程序之间传递消息中包含的图片数据对象。
* @note imageData成员不能为空
* @see WXMediaMessage
*/
@interface WXImageObject : NSObject
/*! @brief 返回一个WXImageObject对象
*
* @note 返回的WXImageObject对象是自动释放的
*/
+(WXImageObject *) object;
/** 图片真实数据内容
* @note 大小不能超过10M
*/
@property (nonatomic, retain) NSData *imageData;
@end
#pragma mark - WXMusicObject
/*! @brief 多媒体消息中包含的音乐数据对象
*
* 微信终端和第三方程序之间传递消息中包含的音乐数据对象。
* @note musicUrl和musicLowBandUrl成员不能同时为空。
* @see WXMediaMessage
*/
@interface WXMusicObject : NSObject
/*! @brief 返回一个WXMusicObject对象
*
* @note 返回的WXMusicObject对象是自动释放的
*/
+(WXMusicObject *) object;
/** 音乐网页的url地址
* @note 长度不能超过10K
*/
@property (nonatomic, retain) NSString *musicUrl;
/** 音乐lowband网页的url地址
* @note 长度不能超过10K
*/
@property (nonatomic, retain) NSString *musicLowBandUrl;
/** 音乐数据url地址
* @note 长度不能超过10K
*/
@property (nonatomic, retain) NSString *musicDataUrl;
/**音乐lowband数据url地址
* @note 长度不能超过10K
*/
@property (nonatomic, retain) NSString *musicLowBandDataUrl;
@end
#pragma mark - WXVideoObject
/*! @brief 多媒体消息中包含的视频数据对象
*
* 微信终端和第三方程序之间传递消息中包含的视频数据对象。
* @note videoUrl和videoLowBandUrl不能同时为空。
* @see WXMediaMessage
*/
@interface WXVideoObject : NSObject
/*! @brief 返回一个WXVideoObject对象
*
* @note 返回的WXVideoObject对象是自动释放的
*/
+(WXVideoObject *) object;
/** 视频网页的url地址
* @note 长度不能超过10K
*/
@property (nonatomic, retain) NSString *videoUrl;
/** 视频lowband网页的url地址
* @note 长度不能超过10K
*/
@property (nonatomic, retain) NSString *videoLowBandUrl;
@end
#pragma mark - WXWebpageObject
/*! @brief 多媒体消息中包含的网页数据对象
*
* 微信终端和第三方程序之间传递消息中包含的网页数据对象。
* @see WXMediaMessage
*/
@interface WXWebpageObject : NSObject
/*! @brief 返回一个WXWebpageObject对象
*
* @note 返回的WXWebpageObject对象是自动释放的
*/
+(WXWebpageObject *) object;
/** 网页的url地址
* @note 不能为空且长度不能超过10K
*/
@property (nonatomic, retain) NSString *webpageUrl;
@end
#pragma mark - WXAppExtendObject
/*! @brief 多媒体消息中包含的App扩展数据对象
*
* 第三方程序向微信终端发送包含WXAppExtendObject的多媒体消息,
* 微信需要处理该消息时,会调用该第三方程序来处理多媒体消息内容。
* @note urlextInfo和fileData不能同时为空
* @see WXMediaMessage
*/
@interface WXAppExtendObject : NSObject
/*! @brief 返回一个WXAppExtendObject对象
*
* @note 返回的WXAppExtendObject对象是自动释放的
*/
+(WXAppExtendObject *) object;
/** 若第三方程序不存在,微信终端会打开该url所指的App下载地址
* @note 长度不能超过10K
*/
@property (nonatomic, retain) NSString *url;
/** 第三方程序自定义简单数据,微信终端会回传给第三方程序处理
* @note 长度不能超过2K
*/
@property (nonatomic, retain) NSString *extInfo;
/** App文件数据,该数据发送给微信好友,微信好友需要点击后下载数据,微信终端会回传给第三方程序处理
* @note 大小不能超过10M
*/
@property (nonatomic, retain) NSData *fileData;
@end
#pragma mark - WXEmoticonObject
/*! @brief 多媒体消息中包含的表情数据对象
*
* 微信终端和第三方程序之间传递消息中包含的表情数据对象。
* @see WXMediaMessage
*/
@interface WXEmoticonObject : NSObject
/*! @brief 返回一个WXEmoticonObject对象
*
* @note 返回的WXEmoticonObject对象是自动释放的
*/
+(WXEmoticonObject *) object;
/** 表情真实数据内容
* @note 大小不能超过10M
*/
@property (nonatomic, retain) NSData *emoticonData;
@end
#pragma mark - WXFileObject
/*! @brief 多媒体消息中包含的文件数据对象
*
* @see WXMediaMessage
*/
@interface WXFileObject : NSObject
/*! @brief 返回一个WXFileObject对象
*
* @note 返回的WXFileObject对象是自动释放的
*/
+(WXFileObject *) object;
/** 文件后缀名
* @note 长度不超过64字节
*/
@property (nonatomic, retain) NSString *fileExtension;
/** 文件真实数据内容
* @note 大小不能超过10M
*/
@property (nonatomic, retain) NSData *fileData;
@end
#pragma mark - WXLocationObject
/*! @brief 多媒体消息中包含的地理位置数据对象
*
* 微信终端和第三方程序之间传递消息中包含的地理位置数据对象。
* @see WXMediaMessage
*/
@interface WXLocationObject : NSObject
/*! @brief 返回一个WXLocationObject对象
*
* @note 返回的WXLocationObject对象是自动释放的
*/
+(WXLocationObject *) object;
/** 地理位置信息
* @note 经纬度
*/
@property (nonatomic, assign) double lng; //经度
@property (nonatomic, assign) double lat; //纬度
@end
@interface WXMiniProgramObject : NSObject
/*! @brief WXMiniProgramObject对象
*
* @note 返回的WXMiniProgramObject对象是自动释放的
*/
+(WXMiniProgramObject *) object;
@property (nonatomic, strong) NSString *webpageUrl; //低版本网页链接
@property (nonatomic, strong) NSString *userName; //小程序username
@property (nonatomic, strong) NSString *path; //小程序页面的路径
@property (nonatomic, strong) NSData *hdImageData; // 小程序新版本的预览图 128k
@property (nonatomic, assign) BOOL withShareTicket; //是否使用带 shareTicket 的转发
@property (nonatomic, assign) WXMiniProgramType miniProgramType; // 分享小程序的版本(正式,开发,体验)
@end
#pragma mark - WXLaunchMiniProgramReq
/*! @brief WXLaunchMiniProgramReq对象, 可实现通过sdk拉起微信小程序
*
* @note 返回的WXLaunchMiniProgramReq对象是自动释放的
*/
@interface WXLaunchMiniProgramReq : BaseReq
+(WXLaunchMiniProgramReq *) object;
@property (nonatomic, strong) NSString *userName; //拉起的小程序的username
@property (nonatomic, strong) NSString *path; //拉起小程序页面的路径,不填默认拉起小程序首页
@property (nonatomic, assign) WXMiniProgramType miniProgramType; //拉起小程序的类型
@end
#pragma mark - WXLaunchMiniProgramResp
/*! @brief 微信终端向第三方程序返回的WXLaunchMiniProgramReq处理结果。
*
* 第三方程序向微信终端发送WXLaunchMiniProgramReq后,微信发送回来的处理结果,该结果用WXLaunchMiniProgramResp表示。
*/
@interface WXLaunchMiniProgramResp : BaseResp
@property (nonatomic, retain) NSString *extMsg;
@end
#pragma mark - WXTextObject
/*! @brief 多媒体消息中包含的文本数据对象
*
* 微信终端和第三方程序之间传递消息中包含的文本数据对象。
* @see WXMediaMessage
*/
@interface WXTextObject : NSObject
/*! @brief 返回一个WXTextObject对象
*
* @note 返回的WXTextObject对象是自动释放的
*/
+(WXTextObject *) object;
/** 地理位置信息
* @note 文本内容
*/
@property (nonatomic, retain) NSString *contentText;
@end
@@ -9,8 +9,6 @@
#import <Foundation/Foundation.h> #import <Foundation/Foundation.h>
#import <UIKit/UIKit.h> #import <UIKit/UIKit.h>
NS_ASSUME_NONNULL_BEGIN
enum AuthErrCode { enum AuthErrCode {
WechatAuth_Err_Ok = 0, //Auth成功 WechatAuth_Err_Ok = 0, //Auth成功
WechatAuth_Err_NormalErr = -1, //普通错误 WechatAuth_Err_NormalErr = -1, //普通错误
@@ -25,7 +23,7 @@ enum AuthErrCode {
- (void)onAuthGotQrcode:(UIImage *)image; //得到二维码 - (void)onAuthGotQrcode:(UIImage *)image; //得到二维码
- (void)onQrcodeScanned; //二维码被扫描 - (void)onQrcodeScanned; //二维码被扫描
- (void)onAuthFinish:(int)errCode AuthCode:(nullable NSString *)authCode; //成功登录 - (void)onAuthFinish:(int)errCode AuthCode:(NSString *)authCode; //成功登录
@end @end
@@ -34,7 +32,7 @@ enum AuthErrCode {
__weak id<WechatAuthAPIDelegate> _delegate; __weak id<WechatAuthAPIDelegate> _delegate;
} }
@property(nonatomic, weak, nullable) id<WechatAuthAPIDelegate> delegate; @property(nonatomic, weak) id<WechatAuthAPIDelegate> delegate;
@property(nonatomic, readonly) NSString *sdkVersion; //authSDK版本号 @property(nonatomic, readonly) NSString *sdkVersion; //authSDK版本号
/*! @brief 发送登录请求,等待WechatAuthAPIDelegate回调 /*! @brief 发送登录请求,等待WechatAuthAPIDelegate回调
@@ -51,10 +49,10 @@ enum AuthErrCode {
- (BOOL)Auth:(NSString *)appId - (BOOL)Auth:(NSString *)appId
nonceStr:(NSString *)nonceStr nonceStr:(NSString *)nonceStr
timeStamp:(NSString *)timeStamp timeStamp:(NSString*)timeStamp
scope:(NSString *)scope scope:(NSString *)scope
signature:(NSString *)signature signature:(NSString *)signature
schemeData:(nullable NSString *)schemeData; schemeData:(NSString *)schemeData;
/*! @brief 暂停登录请求 /*! @brief 暂停登录请求
@@ -64,5 +62,3 @@ enum AuthErrCode {
- (BOOL)StopAuth; - (BOOL)StopAuth;
@end @end
NS_ASSUME_NONNULL_END
+15 -9
View File
@@ -18,17 +18,23 @@
> >
> 这 3 件事都是 Xcode UI 操作,无法 AI 自动完成。完成后 `BuildProject` 即激活所有真实路径。 > 这 3 件事都是 Xcode UI 操作,无法 AI 自动完成。完成后 `BuildProject` 即激活所有真实路径。
### A.1 添加微信 OpenSDKVendor 手动) ### A.1 添加微信 OpenSDK 1.8.2Vendor 手动,与 daoqi msext 同款
> Tencent 官方至今未维护 SPM 仓库(`Tencent/WechatOpenSDK-XCFramework` 不存在,404);社区 wrapperyanyin1986 / anotheren)非官方,被否决。改走 Vendor `.xcframework`,与 AMap 同款处置方式 > **改用 1.8.2 的原因**2.0.x 强制 Universal LinkHTTPS 域名 + AASA + 微信开放平台后台审核),运维负担大;daoqi msext 多年 1.8.2 上线稳定,沿用避免无谓改造。详见 `Vendor/WechatSDK/README.md`
>
> SDK 已入库 `Vendor/WechatSDK/v1.8.2/`4 个文件 + README,从 daoqi 同步),无需额外下载。
**预先准备**:从腾讯开放平台下载 `OpenSDK*_NoPay.zip`(推荐 2.0.5+),解压取出 `WechatOpenSDK.xcframework`,放到 `Vendor/WechatSDK/`。下载页与详细说明见 `Vendor/WechatSDK/README.md` 1. **删除(如有)2.0.5 xcframework**Target → General → Frameworks → 选 `WechatOpenSDK-NoPay.xcframework``-` 删除(文件已从 git 移除)
2. **加 libWeChatSDK.a**:点 `+` → Add Other → Add Files → 选 `Vendor/WechatSDK/v1.8.2/libWeChatSDK.a`**Do Not Embed**(静态库不能 embed
1. 选中 `ylgamehall` Target → General → Frameworks, Libraries, and Embedded Content 3. **加 4 个 1.x 依赖系统库**:同位置 `+` 搜索后逐个加(均 Do Not Embed):
2. 点 `+` → Add Other → Add Files - `libz.tbd`
3. 选 `Vendor/WechatSDK/WechatOpenSDK.xcframework` - `libsqlite3.tbd`
4. **Embed** 列选 **Embed & Sign**xcframework 是动态库,与下面 AMap 的 `Do Not Embed` 不同,别错) - `Security.framework`
5. ⌘B 编译 - `CFNetwork.framework`
4. **配置 Build Settings**
- Header Search Paths += `$(PROJECT_DIR)/Vendor/WechatSDK/v1.8.2`
- Objective-C Bridging Header = `ylgamehall/ylgamehall-Bridging-Header.h`
5. ⌘B 编译 — **target 必须选真机**或 Generic iOS Devicefat 库不含 ios-arm64-simulatorM Mac 模拟器链接会失败(与 AMap 同款已接受现状)
### A.2 添加高德定位 framework × 2Vendor 手动,无 SPM 替代) ### A.2 添加高德定位 framework × 2Vendor 手动,无 SPM 替代)
@@ -24,11 +24,8 @@ public enum AccreditLoginHandler {
print("[Bridge] accreditlogin H5 调用命中 ✅") print("[Bridge] accreditlogin H5 调用命中 ✅")
callback?(.string("Response from accreditlogin")) callback?(.string("Response from accreditlogin"))
#if canImport(WechatOpenSDK) // 7 callback sharelogin
print("[Bridge] accreditlogin → canImport(WechatOpenSDK)=true,启动 Task")
// SDK 7 callback sharelogin
Task { @MainActor in Task { @MainActor in
print("[Bridge] accreditlogin Task @MainActor 开始执行 WeChatAuth.authorize()")
do { do {
let user = try await WeChatAuth.authorize() let user = try await WeChatAuth.authorize()
print("[Bridge] accreditlogin 拿到 user,发 sharelogin 反向 callback") print("[Bridge] accreditlogin 拿到 user,发 sharelogin 反向 callback")
@@ -48,12 +45,8 @@ public enum AccreditLoginHandler {
} catch { } catch {
print("[Bridge] accreditlogin 失败:\(error)") print("[Bridge] accreditlogin 失败:\(error)")
// msext H5 // msext H5
// Phase 9 Sentry breadcrumb
} }
} }
#else
print("[Bridge] accreditlogin → ⚠️ canImport(WechatOpenSDK)=falseSDK 未链接,仅 stub")
#endif
} }
} }
} }
@@ -49,10 +49,11 @@ public enum BackGameDataHandler {
// msext gameController.m:691-709 + cleanUpAction // msext gameController.m:691-709 + cleanUpAction
AudioPlayer.shared.stopAllBackground() AudioPlayer.shared.stopAllBackground()
// SDK 2.xdelegate handleOpenURL: / sendAuthReq:...:delegate: // SDK 1.8.2 delegate sendAuthReq:viewController:delegate:
// SDK static delegate WeChatManager // handleOpenURL:delegate: SDK WeChatManager
// shared singleton pop // shared singleton pop
// msext gameController.m:699 [WXApi setDelegate:nil] 1.x SDK API // msext gameController.m:699 [WXApi setDelegate:nil] 1.x API
// 1.8.x
#if canImport(AMapLocationKit) #if canImport(AMapLocationKit)
// msext gameController.m:2473-2478 cleanUpAction // msext gameController.m:2473-2478 cleanUpAction
@@ -11,9 +11,7 @@
import Foundation import Foundation
import UIKit import UIKit
#if canImport(WechatOpenSDK) // SDK 1.8.2 daoqi msext Bridging Header import
import WechatOpenSDK
#endif
@MainActor @MainActor
public final class WeChatManager: NSObject { public final class WeChatManager: NSObject {
@@ -41,10 +39,9 @@ public final class WeChatManager: NSObject {
/// openURL SDK delegate /// openURL SDK delegate
/// 1.x `WXApi.send(req)` deprecated vc/delegate H5 /// 1.x `WXApi.send(req)` deprecated vc/delegate H5
public func authorize() async throws -> WXAuthCodePayload { public func authorize() async throws -> WXAuthCodePayload {
#if canImport(WechatOpenSDK)
print("[WeChat] authorize() 开始") print("[WeChat] authorize() 开始")
print("[WeChat] - WXApi.isWXAppInstalled = \(WXApi.isWXAppInstalled())") print("[WeChat] - WXApi.isWXAppInstalled = \(WXApi.isWXAppInstalled())")
print("[WeChat] - WXApi.getVersion = \(WXApi.getVersion() ?? "nil")") print("[WeChat] - WXApi.getApiVersion = \(WXApi.getApiVersion() ?? "nil")")
let state = UUID().uuidString let state = UUID().uuidString
return try await withCheckedThrowingContinuation { cont in return try await withCheckedThrowingContinuation { cont in
authPending[state] = cont authPending[state] = cont
@@ -59,23 +56,16 @@ public final class WeChatManager: NSObject {
return return
} }
print("[WeChat] 调 sendAuthReq vc=\(type(of: vc)) scope=\(Self.authScope) state=\(state)") print("[WeChat] 调 sendAuthReq vc=\(type(of: vc)) scope=\(Self.authScope) state=\(state)")
WXApi.sendAuthReq(req, viewController: vc, delegate: self) { [weak self] success in // 1.x sendAuthReq BOOL completion
print("[WeChat] sendAuthReq completion success=\(success)") let success = WXApi.sendAuthReq(req, viewController: vc, delegate: self)
// success = SDK app fail print("[WeChat] sendAuthReq 返回 success=\(success)")
// URL Scheme onResp if !success {
guard !success else { return } if let pending = authPending.removeValue(forKey: state) {
Task { @MainActor in pending.resume(throwing: WeChatError.authFailed(-3))
guard let self else { return }
if let pending = self.authPending.removeValue(forKey: state) {
pending.resume(throwing: WeChatError.authFailed(-3))
}
} }
} }
// success=true WXApiDelegate.onResp SceneDelegate openURL
} }
#else
print("[WeChat] ⚠️ canImport(WechatOpenSDK)=false")
throw WeChatError.sdkNotLinked
#endif
} }
/// ViewController presented / nav.visible SDK /// ViewController presented / nav.visible SDK
@@ -133,7 +123,6 @@ public final class WeChatManager: NSObject {
/// FIFO ID /// FIFO ID
public func shareLink(_ link: ShareLink, scene: ShareScene) async throws { public func shareLink(_ link: ShareLink, scene: ShareScene) async throws {
#if canImport(WechatOpenSDK)
try await withCheckedThrowingContinuation { (cont: CheckedContinuation<Void, Error>) in try await withCheckedThrowingContinuation { (cont: CheckedContinuation<Void, Error>) in
sharePending.append(cont) sharePending.append(cont)
@@ -152,22 +141,15 @@ public final class WeChatManager: NSObject {
case .session: req.scene = Int32(WXSceneSession.rawValue) case .session: req.scene = Int32(WXSceneSession.rawValue)
case .timeline: req.scene = Int32(WXSceneTimeline.rawValue) case .timeline: req.scene = Int32(WXSceneTimeline.rawValue)
} }
// SceneDelegate.openURLContexts // 1.x: sendReq BOOL SceneDelegate.openURLContexts
// WXApi.handleOpen(url:delegate:WeChatManager.shared) onResp // WXApi.handleOpen(url:delegate:WeChatManager.shared) onResp
// sendReq delegatecompletion=nil WXApi.sendReq(req)
// sharePending onResp FIFO
// SDK 2.x `sendReq:completion:` `send:` deprecated
WXApi.send(req, completion: nil)
} }
#else
throw WeChatError.sdkNotLinked
#endif
} }
/// FIFO sharePendingmsext gameController.m:637-678 /// FIFO sharePendingmsext gameController.m:637-678
/// type=2 / type= WXImageObject + setThumbImage /// type=2 / type= WXImageObject + setThumbImage
public func shareImage(_ img: ShareImage, scene: ShareScene) async throws { public func shareImage(_ img: ShareImage, scene: ShareScene) async throws {
#if canImport(WechatOpenSDK)
try await withCheckedThrowingContinuation { (cont: CheckedContinuation<Void, Error>) in try await withCheckedThrowingContinuation { (cont: CheckedContinuation<Void, Error>) in
sharePending.append(cont) sharePending.append(cont)
@@ -186,16 +168,8 @@ public final class WeChatManager: NSObject {
case .session: req.scene = Int32(WXSceneSession.rawValue) case .session: req.scene = Int32(WXSceneSession.rawValue)
case .timeline: req.scene = Int32(WXSceneTimeline.rawValue) case .timeline: req.scene = Int32(WXSceneTimeline.rawValue)
} }
// SceneDelegate.openURLContexts WXApi.sendReq(req)
// WXApi.handleOpen(url:delegate:WeChatManager.shared) onResp
// sendReq delegatecompletion=nil
// sharePending onResp FIFO
// SDK 2.x `sendReq:completion:` `send:` deprecated
WXApi.send(req, completion: nil)
} }
#else
throw WeChatError.sdkNotLinked
#endif
} }
// MARK: - Internal: resolve callbacks // MARK: - Internal: resolve callbacks
@@ -222,7 +196,6 @@ public final class WeChatManager: NSObject {
// MARK: - WXApiDelegate // MARK: - WXApiDelegate
#if canImport(WechatOpenSDK)
extension WeChatManager: WXApiDelegate { extension WeChatManager: WXApiDelegate {
public nonisolated func onReq(_ req: BaseReq) { public nonisolated func onReq(_ req: BaseReq) {
@@ -245,9 +218,8 @@ extension WeChatManager: WXApiDelegate {
} }
} }
} }
#endif
// MARK: - Public payload / error types SDK canImport 使 // MARK: - Public payload / error types
public struct WXAuthCodePayload: Sendable { public struct WXAuthCodePayload: Sendable {
public let code: String public let code: String
+9 -21
View File
@@ -2,18 +2,15 @@
// WeChatSDK.swift // WeChatSDK.swift
// ylgamehall // ylgamehall
// //
// OpenSDK 沿 msext AppID docs/SDK-Integration-Guide.md §0 // OpenSDK 1.8.2 daoqi msext 2.x
// Universal Link HTTPS + AASA +
// //
// canImport(WechatOpenSDK) Vendor/WechatSDK/WechatOpenSDK.xcframework // Bridging Header ObjC 1.x .a Swift module
// Xcode "Frameworks, Libraries, and Embedded Content" Embed & Sign // ylgamehall-Bridging-Header.h
// no-opEmbed
// //
import Foundation import Foundation
import UIKit
#if canImport(WechatOpenSDK)
import WechatOpenSDK
#endif
@MainActor @MainActor
public enum WeChatSDK { public enum WeChatSDK {
@@ -22,22 +19,13 @@ public enum WeChatSDK {
public static let appID = "wx586a9b321e56efb7" public static let appID = "wx586a9b321e56efb7"
/// AppDelegate.didFinishLaunchingWithOptions /// AppDelegate.didFinishLaunchingWithOptions
/// universalLink 沿 msext ULAPI msext /// 1.x registerApp Universal Link
public static func register() { public static func register() {
#if canImport(WechatOpenSDK) WXApi.registerApp(appID)
// Universal Linksmsext / ULAPI
WXApi.registerApp(appID, universalLink: "")
#else
// SDK no-opXcode framework WXApi
#endif
} }
/// SceneDelegate.openURLContexts QQ WXApi QQ msext /// SceneDelegate.openURLContexts
public static func handleOpenURL(_ url: URL) -> Bool { public static func handleOpenURL(_ url: URL) -> Bool {
#if canImport(WechatOpenSDK) WXApi.handleOpen(url, delegate: WeChatManager.shared)
return WXApi.handleOpen(url, delegate: WeChatManager.shared)
#else
return false
#endif
} }
} }
+2 -13
View File
@@ -11,9 +11,7 @@
import Foundation import Foundation
import UIKit import UIKit
#if canImport(WechatOpenSDK) // SDK 1.8.2 Bridging Header import
import WechatOpenSDK
#endif
@MainActor @MainActor
public final class WechatShare: SharePlatform { public final class WechatShare: SharePlatform {
@@ -23,17 +21,12 @@ public final class WechatShare: SharePlatform {
public let name = "WeChat" public let name = "WeChat"
public var isInstalled: Bool { public var isInstalled: Bool {
#if canImport(WechatOpenSDK) WXApi.isWXAppInstalled()
return WXApi.isWXAppInstalled()
#else
return true // SDK share stub success
#endif
} }
public init() {} public init() {}
public func share(_ content: ShareContent, scene: ShareScene) async -> ShareResult { public func share(_ content: ShareContent, scene: ShareScene) async -> ShareResult {
#if canImport(WechatOpenSDK)
guard WXApi.isWXAppInstalled() else { guard WXApi.isWXAppInstalled() else {
return .notInstalled(platform: name) return .notInstalled(platform: name)
} }
@@ -83,9 +76,5 @@ public final class WechatShare: SharePlatform {
} catch { } catch {
return .failed(reason: "\(error)") return .failed(reason: "\(error)")
} }
#else
// SDK Phase 4.B stub SharePanel
return .success
#endif
} }
} }
+15
View File
@@ -0,0 +1,15 @@
//
// ylgamehall-Bridging-Header.h
// ylgamehall
//
// Objective-C → Swift 桥接头文件。
//
// 当前唯一用途:微信 OpenSDK 1.8.2(与 daoqi msext 同款,避免 2.x 强制
// Universal Link 的运维负担)。1.x SDK 是 .a 静态库 + 头文件,没有 Swift
// module(不能 `import WechatOpenSDK`),必须通过 Bridging Header 导入。
//
// 详见 docs/SDK-Integration-Guide.md §A.1 / Vendor/WechatSDK/README.md。
//
#import "WXApi.h"
#import "WXApiObject.h"