快速入门

安装

你可以使用我们的 AI 辅助设置来安装插件。使用以下命令将 Capgo skills 添加到你的 AI 工具中：

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

然后使用以下 prompt：

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

如果你更想手动设置，请运行以下命令安装插件，并按照下方各平台的说明操作：

bun add @capgo/capacitor-persistent-account
bunx cap sync

导入

import { CapacitorPersistentAccount } from '@capgo/capacitor-persistent-account';

快速入门

import { CapacitorPersistentAccount } from '@capgo/capacitor-persistent-account';

const result = await CapacitorPersistentAccount.readAccount();
if (result.data) {
  console.log('Account data:', result.data);
} else {
  console.log('No account data found');
}

示例：saveAccount

import { CapacitorPersistentAccount } from '@capgo/capacitor-persistent-account';

await CapacitorPersistentAccount.saveAccount({
  data: {
    userId: '12345',
    username: 'john.doe',
    email: 'john@example.com'
  }
});

常见坑点

• 原生同步：运行 bunx cap sync 在插件升级后。
• 唯一可信来源：信任 src/definitions.ts 在 GitHub 仓库中。

API 概览

readAccount

从持久化存储中读取已保存的账户数据。

获取之前通过 saveAccount() 保存的账户数据。在支持的平台上，这些数据可跨应用会话持久保存，并在重装应用后仍然保留。

import { CapacitorPersistentAccount } from '@capgo/capacitor-persistent-account';

const result = await CapacitorPersistentAccount.readAccount();
if (result.data) {
  console.log('Account data:', result.data);
} else {
  console.log('No account data found');
}

saveAccount

将账户数据保存到持久化存储中。

使用平台特定的安全存储机制存储提供的账户数据。 数据将在应用会话间持久保存，即使重新安装应用也不会丢失。 任何现有的账户数据都将被覆盖。

import { CapacitorPersistentAccount } from '@capgo/capacitor-persistent-account';

await CapacitorPersistentAccount.saveAccount({
  data: {
    userId: '12345',
    username: 'john.doe',
    email: 'john@example.com'
  }
});

单一事实来源

本页面由插件的 src/definitions.ts生成。当上游的公共 API 发生变化时，请重新运行 sync。

从入门指南继续

如果你正在使用 快速入门 要规划 dashboard 和 API 操作，请将其连接到 使用 @capgo/capacitor-persistent-account 若要在 @capgo/capacitor-persistent-account 中使用原生能力， API 概览 关于 API Overview 中的实现细节， 简介 关于 Introduction 中的实现细节， API 密钥 有关 API Keys 的实现细节，以及 设备 有关 Devices 的实现细节。