Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/reactnativecn/react-native-qq


https://github.com/reactnativecn/react-native-qq

Last synced: 1 day ago
JSON representation

Awesome Lists containing this project

README 

        
# react-native-qq [![npm version](https://badge.fury.io/js/react-native-qq.svg)](http://badge.fury.io/js/react-native-qq)



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



## 如何安装



### 首先安装npm包



```bash

yarn add react-native-qq

```

或



```bash

npm install react-native-qq --save

```



然后执行



```bash

react-native link react-native-qq

```



### 安装iOS工程



在工程target的`Build Phases->Link Binary with Libraries`中加入`libRCTQQAPI.a、libiconv.tbd、libsqlite3.tbd、libz.tbd、libc++.tbd`



在 `Build Settings->Search Paths->Framework Search Paths`（如果你找不到Framework Search Paths，请注意选择Build Settings下方的All，而不是Basic） 中加入路径 `$(SRCROOT)/../node_modules/react-native-qq/ios/RCTQQAPI`



在 `Build Settings->Link->Other Linker Flags` 中加入 `-framework "TencentOpenAPI"`



在 `Apple LLVM X.X - Custom Compiler Flags->Link->Other C Flags`中加入 `-isystem "$(SRCROOT)/../node_modules/react-native-qq/ios/RCTQQAPI"`



在工程plist文件中加入qq白名单：(ios9以上必须)

请以文本方式打开Info.plist，在其中添加

```xml

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 



- (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/app/build.gradle`里，defaultConfig栏目下添加如下代码：



```

manifestPlaceholders = [

    QQ_APPID: "<平台申请的APPID>"

]

```



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



另外，确保你的MainActivity.java中有`onActivityResult`的实现：



```java

    @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`对象。成功时的回调为一个类似这样的对象：



```javascript

{

	"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，可以有如下的形式：



```javascript

// 分享图文消息

{	

	type: 'news',

	title: 分享标题,

	description: 描述,

	webpageUrl: 网页地址,

	imageUrl: 远程图片地址,

}



// 其余格式尚未实现。

```



## 常见问题



#### Android: 调用QQAPI.login()没有反应



通常出现这个原因是因为Manifest没有配置好，检查Manifest中有关Activity的配置。



#### Android: 已经成功激活QQ登录，但回调没有被执行



通常出现这个原因是因为MainActivity.java中缺少onActivityResult的调用。