帮助与文档

> >

注意→_→目前ShareSDK for iOS有2个大版本:ShareSDK v3.x(新版)和ShareSKD v2.x(旧版),本教程是ShareSDK v3.x适用的集成文档。若需要ShareSDK v2.x,请参考旧版文档:网页链接

一、新建项目并下载ShareSDK

(1)Cocos2d-x项目环境搭建,不会的童鞋自行面壁哈->网页链接

(2)下载ShareSDK

ShareSDK iOS版本的 Cocos2d-x 插件是在ShareSDK iOS版本基础上对接口做个C++接口的封装,是依赖ShareSDK for iOS的。所以下载ShareSDK就包含了以下2部分,下载下来的文件目录截图如下:

3C796C2E-BC64-43EA-8284-6E9581ACAD92

  • 将以上红色方框的资源文件拖到新建的Cocos2d-x项目中。

二、初始化ShareSDK并设置社交平台

(1)iOS 部分

    1)下载的ShareSDK文件拖进项目

AA479B4D-9595-47E2-B55D-8731A9413CDB

8873DC19-F990-4577-83DF-AE4A36107C24

注意:请务必在上述步骤中选择“Create groups for any added folders”单选按钮组。如果你选择“Create folder references for any added folders”,一个蓝色的文件夹引用将被添加到项目并且将无法找到它的资源。

    2)添加必须的依赖库

必须添加的依赖库如下(Xcode 7 下 *.dylib库后缀名更改为*.tbd):
  • libicucore.dylib
  • libz.dylib
  • libstdc++.dylib
  • JavaScriptCore.framework
以下依赖库根据社交平台添加:
新浪微博SDK依赖库

  • ImageIO.framework
  • AdSupport.framework
  • libsqlite3.dylib
QQ好友和QQ空间SDK依赖库

  • libsqlite3.dylib
微信SDK依赖库

  • libsqlite3.dylib
短信和邮件需要依赖库

  • MessageUI.framework
Google+SDK依赖库

  • CoreMotion.framework
  • CoreLocation.framework
  • MediaPlayer.framework
  • AssetsLibrary.framework
  • AddressBook.framework

添加依赖库的方法如下:

233D16A0-E241-4D4B-ACF2-4C03259F995A

    3)各个社交平台需要的配置(url schemes 等)可以参考文档中的可选配置项:网页链接

(2)Cocos2d-x 部分

    1)选择需要的平台SDK和Cocos2d-x环境

打开 C2DXShareSDK / iOS / C2DXiOSShareSDK.mm ,按需注释掉已导入的原生SDK库,ShareSDK的 Support /PlatformSDK 也可以删除相应的不需要的第三方SDK。

打开 C2DXShareSDK / C2DXShareSDKTypeDef.h ,按需选择要使用的 Cocos2d-x的版本(切换适配Cocos2d-x 2.x 或者 3.x 版本)

    2)修改 AppDelegate 文件,进行初始化

a 、打开 “AppDelegate.cpp”文件,导入头文件

b 、在 AppDelegate::applicationDidFinishLaunching() 函数中添加 ShareSDK 各个平台的初始化函数,例如(新浪微博、QQ、微信、Facebook、Twitter)

另外在项目工程的Info.plist 中如图增加 MOBAppKey 和 MOBAppSecret 两个字段

在 MOBAppKey中 设置ShareSDK的appKey,如果尚未在ShareSDK官网注册过App,请移步到登录后台进行应用注册  也可以点击链接看里面的操作步骤。
57660F69-641E-4C23-933A-4045ABDE9B25

 

以上平台的app_key、app_secret等字段不同分享平台可能不同,详情可参考:《统一表》。

 三、ShareSDK接口的调用

(1)分享

    1)在需要分享操作的代码块中进行构造分享参数,示例如下:

构造分享内容字段参数值请参考:《分享内容字段值表》

    2)调用分享方法:

    3)设置分享回调方法 shareContentResultHandler,示例如下:

(2)授权

    1)调用授权方法:

    2)设置获取用户数据回调 getUserResultHandler,代码如下:

注意:例如微信,QQ这些必须要依赖客户端的平台必须要配置URL Scheme,可以参照原生集成文档,可选部分微信,QQ等配置URL Scheme部分,另外ios9+之后需要跳客户端的平台都需要配置白名单,请参考ios9+适配文档

 

0 0