runnercamp-react-native-qq

React Native的QQ登录插件, react-native版本需要0.17.0及以上

如何安装

首先安装npm包

npm install runnercamp-react-native-qq --save

安装iOS工程

将node_modules/runnercamp-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/runnercamp-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/runnercamp-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 ':runnercamp-react-native-qq'
project(':runnercamp-react-native-qq').projectDir = new File(rootProject.projectDir, '../node_modules/runnercamp-react-native-qq/android')

在app/build.gradle里添加如下代码：

compile project(':runnercamp-react-native-qq')

在android/app/build.gradle里的dependencies结构中添加如下代码：

dependencies{
    ... // 原本的代码
    compile project(':runnercamp-react-native-qq')
}

在android/app/build.gradle里，defaultConfig栏目下添加如下代码：

        manifestPlaceholders = [
            QQ_APPID: "<平台申请的APPID>"
        ]

以后如果需要修改APPID，只需要修改此一处。

android/app/src/main/java/<你的包名>/MainActivity.java中，public class MainActivity之前增加：

import cn.reactnative.modules.qq.QQPackage;

.addPackage(new MainReactPackage())之后增加：

                .addPackage(new QQPackage())

另外，确保你的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 'runnercamp-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的调用。