更新记录

1.0.0（2026-06-19）

无

平台兼容性

uni-app(4.76)

ulian-umverify-andro（友盟一键登录 Android）

友盟 UMVerify 智能认证 SDK 的 uni-app UTS 插件，仅支持 Android App，提供一键登录与本机号码校验能力。

插件 ID

核心能力

• 一键登录：运营商网关认证，无需短信验证码
• 本机号码校验：verifyPhone() 获取校验 token
• Promise 风格 API，Vue2 / Vue3 通用
• 内置友盟 Android SDK（uverify 4.0.2），云打包即用

快速开始

// #ifdef APP-PLUS
import umVerify from '@/uni_modules/ulian-umverify-andro/index.js';

// 用户同意隐私政策后
await umVerify.init({
  appKey: '友盟Android AppKey',
  appSecret: '认证方案秘钥',
  channel: 'Umeng'   // 可选，默认 Umeng
});
await umVerify.preLogin(3);              // 预取号（可选）
await umVerify.checkEnvironment(2);     // 检查环境
const res = await umVerify.login(30);    // 拉起授权页
console.log(res.token);                  // 提交服务端换手机号
// #endif

环境要求

• HBuilderX 3.9+，uni-app Vue2 / Vue3
• Android 5.0+（API 21）真机，蜂窝网络（关 Wi-Fi / VPN）
• 自定义调试基座 或云打包正式版（标准基座不可用）

友盟参数

AppKey 与秘钥是两个不同字段，不可混用。

系统权限与隐私

本插件涉及的 Android 权限（均无需用户弹窗授权）：

• 网络访问（INTERNET）
• 读取 / 切换网络状态（ACCESS_NETWORK_STATE、CHANGE_NETWORK_STATE）
• 读取 / 切换 Wi-Fi 状态（ACCESS_WIFI_STATE、CHANGE_WIFI_STATE）
• 读取设备标识信息

不涉及：定位、相机、相册、通讯录、麦克风等权限。

须在用户同意隐私政策后初始化 SDK。

API 一览

详细文档

完整接入步骤、Vue 示例、服务端换号、错误码与常见问题，请查看：

使用说明.md

SDK 集成（源码版）

cd uni_modules/ulian-umverify-andro/scripts
powershell -ExecutionPolicy Bypass -File .\setup-android-sdk.ps1

打包调试

1. 确认 utssdk/app-android/libs/ 下 AAR 齐全
2. 删除 unpackage/cache
3. 制作 Android 自定义调试基座 并安装到手机
4. 运行时选择「自定义调试基座」
5. 关闭 Wi-Fi / VPN，蜂窝网真机测试

更新日志

详见 changelog.md

授权与技术支持

• 试用：Android 自定义调试基座，约 7 天
• 技术支持 QQ：237672245

双端项目

若需 iOS + Android 同时接入，可：

• 分别购买 ulian-umverify-ios + ulian-umverify-andro
• 或购买合并版 ulian-umverify（一个插件 ID 双端）

许可

友盟 SDK 版权归友盟同欣（北京）科技有限公司所有，使用须遵守友盟服务条款。