更新记录

2.0.1（2026-05-15） 下载此版本

支持新版2.0不同安装包名，兼容模式更新，同样对过往版本向下兼容

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

2.0.0（首次发布）

支持 App 端（Android）栖岛账号授权登录 支持栖岛小程序端授权登录 App 端与小程序端统一调用接口，无需区分环境

平台兼容性

uni-app(4.64)

uni-app x

其他

QidaoLogin - UniApp 原生登录插件

栖岛登录的 UniApp 原生插件，支持 App 端（Android）和栖岛小程序端，两种环境调用方式完全一致。

目录结构

nativeplugins/QidaoLogin/
├── android/
│   └── libs/
│       └── qidao-login-sdk-2.0.0.jar   # Android 端 SDK
├── qidao-login.js                       # JS 接口（统一封装 App 和小程序两种环境）
├── package.json                         # 插件配置（插件 ID、模块注册信息）
└── README.md                            # 本文档

放到 UniApp 项目的哪里

将整个 QidaoLogin 文件夹复制到你的 UniApp 项目根目录下的 nativeplugins/ 目录中：

你的UniApp项目/
├── nativeplugins/
│   └── QidaoLogin/          ← 把这个文件夹放这里
│       ├── android/
│       │   └── libs/
│       │       └── qidao-login-sdk-2.0.0.jar
│       ├── qidao-login.js
│       └── package.json
├── pages/
├── App.vue
└── manifest.json

在 manifest.json 中注册插件

在 HBuilderX 中打开 manifest.json，切换到「App 原生插件配置」，点击「选择本地插件」，勾选 QidaoLogin。

或直接编辑 manifest.json 的 app-plus 节点：

{
  "app-plus": {
    "nativePlugins": {
      "QidaoLogin": {
        "QidaoLogin": {}
      }
    }
  }
}

注意：原生插件仅在云打包或自定义基座后生效，普通运行不会加载。

配置回调 Scheme

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

同时修改 package.json 中的 scheme，改为你自己的值：

"data": [
  {
    "scheme": "yourapp",   ← 改为你的 scheme
    "host": "callback"
  }
]

使用方式

引入

import QidaoLogin from '@/nativeplugins/QidaoLogin/qidao-login.js'

初始化（App 端必须，小程序端自动忽略）

QidaoLogin.init({
  clientId:    'your_client_id',
  redirectUri: 'yourapp://callback',
  scope:       'screen_name avatar'
})

发起登录

QidaoLogin.login({ clientId: 'your_client_id' }).then(code => {
  // 将 code 发给后端换取用户信息
}).catch(err => {
  console.error('登录失败:', err)
})

处理 App 端回调（放在 App.vue 的 onShow 中）

// App.vue
export default {
  onShow(options) {
    QidaoLogin.handleAppCallback(options)
  }
}

小程序端无需此步骤，调用 handleAppCallback 会自动忽略。

注意事项

• 插件仅支持 Android，iOS 暂不支持
• 必须云打包或使用自定义基座才能运行，普通运行无效