expo-qq

这是QQ开放平台，Tencent Open API的React Native封装，支持所有QQ开放平台的功能。基于TypeScript和最新的Expo Module Api实现，全类型提示支持。

安装📦

npx expo install expo-qq

配置🔧

在 app.json 中配置你的app id，这将用于自动配置安卓清单文件。同时要配置通用链接和URL Scheme等信息：

请注意，通用链接并不是在这里写了就生效的，你需要在腾讯后台注册，还需要在你的服务器的.well-known目录下添加apple-app-site-association文件，具体可以搜iOS Deep Link看看相关文档。

{
  "expo": {
    "scheme": [
      "tencent+你的腾讯QQ App ID，如tencent12345"
    ],
    "ios": {
      "associatedDomains": ["请在这里配置你的通用链接"]
    },
    "plugins": [
      [
        "expo-qq",
        {
          "appId": "你的腾讯QQ App ID"
        }
      ]
    ]
  }
}

添加了这些配置后，执行npx expo prebuild，它会自动帮你配置安卓和iOS项目。

使用📱

import { useEffect } from 'react';
import ExpoQQ from 'expo-qq';


export default function App() {
  /// 监听登录结果，你也可以使用ExpoQQ.addListener('onLoginFinished', callback)来实现，但请不要忘记移除监听
  const onLoginFinished = useEvent(ExpoQQ, 'onLoginFinished');

  /// 国内应用需要在用户接受隐私协议后再初始化
  useEffect(() => {
    const init = async () => {
      await ExpoQQ.init('appId', 'universal link')
    }

    init()
  }, [])

  /// 调用qq登陆
  const loginByQQ = async () => {
    await ExpoQQ.login(['get_user_info'])
  }
}

常见问题❓

我使用Exou Router，我的QQ跳回App后，跳到了一个404页面？

这是因为QQ会通过一个类似tencent1234567://qzapp/xxx的URL来跳到你的app，而expo router会尝试解析并跳转到/qzapp这个路由，但是很显然这个路由并不存在，所以就会显示404，

解决方案，使用Expo Router的Native Intent方案，新建app/+native-intent.tsx文件，并按照文档，拦截tencent1234567这种URL，重定向到你的登录页面即可。

联系我📞

本框架积极维护，如有任何问题，欢迎提交issue或者PR。 QQ 群：682911244。

线路图🚀

• [ ] 添加日志功能
• [ ] 完善Example

鸣谢👏

感谢pianduan-M同学为对本项目的测试和反馈作出的巨大贡献👏。