友盟集成（一） —— UShare模塊之快速集成（一）

版本記錄

版本號(hào)	時(shí)間
V1.0	2018.04.03

前言

相信很多人用過友盟，包括友盟的第三方登錄、分享以及統(tǒng)計(jì)侣监。這里我們就分幾個(gè)模塊進(jìn)行詳細(xì)的說明 —— 移動(dòng)統(tǒng)計(jì)（U - App）脉幢、網(wǎng)站統(tǒng)計(jì)（U - Web）歪沃、消息推送（U - Push）、社會(huì)化分享（U - Share）嫌松、游戲統(tǒng)計(jì)（U - Game）沪曙、互聯(lián)網(wǎng)運(yùn)營(yíng)數(shù)據(jù)服務(wù)（Dplus） - 多維度、一站式萎羔、精細(xì)化數(shù)據(jù)管理服務(wù)液走。

U - Share

U - Share有什么用，其實(shí)三方登錄和分享都可以利用它來(lái)實(shí)現(xiàn)。后面我們會(huì)給出流程和工程實(shí)踐缘眶。

升級(jí)舊版SDK到組件化SDK說明

如果您的APP已經(jīng)接入過【友盟+】應(yīng)用統(tǒng)計(jì)嘱根，Push，分享SDKs巷懈，升級(jí)過程中的接入方式和接口變動(dòng)請(qǐng)參考老版SDK升級(jí)指南衔掸。

導(dǎo)入U(xiǎn)-Share

1. 將U-Share SDK添加到工程

2. 添加項(xiàng)目配置

在Other Linker Flags加入-ObjC 脊僚，注意不要寫為-Objc株憾。

-ObjC屬于鏈接庫(kù)必備參數(shù)饿敲，如果不加此項(xiàng)，會(huì)導(dǎo)致庫(kù)文件無(wú)法被正確鏈接涌攻，SDK無(wú)法正常運(yùn)行欧引。

3. 加入依賴系統(tǒng)庫(kù)

加入以下系統(tǒng)庫(kù)：

libsqlite3.tbd
CoreGraphics.framework

添加第三方平臺(tái)庫(kù)

根據(jù)集成的不同平臺(tái)加入相關(guān)的依賴庫(kù)，未列出平臺(tái)則不需添加添加方式：選中項(xiàng)目Target -> General -> Linked Frameworks and Libraries列表中進(jìn)行添加恳谎。

微信(完整版)-精簡(jiǎn)版無(wú)需添加以下依賴庫(kù)

SystemConfiguration.framework
CoreTelephony.framework
libsqlite3.tbd
libc++.tbd
libz.tbd

QQ(完整版)-精簡(jiǎn)版無(wú)需添加以下依賴庫(kù)

SystemConfiguration.framework
libc++.tbd

新浪微博(完整版)-精簡(jiǎn)版無(wú)需添加以下依賴庫(kù)

SystemConfiguration.framework
CoreTelephony.framework
ImageIO.framework
libsqlite3.tbd
libz.tbd

Twitter

CoreData.framework

Twitter平臺(tái)加入后需在Twitter目錄右鍵->Add files to "Twitter"->添加TwitterKit.framework/TwitterKitResources.bundle 和 TwitterShareExtensionUIResources.bundle芝此。

短信

MessageUI.framework

SafariServices.framework

VKontakte

CoreGraphics.framework
Security.framework

第三方平臺(tái)配置

1. 配置SSO白名單

如果你的應(yīng)用使用了如SSO授權(quán)登錄或跳轉(zhuǎn)到第三方分享功能，在iOS9/10下就需要增加一個(gè)可跳轉(zhuǎn)的白名單惠爽，即LSApplicationQueriesSchemes癌蓖，否則將在SDK判斷是否跳轉(zhuǎn)時(shí)用到的canOpenURL時(shí)返回NO，進(jìn)而只進(jìn)行webview授權(quán)或授權(quán)/分享失敗婚肆。在項(xiàng)目中的info.plist中加入應(yīng)用白名單租副，右鍵info.plist選擇source code打開(plist具體設(shè)置在Build Setting -> Packaging -> Info.plistFile可獲取plist路徑) 請(qǐng)根據(jù)選擇的平臺(tái)對(duì)以下配置進(jìn)行裁剪：

<key>LSApplicationQueriesSchemes</key>
<array>
    <!-- 微信 URL Scheme 白名單-->
    <string>wechat</string>
    <string>weixin</string>

    <!-- 新浪微博 URL Scheme 白名單-->
    <string>sinaweibohd</string>
    <string>sinaweibo</string>
    <string>sinaweibosso</string>
    <string>weibosdk</string>
    <string>weibosdk2.5</string>

    <!-- QQ、Qzone较性、Tim URL Scheme 白名單-->
    <string>mqqapi</string>
    <string>mqq</string>
    <string>mqqOpensdkSSoLogin</string>
    <string>mqqconnect</string>
    <string>mqqopensdkdataline</string>
    <string>mqqopensdkgrouptribeshare</string>
    <string>mqqopensdkfriend</string>
    <string>mqqopensdkapi</string>
    <string>mqqopensdkapiV2</string>
    <string>mqqopensdkapiV3</string>
    <string>mqqopensdkapiV4</string>
    <string>mqzoneopensdk</string>
    <string>wtloginmqq</string>
    <string>wtloginmqq2</string>
    <string>mqqwpa</string>
    <string>mqzone</string>
    <string>mqzonev2</string>
    <string>mqzoneshare</string>
    <string>wtloginqzone</string>
    <string>mqzonewx</string>
    <string>mqzoneopensdkapiV2</string>
    <string>mqzoneopensdkapi19</string>
    <string>mqzoneopensdkapi</string>
    <string>mqqbrowser</string>
    <string>mttbrowser</string>    
    <string>tim</string>
    <string>timapi</string>
    <string>timopensdkfriend</string>
    <string>timwpa</string>
    <string>timgamebindinggroup</string>
    <string>timapiwallet</string>
    <string>timOpensdkSSoLogin</string>
    <string>wtlogintim</string>
    <string>timopensdkgrouptribeshare</string>
    <string>timopensdkapiV4</string>
    <string>timgamebindinggroup</string>
    <string>timopensdkdataline</string>
    <string>wtlogintimV1</string>
    <string>timapiV1</string>

    <!-- 支付寶 URL Scheme 白名單-->
    <string>alipay</string>
    <string>alipayshare</string>

    <!-- 釘釘 URL Scheme 白名單-->
      <string>dingtalk</string>
      <string>dingtalk-open</string>

    <!--Linkedin URL Scheme 白名單-->
    <string>linkedin</string>
    <string>linkedin-sdk2</string>
    <string>linkedin-sdk</string>

    <!-- 點(diǎn)點(diǎn)蟲 URL Scheme 白名單-->
    <string>laiwangsso</string>

    <!-- 易信 URL Scheme 白名單-->
    <string>yixin</string>
    <string>yixinopenapi</string>

    <!-- instagram URL Scheme 白名單-->
    <string>instagram</string>

    <!-- whatsapp URL Scheme 白名單-->
    <string>whatsapp</string>

    <!-- line URL Scheme 白名單-->
    <string>line</string>

    <!-- Facebook URL Scheme 白名單-->
    <string>fbapi</string>
    <string>fb-messenger-api</string>
    <string>fbauth2</string>
    <string>fbshareextension</string>

    <!-- Kakao URL Scheme 白名單-->  
    <!-- 注：以下第一個(gè)參數(shù)需替換為自己的kakao appkey--> 
    <!-- 格式為 kakao + "kakao appkey"-->    
    <string>kakaofa63a0b2356e923f3edd6512d531f546</string>
    <string>kakaokompassauth</string>
    <string>storykompassauth</string>
    <string>kakaolink</string>
    <string>kakaotalk-4.5.0</string>
    <string>kakaostory-2.9.0</string>

   <!-- pinterest URL Scheme 白名單-->  
    <string>pinterestsdk.v1</string>

   <!-- Tumblr URL Scheme 白名單-->  
    <string>tumblr</string>

   <!-- 印象筆記 -->
    <string>evernote</string>
    <string>en</string>
    <string>enx</string>
    <string>evernotecid</string>
    <string>evernotemsg</string>

   <!-- 有道云筆記-->
    <string>youdaonote</string>
    <string>ynotedictfav</string>
    <string>com.youdao.note.todayViewNote</string>
    <string>ynotesharesdk</string>

   <!-- Google+-->
    <string>gplus</string>

   <!-- Pocket-->
    <string>pocket</string>
    <string>readitlater</string>
    <string>pocket-oauth-v1</string>
    <string>fb131450656879143</string>
    <string>en-readitlater-5776</string>
    <string>com.ideashower.ReadItLaterPro3</string>
    <string>com.ideashower.ReadItLaterPro</string>
    <string>com.ideashower.ReadItLaterProAlpha</string>
    <string>com.ideashower.ReadItLaterProEnterprise</string>

   <!-- VKontakte-->
    <string>vk</string>
    <string>vk-share</string>
    <string>vkauthorize</string>

   <!-- Twitter-->
    <string>twitter</string>
    <string>twitterauth</string>
</array>

2. 配置URL Scheme

URL Scheme是通過系統(tǒng)找到并跳轉(zhuǎn)對(duì)應(yīng)app的一類設(shè)置用僧，通過向項(xiàng)目中的info.plist文件中加入U(xiǎn)RL types可使用第三方平臺(tái)所注冊(cè)的appkey信息向系統(tǒng)注冊(cè)你的app，當(dāng)跳轉(zhuǎn)到第三方應(yīng)用授權(quán)或分享后赞咙，可直接跳轉(zhuǎn)回你的app责循。
添加URL Types可工程設(shè)置面板設(shè)置

配置第三方平臺(tái)URL Scheme 未列出則不需設(shè)置。

這里根據(jù)在第三方平臺(tái)攀操，例如微信院仿、QQ以及微博上注冊(cè)的AppKey等，根據(jù)上表進(jìn)行配置URL Types速和。

部分平臺(tái)需要再參考進(jìn)階文檔
微信平臺(tái)從U-Share 4/5升級(jí)說明
 新浪微博集成說明
 QQ/QZone平臺(tái)集成說明
 人人平臺(tái)集成說明
 Facebook/Messenger集成說明
 Twitter集成說明
 Kakao集成說明

初始化設(shè)置

1. 初始化U-Share及第三方平臺(tái)

應(yīng)用啟動(dòng)后進(jìn)行U-Share和第三方平臺(tái)的初始化工作以下代碼將所有平臺(tái)初始化示例放出歹垫，開發(fā)者根據(jù)平臺(tái)需要選取相應(yīng)代碼，并替換為所屬注冊(cè)的appKey和appSecret颠放。

注意并不是所有分享平臺(tái)都需要配置對(duì)應(yīng)的Appkey排惨，比如WhatsApp、印象筆記平臺(tái)會(huì)直接通過AirDrop方式分享碰凶，而短信和郵件會(huì)直接調(diào)用系統(tǒng)自帶的應(yīng)用進(jìn)行分享暮芭，這兩種分享方式均不需要配置對(duì)應(yīng)的三方Appkey鹿驼。

#import <UMShare/UMShare.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    // UMConfigure 通用設(shè)置，請(qǐng)參考SDKs集成做統(tǒng)一初始化辕宏。
    // 以下僅列出U-Share初始化部分

    // U-Share 平臺(tái)設(shè)置
    [self configUSharePlatforms];
    [self confitUShareSettings];

    // Custom code

    return YES;
}

- (void)confitUShareSettings
{
    /*
     * 打開圖片水印
     */
    //[UMSocialGlobal shareInstance].isUsingWaterMark = YES;

    /*
     * 關(guān)閉強(qiáng)制驗(yàn)證https畜晰，可允許http圖片分享，但需要在info.plist設(shè)置安全域名
     <key>NSAppTransportSecurity</key>
     <dict>
     <key>NSAllowsArbitraryLoads</key>
     <true/>
     </dict>
     */
    //[UMSocialGlobal shareInstance].isUsingHttpsWhenShareContent = NO;

}

- (void)configUSharePlatforms
{
    /* 設(shè)置微信的appKey和appSecret */
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_WechatSession appKey:@"wxdc1e388c3822c80b" appSecret:@"3baf1193c85774b3fd9d18447d76cab0" redirectURL:@"http://mobile.umeng.com/social"];
    /*
     * 移除相應(yīng)平臺(tái)的分享瑞筐，如微信收藏
     */
    //[[UMSocialManager defaultManager] removePlatformProviderWithPlatformTypes:@[@(UMSocialPlatformType_WechatFavorite)]];

    /* 設(shè)置分享到QQ互聯(lián)的appID
     * U-Share SDK為了兼容大部分平臺(tái)命名舷蟀，統(tǒng)一用appKey和appSecret進(jìn)行參數(shù)設(shè)置，而QQ平臺(tái)僅需將appID作為U-Share的appKey參數(shù)傳進(jìn)即可面哼。
    */
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_QQ appKey:@"1105821097"/*設(shè)置QQ平臺(tái)的appID*/  appSecret:nil redirectURL:@"http://mobile.umeng.com/social"];

    /* 設(shè)置新浪的appKey和appSecret */
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Sina appKey:@"3921700954"  appSecret:@"04b48b094faeb16683c32669824ebdad" redirectURL:@"https://sns.whalecloud.com/sina2/callback"];

    /* 釘釘?shù)腶ppKey */
    [[UMSocialManager defaultManager] setPlaform: UMSocialPlatformType_DingDing appKey:@"dingoalmlnohc0wggfedpk" appSecret:nil redirectURL:nil];

    /* 支付寶的appKey */
    [[UMSocialManager defaultManager] setPlaform: UMSocialPlatformType_AlipaySession appKey:@"2015111700822536" appSecret:nil redirectURL:@"http://mobile.umeng.com/social"];


    /* 設(shè)置易信的appKey */
    [[UMSocialManager defaultManager] setPlaform: UMSocialPlatformType_YixinSession appKey:@"yx35664bdff4db42c2b7be1e29390c1a06" appSecret:nil redirectURL:@"http://mobile.umeng.com/social"];

    /* 設(shè)置點(diǎn)點(diǎn)蟲（原來(lái)往）的appKey和appSecret */
    [[UMSocialManager defaultManager] setPlaform: UMSocialPlatformType_LaiWangSession appKey:@"8112117817424282305" appSecret:@"9996ed5039e641658de7b83345fee6c9" redirectURL:@"http://mobile.umeng.com/social"];

    /* 設(shè)置領(lǐng)英的appKey和appSecret */
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Linkedin appKey:@"81t5eiem37d2sc"  appSecret:@"7dgUXPLH8kA8WHMV" redirectURL:@"https://api.linkedin.com/v1/people"];

    /* 設(shè)置Twitter的appKey和appSecret */
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Twitter appKey:@"fB5tvRpna1CKK97xZUslbxiet"  appSecret:@"YcbSvseLIwZ4hZg9YmgJPP5uWzd4zr6BpBKGZhf07zzh3oj62K" redirectURL:nil];

    /* 設(shè)置Facebook的appKey和UrlString */
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Facebook appKey:@"506027402887373"  appSecret:nil redirectURL:@"http://www.umeng.com/social"];

    /* 設(shè)置Pinterest的appKey */
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Pinterest appKey:@"4864546872699668063"  appSecret:nil redirectURL:nil];

    /* dropbox的appKey */
    [[UMSocialManager defaultManager] setPlaform: UMSocialPlatformType_DropBox appKey:@"k4pn9gdwygpy4av" appSecret:@"td28zkbyb9p49xu" redirectURL:@"https://mobile.umeng.com/social"];

    /* vk的appkey */
    [[UMSocialManager defaultManager]  setPlaform:UMSocialPlatformType_VKontakte appKey:@"5786123" appSecret:nil redirectURL:nil];

}

2. 設(shè)置系統(tǒng)回調(diào)

// 支持所有iOS系統(tǒng)
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
    //6.3的新的API調(diào)用，是為了兼容國(guó)外平臺(tái)(例如:新版facebookSDK,VK等)的調(diào)用[如果用6.2的api調(diào)用會(huì)沒有回調(diào)],對(duì)國(guó)內(nèi)平臺(tái)沒有影響
    BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url sourceApplication:sourceApplication annotation:annotation];
    if (!result) {
         // 其他如支付等SDK的回調(diào)
    }
    return result;
}

注：以上為建議使用的系統(tǒng)openURL回調(diào)扫步，且新浪平臺(tái)僅支持以上回調(diào)魔策。還有以下兩種回調(diào)方式，如果開發(fā)者選取以下回調(diào)河胎，也請(qǐng)補(bǔ)充相應(yīng)的函數(shù)調(diào)用闯袒。

僅支持iOS9以上系統(tǒng)，iOS8及以下系統(tǒng)不會(huì)回調(diào)

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options
{
    //6.3的新的API調(diào)用游岳，是為了兼容國(guó)外平臺(tái)(例如:新版facebookSDK,VK等)的調(diào)用[如果用6.2的api調(diào)用會(huì)沒有回調(diào)],對(duì)國(guó)內(nèi)平臺(tái)沒有影響
    BOOL result = [[UMSocialManager defaultManager]  handleOpenURL:url options:options];
    if (!result) {
        // 其他如支付等SDK的回調(diào)
    }
    return result;
}

支持目前所有iOS系統(tǒng)

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
    BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url];
    if (!result) {
        // 其他如支付等SDK的回調(diào)
    }
    return result;
}

若想了解更多U-Share接口政敢，如判斷平臺(tái)安裝等，請(qǐng)參考U-Share API說明

后記

本篇主要介紹了U - Share集成的一些初始化配置胚迫，感興趣的給個(gè)贊或者關(guān)注~~~~

最后編輯于：2018.04.03 23:47:33

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者

人面猴
序言：七十年代末喷户，一起剝皮案震驚了整個(gè)濱河市，隨后出現(xiàn)的幾起案子访锻，更是在濱河造成了極大的恐慌褪尝，老刑警劉巖，帶你破解...
沈念sama閱讀 217,657評(píng)論 6贊 505
死咒
序言：濱河連續(xù)發(fā)生了三起死亡事件期犬，死亡現(xiàn)場(chǎng)離奇詭異河哑，居然都是意外死亡，警方通過查閱死者的電腦和手機(jī)龟虎，發(fā)現(xiàn)死者居然都...
沈念sama閱讀 92,889評(píng)論 3贊 394
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進(jìn)店門璃谨，熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)，“玉大人鲤妥，你說我怎么就攤上這事佳吞。” “怎么了旭斥？”我有些...
開封第一講書人閱讀 164,057評(píng)論 0贊 354
道士緝兇錄：失蹤的賣姜人
文/不壞的土叔我叫張陵容达，是天一觀的道長(zhǎng)。經(jīng)常有香客問我垂券，道長(zhǎng)花盐，這世上最難降的妖魔是什么羡滑？我笑而不...
開封第一講書人閱讀 58,509評(píng)論 1贊 293
?港島之戀（遺憾婚禮）
正文為了忘掉前任，我火速辦了婚禮算芯，結(jié)果婚禮上柒昏，老公的妹妹穿的比我還像新娘。我一直安慰自己熙揍，他們只是感情好职祷，可當(dāng)我...
茶點(diǎn)故事閱讀 67,562評(píng)論 6贊 392
惡毒庶女頂嫁案：這布局不是一般人想出來(lái)的
文/花漫我一把揭開白布。她就那樣靜靜地躺著届囚，像睡著了一般有梆。火紅的嫁衣襯著肌膚如雪。梳的紋絲不亂的頭發(fā)上意系，一...
開封第一講書人閱讀 51,443評(píng)論 1贊 302
城市分裂傳說
那天泥耀，我揣著相機(jī)與錄音，去河邊找鬼蛔添。笑死痰催，一個(gè)胖子當(dāng)著我的面吹牛，可吹牛的內(nèi)容都是我干的迎瞧。我是一名探鬼主播夸溶，決...
沈念sama閱讀 40,251評(píng)論 3贊 418
雙鴛鴦連環(huán)套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開眼，長(zhǎng)吁一口氣：“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼凶硅！你這毒婦竟也來(lái)了缝裁？” 一聲冷哼從身側(cè)響起，我...
開封第一講書人閱讀 39,129評(píng)論 0贊 276
萬(wàn)榮殺人案實(shí)錄
序言：老撾萬(wàn)榮一對(duì)情侶失蹤足绅，失蹤者是張志新（化名）和其女友劉穎压语，沒想到半個(gè)月后，有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體编检，經(jīng)...
沈念sama閱讀 45,561評(píng)論 1贊 314
?護(hù)林員之死
正文獨(dú)居荒郊野嶺守林人離奇死亡胎食，尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛以下內(nèi)容為張勛視角年9月15日...
茶點(diǎn)故事閱讀 37,779評(píng)論 3贊 335
?白月光啟示錄
正文我和宋清朗相戀三年，在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了允懂。大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片厕怜。...
茶點(diǎn)故事閱讀 39,902評(píng)論 1贊 348
活死人
序言：一個(gè)原本活蹦亂跳的男人離奇死亡，死狀恐怖蕾总，靈堂內(nèi)的尸體忽然破棺而出粥航，到底是詐尸還是另有隱情，我是刑警寧澤生百，帶...
沈念sama閱讀 35,621評(píng)論 5贊 345
?日本核電站爆炸內(nèi)幕
正文年R本政府宣布递雀，位于F島的核電站，受9級(jí)特大地震影響蚀浆，放射性物質(zhì)發(fā)生泄漏缀程。R本人自食惡果不足惜搜吧，卻給世界環(huán)境...
茶點(diǎn)故事閱讀 41,220評(píng)論 3贊 328
男人毒藥：我在死后第九天來(lái)索命
文/蒙蒙一、第九天我趴在偏房一處隱蔽的房頂上張望杨凑。院中可真熱鬧滤奈，春花似錦、人聲如沸撩满。這莊子的主人今日做“春日...
開封第一講書人閱讀 31,838評(píng)論 0贊 22
一樁弒父案，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽(yáng)伺帘。三九已至昭躺，卻和暖如春，著一層夾襖步出監(jiān)牢的瞬間伪嫁，已是汗流浹背窍仰。一陣腳步聲響...
開封第一講書人閱讀 32,971評(píng)論 1贊 269
情欲美人皮
我被黑心中介騙來(lái)泰國(guó)打工，沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留礼殊，地道東北人。一個(gè)月前我還...
沈念sama閱讀 48,025評(píng)論 2贊 370
代替公主和親
正文我出身青樓针史，卻偏偏與公主長(zhǎng)得像晶伦，于是被迫代替她去往敵國(guó)和親。傳聞我的和親對(duì)象是個(gè)殘疾皇子啄枕，可洞房花燭夜當(dāng)晚...
茶點(diǎn)故事閱讀 44,843評(píng)論 2贊 354