ガイド
__CAPGO_KEEP_0__ の永続的な UUID についてのチュートリアル
capgo/capacitor-persistent-uuid を使用して capgo に一意の永続的なアプリスコープ 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 - アプリのデバッグとプロダクション パッケージ ID が異なる場合に使用するオプションのネームスペース
- scope - Optional namespace for apps whose debug and production package identifiers differ.
例外使用
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を公開せず、ファクトリリセット、手動アカウント削除、Keychainクリア、ブラウザストレージクリア、またはresetIdを実行しても存続しません。
フルリファレンス
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- ドキュメント: /docs/plugins/persistent-uuid/
続ける
使用中の場合 @capgo/capacitor-persistent-uuid アプリの固有識別子を安定させるために、__CAPGO_KEEP_0__に接続する @capgo/capacitor-persistent-uuid 概要のため Getting Started APIのインストールと例のために Androidの動作 __CAPGO_KEEP_0__の再インストールの詳細 iOSの動作 __CAPGO_KEEP_0__のKeychainの詳細 @capgo/capacitor-persistent-account @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-account