react-native-qq
v2.0.5
Published
QQ Login&Share support in React Native.
Downloads
25
Readme
react-native-qq
React Native的QQ登录插件, react-native版本需要0.33.0及以上
如何安装
首先安装npm包
npm install react-native-qq --save
安装iOS工程
将node_modules/react-native-qq/ios/RCTQQAPI.xcodeproj
加入到工程中
在工程target的Build Phases->Link Binary with Libraries
中加入libRCTQQAPI.a、libiconv.tbd、libsqlite3.tbd、libz.tbd、libc++.tbd
在 Build Settings->Search Paths->Framework Search Paths
中加入路径 $(SRCROOT)/../node_modules/react-native-qq/ios/RCTQQAPI
在 Build Settings->Link->Other Linker Flags
中加入 -framework "TencentOpenAPI"
在 Apple LLVM 7.0 - Custom Compiler Flags->Link->Other C Flags
中加入 -isystem "$(SRCROOT)/../node_modules/react-native-qq/ios/RCTQQAPI"
在工程plist文件中加入qq白名单:(ios9以上必须)
如果plist中没有 LSApplicationQueriesSchemes
项,请先添加该项,Type设置为Array。接着,在LSApplicationQueriesSchemes
中添加子项:mqqapi、mqq、mqqOpensdkSSoLogin、mqqconnect、mqqopensdkdataline、mqqopensdkgrouptribeshare、mqqopensdkfriend、mqqopensdkapi、mqqopensdkapiV2、mqqopensdkapiV3、mqzoneopensdk、wtloginmqq、wtloginmqq2、mqqwpa、mqzone、mqzonev2、mqzoneshare、wtloginqzone、mqzonewx、
mqzoneopensdkapiV2、mqzoneopensdkapi19、mqzoneopensdkapi、mqzoneopensdk、
在Info->URL Types
中增加QQ的scheme: Identifier
设置为qq
, URL Schemes
设置为你注册的QQ开发者账号中的APPID,需要加前缀tencent
,例如tencent1104903684
在你工程的AppDelegate.m
文件中添加如下代码:
#import "../Libraries/LinkingIOS/RCTLinkingManager.h"
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
return [RCTLinkingManager application:application openURL:url sourceApplication:sourceApplication annotation:annotation];
}
安装Android工程
在android/settings.gradle
里添加如下代码:
include ':react-native-qq'
project(':react-native-qq').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-qq/android')
在app/build.gradle
里添加如下代码:
compile project(':react-native-qq')
在android/app/build.gradle
里的dependencies
结构中添加如下代码:
dependencies{
... // 原本的代码
compile project(':react-native-qq')
}
在android/app/build.gradle
里,defaultConfig栏目下添加如下代码:
manifestPlaceholders = [
QQ_APPID: "<平台申请的APPID>"
]
以后如果需要修改APPID,只需要修改此一处。
android/app/src/main/java/<你的包名>/MainApplication.java
中添加如下两行:
...
import cn.reactnative.modules.qq.QQPackage; // 在public class MainApplication之前import
public class MainApplication extends Application implements ReactApplication {
private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {
@Override
protected boolean getUseDeveloperSupport() {
return BuildConfig.DEBUG;
}
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new QQPackage(), // 然后添加这一行
new MainReactPackage()
);
}
};
@Override
public ReactNativeHost getReactNativeHost() {
return mReactNativeHost;
}
}
另外,确保你的MainActivity.java中有onActivityResult
的实现:
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data){
super.onActivityResult(requestCode, resultCode, data);
mReactInstanceManager.onActivityResult(requestCode, resultCode, data);
}
如何使用
引入包
import * as QQAPI from 'react-native-qq';
API
QQAPI.login([scopes])
- scopes: 登录所申请的权限,默认为get_simple_userinfo。 需要多个权限时,以逗号分隔。
调用QQ登录,可能会跳转到QQ应用或者打开一个网页浏览器以供用户登录。在本次login返回前,所有接下来的login调用都会直接失败。
返回一个Promise
对象。成功时的回调为一个类似这样的对象:
{
"access_token": "CAF0085A2AB8FDE7903C97F4792ECBC3",
"openid": "0E00BA738F6BB55731A5BBC59746E88D"
"expires_in": "1458208143094.6"
"oauth_consumer_key": "12345"
}
QQAPI.shareToQQ(data)
分享到QQ好友,参数同QQAPI.shareToQzone,返回一个Promise
对象
QQAPI.shareToQzone(data)
分享到QZone,参数为一个object,可以有如下的形式:
// 分享图文消息
{
type: 'news',
title: 分享标题,
description: 描述,
webpageUrl: 网页地址,
imageUrl: 远程图片地址,
}
// 其余格式尚未实现。
常见问题
Android: 调用QQAPI.login()没有反应
通常出现这个原因是因为Manifest没有配置好,检查Manifest中有关Activity的配置。
Android: 已经成功激活QQ登录,但回调没有被执行
通常出现这个原因是因为MainActivity.java中缺少onActivityResult的调用。