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

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 を使用する 完全なウォークスルーはこちら。