更新记录

1.0.0（2026-07-08）

• 首发：Android / iOS / HarmonyOS / Web / 微信小程序五端设备标识与设备信息。
• 公开 API：getDeviceId、getPlatformInfo、getDeviceInfo（各含 Sync 版本）。
• getDeviceId 返回 id / idType / osId / osType；类型 XviewUniqueIdInfo。
• Android：OAID → AndroidID → WidevineID → UUID；iOS：IDFA → IDFV → Keychain UUID；HarmonyOS：OAID → ODID → UUID。
• Web / 微信小程序：纯环境指纹（fingerprint），不依赖 Storage。
• getDeviceInfo 对齐 uni.getDeviceInfo 常用字段；getPlatformInfo 提供平台概要。
• 提供 uni-app 与 uni-app x 示例页面。

平台兼容性

uni-app(5.06)

uni-app x(5.06)

xview-device

跨平台 UTS 设备标识插件，覆盖 Android、iOS、HarmonyOS、Web、微信小程序。提供统一的 getDeviceId、getPlatformInfo、getDeviceInfo API（各含 Sync 版本），用于业务去重、设备信息展示与统计分析等场景。

支持平台与标识策略

• App 端：OAID、AndroidID、IDFV、ODID 等仅在插件内部读取，对外只暴露 id / idType / osId / osType。
• Web / 小程序：基于环境参数生成确定性环境指纹（idType / osType = fingerprint），不读写 Storage；清缓存、刷新后同环境不变。不同用户可能碰撞，环境变更后 ID 可能变化。
• IDFA / OAID 受系统版本、权限、用户授权及厂商服务影响，可能为空并走后续兜底。

公开 API

返回结构

XviewUniqueIdInfo（getDeviceId）

XviewPlatformInfo（getPlatformInfo）

XviewDeviceInfo（getDeviceInfo）

id 与 osId 的区别

• id：业务去重主入口，按各平台兜底链选取（见上表）。
• osId：OS 层主标识，不含 OAID、IDFA 等广告类标识。

典型情况：Android 上 id 为 OAID（idType=oaid），osId 为 AndroidID（osType=androidId）。主标识均不可用时，二者可能同为持久 UUID，可通过 idType / osType 区分。

使用示例

import {
  getDeviceId,
  getDeviceIdSync,
  getPlatformInfo,
  getPlatformInfoSync,
  getDeviceInfo,
  getDeviceInfoSync,
  type XviewUniqueIdInfo
} from '@/uni_modules/xview-device'

// 异步（推荐：Android / HarmonyOS 会预取 OAID）
getDeviceId((info : XviewUniqueIdInfo) => {
  console.log('业务 ID:', info.id, info.idType)
  console.log('OS 标识:', info.osId, info.osType)
})

getPlatformInfo((platform) => {
  console.log(platform.platform, platform.brand, platform.model)
})

getDeviceInfo((device) => {
  console.log(device.deviceId, device.uniPlatform)
})

// 同步
const uniqueId = getDeviceIdSync()
const platform = getPlatformInfoSync()
const device = getDeviceInfoSync()