はじめに

インストール

AI-Assisted Setupを使用してプラグインをインストールできます。AIツールにCapgoスキルを追加するには、以下のコマンドを実行してください。

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

次のプロンプトを使用してください。

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-persistent-uuid` plugin in my project.

Manual Setupを使用する場合は、以下のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の指示に従ってください。

npm install @capgo/capacitor-persistent-uuid
npx cap sync

インポート

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

UUIDを読み取ったり作ったりする

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

const result = await PersistentUuid.getId();

console.log(result.id);
console.log(result.scope);
console.log(result.created);

最初の呼び出しでUUIDが作成され、保存されます。後続の呼び出しでは同じスコープで同じUUIDが返されます。

安定したカスタムスコープを使用する

ネイティブのデフォルトスコープは、Androidではパッケージ名、iOSではバンドル識別子です。デバッグとリリースビルドが異なるパッケージ識別子を使用している場合でも、UUIDを共有したい場合は共有スコープを渡してください。

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

UUIDをリセット

ユーザーがログアウトしたとき、プライバシーをリセットしたとき、または自動テストで新しい識別子が必要なときは、resetIdを呼び出してください。

const replacement = await PersistentUuid.resetId();
console.log(replacement.id);

持続性の期待

• Androidは、パッケージ名またはカスタムスコープが安定している場合、アンインストールと再インストールを乗り切ることができます。これには、Android StudioとPlayのインストールに異なる署名キーが含まれます。
• iOSは、キーチェーンのアクセス規則が同じである限り、アプリの更新とiOSの更新を乗り切ることができます。
• WebはlocalStorageを使用し、開発用のフォールバックのみです。

Getting Startedから続けてください

Capgoを使用している場合 はじめに 持続的なアプリケーションIDを追加するには、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuidと接続する 持続的なアプリケーションIDを追加するには、@capgo/capacitor-persistent-uuidと接続する 概要については Androidの動作 再インストールの動作 iOSの動作 キーチェーンの動作 持続的なアプリケーションIDを追加するには、@capgo/capacitor-persistent-uuidを使用する チュートリアルについては Capgo プラグインディレクトリ その他のネイティブプラグインについては