美文网首页iosios开发学习程序员
U-Share(友盟社会化SDK 6.3.0) 分享及登录的使用

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

作者: 鲸鱼座的男孩 | 来源:发表于2017-03-11 18:31 被阅读2096次

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

    ①友盟分享基本功能集成

    一、下载SDK

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

    步骤1.1-1.2 :点击U-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目录
    1. Document - U-Share SDK文档
    2. UMSocialDemo - U-Share SDK Demo(如点选下载)
    3. 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
       3.3加入依赖系统库(下面分别有微信、微博、QQ所需要的依赖系统库)
    步骤3.3加入依赖系统库 各平台所需要的依赖库

    四、U-Share SDK平台配置(iOS9+)

    4.1需要有友盟及第三方平台的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);
                }
            }];
    

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

    相关文章

      网友评论

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

        本文链接:https://www.haomeiwen.com/subject/llxzgttx.html