Home

Awesome

ShareSDK-iOS (v3.x) for React-Native

目录

<a id="Download"></a>1、新建项目并下载 ShareSDK

<a id="init"></a> 2、初始化ShareSDK并设置社交平台

iOS 部分

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

必须添加的依赖库如下 ( Xcode 7 下 .dylib库后缀名更改为.tbd ):

libicucore.dylib
libz.dylib
libstdc++.dylib
JavaScriptCore.framework

以下依赖库根据社交平台添加:

新浪微博SDK依赖库

ImageIO.framework
libsqlite3.dylib
微信SDK依赖库 

libsqlite3.dylib
QQ好友和QQ空间SDK依赖库 

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

MessageUI.framework
Google+SDK依赖库 

CoreMotion.framework
CoreLocation.framework
MediaPlayer.framework
AssetsLibrary.framework

添加依赖库的方法如下:

img

#define IMPORT_SINA_WEIBO_LIB //导入新浪微博库,如果不需要新浪微博客户端分享可以注释此行 #define IMPORT_QZONE_QQ_LIB //导入腾讯开发平台库,如果不需要QQ空间分享、SSO或者QQ好友分享可以注释此行 #define IMPORT_RENREN_LIB //导入人人库,如果不需要人人SSO,可以注释此行 #define IMPORT_GOOGLE_PLUS_LIB //导入Google+库,如果不需要Google+分享可以注释此行 #define IMPORT_WECHAT_LIB //导入微信库,如果不需要微信分享可以注释此行 //#define IMPORT_ALIPAY_LIB //导入支付宝分享库,如果不需要支付宝分享可以注释此行 //#define IMPORT_KAKAO_LIB //导入Kakao库,如果不需要Kakao分享可以注释此行


## JS 部分

* 在 index.ios.js 文件中进行初始化操作 (确定要分享出去的平台,初始化分享平台的参数信息)
  
  a、首先导入 ShareSDK.js

var ShareSDK = require('./ShareSDK')


b、在 activePlatforms 数组中配置需要分享的平台

var activePlatforms = [ ShareSDK.PlatformType.SinaWeibo, ShareSDK.PlatformType.TencentWeibo, ShareSDK.PlatformType.Wechat, ShareSDK.PlatformType.QQ, ShareSDK.PlatformType.Twitter, ShareSDK.PlatformType.Facebook ]

c、在 TotalPlatforms 对象中添加 ShareSDK 各个平台的初始化参数,例如(新浪微博、QQ、微信、Facebook、Twitter)

  ```
  // 设置各个平台初始化
  // platforms
  var TotalPlatforms =  {
  	// key 值取自ShareSDK.PlatformType,详情可参阅
  	// 新浪微博
  	[ShareSDK.PlatformType.SinaWeibo] : {
      	app_key: '568898243',
      	app_secret: '38a4f8204cc784f81f9f0daaf31e02e3',
      	redirect_uri: 'http://www.sharesdk.cn',
      	authType: ShareSDK.AuthType.Both
  	},
  	// 腾讯微博
  	[ShareSDK.PlatformType.TencentWeibo] : {
      	app_key: '801307650',
      	app_secret: 'ae36f4ee3946e1cbb98d6965b0b2ff5c',
      	redirect_uri: 'http://www.sharesdk.cn',
      	authType: ShareSDK.AuthType.Both
  	},
  	// 微信系列 微信好友 微信朋友圈 微信收藏
  	[ShareSDK.PlatformType.Wechat] : {
      	app_id: 'wx4868b35061f87885',
      	app_secret: '64020361b8ec4c99936c0e3999a9f249',
      	authType: ShareSDK.AuthType.Both
  	},
  	// QQ系列 QQ好友 QQ空间
  	 [ShareSDK.PlatformType.QQ] : {
      	app_id: '100371282',
       	app_key: 'aed9b0303e3ed1e27bae87c33761161d',
      	authType: ShareSDK.AuthType.Both
  	}
  // Facebook
  // Twitter
  // Google plus
  // TODO 平台 app_key,app_id 参数信息表请戳:-》
  }
  ```
[以上平台的app_key、app_secret等字段不同分享平台可能不同,详情可参考](#SocialConfiguration)




  d、调用初始化方法进行初始化
  
  ```
  // 初始化方法
  ShareSDK.registerApp('iosv1001',activePlatforms,TotalPlatforms);
  
  ```


## <a id="interface"></a>3、ShareSDK接口的调用

## 分享

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

// 构造分享参数 var shareParams = { Text: '分享内容', images: '', url: 'http://www.mob.com', title: '分享标题', type: ShareSDK.ContentType.Auto }


* 2、调用分享方法,并设置回调:

// 分享,传入需要分享的平台,已经构建好的分享参数 ShareSDK.share(ShareSDK.platformType.SinaWeibo,shareParams)

// 在 react native 提供的方法componentWillMount中设置回调 componentWillMount() { ShareSDK.callBack(); }



## 授权

* 1、调用授权方法,并设置获取用户信息的回调

// 平台授权 ShareSDK.authorize(ShareSDK.platformType.SinaWeibo)

// 在 react native 提供的方法componentWillMount中设置回调 componentWillMount() { ShareSDK.callBack(); }



## <a id="SocialConfiguration"></a>各个分享平台参数配置描述
各个社交平台在初始化时 app_key、app_secret等字段不同分享平台可能不同,可参考下表进行调整。

平台                 | 通用字段           | 通用字段               |通用字段             | iOS 特需           | Android 特需  |
--------------------|------------------|-----------------------|--------------------|------------------|-----------------------|
新浪微博              | app_key          | app_secret           |redirect_uri         | auth_type        |                      |
腾讯微博              | app_key          | app_secret           |redirect_uri         | ––               |                      |
豆瓣                 | api_key          | secret               | redirect_uri        | ––               |    | 
QQ系列               | app_id           | app_key              | ––                  | auth_type        |    |
人人网               |app_id            | app_key              |secret_key           | auth_type        |    |
开心网               | api_key          | secret_key           |redirect_uri         | ––               |    |
Facebook            | api_key          | app_secret           |  ––                 | auth_type        |    |
Twitter             | consumer_key     | consumer_secret      |redirect_uri         |  ––              |    |
GooglePlus          |client_id         | client_secret        |redirect_uri         | auth_type        |    |
微信系列              | app_id          | app_secret           | ––                   |  ––             |    |
Pocket              | consumer_key     | ––                   |redirect_uri         | auth_type        |    |
Instragram          | client_id        | client_secret        |redirect_uri         |  ––              |    |
LinkedIn            | api_key          | secret_key           |redirect_uri         |  ––              |    |
Tumblr              | consumer_key     | consumer_secret      |callback_url         |  ––              |    |
Flicker             | api_key          | api_secret           | ––                  |  ––              |    |
有道                 | consumer_key     | consumer_secret      |oauth_callback       |  ––              |    |
印象笔记Evernote      | consumer_key     |consumer_secret       |––                   | ––               |    |
支付宝好友            | app_id           | ––                   | ––                  | ––               |    |
Pinterest           | client_id         | ––                   |––                   | ––               |    |
Kakao系列            | app_key          | rest_api_key         |redirect_uri         | auth_type        |     |
Dropbox             | app_key           | app_secret           |oauth_callback      |  ––              |     |
Vkontakte           | application_id    | secret_key           |––                   | ––              |     |
明道                 | app_key           | app_secret           |redirect_uri        | ––              |     |
易信                 | app_id            | app_secret           |redirect_uri        | auth_type        |     |
Instapaper           |consumer_key      | consumer_secret      |––                 |––               |    |