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

三步驟快速整合 ShareSDK 社群分享功能

編輯:iOS 開發綜合

社群分享幾乎是現在 App 的標配。市面上常見的兩套方案各有取捨:ShareSDK 功能豐富、支援平台多,缺點是函式庫體積較大;百度分享 SDK 體積小、整合輕量,但支援的管道較少。選擇哪一種,取決於你的 App 需要分享到哪里。本文說明 ShareSDK 的整合流程。

一、準備工作

1. 下載 ShareSDK。到官方網站下載 SDK 並取得自己的 AppKey。

2. 申請各平台的 AppKey。ShareSDK 只是中介層,要分享到你想要的平台,必須先在該平台的開發者網站註冊應用並取得憑證。以新浪微博、騰訊微博、豆瓣、人人網、QQ 空間為例,逐一申請即可。

取得的憑證形式如下(以下為格式示意,實際數值請填入你自己申請的結果):

// 新浪微博
// App Key    :
// App Secret :

// 騰訊微博
// App Key    :
// App Secret :

部分平台(如新浪微博)還需要你提供回調位址,同樣在該平台開發者後台申請。

二、註冊 ShareSDK

在 App 啟動時完成註冊:

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // 註冊 ShareSDK
    [ShareSDK registerApp:@"你的ShareSDK的AppKey"];

    return YES;
}

三、掛上各分享平台

在同一個啟動流程中,依序把各平台的憑證交給 ShareSDK:

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [ShareSDK registerApp:@"你的ShareSDK的AppKey"];

    // 新浪微博(需要回調位址)
    [ShareSDK connectSinaWeiboWithAppKey:@"你的新浪AppKey"
                               appSecret:@"你的新浪AppSecret"
                              redirectUri:@"你在新浪申請到的回調位址"];

    // 騰訊微博
    [ShareSDK connectTencentWeiboWithAppKey:@"你的騰訊AppKey"
                                  appSecret:@"你的騰訊AppSecret"
                                 redirectUri:@"https://www.sharesdk.cn"];

    // 豆瓣
    [ShareSDK connectDoubanWithAppKey:@"你的豆瓣AppKey"
                            appSecret:@"你的豆瓣AppSecret"
                           redirectUri:@"你的豆瓣回調位址"];

    // 人人網
    [ShareSDK connectRenRenWithAppKey:@"你的人人AppKey"
                            appSecret:@"你的人人AppSecret"];

    // Facebook
    [ShareSDK connectFacebookWithAppKey:@"你的FacebookAppKey"
                              appSecret:@"你的FacebookAppSecret"];

    return YES;
}

不需要的平台直接不寫即可,不必全部掛上——少一個平台就少一份依賴與潛在的啟動延遲。

四、彈出分享面板

a. 初始化分享內容

NSString *imagePath = [[NSBundle mainBundle] pathForResource:@"123" ofType:@"png"];

// 構造分享內容
id<ISSContent> publishContent = [ShareSDK content:@"iOS 社群化分享測試內容"
                                    defaultContent:@"默認分享內容,沒內容時顯示"
                                             image:[ShareSDK imageWithPath:imagePath]
                                             title:@"ShareSDK"
                                               url:@"https://www.sharesdk.cn"
                                       description:@"這是一條測試信息"
                                         mediaType:SSPublishContentMediaTypeNews];

b. 顯示分享面板

[ShareSDK showShareActionSheet:nil
                     shareList:nil
                       content:publishContent
                 statusBarTips:YES
                  authOptions:nil
                 shareOptions:nil
                        result:^(ShareType type, SSResponseState state,
                                 id<ISSPlatformShareInfo> statusInfo,
                                 id<ICMErrorInfo> error, BOOL end) {

    if (state == SSResponseStateSuccess) {
        NSLog(@"分享成功");
    } else if (state == SSResponseStateFail) {
        NSLog(@"分享失敗, 錯誤碼:%d, 錯誤描述:%@",
              [error errorCode], [error errorDescription]);
    }
}];

五、整合時最容易踩的坑

URL Scheme 沒設定。多數社群平台透過 URL Scheme 跳回你的 App 完成授權。必須在 Info.plist 的 CFBundleURLTypes 中註冊各平台要求的 scheme,否則分享後使用者會卡在授權頁。同時也要把平台要求的 LSApplicationQueriesSchemes 白名單補上,否則 canOpenURL: 一律回傳 NO。

憑證與套件不匹配。平台後台通常要求填寫 Bundle ID 與簽章(尤其是 Android 的 keystore SHA1)。若與實際打包的簽章不符,授權會失敗但錯誤訊息往往很模糊。

不要把 AppSecret 寫進用戶端。更嚴重的問題是:把各平台的 AppSecret 硬編碼在 App 裡,等於公開你的憑證。有心人士可以反編譯取得後濫用。若平台支援,應把需要 secret 的流程移到伺服器端執行。

分享失敗缺少使用者提示。使用者取消分享與真的失敗是兩種不同狀態(SSResponseStateCancel 與 SSResponseStateFail)。把取消當成錯誤彈出提示,是很常見的體驗缺陷。

版本維護成本。本文示範的是 ShareSDK 早期(v2 系列)的 API,介面以 ISSContent 等不正式協定為主。後續版本已大幅改版為 SSDKContent 與 block 語法。整合第三方分享 SDK 時,務必確認文件版本與你下載的 SDK 一致。

替代方案。如果只是分享到少數平台,系統內建的 UIActivityViewController(iOS 6+)或 SLComposeViewController(社群專用)就能覆蓋絕大多數需求,且免費、免申請、免額外依賴。建議先評估系統方案是否已足夠,再決定要不要引入第三方 SDK。

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