iOS 微信openSDK使用Universal Links填坑

傳送門:
Demo源碼
Universal Links配置方法
蘋果Universal Links官方文檔
微信開發平臺文檔
微信授權登錄
微信分享

配置要求:

  1. openSDK版本: 1.8.6或以上
  2. 手機微信版本: 7.0.7或以上

本文從配置微信開放平臺這一步開始,在這之前需要先配置Universal Links

第一步:配置微信開發平臺

到微信開發平臺的“管理中心”里,更新你的iOS移動應用:

  1. 查看詳情,找到開發者信息一欄,點擊右上角的“修改”按鈕;


    微信開發平臺截圖.png
  2. 修改Universal Links路徑,要求https開頭,以“/”結尾,
    注意,這里的Universal Links需要配合服務端的apple-app-site-association文件使用

https://www.baidu.com/wx_conn/wxc59ee02301029db6/

這里很多帖子包括微信的開發指南中說的都很模糊,這里附上:Universal Links詳細的配置方法

  1. 保存,并記錄這里的AppID和Universal Links備用

第二步:集成微信openSDK

將微信提供的openSDK(版本1.8.6或以上)下載并集成到你的工程內(詳細過程查看iOS接入指南:https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/iOS.html

  1. 配置URL Scheme,當分享結束后從微信回到原生App是通過URL Scheme跳轉的,這里要使用從步驟四中從微信開發平臺獲取的AppID ,打開Xcode選擇project → Info → URL Types → 新增一個,Identifier填weixin URL Schemes填AppID

    Xcode配置3.png

  2. 配置Info.plist,在LSApplicationQueriesSchemes下新增兩個字段:weixinweixinULAPI

    Xcode配置4.png

    當然,如果你使用的API所在服務器不支持http,還需要加上App Transport Security Settings

  3. 代碼部分,這里需要用到這里要使用從步驟四中從微信開發平臺獲取的App ID和Universal Links,在AppDelegate.m中實現如下代碼:

#import "AppDelegate.h"
#import "WXApi.h"

#warning 注意修改WXAppId和WXUniversalLink為當前App對應在微信開放平臺的配置
#define WXAppId @"wx123456789"http://TODO:注意修改
#define WXUniversalLink @"https://www.wechat.com/wx_conn/app/"http://TODO:注意修改

@interface AppDelegate ()<WXApiDelegate>

@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    [WXApi startLogByLevel:WXLogLevelDetail logBlock:^(NSString * _Nonnull log) {
        NSLog(@"%@", log);
    }];

    if([WXApi registerApp:WXAppId universalLink:WXUniversalLink]){
        NSLog(@"初始化成功");

        //自檢函數
        [WXApi checkUniversalLinkReady:^(WXULCheckStep step, WXCheckULStepResult* result) {
            NSLog(@"%@, %u, %@, %@", @(step), result.success, result.errorInfo, result.suggestion);
        }];
    }
    
    return YES;
}

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    
    return [WXApi handleOpenURL:url delegate:self];
}

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
    
    return [WXApi handleOpenURL:url delegate:self];
}

#pragma mark - Universal Link
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void(^)(NSArray<id<UIUserActivityRestoring>> * __nullable restorableObjects))restorationHandler {
    
    return [WXApi handleOpenUniversalLink:userActivity delegate:self];
}

#pragma mark - WXApiDelegate
- (void)onResp:(id)resp{

    if([resp isKindOfClass:[SendMessageToWXResp class]]){//微信回調
        
        SendMessageToWXResp *response = (SendMessageToWXResp *)resp;

        if(response.errCode == WXSuccess){
            //目前分享回調只會走成功
        }
    }else if([resp isKindOfClass:[SendAuthResp class]]){//判斷是否為授權登錄類

        SendAuthResp *req = (SendAuthResp *)resp;
        if([req.state isEqualToString:@"wx_oauth_authorization_state"]){//微信授權成功

        }
    }else if ([resp isKindOfClass:[WXLaunchMiniProgramResp class]]){
        
        WXLaunchMiniProgramResp *req = (WXLaunchMiniProgramResp *)resp;
        NSString *string = req.msg; // 對應JsApi navigateBackApplication中的extraData字段數據
    }
}

@end

如果是在debug模式下真機調試,建議打開WXApi提供的log函數和自檢函數,方便查看具體問題所在,但是后面打生產環境包前記得刪除

  1. 真機測試,檢查手機上安裝的微信版本(需要7.0.7或以上),如果你在上面代碼部分實現了自檢函數[WXApi checkUniversalLinkReady:block];運行啟動registerApp初始化通過后會主動拉起微信進行檢查

WXULCheckStep值說明:
(1) step = WXULCheckStepParams: 參數檢查
(2) step = WXULCheckStepSystemVersion: 當前系統版本檢查
(3) step = WXULCheckStepWechatVersion: 微信客戶端版本檢查
(4) step = WXULCheckStepSDKInnerOperation: 微信SDK內部操作檢查
(5) step = WXULCheckStepLaunchWechat: App拉起微信檢查
(6) step = WXULCheckStepBackToCurrentApp: 由微信返回當前App檢查
(7) step = WXULCheckStepFinal: 最終檢查

自檢函數會依次回調這7個step,當回調了WXULCheckStepFinal,說明檢測通過,SDK接入成功。 任一step回調的result.success為NO, 流程終止,后續不再回調,可以根據result.errorInfo的查看當前步驟錯誤的原因,根據result.suggestion修復問題

  1. 如果上面自檢函數步驟全檢測通過那距離大功告成就已經不遠了,發起分享:
if([WXApi isWXAppInstalled]){//判斷當前設備是否安裝微信客戶端

    //創建多媒體消息結構體
    WXMediaMessage *message = [WXMediaMessage message];
    message.title = @"【爆款直降 盛夏特惠】【29.9免郵 限量買3免1】清新持久自然GUCCMI香水";//標題
    message.description = @"我在京東發現了一個不錯的商品,趕快來看看吧。";//描述
    [message setThumbImage:[UIImage imageNamed:@"res2.png"]];//設置預覽圖

    //創建網頁數據對象
    WXWebpageObject *webObj = [WXWebpageObject object];
    webObj.webpageUrl = @"[https://open.weixin.qq.com](https://open.weixin.qq.com)";//鏈接
    message.mediaObject = webObj;

    SendMessageToWXReq *sendReq = [[SendMessageToWXReq alloc] init];
    sendReq.bText = NO;//不使用文本信息
    sendReq.message = message;
    sendReq.scene = WXSceneSession;//分享到好友會話
    //發送分享信息
    [WXApi sendReq:sendReq completion:^(BOOL success) {
        NSLog(@"喚起微信:%@", success ? @"成功" : @"失敗");
    }];
}else{

    //未安裝微信應用或版本過低
}

當開發者的App發起分享時,微信SDK會校驗Universal Links是否匹配,使用新版本SDK發起分享時,會出現如下圖所示交互過程:從App拉起微信-出現“正在連接”頁面-返回App-重新打開微信,這是新的安全驗證流程,每個用戶在首次使用時會出現上述跳轉,理論上該過程只會出現一次,若同一用戶發起分享多次都出現該跳轉,則需要檢查上面各步驟是否配置正確,下面附上我自己總結的流程圖:

安全驗證流程圖.jpg

如果本文對你有所幫助記得點個贊哈:)

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,732評論 6 539
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,214評論 3 426
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,781評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,588評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,315評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,699評論 1 327
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,698評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,882評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,441評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,189評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,388評論 1 372
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,933評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,613評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,023評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,310評論 1 293
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,112評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,334評論 2 377