shareSDK集成

share sdk

 

Connection

  

包含所有分享平台框架（framework）。可以根据自己的需要删除不需要集成的平台。

DouBanConnection.framework

豆瓣分享平台框架

FacebookConnection.framework     

Facebook分享平台框架。

InstapaperConnection.framework

Instapaper分享平台框架。

InstapaperResource.bundle

Instapaper资源包

KaiXinConnection.framework

开心网分享平台框架。

MailConnection.framework

邮件分享框架。

PrintConnection.framework

打印分享框架。

QQConnection.framework

QQ好友分享框架

QZoneConnection.framework

QQ空间分享平台框架。

RenRenConnection.framework

人人网分享框架。

SinaWeiboConnection.framework

新浪微博分享框架

SMSConnection.framework

短信分享框架。

SohuConnection.framework

搜狐分享框架，用于搜狐随身看。

SohuWeiboConnection.framework

搜狐微博分享框架

T163WeiboConnection.framework

网易微博分享框架

TencentWeiboConnection.framework

腾讯微博分享框架

TwitterConnection.framework

Twitter分享框架

WeChatConnection.framework

微信分享框架

YouDaoNoteConnection.framework

有道云笔记分享框架

PocketConnection.framework

Pocket分享框架

EverNoteConnection.framework

印象笔记分享框架

Core

SDK核心框架目录，包括了SDK的核心服务。所有的Connection必须依赖此目录中的框架（framework）。

AGCommon.framework

通用工具类框架。

en.lproj/ShareSDKLocalizable.strings

本地化资源文件。

Resource.bundle

通用资源包

ShareSDKCoreService.framework

SDK核心服务包

Extend

外部SDK目录，用于存在第三方SDK，目前包括微信和QQ好友分享两个平台的SDK。如果不需要集成这两个平台可以删除掉此目录。

TencentOpenAPI.framework

QQ空间SSO授权以及QQ好友分享框架。QQConnection.framework和QZoneConnection.framework的SSO功能需要依赖此库进行分享。

SDKExport

微信SDK开发包。WeChatConnection.framework需要依赖此库进行分享。

TencentOpenApi_IOS_Bundle.bundle

TencentOpenApi框架所要使用的资源包。

TencentWeiboSSO

腾讯微博的SSO开发包。TencentWeiboConnection.framework需要依赖此库进行SSO登陆。

ShareSDK.framework

SDK的快捷分享框架，此框架提供了一组实用功能接口，使用此框架可以进行快速集成。

UI

SDK的内置UI框架目录。尚未使用的UI框架及其资源包可以删除。

ShareSDKiPadDefaultShareViewUI.bundle

iPad版默认分享视图资源包。

ShareSDKiPadDefaultShareViewUI.framework

iPad版默认分享视图框架。

ShareSDKiPadSimpleShareViewUI.bundle

iPad版简单分享视图资源包。

ShareSDKiPadSimpleShareViewUI.framework

iPad版简单分享视图框架。

ShareSDKiPhoneAppRecommendShareViewUI.framework

iPhone版应用推荐视图框架。

ShareSDKiPhoneDefaultShareViewUI.bundle

iPhone版默认分享视图资源包。

ShareSDKiPhoneDefaultShareViewUI.framework

iPhone版默认分享视图框架。

ShareSDKiPhoneSimpleShareViewUI.bundle

iPhone版简单分享视图资源包

ShareSDKiPhoneSimpleShareViewUI.framework

iPhone版简单分享视图框架。

1. 导入shareSDK

将ShareSDK文件夹到项目文件夹中夹并拖入项目中。

2. 添加依赖框架(Framework)

打开项目设置中的Build Phases页，在“LinkBinary With Libraries”一栏中，点击左下角的“＋”号；在弹出窗口里面分别以下库加入到项目中：

      SystemConfiguration.framework

      QuartzCore.framework

      MessageUI.framework (如果不集成邮件和短信可以不添加)

      libicucore.dylib

      libz.1.2.5.dylib

      libstdc++.dylib (如果不需要QQ空间SSO登录可以不添加)

      libsqlite3.dylib  (如果不需要QQ空间SSO登录可以不添加)

         CoreTelephony.framework          (如果不需要QQ空间SSO登录可以不添加)

3. 导入头文件ShareSDK.h并初始化社交平台的App信息。

     打开*AppDelegate.m(*代表你的工程名字)
 导入文件头ShareSDK.h：

?

1

#import <ShareSDK/ShareSDK.h>

     在- (BOOL)application:didFinishLaunchingWithOptions:方法中添加如下语句对SDK进行初始化并为各个分享平台的应用信息进行设置，

初始化SDK使用的appKey（调用registerApp方法）在ShareSDK官网中可以注册申请，建议为每个应用申请一个appKey，如果多个应用用同一个key会导致不同应用的统计数据混合在一起。

     应用相关信息需要到各个平台进行注册申请（申请地址见文档附录），如果不需要使用到的平台可以不进行设置：    

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

- (void)initializePlat

{

    //添加新浪微博应用

    [ShareSDK connectSinaWeiboWithAppKey:@"3201194191"

                   appSecret:@"0334252914651e8f76bad63337b3b78f"

                   redirectUri:@"http://appgo.cn"];

 

    //添加腾讯微博应用

    [ShareSDK connectTencentWeiboWithAppKey:@"801307650"

                   appSecret:@"ae36f4ee3946e1cbb98d6965b0b2ff5c"

                   redirectUri:@"http://www.sharesdk.cn"];

 

    //添加QQ空间应用

    [ShareSDK connectQZoneWithAppKey:@"100371282"

                   appSecret:@"aed9b0303e3ed1e27bae87c33761161d"];

 

    //添加网易微博应用

    [ShareSDK connect163WeiboWithAppKey:@"T5EI7BXe13vfyDuy"

                   appSecret:@"gZxwyNOvjFYpxwwlnuizHRRtBRZ2lV1j"

                   redirectUri:@"http://www.shareSDK.cn"];

 

    //添加搜狐微博应用

    [ShareSDK connectSohuWeiboWithConsumerKey:@"SAfmTG1blxZY3HztESWx"

                   consumerSecret:@"yfTZf)!rVwh*3dqQuVJVsUL37!F)!yS9S!Orcsij"

                   redirectUri:@"http://www.sharesdk.cn"];  

 

    //添加豆瓣应用

    [ShareSDK connectDoubanWithAppKey:@"07d08fbfc1210e931771af3f43632bb9"

                   appSecret:@"e32896161e72be91"

                   redirectUri:@"http://dev.kumoway.com/braininference/infos.php"];

 

    //添加人人网应用

    [ShareSDK connectRenRenWithAppKey:@"fc5b8aed373c4c27a05b712acba0f8c3"

                   appSecret:@"f29df781abdd4f49beca5a2194676ca4"];

 

    //添加开心网应用

    [ShareSDK connectKaiXinWithAppKey:@"358443394194887cee81ff5890870c7c"

                   appSecret:@"da32179d859c016169f66d90b6db2a23"

                   redirectUri:@"http://www.sharesdk.cn/"];

 

    //添加Instapaper应用

    [ShareSDK connectInstapaperWithAppKey:@"4rDJORmcOcSAZL1YpqGHRI605xUvrLbOhkJ07yO0wWrYrc61FA"

                   appSecret:@"GNr1GespOQbrm8nvd7rlUsyRQsIo3boIbMguAl9gfpdL0aKZWe"];

 

    //添加有道云笔记应用

    [ShareSDK connectYouDaoNoteWithConsumerKey:@"dcde25dca105bcc36884ed4534dab940"

                   consumerSecret:@"d98217b4020e7f1874263795f44838fe"

                   redirectUri:@"http://www.sharesdk.cn/"];

 

    //添加Facebook应用

    [ShareSDK connectFacebookWithAppKey:@"107704292745179"

                   appSecret:@"38053202e1a5fe26c80c753071f0b573"];

     

    //添加Twitter应用

    [ShareSDK connectTwitterWithConsumerKey:@"mnTGqtXk0TYMXYTN7qUxg"

                   consumerSecret:@"ROkFqr8c3m1HXqS3rm3TJ0WkAJuwBOSaWhPbZ9Ojuc"

                   redirectUri:@"http://www.sharesdk.cn"];

 

    //添加搜狐随身看应用

    [ShareSDK connectSohuKanWithAppKey:@"e16680a815134504b746c86e08a19db0"

                   appSecret:@"b8eec53707c3976efc91614dd16ef81c"

                   redirectUri:@"http://sharesdk.cn"];

     

    //添加Pocket应用

    [ShareSDK connectPocketWithConsumerKey:@"11496-de7c8c5eb25b2c9fcdc2b627"

                   redirectUri:@"pocketapp1234"];

     

    //添加印象笔记应用

    [ShareSDK connectEvernoteWithType:SSEverNoteTypeSandbox

                   consumerKey:@"sharesdk-7807"

                   consumerSecret:@"d05bf86993836004"];

}

 

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

{

     [ShareSDK registerApp:@"520520test"];

     [selfinitializePlat];

     

     ⋯⋯

     returnYES;

}

4. 为keyWindow设置rootViewController属性

      请确认didFinishLaunchingWithOptions方法中是否有设置window对象的rootViewController属性。否则会导致无法弹出授权界面或者分享界面点击后无反映，卡死现象等。

      设置类似于下面代码所示：

?

01

02

03

04

05

06

07

08

09

10

11

12

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

{

      ⋯⋯

 

      self.window = [[[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]] autorelease];

      self.viewController = [[[UINavigationController alloc] init] autorelease];

     

      self.window.rootViewController = self.viewController;

      [self.window makeKeyAndVisible];

 

      returnYES;

}

注：如果您创建应用时使用storyBoard可以省略此步骤，系统以自动为您设置了rootViewController。

5. 加入handleOpenURL处理方法

      在使用SSO授权方式（即跳转到相应客户端进行授权的方式）或者集成微信、QQ好友分享时，需要在处理请求URL的委托方法中加入ShareSDK的处理方法（没有以上说明情况可省略此步骤），在*AppDelegate.m(*代表你的工程名字)文件中加入如下方法：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

- (BOOL)application:(UIApplication *)application

       handleOpenURL:(NSURL*)url

{

    return[ShareSDK handleOpenURL:url

                             wxDelegate:self];

}

   

   

- (BOOL)application:(UIApplication *)application

          openURL:(NSURL*)url

          sourceApplication:(NSString *)sourceApplication

          annotation:(id)annotation

{

    return[ShareSDK handleOpenURL:url

                   sourceApplication:sourceApplication

                   annotation:annotation

                   wxDelegate:self];

}

6. 添加微信社交平台（不需要微信分享可略过此步骤）

      登录微信开放平台（http://open.weixin.qq.com/）注册应用并取得应用的AppID，然后打开工程中的*AppDelegate.m(*代表你的工程名字)
文件，导入微信SDK的头文件：

?

1

#import "WXApi.h"

      在-application: didFinishLaunchingWithOptions: 方法内添加如下语句：    

?

1

2

3

//添加微信应用

[ShareSDK connectWeChatWithAppId:@"wx6dd7a9b94f3dd72a"

                            wechatCls:[WXApiclass]];

      打开*-Info.plist（*代表你的工程名字）。找到URL types配置项（如果没有则新增），展开URL types – URL Schemes，在URLSchemes下分别各新增一项用于微信的Scheme（如果不添加则会导致法返回应用）。将申请的appId填入此配置项中。如图所示：

 注：必须执行步骤5中的操作。

7. 添加QQ社交平台（不需要QQ好友分享可略过此步骤）

      登录手机QQ开发者平台（http://mobile.qq.com/api/）注册成为开发者，并登记应用取得APPID，然后打开工程中的*AppDelegate.m(*代表你的工程名字)
文件，导入QQSDK的头文件：

?

1

#import <QQApi/QQApi.h>

     注：如果你使用QQ空间SSO授权方式，那么不能引入以上头文件，否则会导致名称空间冲突。应修改为导入以下头文件：

?

1

#import <TencentOpenAPI/QQApi.h>

在- (BOOL)application:didFinishLaunchingWithOptions:方法内添加如下语句：

?

1

2

//添加QQ应用

[ShareSDK connectQQWithAppId:@"QQ0F0A941E"qqApiCls:[QQApiclass]];

      打开*-Info.plist（*代表你的工程名字）。找到URL types配置项（如果没有则新增），展开URL types – URL Schemes，在URLSchemes下分别各新增一项用于QQ的Scheme（如果不添加则会导致法返回应用）。将申请的appId填入此配置项中。如图所示：

注：必须执行步骤5中的操作。

8. 配置SSO授权（没有使用SSO授权可略过此步骤）

      注：在执行该步骤时必须完成步骤5中的操作。

8.1新浪微博  

      打开*-Info.plist（*代表你的工程名字）。找到URLtypes配置项（如果没有则新增），展开URL types – URL Schemes，在URL Schemes下分别各新增一项用于新浪微博的Scheme（如果不添加则会导致法返回应用）。其填写格式为：sinaweibosso.2279784657，后面的数字为你在新浪微博申请的AppKey。如图所示：

9．分享内容

     在分享内容部分ShareSDK提供了三种接口来满足不同需求的分享功能实现。

9.1 菜单方式分享：

         使用此方式进行分享会首先弹出菜单供用户选择分享的目标平台，然后再显示内容编辑界面供用户进行分享内容编辑，最后进行分享。调用该方式的接口如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

NSString*imagePath =  [[NSBundlemainBundle] pathForResource:@"ShareSDK"

                                                                  ofType:@"jpg"];

//构造分享内容

id<ISSContent> publishContent = [ShareSDK content:@"分享内容"

                                          defaultContent:@"默认分享内容，没内容时显示"

                                          image:[ShareSDK imageWithPath:imagePath]

                                          title:@"ShareSDK"

                                          url:@"http://www.sharesdk.cn"

                                          description:@"这是一条测试信息"

                                          mediaType:SSPublishContentMediaTypeNews];

   

[ShareSDK showShareActionSheet:nil

                      shareList:nil

                      content:publishContent

                      statusBarTips:YES

                      authOptions:nil

                      shareOptions:nil

                      result:^(ShareType type, SSPublishContentState state, id<ISSStatusInfo> statusInfo, id<ICMErrorInfo> error, BOOLend) {

                                if(state == SSPublishContentStateSuccess)

                                {

                                    NSLog(@"分享成功");

                                }

                                elseif(state == SSPublishContentStateFail)

                                {

                                    NSLog(@"分享失败,错误码:%d,错误描述:%@", [error errorCode],  [error errorDescription]);

                                }

                            }];

       以上代码中主要使用[ShareSDKshowShareActionSheet: shareList: content: statusBarTips: authOptions: shareOptions:esult]方法进行分享。

      第一个参数用于指定菜单显示在哪个视图控制器上。如果指定为nil，则表示使用显示在最顶层的UIViewController对象。（注：如果需要适配iPad版本，需要调用container对象中的相关方法设置iPad容器，否则无法在iPad中正常显示。）

      第二个参数则用于指定菜单弹出的分享平台列表，传入nil则表示显示所有分享平台，如果开发者需要自己定制显示列表则通过此参数进行控制。ShareSDK提供了getShareListWithType方法来进行分享列表的构造。

      第三个参数为实现了ISSContent协议的对象，需要调用了ShareSDK的+ (id<ISSContent>)content: defaultContent:image: title: url: description: mediaType:;方法来构造对象。（注：id<ISSContent>对象提供了对部分平台，如：微信、QQ、QQ空间、邮件、短信、有道云笔记、Instapaper平台的内容定制，通过定制可以针对不同的平台发送不同的内容。详细请参考Demo程序）

      第四个参数为是否在状态栏上显示提示信息（包括成功和错误提示）。

      第五个参数用于指定在分享过程中，需要授权时的一些信息配置。如：是否需要自动弹出授权界面然后授权、授权时是否回调服务器以及授权视图的委托等。需要说明的是在设置是否需要自动授权标志为NO时，则SDK对于需要授权的状态不会弹出授权界面，需要用户自行处理。

      第六个参数用于指定分享时的一些信息配置。如：分享视图标题、一键分享列表的定制、微信、QQ分享按钮的隐藏以及分享视图委托等。

      第七个参数用于处理分享返回后续的处理方法。返回方法中包括了分享状态、分享成功后的状态信息（StatusInfo）、分享失败时的错误信息、以及本次分享会话是否结束标识。

9.2 分享内容视图方式

       使用此方式直接弹出内容分享编辑框，用户编辑完内容后点击发布直接分享出去。其调用代码如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

//创建分享内容

    NSString*imagePath = [[NSBundlemainBundle] pathForResource:@"image"ofType:@"jpg"];

   

    id<ISSContent> publishContent = [ShareSDK content:@"content"

                                       defaultContent:@""

                                       image:[ShareSDK imageWithPath:imagePath]

                                       title:nil

                                       url:nil

                                       description:nil

                                       mediaType:SSPublishContentMediaTypeText];

  

    //创建弹出菜单容器

    id<ISSContainer> container = [ShareSDK container];

    [container setIPadContainerWithView:sender

                             arrowDirect:UIPopoverArrowDirectionUp];

   

    //显示分享菜单

    [ShareSDK showShareViewWithType:ShareTypeSinaWeibo

                      container:container

                      content:publishContent

                      statusBarTips:YES

                      authOptions:nil

                      shareOptions:nil

                      result:^(ShareType type, SSPublishContentState state, id<ISSStatusInfo> statusInfo, id<ICMErrorInfo> error, BOOLend) {

                                 if(state == SSPublishContentStateSuccess)

                                 {

                                     NSLog(@"发表成功");

                                 }

                                 elseif(state == SSPublishContentStateFail)

                                 {

                                     NSLog(@"发布失败!error code == %d, error code == %@", [error errorCode], [error errorDescription]);

                                 }

                             }];

    

       以上代码主要使用主要使用[ShareSDKshowShareViewWithType: container:  content:statusBarTips: authOptions: shareOptions: result:]方法进行分享。

       第一个参数为分享的目标平台类型。其他参数与菜单方式中的content参数含义相同。其显示效果如上面编辑分享内容视图截图。

9.3 直接分享方式

       此方式不需要通过任何分享界面直接发送到指定的平台。其提供了两种不同的方法来满足不同的功能，第一种分享到单个平台，调用代码如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

//创建分享内容

NSString*imagePath = [[NSBundlemainBundle] pathForResource:@"image"ofType:@"jpg"];

   

id<ISSContent> publishContent = [ShareSDK content:@"content"

                                       defaultContent:@""

                                       image:[ShareSDK imageWithPath:imagePath]

                                       title:nil

                                       url:nil

                                       description:nil

                                       mediaType:SSPublishContentMediaTypeText];

   

[ShareSDK shareContent:publishContent

                      type:ShareTypeSinaWeibo

                      authOptions:nil

                      statusBarTips:YES

                      result:^(ShareType type, SSPublishContentState state, id<ISSStatusInfo> statusInfo, id<ICMErrorInfo> error, BOOLend) {

              if(state == SSPublishContentStateSuccess)

              {

                       NSLog(@"分享成功");

              }

              elseif(state == SSPublishContentStateFail)

              {

                       NSLog(@"分享失败,错误码:%d,错误描述:%@", [error errorCode],  [error errorDescription]);

              }

         }];

         以上代码中主要使用[ShareSDKshareContent: type: authOptions: statusBarTips: result:]方法进行分享。其参数说明与上面带分享界面的功能接口参数说明相同。

         另外一种方法就是可以通过传入多个平台类型来进行一键分享信息。其调用代码如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

//创建分享内容

NSString*imagePath =  [[NSBundlemainBundle] pathForResource:@"image"ofType:@"jpg"];

   

    id<ISSContent>  publishContent = [ShareSDK content:@"content"

                                         defaultContent:@""

                                         image:[ShareSDK imageWithPath:imagePath]

                                         title:nil

                                         url:nil

                                         description:nil

                                         mediaType:SSPublishContentMediaTypeText];

   

    [ShareSDK oneKeyShareContent:publishContent

                    shareList:[NSArray defaultOneKeyShareList]

                    authOptions:nil

                    statusBarTips:nil

                    result:^(ShareType type, SSPublishContentState state, id<ISSStatusInfo> statusInfo, id<ICMErrorInfo>  error, BOOLend) {

                              if(state ==  SSPublishContentStateSuccess)

                              {

                                  NSLog(@"分享成功");

                              }

                              elseif(state ==  SSPublishContentStateFail)

                              {

                                  NSLog(@"分享失败,错误码:%d,错误描述:%@", [error errorCode],  [error errorDescription]);

                              }

                          }];

         

      以上代码主要使用[ShareSDKoneKeyShareContent: shareList: authOptions: statusBarTips: result:]方法进行分享，其中shareList参数表示需要将内容分享到的目标平台类型列表，[NSArraydefaultOneKeyShareList表示分享到所有支持一键分享的平台中。其余参数与其他分享接口意义相同。

9.4 定制分享

         对于需要定义分享视图的样式、标题以及部分属性（如控制默认分享视图中的QQ、微信分享按钮显示）或者调整分享视图时，可以在各个分享接口的shareOptions参数中进行设定。如：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

//创建分享内容

NSString*imagePath =  [[NSBundlemainBundle] pathForResource:@"image"ofType:@"jpg"];[/size]

[size=4]

id<ISSContent>  publishContent = [ShareSDK content:@"content"

                                       defaultContent:@""

                                       image:[ShareSDK imageWithPath:imagePath]

                                       title:nil

                                       url:nil

                                       description:nil

                                       mediaType:SSPublishContentMediaTypeText];

   

//创建分享选项

id<ISSShareOptions> shareOptions =

       [ShareSDK defaultShareOptionsWithTitle:@"内容分享"

                          oneKeyShareList:[NSArraydefaultOneKeyShareList]

                          qqButtonHidden:YES

                          wxSessionButtonHidden:YES

                          wxTimelineButtonHidden:YES

                          showKeyboardOnAppear:NO

                          shareViewDelegate:nil

                          friendsViewDelegate:nil

                          picViewerViewDelegate:nil];

   

//弹出分享菜单

[ShareSDK showShareActionSheet:nil

                     shareList:nil

                     content:publishContent

                     statusBarTips:YES

                     authOptions:nil

                     shareOptions:shareOptions

                     result:^(ShareType type, SSPublishContentState state, id<ISSStatusInfo> statusInfo, id<ICMErrorInfo> error, BOOLend) {

                                if(state == SSPublishContentStateSuccess)

                                {

                                    NSLog(@"分享成功");

                                }

                                elseif(state == SSPublishContentStateFail)

                                {

                                    NSLog(@"分享失败,错误码:%d,错误描述:%@", [error errorCode],  [error errorDescription]);

                                }

                            }];

         ShareSDK提供了三种构造ShareOptions对象的方法，分别对应默认、简单以及应用推荐三种分享视图样式，其分别是：

+ defaultShareOptionsWithTitle: oneKeyShareList:qqButtonHidden: wxSessionButtonHidden: wxTimelineButtonHidden: showKeyboardOnAppear:shareViewDelegate: friendsViewDelegate: picViewerViewDelegate:;

+ simpleShareOptionsWithTitle: shareViewDelegate:;

+ appRecommendShareOptionsWithTile: shareViewDelegate:;

         title参数表示了设置分享视图的标题，oneKeyShareList参数控制一键分享列表的显示（在默认分享视图底部显示的平台列表），qqButtonHidden、wxSessionButtonHidden、wxTimelineButtonHidden则分别是控制默认分享视图下的QQ、微信好友、微信朋友圈按钮的显示。showKeyboardOnAppear参数控制分享视图显示时是否弹出键盘。shareViewDelegate参数表示分享视图委托，friendsViewDelegate参数表示好友列表视图委托。picViewerViewDelegate参数表示照片查看视图委托。

9.5 定制属于自己的分享UI

         结合+ shareContent: type: authOptions: statusBarTips: result:;和+ authWithType: options: result:;以及+ hasAuthorizedWithType:;方法来打造属于自己的分享UI。下面代码使用简单的UITextView和UIButton来搭建简单的新浪微博分享界面。代码如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

- (void)viewDidLoad

{

    [superviewDidLoad];[/size]

[size=4]

    _contentTextView = [[UITextView alloc] initWithFrame:CGRectMake(0.0, 0.0, 320.0, 200.0)];

    [self.view addSubview:_contentTextView];

    [_contentTextView release];

   

    UIButton *sendButton =  [UIButton buttonWithType:UIButtonTypeRoundedRect];

    sendButton.frame = CGRectMake(0.0, 205.0, 100.0, 45.0);

    [sendButton setTitle:@"分享"forState:UIControlStateNormal];

    [sendButton addTarget:self

                   action:@selector(sendButtonClickHandler:)

                   forControlEvents:UIControlEventTouchUpInside];

    [self.view addSubview:sendButton];

}[/size]

[size=4]

- (void)sendButtonClickHandler:(id)sender

{

    if([ShareSDK hasAuthorizedWithType:ShareTypeSinaWeibo])

    {

        //构造分享内容

        id<ISSContent> publishContent =

        [ShareSDK content:_contentTextView.text

                        defaultContent:nil

                        image:nil

                        title:nil

                        url:nil

                        description:nil

                        mediaType:SSPublishContentMediaTypeNews];

   

        [ShareSDK shareContent:publishContent

                         type:ShareTypeSinaWeibo

                         authOptions:nil

                         statusBarTips:YES

                         result:^(ShareType type, SSPublishContentState state, id<ISSStatusInfo> statusInfo, id<ICMErrorInfo> error, BOOLend) {

                   if(state == SSPublishContentStateSuccess)

                   {

                            NSLog(@"分享成功");

                   }

                   elseif(state == SSPublishContentStateFail)

                   {

                            NSLog(@"分享失败,错误码:%d,错误描述:%@", [error errorCode],  [error errorDescription]);

                   }

            }];

    }

    else

    {

      [ShareSDK authWithType:ShareTypeSinaWeibo

                    authOptions:nil

                    result:^(SSAuthState state, id<ICMErrorInfo> error) {

                            if(state == SSPublishContentStateSuccess)

                            {

                                  //构造分享内容

                                  id<ISSContent> publishContent = [ShareSDK content:_contentTextView.text

                                                                                                defaultContent:nil[/size]

                                                                                                                                                [size=4]image:nil

                                                                                                title:nil

                                                                                                url:nil

                                                                                                description:nil

                                                                                                mediaType:SSPublishContentMediaTypeNews];

   

                                  [ShareSDK shareContent:publishContent

                                                             type:ShareTypeSinaWeibo

                                                             authOptions:nil

                                                             statusBarTips:YES

                                                             result:^(ShareType type, SSPublishContentState state, id<ISSStatusInfo> statusInfo, id<ICMErrorInfo> error, BOOLend) {

                                                if(state == SSPublishContentStateSuccess)

                                                {

                                                          NSLog(@"分享成功");

                                                 }

                                                elseif(state == SSPublishContentStateFail)

                                                {

                                                          NSLog(@"分享失败,错误码:%d,错误描述:%@", [error errorCode],  [error errorDescription]);

                                                 }

                                  }];

                          }

              }];

     }

}

         
9.6  iPad版本分享界面集成

         如果需要在iPad中显示分享，则需要使用+container;功能接口创建一个容器对象并调用容器对象的setIPhoneContainer系列方法来设置iPad版显示容器。其实现代码如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

//创建弹出菜单容器

id<ISSContainer> container = [ShareSDK container];

[container setIPadContainerWithView:sender

                                  arrowDirect:UIPopoverArrowDirectionUp];

//弹出分享菜单

[ShareSDK showShareActionSheet:container

                         shareList:nil

                         content:publishContent

                         statusBarTips:YES

                         authOptions:authOptions

                         shareOptions:shareOptions

                         result:^(ShareType type, SSPublishContentState state, id<ISSStatusInfo> statusInfo, id<ICMErrorInfo> error, BOOLend) {

                                if(state == SSPublishContentStateSuccess)

                                {

                                    NSLog(@"分享成功");

                                }

                                elseif(state == SSPublishContentStateFail)

                                {

                                    NSLog(@"分享失败,错误码:%d,错误描述:%@", [error errorCode],  [error errorDescription]);

                                }

                            }];

10. 激活／禁止SSO登录。

         用于控制平台是否使用SSO登录方式进行登录（目前只支持新浪微博、Facebook），如下代码禁止SSO登录：

?

1

[ShareSDK ssoEnabled:_ssoEnable];

         
11. 获取当前用户信息

         获取当前授权用户信息，其调用方式如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

[ShareSDK getUserInfoWithType:ShareTypeSinaWeibo

                authOptions:nil

                result:^(BOOLresult,id<ISSUserInfo> userInfo, id<ICMErrorInfo> error) {

                               if(result)

                               {

                                   NSLog(@"成功");

                               }

                               else

                               {

                                   NSLog(@"失败");

                               }

                         }];

         

         其中第一个参数为平台类型，用于指定获取哪个平台的授权用户信息。如果指定平台的用户尚未进行授权则弹出授权界面。第二个参数为授权选项参数。第三个参数为授权返回的处理方法。

12. 关注用户

         关注指定用户（此接口目前仅支持新浪微博和腾讯微博），其调用方式如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

//关注用户

[ShareSDK followUserWithType:ShareTypeSinaWeibo

                   field:@"ShareSDK"

                   fieldType:SSUserFieldTypeTypeName

                   authOptions:nil

                   viewDelegate:nil

                   result:^(SSResponseState state, id<ISSUserInfo> userInfo, id<ICMErrorInfo> error) {

                                  NSString*msg = nil;

                                  if(state == SSResponseStateSuccess)

                                  {

                                      NSLog(@"关注成功");

                                  }

                                  elseif(state == SSResponseStateFail)

                                  {

                                      NSLog(@"%@", [NSStringstringWithFormat:@"关注失败:%@", error.errorDescription]);

                                  }

                              }];

         

         其中第一个参数为关注用户所属平台类型，第二个参数为关注用户的昵称或者用户ID（具体指示昵称还是用户ID由第三个参数控制），第三个参数为标识第二个参数的字段类型）。第四个参数为授权选项配置，第五个参数为视图委托，主要用于Facebook关注时弹出的添加好友界面的委托。

13. 获取关注列表

         获取当前授权用户的关注列表（此接口目前仅支持新浪微博、腾讯微博、Facebook、Twitter），其调用方式如下：

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

id<ISSPage> page = [ShareSDK pageWithPageNo:1 pageSize:0];

[ShareSDK getFriendsWithType:ShareTypeSinaWeibo

                          page:page

                          authOptions:nil

                          result:^(BOOLresult,NSArray*users,id<ISSPage> currPage, id<ISSPage> prevPage, id<ISSPage> nextPage, BOOLhasNext,id<ICMErrorInfo> error) {

                                  if(result)

                                  {

                                     NSLog(@"成功");

                                  }

                                  else

                                  {

                                      NSLog(@"失败");

                                  }                  

                          }];

         

         其中第一个参数为平台类型，用于指定获取哪个平台的授权用户关注列表，如果指定平台的用户尚未进行授权则弹出授权界面。第二个参数为取关注列表的分页对象，用于指定要获取那一页的好友列表数据；ShareSDK中提供了两种构造分页对象的方法+ pageWithCursor:;和+ pageWithPageNo: pageSize:;。第三个参数为授权选项设置，第四个参数为关注列表返回的处理方法。

14. 用户授权

         要想操作相关平台提供的方法必须要先取得用户授权。ShareSDK提供了单独的授权接口来实现用户的登录授权。其代码如下：

?

01

02

03

04

05

06

07

08

09

10

[ShareSDK authWithType:ShareTypeSinaWeibo  options:nilresult:^(SSAuthState state, id<ICMErrorInfo> error) {

         if(state == SSAuthStateSuccess)

         {

             NSLog(@"成功");

         }

         elseif(state == SSAuthStateFail)

         {

             NSLog(@"失败");

         }

}];

         

         第一个参数为需要进行授权的平台类型。第二个参数为授权选项设置，如果需要定制授权视图的样式需要指定此参数。第三个参数则是授权返回结果的处理方法。需要注意的是ShareSDK中提供的各种需要进行授权的接口（包括分享、获取用户信息等）都已经在内部进行授权检测判断，不需要开发者单独进行授权。