更新记录

1.0.1（2025-05-19）

【更新】新增 Android 端 UUID 获取方案，统一两端代码，移除 iOS 设置 UUID 功能。

1.0.0（2025-05-15）

ph-keychain 是一个基于 UTS 实现的 iOS Keychain 插件，可用于在 iOS App 中安全地读写设备唯一标识（UUID）等敏感信息。

平台兼容性

uni-app

uni-app x

ph-uuid 插件使用说明

ph-uuid 是一个基于 UTS 实现的原生插件，用于在 App 中安全地获取设备唯一标识（UUID）。

• 在 iOS 平台通过 Keychain 实现持久化
• 在 Android 平台通过组合设备信息生成唯一标识，实现卸载重装后保持一致

🧩 插件功能

📲 支持平台

• ✅ App（iOS 10+）
• ✅ App（Android 5.0+）
• ❌ 小程序 / H5（不支持）

🔧 使用方式

import { getUUID } from '@/uni_modules/ph-keychain'

const uuid = getUUID()
console.log('设备 UUID:', uuid)

插件内部会自动生成并保存 UUID，无需手动写入。

🔐 安全说明

• iOS：使用原生 Keychain 存储，具备系统级加密与沙箱隔离；
• Android：通过组合 androidId、设备 serial 号和 pseudoId 生成唯一标识，确保卸载重装后保持一致；
• 插件 完全离线，不联网、不上传任何数据；
• UUID 可在卸载后保留（除非用户手动清除存储或设备信息发生变化）。

❓常见问题

Q: 安卓支持吗？如何生成 UUID？

A: 支持。安卓端通过组合 androidId、设备 serial 号和 pseudoId 生成设备唯一标识，保证唯一且稳定。

Q: 需要自己生成和保存 UUID 吗？

A: 不需要。插件自动判断并在首次调用时生成 UUID，后续调用自动读取。

Q: UUID 会不会丢失？

A: 正常情况下不会。iOS 使用 Keychain，Android 依赖设备信息生成，卸载后仍可保持，除非用户重置设备或清除数据。