更新记录

1.0.2（2026-08-20）

• 修复 iOS 云打包 load_transformed failed：恢复 index.uts 对 DeviceBridge.swift 的显式 import，确保混编 Swift 源码被云端编译器正确解析。

1.0.1（2026-08-12）

• 新增 register(options?)，隐私同意后显式预取；Vue 侧须 { success } 对象形式；getter 不再自动 register。
• 五端统一用 getDeviceId().id 作业务唯一标识；Web/MP：id 完整指纹、osId 精简指纹、deviceId Storage UUID。
• Web 新增 StorageBridge；微信小程序新增 DeviceBridge；移除 uni.* 依赖。
• App 端修复 register 回调、OAID Maven 仓库与 3s 超时；Harmony ArkTS 混编与 OAID 兜底；iOS 混编 import 修复。
• 过滤无效标识（全零 UUID 等）；补全设备信息字段；更新示例与文档。

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 跨平台设备唯一标识获取、OAID、IDFV、ODID

跨平台 UTS 设备标识插件，覆盖 Android、iOS、HarmonyOS、Web、微信小程序。

提供统一的 register、getDeviceId、getPlatformInfo、getDeviceInfo API（各含 Sync 版本），适用于业务去重、设备信息展示与统计分析。

安装

将 uni_modules/xview-device 放入项目后，App 端需制作自定义调试基座（UTS 原生插件不会打进默认基座）。

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

核心概念

五端业务统一使用 getDeviceId().id 作为唯一标识。

各平台标识策略

公开 API

register 参数

type XviewRegisterOptions = {
  success?: () => void   // 注册完成后回调（推荐）
  complete?: () => void  // 与 success 等价
}

重要：

• uni-app Vue 侧请使用 register({ success: () => {} })，不要 register(() => {})，否则 App 端回调可能不触发。
• register() 不会在 getDeviceId 等 getter 内部自动调用，需业务在隐私同意后显式调用。

返回结构

XviewUniqueIdInfo

XviewPlatformInfo

XviewDeviceInfo

推荐调用流程

// 1. 用户同意隐私政策
register({
  success: () => {
    // 2. 读取业务唯一标识
    getDeviceId((info: XviewUniqueIdInfo) => {
      console.log('唯一标识:', info.id, info.idType)
      console.log('OS 标识:', info.osId, info.osType)
    })
  }
})

同步读取：

const info = getDeviceIdSync()
const platform = getPlatformInfoSync()
const device = getDeviceInfoSync()