react-native-wechat-lib

React-Native-Wechat-Lib

本库为 react-native 项目提供 Wechat SDK 支持

[React Native] bridging library that integrates WeChat SDKs:

• Android SDK 6.8.20
• iOS SDK 2.0

路线图

• 3.0.x
  • React native 70
  • Android SDK 6.8.20
  • iOS SDK 2.0
  • iOS SDK 2.0 No payment function
  • Example
• 1.1.x
  • React native 60
  • Android SDK 5.5.6
  • iOS SDK 1.8.7.1
  • iOS SDK 1.8.7.1 No payment function

注意

如果你的 IOS 应用需要使用不带支付功能的 WeChat SDK，请使用带有 “-notpay” 后缀的 NPM 包。

目前最新代码版本为 3.0.x，但 NPM Last 版本暂时只到 1.1.26，因为 3.0.x 暂时还处于开发阶段，有小部分功能未经过测试。

如果你需要使用 3.0.x 版本，请在 package.json 中加上版本号 [email protected]，切换前请你清楚了解该版本的风险，该版本为开发版。

我会尽快推出 3.0.x 发行版。

附言

本库由 little-snow-fox 发起。

希望各位大佬积极提交 PR，单靠我一个人维护工作量大。

目录

• 安装
• 起步
• API 文档

安装

NPM 安装

npm install react-native-wechat-lib --save
# 3.0.x 使用3.0.4
npm install [email protected] --save

# 3.0.0 开始弃用
react-native link react-native-wechat-lib

源码安装

git clone https://github.com/little-snow-fox/react-native-wechat-lib
cd react-native-wechat-lib
npm link
cd ../my-project
npm link react-native-wechat-lib

源码安装指定版本

git clone https://github.com/little-snow-fox/react-native-wechat-lib
cd react-native-wechat-lib
git checkout 1.1.x
npm link
cd ../my-project
npm link react-native-wechat-lib

起步

• iOS 安装
• Android 安装
• 样例工程

API 文档

本库支持 TypeScript，使用 Promise 或 async/await 来接收返回。

接口名称和参数尽量跟腾讯官网保持一致性，除了嵌套对象变成扁平对象，你可以直接查看腾讯文档来获得更多帮助。

registerApp(appid) 注册

• appid {String} the appid you get from WeChat dashboard
• returns {Boolean} explains if your application is registered done

This method should be called once globally.

import * as WeChat from 'react-native-wechat-lib';

WeChat.registerApp('appid', 'universalLink');

isWXAppInstalled() 判断微信是否已安装

• returns {Boolean} if WeChat is installed.

Check if the WeChat app is installed on the device.

isWXAppSupportApi() 检查支持情况

• returns {Boolean} Contains the result.

Check if wechat support open url.

getApiVersion() 获取 API 版本号

• returns {String} Contains the result.

Get the WeChat SDK api version.

openWXApp() 打开微信

• returns {Boolean}

Open the WeChat app from your application.

sendAuthRequest([scope[, state]]) 微信授权登录

• scope {Array|String} Scopes of auth request.
• state {String} the state of OAuth2
• returns {Object}

Send authentication request, and it returns an object with the following fields:

authByScan([scope, nonceStr, onQRGet]) 微信扫码授权登录

• appId {String} the appId you get from WeChat dashboard
• appSecret {String} the appSecret you get from WeChat dashboard
• onQRGet (String) => void

调用 authByScan 后，需要监听二维码的获取，展示完二维码，用户扫码登录完成后才会回调 callback，字段如下

示例如下

const ret = await WeChat.authByScan(WeiXinId, WeiXinSecret, (qrcode) => {
  console.log(qrcode)
  // 拿到 qrcode 用 Image 去渲染
});  
console.log('登录信息', ret);

如有不懂，可以查看微信官方文档

ShareText(ShareTextMetadata) 分享文本

ShareTextMetadata

Return:

import * as WeChat from 'react-native-wechat-lib';

WeChat.shareText({
  text: 'Text content.',
  scene: 0,
});

ShareImage(ShareImageMetadata) 分享图片

ShareImageMetadata

Return:

import * as WeChat from 'react-native-wechat-lib';

WeChat.shareImage({
  imageUrl: 'https://google.com/1.jpg',
  scene: 0,
});

ShareLocalImage(ShareImageMetadata) 分享本地图片

ShareImageMetadata

Return:

ShareFile(ShareFileMetadata) 分享文件

ShareFileMetadata

Return:

安卓实现分享本地文件需要对工程进行一些配置，详见 Android 安装

import * as WeChat from 'react-native-wechat-lib';

WeChat.shareFile({
  imageUrl: 'https://sdcard/test.png',
  title: '测试文件.pdf',
  scene: 0,
});

ShareMusic(ShareMusicMetadata) 分享音乐

ShareMusicMetadata

Return:

import * as WeChat from 'react-native-wechat-lib';

WeChat.shareMusic({
  title: 'Good music.',
  musicUrl: 'https://google.com/music.mp3',
  thumbImageUrl: 'https://google.com/1.jpg',
  scene: 0,
});

ShareVideo(ShareVideoMetadata) 分享视频

ShareVideoMetadata

Return:

import * as WeChat from 'react-native-wechat-lib';

WeChat.shareVideo({
  title: 'Interesting video.',
  videoUrl: 'https://google.com/music.mp3',
  thumbImageUrl: 'https://google.com/1.jpg',
  scene: 0,
});

ShareWebpage (ShareWebpageMetadata) 分享网页

ShareWebpageMetadata

Return:

import * as WeChat from 'react-native-wechat-lib';

WeChat.shareWebpage({
  title: 'Interesting web.',
  videoUrl: 'https://google.com/music.mp3',
  thumbImageUrl: 'https://google.com/1.jpg',
  scene: 0,
});

ShareMiniProgram(ShareMiniProgramMetadata) 分享小程序

ShareMiniProgram

Return:

import * as WeChat from 'react-native-wechat-lib';

WeChat.shareMiniProgram({
  title: 'Mini program.',
  userName: 'gh_d39d10000000',
  webpageUrl: 'https://google.com/show.html',
  thumbImageUrl: 'https://google.com/1.jpg',
  scene: 0,
});

LaunchMiniProgram (LaunchMiniProgramMetadata) 跳到小程序

LaunchMiniProgramMetadata