更新记录

1.0.0（2025-05-15） 下载此版本

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

平台兼容性

ph-keychain 插件使用说明

ph-keychain 是一个基于 UTS 实现的 iOS 原生插件，用于在 iOS App 中安全地读写设备唯一标识（UUID），通过 Keychain 实现持久化。

🧩 插件功能

📲 支持平台

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

🔧 使用方式

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

let uuid = getUUID()
if (!uuid) {
    uuid = 'uuid-' + Date.now()
    setUUID(uuid)
}
console.log('设备 UUID:', uuid)

📁 接口定义（TypeScript）

/**
 * 获取存储的 UUID
 * @returns UUID 字符串或 null
 */
declare function getUUID(): string | null

/**
 * 写入 UUID 到 Keychain
 * @param uuid 要保存的 UUID 字符串
 * @returns 是否保存成功
 */
declare function setUUID(uuid: string): boolean

🔐 安全说明

• 使用 iOS 原生 Keychain 进行存储；
• 数据具备系统级加密和应用沙箱隔离；
• 插件不联网、不上传任何信息，完全离线运行；
• Keychain 中的数据在卸载重装后可保留。

❓常见问题

Q: 安卓支持吗？

A: 当前版本仅支持 iOS。

Q: UUID 会不会丢失？

A: 只要用户未手动清除 Keychain，UUID 会一直存在，卸载应用也不会丢失。