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

JS 开发者方便的集成ShareSDK分享和授权功能。
ShareSDK for android 集成文档网页链接

目录

Getting started
Notice
- 各个分享平台参数配置描述
- 构造分享内容字段参数值

1、新建项目并下载 ShareSDK

1、React-Native 项目环境搭建，不会的童鞋自行面壁哈: 网页链接.
2、ShareSDK iOS版本的 RN 插件是在ShareSDK iOS版本基础上对原生模块的接口做导出供给JS端使用，是依赖ShareSDK for iOS的。所以下载本示例DEMO就包含了以下2部分，下载下来的文件目录截图如下：

（1）ShareSDK iOS 版本的下载：网页链接

（2）React-Native 插件的下载: ：网页链接（包含demo，需要的是ShareSDKManager.h / ShareSDKManager.m / ShareSDK.js）
将以上文件ShareSDKManager.h / ShareSDKManager.m / ShareSDK 拖到新建的 RN 项目中的 ios 目录下，将 ShareSDK.js 拖入 RN 项目中。
注意：Sources(导入文件）就是集成所需要的所有文件

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

iOS 部分

1、下载的 ShareSDK 文件夹拖拽进项目

注意：请务必在上述步骤中选择“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
libsqlite3.dylib

微信SDK依赖库 

libsqlite3.dylib

QQ好友和QQ空间SDK依赖库 

libsqlite3.dylib

短信和邮件需要依赖库 

MessageUI.framework

Google＋SDK依赖库 

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

添加依赖库的方法如下:

3、各个社交平台需要的配置（url schemes 等）可以参考文档中的可选配置项：网页链接
附录：iOS 9 配置文档请戳－》网页链接
4、选择需要的平台SDK

打开 ShareSDKManager.m ，按需注释掉已导入的原生SDK库 (不需要的平台SDK也可以做删除处理)

#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      |––                 |––               |    |

Code4Bull/RNShareSDK

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages