UM分享 - 详解 - 秒客网

官网: http://dev.umeng.com

友盟现在发展的很壮大! 有熟为人知的社会化分享\统计分析\消息推送\即时通信\自动更新\多媒体服务等功能, 今天就其中第一项分享功能, 做出分解.

1. 准备工作

1.1 注册账号, 添加App, 可以得到唯一的AppKey: 比如 562795cbe0f55a6cd7006d1a;

1.2 下载最新版的SDK, 解压SDK压缩包，将形如UMSocial_Sdk_x.x.x的文件夹拖入工程目录;

　　UMSocial_Sdk_x.x.x 文件夹的目录结构

文件或文件夹	含义
libUMSocial_Sdk_x.x.x.a, libUMSocial_Sdk_Comment_3.0.a	库文件
Header	头文件
SocialSDKXib	xib文件
en.lproj，zh-Hans.lproj	英文和中文语言文件
frameworks	使用的第三方SDK，里面的Wechat 代表微信SDK

　　UMSocial_Sdk_Extra_Frameworks 文件夹的目录结构

文件或文件夹	含义
TencentOpenAPI	QQ互联SDK
Facebook	Facebook SDK
LaiWang	来往 SDK
UMSocialYiXin.framework	易信 SDK
UMSocial_ScreenShot_Sdk	截屏 SDK
UMSocial_Shake_Sdk	摇一摇 SDK

　　注意: 1.若你的工程设置了all_load,需要添加手机QQ SDK需要的系统framework:

- - Security.framework
  - libiconv.dylib
  - SystemConfiguration.framework
  - CoreGraphics.framework
  - libsqlite3.dylib
  - CoreTelephony.framework
  - libstdc++.dylib
  - libz.dylib

1.3 添加SDK后需要手动添加系统库SystemConfiguration.framework

2. 配置代码

2.1 在AppDelegate内设置友盟AppKey

#import "UMSocial.h"

……

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

{

    [UMSocialData setAppKey:@"507fcab25270157b37000010"];

}

2.2添加实现代码

打开需要集成分享功能的视图源码UIViewController.m，把如下代码复制并粘贴到你将弹出一个分享列表的位置，例如到响应分享按钮的方法中。并且修改下面的友盟appkey，你要分享的文字、图片，你要分享到的微博平台，例如下面写的是新浪微博、腾讯微博、人人网。

#import "UMSocial.h"

……

//注意：分享到微信好友、微信朋友圈、微信收藏、QQ空间、QQ好友、来往好友、来往朋友圈、易信好友、易信朋友圈、Facebook、Twitter、Instagram等平台需要参考各自的集成方法

[UMSocialSnsService presentSnsIconSheetView:self

                                     appKey:@"507fcab25270157b37000010"

                                  shareText:@"你要分享的文字"

                                 shareImage:[UIImage imageNamed:@"icon.png"]

                            shareToSnsNames:[NSArray arrayWithObjects:UMShareToSina,UMShareToTencent,UMShareToRenren,nil]

                                delegate:self];

实现回调方法（可选）:

-(void)didFinishGetUMSocialDataInViewController:(UMSocialResponseEntity *)response

{

    //根据`responseCode`得到发送结果,如果分享成功

    if(response.responseCode == UMSResponseCodeSuccess)

    {

        //得到分享到的微博平台名

        NSLog(@"share to sns name is %@",[[response.data allKeys] objectAtIndex:0]);

    }

}

形参名	含义
controller	分享列表页面所在的UIViewController对象
appKey	友盟appKey，如果你在其他地方用`UMSocialData`设置了appKey，这里也可以传nil
shareText	分享编辑页面的内嵌文字
shareImage	分享编辑页面的内嵌图片，用户可以在编辑页面中删除。如果你不需要分享图片，可以传入`nil`
shareToSnsNames	定义列表出现的微博平台字符串构成的数组，字符变量名为UMShareToSina、UMShareToTencent、UMShareToWechatSession、UMShareToWechatTimeline、UMShareToQzone、UMShareToQQ、UMShareToRenren、UMShareToDouban、UMShareToEmail、UMShareToSms、UMShareToFacebook、UMShareToTwitter，分别代表新浪微博、腾讯微博、微信好友、微信朋友圈、QQ空间、手机QQ、人人网、豆瓣、电子邮箱、短信、Facebook、Twitter
delegate	实现分享状态回调方法的对象，回调方法的实现可以参见分享详细说明的回调方法部分。如果你不需要回调的话，可以设为`nil`

注意：
1 . 集成微信和手机QQ，请参考添加QQ及Qzone
2 . 弹出横屏页面必须要先使用如下设置屏幕方向的代码，再弹出分享列表页面：
[UMSocialConfig setSupportedInterfaceOrientations:UIInterfaceOrientationMaskLandscape];

// -------------------------- -------------------------- -------------------------- -------------------------- -------------------------- --------------------------

完成以上两步, 就能实现基本的分享功能了,

(新浪微博 - UMShareToSina, 腾讯微博 - UMShareToTencent,

人人网 - UMShareToRenren, 豆瓣网 - UMShareToDouban,

邮箱 - UMShareToEmail, 短信 - UMShareToSms,UMShareToFacebook,UMShareToTwitter,)

[注意]: UMShareToFacebook,UMShareToTwitter - 预先需要登录账号, 才能完成分享.

如果需要实现分享到其他平台的功能, 需要对对应的平台专门设置.

3. 集成分享到微信

(微信好友列表 - UMShareToWechatSession, 微信朋友圈 - UMShareToWechatTimeline, 微信收藏 - UMShareToWechatFavorite)

3.1 登录微信开发者, 注册 App (https://open.weixin.qq.com)

　　注册App -- 审核成功后, 会生成 AppID , AppSecret, App Bundle Identifier;

3.2 在系统中, 添加微信SDK库文件,( UMSocial_Sdk_Extra_Frameworks目录下, Wechat文件夹) 并手动添加依赖的系统库SystemConfiguration.framework;

3.2 代码设置

　　在你的程序APPdelegate入口方法添加下面的代码

  #import "UMSocialWechatHandler.h"

    //设置微信AppId、appSecret，分享url

    [UMSocialWechatHandler setWXAppId:@"wxd930ea5d5a258f4f" appSecret:@"db426a9829e4b49a0dcac7b4162da6b6" url:@"http://www.umeng.com/social"];

- 如果不添加上面的代码，则分享列表中不会出现微信及朋友圈图标
- URL必须为http链接，如果设置为nil则默认为友盟官网链接

3.3 Scheme URL配置

　　在你的工程设置项,targets 一栏下,选中自己的 target,在 Info->URL Types 中添加 URL Schemes,添加xcode的url scheme为微信应用appId，例如“wxd9a39c7122aa6516”

3.4 添加回调

在APPdelegate中实现下面两个系统回调方法：

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url

{

 return  [UMSocialSnsService handleOpenURL:url];

}

- (BOOL)application:(UIApplication *)application

              openURL:(NSURL *)url

    sourceApplication:(NSString *)sourceApplication

           annotation:(id)annotation

 {

 return  [UMSocialSnsService handleOpenURL:url];

 }

[注意]: 如果出现 LLVM - linker command error ; 请核查库文件意义 library search path 和 header search path;

UM分享 - 详解

// ------------------ ------------------ ------------------ ------------------ ------------------ ------------------ ------------------ ------------------ ------------------

4. 分享到新浪微博

SSO授权, 在安装App的情况下, 不需要输入账号密码去申请授权.

4.1 登录网站, 创建 App (http://open.weibo.com/development/mobile), App信息参考 (http://dev.umeng.com/social/ios/operation#2_2)

　　生成: AppKey, AppSecret.

　　[注意]: 安全域名设置必须为sns.whalecloud.com ; 回调地址在App设置中与代码中设置必须一致.

4.2 添加相关库文件（使用微博原生SDK）-- 将SinaSSO文件夹添加到工程。

设置: 在other linker flags增加 "-ObjC" 选项，并添加系统支持库: ImageIO.framework

4.3 配置URL schemes（使用微博原生SDK）

　　在你的工程设置项,targets 一栏下,选中自己的 target,在 Info->URL Types 中添加 URL Schemes,格式为“wb”+新浪appkey，例如“wb126663232”

4.4 添加SSO授权开关（使用微博原生SDK）

　　在APPDelegate中集成新浪微博开关

  #import "UMSocialSinaSSOHandler.h"

  //打开新浪微博的SSO开关，设置新浪微博回调地址，这里必须要和你在新浪微博后台设置的回调地址一致。若在新浪后台设置我们的回调地址，“http://sns.whalecloud.com/sina2/callback”，这里可以传nil

  [UMSocialSinaSSOHandler openNewSinaSSOWithRedirectURL:@"http://sns.whalecloud.com/sina2/callback"];
　[注意]: 回调URL必须和后台保持一致，否则会报错redirect URL mismatch

4.5 添加系统回调（使用微博原生SDK）

　　在APPdelegate中实现下面的回调方法

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url

{

 return  [UMSocialSnsService handleOpenURL:url];

}

- (BOOL)application:(UIApplication *)application

              openURL:(NSURL *)url

    sourceApplication:(NSString *)sourceApplication

           annotation:(id)annotation

 {

 return  [UMSocialSnsService handleOpenURL:url];

 }

4.6 使用默认分享界面设置分享

使用友盟默认提供的分享面板，调用下面的代码

[UMSocialSnsService presentSnsIconSheetView:self

                                      appKey:你的友盟应用Appkey

                                   shareText:@"友盟社会化分享让您快速实现分享等社会化功能，http://umeng.com/social"

                                  shareImage:[UIImage imageNamed:@"icon.png"]

                          shareToSnsNames:@[UMShareToSina]

                                    delegate:self];

//实现回调方法（可选）：

-(void)didFinishGetUMSocialDataInViewController:(UMSocialResponseEntity *)response

{

        //根据`responseCode`得到发送结果,如果分享成功

        if(response.responseCode == UMSResponseCodeSuccess)

        {

            //得到分享到的微博平台名

            NSLog(@"share to sns name is %@",[[response.data allKeys] objectAtIndex:0]);

        }

}

// ----------------------- ----------------------- ----------------------- ----------------------- ----------------------- ----------------------- -----------------------

5. 集成 QQ / QQZone

5.1 注册应用

　　使用QQ及Qzone分享首先在腾讯开放平台注册应用，地址：http://open.qq.com 按照要求填写，审核通过前需要添加测试账号，否则会报错110406或110404

5.2 添加相关文件

　　在UMSocial_Sdk_Extra_Frameworks目录下的，添加TencentOpenAPI文件夹到工程添加下面几个系统framework　　

　　在Xcode中打开工程配置文件，选择“summary”一栏。在“summary”中选择“Linked Frameworks and Libraries”一栏，点击“+”图标添加下面八个库文件，分别是

- - Security.framework
  - libiconv.dylib
  - SystemConfiguration.framework
  - CoreGraphics.Framework
  - libsqlite3.dylib
  - CoreTelephony.framework
  - libstdc++.dylib
  - libz.dylib

5.3 添加QQ及Qzone到分享列表

　　在AppDelegate应用入口方法打开集成手机QQ、Qzone开关

//设置分享到QQ/Qzone的应用Id，和分享url 链接

#import "UMSocialQQHandler.h"

[UMSocialQQHandler setQQWithAppId:@"100424468" appKey:@"c7394704798a158208a74ab60104f0ba" url:@"http://www.umeng.com/social"];

- 如果不添加上面的代码，则分享列表中不会出现QQ及Qzone图标
- URL必须为http链接，如果设置为nil则默认为友盟官网链接

5.3 配置URL schemes

在你的工程设置项,targets 一栏下,选中自己的 target,在 Info->URL Types 中添加 URL Schemes,设置Xcode的url scheme格式为“QQ”+腾讯QQ互联应用appId转换成十六进制（不足8位前面补0），例如“QQ05FC5B14”。并在QQ互联后台的URL schema中填入此字符串保持一致。额外设置 url schemes 的格式为"tencent"+腾讯QQ互联应用appId,例如“tencent100424468”

如果 URL schemes 配置错误，则分享完成后无法返回应用

[注意]: 在Xcode 6.0创建工程时，默认可能没有单独设置Bundle display name属性值。但是因为SDK需要用到Bundle display name的值，所以务必请检查确保这个属性存在，如果没有请添加上。

5.4 添加系统回调

　　在APPdelegate中实现下面的方法

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url

{

 return  [UMSocialSnsService handleOpenURL:url];

}

- (BOOL)application:(UIApplication *)application

              openURL:(NSURL *)url

    sourceApplication:(NSString *)sourceApplication

           annotation:(id)annotation

 {

 return  [UMSocialSnsService handleOpenURL:url];

 }

5.5 设置分享内容

默认分享样式 - 使用友盟默认分UI界面，添加下面代码

    [UMSocialSnsService presentSnsIconSheetView:self

                                          appKey:你的友盟应用Appkey

                                       shareText:@"友盟社会化分享让您快速实现分享等社会化功能，www.umeng.com/social"

                                      shareImage:[UIImage imageNamed:@"icon.png"]

                                shareToSnsNames:@[UMShareToQQ,UMShareToQzone]

                                    delegate:self];

    //实现回调方法（可选）：

    -(void)didFinishGetUMSocialDataInViewController:(UMSocialResponseEntity *)response

    {

            //根据`responseCode`得到发送结果,如果分享成功

            if(response.responseCode == UMSResponseCodeSuccess)

            {

                //得到分享到的微博平台名

                NSLog(@"share to sns name is %@",[[response.data allKeys] objectAtIndex:0]);

            }

    }

[注意]: Qzone分享文字与图片缺一不可，否则会出现错误码10001

//// /////////////////////////  ----  就到这里

http://dev.umeng.com/social/ios/feature

UM分享 - 详解

1. 准备工作

2. 配置代码

3. 集成 分享到微信

4. 分享到新浪微博

相关文章

3. 集成分享到微信