U-Share(友盟社会化SDK 6.3.0) 分享及登录的使用

2017-03-11 本文已影响2096人鲸鱼座的男孩

最近两天都在学习友盟分享和登录，因为自己作为一名新手开发者第一次接触友盟，并且友盟分享的SDK在6.0后与前面的版本改动比较大，所以在学习的过程中遇到了许多的问题，在其他网页中许多的资料和使用教程都是基于5.0-5.3版本的，因此我想写一篇关于友盟最新版本（v6.3.0）的使用心得。简单记录一下我使用的步骤，希望对第一次接触新版本的朋友们有所帮助。

①友盟分享基本功能集成

一、下载SDK

1.1 登录友盟官网
　　　　1.2 点击导航栏上的产品->运营工具->U-Share

步骤1.1-1.2 ：点击Ｕ-Share按钮

　　　1.3 点击查看SDK->选择苹果设备文档

步骤1.3：进入苹果设备U-Share集成文档

1.4 点击右上角的SDK下载按钮进入SDK下载页面

1.5 选择你需要的版本，进行下载

步骤1.4

步骤1.5.1

步骤1.5.2

　　在这里我就选择默认的平台（微信、QQ、微博）你们也可以按照自己的需求选择所需要的分享平台进行下载SDK

当然也可以通过Cocoapods集成（比较方便）

下载、解压完成后的SDK目录

Document - U-Share SDK文档

UMSocialDemo - U-Share SDK Demo（如点选下载）

UMSocial - U-Share SDK核心目录
UMSocialSDK - U-Share SDK核心framework
UMSocialUI - U-Share 分享UI资源、分享面板framework
SocialLibraries - 所选择下载的第三方平台SDK及U-Share链接库

二、注册友盟开发者账号、添加新应用、获取APPKey

2.1 注册：地址：https://i.umeng.com/signup
　　　2.2 登录后添加新应用：同1.2 打开U-Share 选择立即使用

步骤2.2

　　　2.3 点击左上角全部应用

步骤2.3

　　　2.4 点击添加新应用，填写应用相关信息获取唯一Appkey

步骤2.4.1

步骤2.4.2

三、集成U-Share v6.3.0到自己的项目中

3.1 新建项目然后把UMSocial 文件夹拖入项目中：

步骤3.1
　　　3.2 在Bulid Setting找到Other Linker Flags，添加-ObjC

步骤3.2
　　　３.３加入依赖系统库（下面分别有微信、微博、QQ所需要的依赖系统库）

步骤3.3加入依赖系统库

各平台所需要的依赖库

四、U-Share SDK平台配置（iOS9+）

4.１需要有友盟及第三方平台的AppKey和AppSecret 具体参照:第三方账号申请及绑定
　　　4.2 我的项目只使用了微信和微博的分享

注意点：
1.在第三方平台创建应用，如果只是用来测试的话，是不用填写AppStore ID的，只要创建应用就会生成appKey和appSecret并且可以拿来测试，但是Bundle ID一定要和测试应用的一致！
2.QQ：一定要填写正确应用调试者账号！如果你在腾讯开放平台登录的账号和你测试的账号不一致，就会出错！
3.Sina：一定要按照文档中说的修改安全域名以及设置授权回调页，并且还要在友盟后台绑定

4.3 配置各平台URL Scheme

URL Scheme是通过系统找到并跳转对应app的一类设置，通过向项目中的info.plist文件中加入URL types可使用第三方平台所注册的appkey信息向系统注册你的app，当跳转到第三方应用授权或分享后，可直接跳转回你的app。具体参照：http://www.jianshu.com/p/f367b4a5e871

步骤4.3配置各平台URL Scheme

　　　4.4 配置SSO白名单(iOS9/10)

如果你的应用使用了如SSO授权登录或跳转到第三方分享功能，在iOS9/10下就需要增加一个可跳转的白名单，即LSApplicationQueriesSchemes，否则将在SDK判断是否跳转时用到的canOpenURL时返回NO，进而只进行webview授权或授权/分享失败。在项目中的info.plist中加入应用白名单，右键info.plist选择source code打开(plist具体设置在Build Setting -> Packaging -> Info.plist File可获取plist路径) 请根据选择的平台对以下配置进行裁剪：

<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 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>

    <!-- 支付宝 URL Scheme 白名单-->
    <string>alipay</string>
    <string>alipayshare</string>

    <!-- 钉钉 URL Scheme 白名单-->
      <string>dingtalk</string>
      <string>dingtalk-open</string>

    <!-- 点点虫 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 白名单-->  
    <!-- 注：以下第一个参数需替换为自己的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>
</array>

五、初始化U-Share及第三方平台

以下代码根据自己的需要进行选择，一定要设置对appKey和appSecret
AppDelegate.m中加入以下代码

 5.1初始化U-Share及第三方平台

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //打开日志
    [[UMSocialManager defaultManager]openLog:YES];
    //设置友盟appkey
    [[UMSocialManager defaultManager]setUmSocialAppkey:@"你在友盟创建的AppKey"];
    //获取友盟social版本号
    NSLog(@"友盟版本: %@", [UMSocialGlobal umSocialSDKVersion]);
    //设置微信的appID和appKey
    [[UMSocialManager defaultManager]setPlaform:UMSocialPlatformType_WechatSession                 
       appKey:@"wxdc1e388c3822c80b"
       appSecret:@"3baf1193c85774b3fd9d18447d76cab0"
       redirectURL:@"http://mobile.umeng.com/social"
    ];
    //设置微博的appID和appkey
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Sina
        appKey:@"3210168487"
        appSecret:@"617fe71b46f0dff305a364c27a465dac"
        redirectURL:@"http://sns.whalecloud.com/sina2/callback"
    ];
    //如果不想显示平台下的某些类型，可用以下接口设置
  /*  
        [[UMSocialManager defaultManager] removePlatformProviderWithPlatformTypes:@[
        @(UMSocialPlatformType_QQ),@(UMSocialPlatformType_WechatFavorite)
        ]
    ];*/
    return YES;
}

5.2设置系统回调

#if __IPHONE_OS_VERSION_MAX_ALLOWED >100000

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
    //6.3的新的API调用，是为了兼容国外平台(例如:新版facebookSDK,VK等)的调用[如果用6.2的api调用会没有回调],对国内平台没有影响
    BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url sourceApplication:sourceApplication annotation:annotation];
    if (!result) {
        // 其他如支付等SDK的回调
    }
    return result;
}
#endif
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options
{
    //6.3的新的API调用，是为了兼容国外平台(例如:新版facebookSDK,VK等)的调用[如果用6.2的api调用会没有回调],对国内平台没有影响
    BOOL result = [[UMSocialManager defaultManager]  handleOpenURL:url options:options];
    if (!result) {
        // 其他如支付等SDK的回调
    }
    return result;
}
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
    BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url];
    if (!result) {
        // 其他如支付等SDK的回调
    }
    return result;
}

六、第三方平台分享

这一步就离成功不远了，现在你想要分享的控制器中加入以下代码

6.1弹出分享面板

#import <UShareUI/UShareUI.h>
//点击分享按钮
- (IBAction)share:(id)sender {
    __weak typeof(self) weakSelf = self;
    //显示分享面板
    [UMSocialUIManager showShareMenuViewInView:nil sharePlatformSelectionBlock:^(UMSocialShareSelectionView *shareSelectionView, NSIndexPath *indexPath, UMSocialPlatformType platformType) {
        // 根据platformType调用相关平台进行分享
        if (platformType == UMSocialPlatformType_WechatSession) {
            [weakSelf shareWebPageToPlatformType:UMSocialPlatformType_WechatSession];
        } else if () {
            
        }
        ...
    }];
}

6.2 - (void)shareWebPageToPlatformType:(UMSocialPlatformType)platformType

- (void)shareWebPageToPlatformType:(UMSocialPlatformType)platformType

{
    //创建分享消息对象
    UMSocialMessageObject *messageObject = [UMSocialMessageObject messageObject];
    
    //创建音乐内容对象
    UMShareMusicObject *shareObject = [UMShareMusicObject shareObjectWithTitle:@"分享标题" descr:@"分享内容描述" thumImage:[UIImage imageNamed:@"分享图片名"]];
    //设置音乐网页播放地址
    shareObject.musicUrl = @"http://c.y.qq.com/v8/playsong.html?songid=108782194&source=yqq#wechat_redirect";
    messageObject.shareObject = shareObject;
    
    //调用分享接口
    [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObject currentViewController:self completion:^(id data, NSError *error) {
        if (error) {
            NSLog(@"************Share fail with error %@*********",error);
        }else{
            NSLog(@"response data is %@",data);
        }
    }];
}

分享图1

分享图2

设置分享内容
下面我列举几个常用的分享内容具体参照官方给出的文档
http://dev.umeng.com/social/ios/进阶文档#2

a.分享文本

- (void)shareTextToPlatformType:(UMSocialPlatformType)platformType
{
    //创建分享消息对象
    UMSocialMessageObject *messageObject = [UMSocialMessageObject messageObject];
    //设置文本
    messageObject.text = @"社会化组件UShare将各大社交平台接入您的应用，快速武装App。";

    //调用分享接口
    [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObject currentViewController:self completion:^(id data, NSError *error) {
        if (error) {
            NSLog(@"************Share fail with error %@*********",error);
        }else{
            NSLog(@"response data is %@",data);
        }
    }];
}

b.分享图片

- (void)shareImageToPlatformType:(UMSocialPlatformType)platformType
{
    //创建分享消息对象
    UMSocialMessageObject *messageObject = [UMSocialMessageObject messageObject];

    //创建图片内容对象
    UMShareImageObject *shareObject = [[UMShareImageObject alloc] init];
    //如果有缩略图，则设置缩略图
    shareObject.thumbImage = [UIImage imageNamed:@"icon"];
    [shareObject setShareImage:@"https://mobile.umeng.com/images/pic/home/social/img-1.png"];

    //分享消息对象设置分享内容对象
    messageObject.shareObject = shareObject;

    //调用分享接口
    [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObject currentViewController:self completion:^(id data, NSError *error) {
        if (error) {
            NSLog(@"************Share fail with error %@*********",error);
        }else{
            NSLog(@"response data is %@",data);
        }
    }];
}

c.分享图文（新浪支持，微信/QQ仅支持图或文本分享）

- (void)shareImageAndTextToPlatformType:(UMSocialPlatformType)platformType
{
    //创建分享消息对象
    UMSocialMessageObject *messageObject = [UMSocialMessageObject messageObject];

    //设置文本
    messageObject.text = @"社会化组件UShare将各大社交平台接入您的应用，快速武装App。";

    //创建图片内容对象
    UMShareImageObject *shareObject = [[UMShareImageObject alloc] init];
    //如果有缩略图，则设置缩略图
    shareObject.thumbImage = [UIImage imageNamed:@"icon"];
    [shareObject setShareImage:@"https://www.umeng.com/img/index/demo/1104.4b2f7dfe614bea70eea4c6071c72d7f5.jpg"];

    //分享消息对象设置分享内容对象
    messageObject.shareObject = shareObject;

    //调用分享接口
    [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObject currentViewController:self completion:^(id data, NSError *error) {
        if (error) {
            NSLog(@"************Share fail with error %@*********",error);
        }else{
            NSLog(@"response data is %@",data);
        }
    }];
}

d.分享网页

- (void)shareWebPageToPlatformType:(UMSocialPlatformType)platformType
{
    //创建分享消息对象
    UMSocialMessageObject *messageObject = [UMSocialMessageObject messageObject];

    //创建网页内容对象
    UMShareWebpageObject *shareObject = [UMShareWebpageObject shareObjectWithTitle:@"分享标题" descr:@"分享内容描述" thumImage:[UIImage imageNamed:@"icon"]];
    //设置网页地址
    shareObject.webpageUrl =@"http://mobile.umeng.com/social";

    //分享消息对象设置分享内容对象
    messageObject.shareObject = shareObject;

    //调用分享接口
    [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObject currentViewController:self completion:^(id data, NSError *error) {
        if (error) {
            NSLog(@"************Share fail with error %@*********",error);
        }else{
            NSLog(@"response data is %@",data);
        }
    }];
}

七、分享面板UI设置

友盟6.0+版本的分享UI相对以前版本来说不仅更加美观，而且支持自定义，通过修改SDK中的UMSocialUI的类，能够获得自己想要的分享UI。具体可以参照下面这篇文章：http://www.jianshu.com/p/7fd968d6094f

八、U-Share第三方平台登录集成

7.1第三方登录的定义
　　第三方登录主要用于简化用户登录流程，通过用户拥有的微博、QQ、微信等第三方账号进行登录并且构建APP自己的登录账号体系。

7.2如何实现三方登录
　　三方登录所添加的SDK和分享功能相同，在这里不再复述，具体工程配置、系统回调及URL scheme配置参考对应分享文档即可分享文档
最终通过调用登录接口，获取用户在第三方平台的用户ID、头像等资料完成账号体系的构建

7.3 三方登录支持的平台
　　国内平台
　　　　微信、QQ、新浪、腾讯微博、人人网、豆瓣
　　国外平台
　　　　Facebook、Twitter、linkedIn、Kakao

下面是登录实现代码：（获取登录微信用户的信息，并输出在控制台中）

 [[UMSocialManager defaultManager] getUserInfoWithPlatform:UMSocialPlatformType_WechatSession currentViewController:nil completion:^(id result, NSError *error) {
            if (error) {
                
            } else {
                UMSocialUserInfoResponse *resp = result;
                
                // 授权信息
                NSLog(@"Wechat uid: %@", resp.uid);
                NSLog(@"Wechat openid: %@", resp.openid);
                NSLog(@"Wechat accessToken: %@", resp.accessToken);
                NSLog(@"Wechat refreshToken: %@", resp.refreshToken);
                NSLog(@"Wechat expiration: %@", resp.expiration);
                
                // 用户信息
                NSLog(@"Wechat name: %@", resp.name);
                NSLog(@"Wechat iconurl: %@", resp.iconurl);
                NSLog(@"Wechat gender: %@", resp.gender);
                
                // 第三方平台SDK源数据
                NSLog(@"Wechat originalResponse: %@", resp.originalResponse);
            }
        }];

关于最新版Ｕ-Share的分享和登录集成大概的内容就写完了，还有其他许多细节，希望读者帮忙补充。最后如果喜欢这篇文章的话，请帮忙点下👍。

U-Share(友盟社会化SDK 6.3.0) 分享及登录的使用

①友盟分享基本功能集成

一、下载SDK

二、注册友盟开发者账号、添加新应用、获取APPKey

三、集成U-Share v6.3.0到自己的项目中

四、U-Share SDK平台配置（iOS9+）

五、初始化U-Share及第三方平台

六、第三方平台分享

七、分享面板UI设置

八、U-Share第三方平台登录集成

猜你喜欢

热点阅读

U-Share(友盟社会化SDK 6.3.0) 分享及登录的使用

①友盟分享基本功能集成

一、下载SDK

二、注册友盟开发者账号、添加新应用、获取APPKey

三、集成U-Share v6.3.0到自己的项目中

四、U-Share SDK平台配置（iOS9+）

五、 初始化U-Share及第三方平台

六、第三方平台分享

七、分享面板UI设置

八、U-Share第三方平台登录集成

猜你喜欢

热点阅读

五、初始化U-Share及第三方平台