ガイド
パーシステント UUIDのチュートリアル
Using @capgo/capacitor-persistent-uuid
Generate one persistent app-scoped UUID for Capacitor and keep it stable across reinstall and update flows where normal app storage is removed.
インストール
npm install @capgo/capacitor-persistent-uuid
npx cap sync
このプラグインが公開するもの
- getId - ストレージされたUUIDを読み取り、指定されたスコープの場合に1つが存在しない場合は作成します。
- resetId - ログアウト、プライバシーリセット、またはテストクリーンアップフローでストレージされたUUIDを回転します。
- scope - オプションの名前空間は、デバッグとプロダクションパッケージ識別子が異なるアプリケーションの場合に使用します。
例の使用方法
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const { id, created, scope } = await PersistentUuid.getId();
console.log(id);
console.log(created);
console.log(scope);
ビルドバリアント間で1つのUUIDを共有する
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
識別子をリセットする
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
プラットフォームの注記
Androidはパッケージ名またはカスタムスコープが安定している場合にAndroid Studioの再インストールサイクルやデバッグとPlayの署名の違いを乗り越えるためにAccountManagerにUUIDを保存します。 iOSはKeychainにUUIDを保存し、Keychainへのアクセスが互換性がある限りアプリとiOSの更新を通じて保持します。 WebはlocalStorageを開発用のフォールバックとして使用します。
このプラグインはハードウェアIDを公開せず、factory reset、手動のアカウント削除、Keychainのクリア、ブラウザのストレージのクリア、またはresetIdを乗り越えることはできません。
フルな参照
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- ドキュメント: /docs/plugins/persistent-uuid/
続ける
Capacitor Persistent UUIDプラグインを使用している場合 @capgo/capacitor-persistent-uuid アプリの固有識別子を安定させるために、__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuidと接続します。 @capgo/capacitor-persistent-uuid 概要については、 Getting Started インストールとAPIの例については、 Androidの動作 再インストールの詳細については、 iOSの動作 キーチェーンの詳細については、 @capgo/capacitor-persistent-account アプリのアカウントデータの永続化が必要な場合は、UUIDの代わりに__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-accountを使用してください。