更新记录

1.0.1（2025-07-01）

添加 toast 方法

1.0.0（2025-07-01）

v1.0.0 (2025-07-01) 新增功能:

平台兼容性

uni-app(4.24)

uni-app x(4.24)

native-device

UniApp UTS 原生设备信息插件，用于获取设备唯一标识符。

功能特性

• 🆔 获取设备唯一标识符 (Device ID)
• 📱 支持 Android 和 iOS 双平台
• 🔐 Android 端提供多重标识符生成策略，确保唯一性
• ⚡ 轻量级，无外部依赖

平台支持

安装使用

1. 导入插件

import { getDeviceId } from '@/uni_modules/native-device'

2. 调用方法

// 获取设备ID
const result = getDeviceId()
console.log(result.key)    // "deviceId"
console.log(result.value)  // 设备唯一标识符字符串

API 文档

getDeviceId()

获取设备唯一标识符

返回值类型: DeviceResult

type DeviceResult = {
  key: string,      // 固定返回 "deviceId"
  value: string | null  // 设备唯一标识符，获取失败时为 null
}

实现原理

Android 端

1. 优先使用 Settings.Secure.ANDROID_ID 作为设备标识
2. 如果 ANDROID_ID 为空或为默认值 "9774d56d682e549c"，则生成自定义唯一ID
3. 自定义ID基于设备硬件信息（BOARD、BRAND、CPU_ABI等）和序列号生成UUID

iOS 端

使用 DCloud UTS Foundation 提供的 UTSiOS.getDeviceId() 方法获取设备标识

技术规格

• 最低 Android SDK: 21 (Android 5.0)
• 最低 iOS 版本: 12.0
• 开发框架: UTS (TypeScript for UniApp)
• 插件类型: 原生API插件

开发文档

• UTS 语法
• UTS API插件
• Hello UTS

版本历史

• v1.0.0: 初始版本，支持 Android 和 iOS 设备ID获取