更新记录

2.0.0（2026-05-18） 下载此版本

兼容性升级，支持新版本，同时向下兼容过往版本

1.0.1（2025-07-17） 下载此版本

OAuth2.0 集成说明

⚠️ 重要注意事项

- 注意：这只是后端的Demo演示方便查看
+ 实际实现中应当：
  1. 将 refresh_token 刷新令牌安全存储到数据库中
  2. 用于后续刷新 access_token 访问令牌
  3. 通过有效的访问令牌获取用户受保护的信息

平台兼容性

uni-app(4.52)

其他

栖岛登录 - UniApp 示例

UniApp 集成栖岛登录的示例项目，支持 App 端（iOS / Android）和栖岛小程序端。

目录结构

Qidoa_Uniapp_小程序-APP-调用栖岛进行授权-带前后端/
├── App.vue                          # 应用入口，处理 App 端授权回调
├── main.js                          # 应用启动入口
├── manifest.json                    # UniApp 配置（scheme、原生插件等）
├── pages.json                       # 页面路由配置
├── pages/
│   └── Miniapp小程序回调示例.vue     # 登录页面
├── utils/
│   └── api.js                       # 配置文件（clientId、后端地址等）
├── nativeplugins/
│   └── QidaoLogin/                  # 栖岛原生登录插件
│       ├── android/libs/
│       │   └── qidao-login-sdk-2.0.0.jar   # Android SDK
│       ├── qidao-login.js           # 插件 JS 接口
│       └── package.json             # 插件配置
├── static/                          # 静态资源
├── Qidao_Server_ApiDemo/
│   ├── index.php                    # 后端示例（部署到服务器）
│   └── README.md                    # 后端说明
└── README.md                        # 本文档

接入步骤

第一步：配置 utils/api.js

export const QIDAO_CONFIG = {
  clientId:    'your_client_id',
  redirectUri: 'yourapp://callback',   // 与 manifest.json 中的 scheme 一致
  scope:       'screen_name avatar',
  userInfoUrl: 'https://your-server.com/index.php'  // 你部署的后端地址
}

第二步：部署后端

将 Qidao_Server_ApiDemo/index.php 部署到服务器，修改顶部配置：

$client_id     = 'your_client_id';
$client_secret = 'your_client_secret';  // 只能放在后端
$redirect_uri  = 'https://your-server.com/index.php';

第三步：配置 manifest.json

在 HBuilderX 的 manifest.json → App 常用其他设置 → Android 设置中，添加自定义 scheme，与 redirectUri 保持一致。

第四步：集成原生插件

将 nativeplugins/QidaoLogin/ 放入项目，在 manifest.json → App 原生插件配置中选择本地插件 QidaoLogin，云打包即可。

调用代码

import QidaoLogin from '@/nativeplugins/QidaoLogin/qidao-login.js'
import { QIDAO_CONFIG, fetchUserInfo } from '@/utils/api.js'

// App 端初始化（小程序端自动忽略）
QidaoLogin.init({
  clientId:    QIDAO_CONFIG.clientId,
  redirectUri: QIDAO_CONFIG.redirectUri,
  scope:       QIDAO_CONFIG.scope
})

// 发起登录
QidaoLogin.login({ clientId: QIDAO_CONFIG.clientId }).then(code => {
  fetchUserInfo(code).then(data => {
    console.log('用户信息:', data.user)
  })
})

注意事项

• 原生插件仅在打包后生效，调试需使用自定义基座
• client_secret 只能放在后端，不能出现在客户端代码中