跳到主要内容
版本：v7

Capacitor 中的数据存储

大多数应用需要持久化和读取本地数据。根据具体的用例，有几种方法可以采用。

需要加密你的本地数据吗？Ionic 为 Capacitor 应用提供了一套即开即用的安全套件，包括身份验证、生物识别和安全存储。了解更多。

为什么我不能只使用 LocalStorage 或 IndexedDB？​

由于 Capacitor 应用主要运行在 Web View 或浏览器中，因此 Capacitor 开发者可以使用 Web API 进行存储。但是，使用这些 API 时需要注意一些重要的注意事项。

Local Storage 可用于少量的临时数据，如用户 ID，但_必须被视为临时的_，这意味着你的应用需要预期数据最终会丢失。这是因为当设备空间不足时，操作系统会从 Web View 中回收本地存储空间。同样的情况也适用于 IndexedDB，至少在 iOS 上是这样（在 Android 上，可以使用持久化存储 API将 IndexedDB 标记为持久化）。在浏览器中阅读更多关于数据存储驱逐策略的信息。

Capacitor Preferences API​

Capacitor 自带原生 Preferences API，可避免上述驱逐问题，但仅适用于少量数据。

Preferences API 提供简单的键/值 API，没有高级查询支持：

import { Preferences } from '@capacitor/preferences';

// JSON "set" 示例
async setObject() {
  await Preferences.set({
    key: 'user',
    value: JSON.stringify({
      id: 1,
      name: 'Max'
    })
  });
}

// JSON "get" 示例
async getObject() {
  const ret = await Preferences.get({ key: 'user' });
  const user = JSON.parse(ret.value);
}

大数据或高性能存储选项​

对于存储大量数据并以高性能方式访问，有几种选择。

最广泛支持的选项是 SQLite。有一些社区维护的 SQLite 插件可以在 Capacitor 中工作，包括 capacitor-sqlite 和 cordova-plugin-sqlite。

Capacitor 团队还提供了一个企业级 SQLite 存储解决方案，具有加密支持并与设备上的安全密钥管理 API集成。

Contents

编辑此页