ガイド
Capacitor で Persistent UUID を使用する方法
@capgo/capacitor-persistent-uuid を使用する方法
Capacitorのための1つの永続的なアプリスコープのUUIDを生成し、正常なアプリストレージが削除された再インストールと更新フローを通じて安定させる。
インストール
npm install @capgo/capacitor-persistent-uuid
npx cap sync
このプラグインが公開するもの
- getId - 指定されたスコープの場合に存在しない場合にUUIDを生成し、保存されたUUIDを読み取る。
- resetId - ログアウト、プライバシーリセット、またはテストクリーンアップフローでUUIDをローテートする。
- スコープ - パッケージ識別子が異なるデバッグとリリースパッケージのアプリのためのオプションのネームスペース。
使用例
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では、パッケージ名またはカスタムスコープが安定している場合に、UUIDをAccountManagerに保存し、Android Studioの再インストールサイクルとデバッグとPlayの署名の差異を乗り越えることができる。iOSでは、KeychainにUUIDを保存し、Keychainへのアクセスが互換性がある限り、AppとiOSの更新を通じてUUIDを保持する。Webでは、localStorageを開発用のフォールバックとして使用する。
このプラグインはハードウェアIDを公開せず、factory reset、手動のアカウント削除、Keychainのクリアリング、ブラウザのストレージのクリアリング、またはresetIdによってUUIDを乗り越えることはない。
フルリファレンス
- GitHub: github.com/Cap-go/capacitor-persistent-uuid/
- ドキュメント: /docs/plugins/persistent-uuid/
続ける
__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuidを使用している場合 capgo/capacitor-persistent-uuidを使用してアプリの固有識別子を安定させる 概要のために接続する capgo/capacitor-persistent-uuidを使用してアプリの固有識別子を安定させる Getting Started インストールと__CAPGO_KEEP_0__の例については Capacitor Persistent UUID のインストールと API の例です。 Androidの動作 再インストールの詳細については、 iOSの動作 Keychainの詳細については、 @capgo/capacitor-persistent-account このページ