社群分享幾乎是現在 App 的標配。市面上常見的兩套方案各有取捨:ShareSDK 功能豐富、支援平台多,缺點是函式庫體積較大;百度分享 SDK 體積小、整合輕量,但支援的管道較少。選擇哪一種,取決於你的 App 需要分享到哪里。本文說明 ShareSDK 的整合流程。
1. 下載 ShareSDK。到官方網站下載 SDK 並取得自己的 AppKey。
2. 申請各平台的 AppKey。ShareSDK 只是中介層,要分享到你想要的平台,必須先在該平台的開發者網站註冊應用並取得憑證。以新浪微博、騰訊微博、豆瓣、人人網、QQ 空間為例,逐一申請即可。
取得的憑證形式如下(以下為格式示意,實際數值請填入你自己申請的結果):
// 新浪微博
// App Key :
// App Secret :
// 騰訊微博
// App Key :
// App Secret :
部分平台(如新浪微博)還需要你提供回調位址,同樣在該平台開發者後台申請。
在 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。