メインコンテンツへスキップ

iOSの動作

GitHub

iOSでは、このプラグインはUUIDを汎用パスワード項目としてKeychainに保存します。この項目はデバイス限定で、デフォルトのスコープとしてbundle identifierを使用します。

これはアプリやiOSのアップデート後も保持されます。また、iOSがKeychain項目を保持し、アプリが同じbundleおよびAppleのチームルールを通じて互換性のあるKeychainアクセスを維持している限り、再インストールのフローでも保持されます。

bundle identifierが安定している場合は、デフォルトのスコープを使用してください。

const result = await PersistentUuid.getId();

複数のビルドバリアントを単一のアプリ識別子に紐付けたい場合は、カスタムスコープを使用してください。

const result = await PersistentUuid.getId({ scope: 'com.example.app' });

デバイスの消去、Keychainデータのクリア、Keychainへのアクセス権限の変更、bundle/teamのアクセス権限の変更、またはアプリがresetIdを呼び出した場合、UUIDが失われる可能性があります。

iOSの永続性を検証する場合は、このページと以下を合わせて確認してください: スタートガイド API の使用方法についてはこちら、 Androidでの動作 Androidの再インストール時の挙動についてはこちら、および @capgo/capacitor-persistent-uuid を使用する 完全なウォークスルーはこちら。