您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 微信分享:從 SDK 導入到回呼處理的完整流程

編輯:iOS 開發綜合

本文以「能跑通」為目標,把微信分享接入拆成幾個步驟。至於申請微信開放平台 AppID 的流程這裡不贅述,公司通常會有專人處理,自己申請也不難。

1. 下載微信 SDK

更多 SDK 資訊與文件請見微信開放平台官方網站。

2. 導入 SDK

把下載回來的 SDKExport 資料夾拖進工程,其中有三個核心檔案:libWeChatSDK.a、WXApi.h、WXApiObject.h。強烈建議先讀一遍 read-me。

3. 連結相依的動態庫與框架

在 Build Phases → Link Binary With Libraries 中加入:

  • SystemConfiguration.framework
  • libz.dylib
  • libsqlite3.0.dylib
  • CoreTelephony.framework

4. 向微信註冊你的 App

建議放在 AppDelegate 的啟動方法中,記得先 #import "WXApi.h"。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [WXApi registerApp:@"wx1234567890"]; // 這裡填申請下來的 AppID,通常以 wx 開頭
    return YES;
}

5. 建立發送物件並發出分享

先看 SendMessageToWXReq 這個類別。從它的屬性可以知道:每次只能發送「純文字」或「多媒體訊息」其中一種,而多媒體訊息又細分為網頁連結、影片、音樂等類型。以下以網頁連結為例。

先準備好要分享的內容常數:

static NSString *kLinkURL = @"https://tech.qq.com/zt2012/tmtdecode/252.htm";
static NSString *kLinkTagName = @"WECHAT_TAG_JUMP_SHOWRANK";
static NSString *kLinkTitle = @"專訪張小龍:產品之上的世界觀";
static NSString *kLinkDescription = @"微信的平台化發展方向是否真的會讓這個原本簡潔的產品變得臃腫?在國際化發展方向上,微信面臨的問題真的是文化差異壁壘嗎?騰訊高級副總裁、微信產品負責人張小龍給出了自己的回復。";

接著組裝並發送:

- (IBAction)shareBtn:(UIButton *)sender {
    // 建立發送物件
    SendMessageToWXReq *sendReq = [[SendMessageToWXReq alloc] init];
    sendReq.bText = NO;  // 不使用純文字
    sendReq.scene = 1;   // 0 = 好友列表 1 = 朋友圈 2 = 收藏

    // 建立分享內容物件
    WXMediaMessage *urlMessage = [WXMediaMessage message];
    urlMessage.title = kLinkTitle;       // 分享標題
    urlMessage.description = kLinkDescription; // 分享描述
    [urlMessage setThumbImage:[UIImage imageNamed:@"testImg"]]; // 縮圖,SDK 會自行壓縮

    // 建立多媒體物件(網頁類型)
    WXWebpageObject *webObj = [WXWebpageObject object];
    webObj.webpageUrl = kLinkURL; // 分享連結

    // 組裝並發送
    urlMessage.mediaObject = webObj;
    sendReq.message = urlMessage;
    [WXApi sendReq:sendReq];
}

6. 常見問題

編譯不通過

解法:加入 libc++.tbd。

無法跳轉到微信

依提示通常是兩種情況之一:

一是 iOS 跳轉其他 App 走的是 URL Scheme,而 iOS 9 加入了白名單機制,必須把微信的 URL Scheme(weixin)加進當前工程的 LSApplicationQueriesSchemes。

二是該台裝置沒有安裝微信。可以用 WXApi 提供的 isWXAppInstalled 先判斷,再決定要提示還是走其他分享管道。

7. 别忘了反向的 URL Scheme

若一切正常,按下分享鈕就會跳去微信:

分享完成後要能跳回自己的 App,關鍵是把註冊時用的 AppID(wx1234567890)也加到工程的 URL Types → URL Schemes 裡,否則會卡在微信端。

8. 分享完成後的回呼

先讓 AppDelegate 遵守 WXApiDelegate 協議:

從微信回到 App 時會呼叫下面這個方法,它再轉呼叫代理的 onResp::

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    return [WXApi handleOpenURL:url delegate:self];
}
- (void)onResp:(BaseResp *)resp {
    // 把回傳型別轉成與發送時對應的型別,這裡是 SendMessageToWXResp
    SendMessageToWXResp *sendResp = (SendMessageToWXResp *)resp;

    // 用 UIAlertView 顯示回呼資訊
    NSString *str = [NSString stringWithFormat:@"%d", sendResp.errCode];
    UIAlertView *alertview = [[UIAlertView alloc] initWithTitle:@"回呼資訊"
                                                        message:str
                                                       delegate:self
                                              cancelButtonTitle:@"確認"
                                              otherButtonTitles:nil, nil];
    [alertview show];
}

9. 依 errCode 做後續處理

實務上最常見的兩個值:ErrCodeWeChatUserCancel(-2,使用者取消)與 ErrCodeSentFailed(-3,發送失敗)。把這些分支都處理掉,才不會出現「使用者取消了卻完全沒反應」的情況。

另外提醒,iOS 9 之後若 App 同時實作了 application:openURL:options:,請確認兩者都有轉呼叫 [WXApi handleOpenURL:delegate:],否則回呼不會進來。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved