更新记录

1.0.0（2026-06-17）

• 新增 lizhao-device-id 设备唯一标识 UTS插件。
• 支持 Android / iOS / HarmonyOS 三端 App 接入，并提供 Web、微信小程序、支付宝小程序降级入口。
• 新增 getDeviceId、getDeviceIdSync、resetAppInstallId、getDeviceIdCapability。
• Android 默认使用 Settings.Secure.ANDROID_ID，并使用本地安装 ID 兜底。
• iOS 默认使用 UIDevice.current.identifierForVendor，并使用本地安装 ID 兜底。
• HarmonyOS 首版提供本地安装 ID 兜底，并预留 ODID、AAID、OAID 扩展边界。
• 明确不默认读取 IMEI、MEID、MAC、Serial、UDID 等高风险硬件标识；广告标识能力仅通过 advertising 策略返回诊断，不默认集成广告 SDK。

平台兼容性

uni-app(4.84)

uni-app x(4.84)

设备唯一标识 UTS插件

lizhao-device-id 是一个面向 uni-app / uni-app x 的设备唯一标识 UTS插件，用于在 Android、iOS、HarmonyOS 中获取可解释、可诊断、可重置边界清晰的设备标识。

功能特色

• 三端统一：Android / iOS / HarmonyOS 使用同一套 API。
• 结构化返回：不仅返回 id，还返回 source、scope、permissionStatus、resetHint、rawAvailable 等字段。
• 合规优先：默认不默认读取 IMEI、MEID、MAC、Serial、UDID 等高风险硬件标识。
• 广告标识隔离：OAID / IDFA 只在 advertising 策略中返回能力诊断，不默认集成广告 SDK。
• 可诊断：业务能清楚知道当前 ID 来自 AndroidId、IDFV、本地安装 ID，还是平台降级。

接入方式选择

最小可运行示例

import { getDeviceIdSync } from '@/uni_modules/lizhao-device-id'

// 默认 privacy 策略：优先返回平台合规作用域 ID，失败时回落本地安装 ID。
const result = getDeviceIdSync({
  strategy: 'privacy',
  includeRawId: false
})

console.log('设备标识', result.id, result.source, result.resetHint)

异步回调示例

import { getDeviceId } from '@/uni_modules/lizhao-device-id'

// 兼容 uni API 风格：success / fail / complete 均可选。
getDeviceId({
  strategy: 'stable',
  success(res) {
    console.log('获取成功', res)
  },
  fail(err) {
    console.log('获取失败', err)
  },
  complete(res) {
    console.log('获取完成', res)
  }
})

能力诊断示例

import { getDeviceIdCapability } from '@/uni_modules/lizhao-device-id'

// 用于上线前展示平台能力，也适合写入售后诊断日志。
const capability = getDeviceIdCapability()
console.log(capability.platform, capability.sources, capability.message)

API

getDeviceId(options)

说明 异步获取设备标识。

支持平台 Android / iOS / HarmonyOS / Web / 微信小程序 / 支付宝小程序

参数

返回值

getDeviceIdSync(options)

说明 同步获取设备标识。

参数

返回值

resetAppInstallId()

说明 重置插件本地安装 ID，不影响 AndroidId、IDFV、ODID、AAID、OAID、IDFA 等平台标识。

参数

返回值

getDeviceIdCapability()

说明 获取当前平台的设备标识能力矩阵。

参数

返回值

错误码

支持平台

三端策略说明

Android

• privacy / stable：优先返回 Android Settings.Secure.ANDROID_ID。
• advertising：返回 OAID 能力诊断，不默认集成 OAID SDK。
• 不默认读取 IMEI、MEID、MAC、Serial。

iOS

• privacy / stable：优先返回 UIDevice.current.identifierForVendor。
• advertising：返回 IDFA / ATT 能力诊断，不默认请求跟踪授权。
• 不使用私有 API，不读取 UDID。

HarmonyOS

• privacy / stable：首版返回插件本地安装 ID，并在结果中说明 ODID / AAID 扩展边界。
• advertising：返回 OAID 能力诊断，需业务按平台权限和 Kit 能力单独接入。
• 不伪造系统 ODID、AAID 或 OAID 成功结果。

隐私与合规说明

本插件默认不默认读取 IMEI、MEID、MAC、Serial、UDID 等高风险硬件标识。业务如需广告归因，应使用 advertising 策略作为入口，并按 Android、iOS、HarmonyOS 的隐私政策、权限授权和应用市场审核要求单独接入。

• 不默认读取 IMEI。
• 不默认读取 MEID。
• 不默认读取 MAC。
• 不默认读取 Serial。
• 不默认读取 UDID。

自定义基座说明

新增或修改 utssdk/app-android、utssdk/app-ios、utssdk/app-harmony 里的原生 UTS 逻辑后，需要重新运行对应平台原生联编或重新打对应平台自定义基座。仅同步 wgt 或 appResource 不能替换旧基座里已编译的 UTS 原生部分。

作者系列UTS插件

以下为已在 DCloud 插件市场上架的作者系列 UTS 插件，可按业务场景组合使用。未列出的插件表示当前未确认公开市场页，后续上架后再补充。