HarmonyOS开发者社区

在 HarmonyOS（API 12+）中，若你希望安全可靠地存储用户设置和偏好，可以使用 Preferences 类（相当于 Android 中的 SharedPreferences）进行本地持久化存储。以下是如何正确使用 Preferences 以及 确保在应用更新后数据不丢失的策略。

✅ 一、使用 Preferences 存储用户设置

在 HarmonyOS 中，推荐使用 Preferences（属于 data.preferences 包）进行键值对存储。支持基本类型：String、int、long、boolean、float 等。

📌 示例：写入和读取用户设置

import preferences from '@ohos.data.preferences';
import { getContext } from '@ohos.abilityAccessCtrl';

async function saveUserSettings() {
  const context = getContext(this); // Ability 或 UIAbility 上下文
  const preferencesDir = await context.getPreferencesDir();
  const pref = await preferences.getPreferences(context, preferencesDir + '/user_config');

  await pref.put('dark_mode', true);
  await pref.put('font_size', 'large');
  await pref.flush(); // 刷新提交
}

async function readUserSettings() {
  const context = getContext(this);
  const preferencesDir = await context.getPreferencesDir();
  const pref = await preferences.getPreferences(context, preferencesDir + '/user_config');

  const darkMode = await pref.get('dark_mode', false);
  const fontSize = await pref.get('font_size', 'medium');
  console.info(`Dark Mode: ${darkMode}, Font Size: ${fontSize}`);
}

🛡️ 二、确保数据在应用更新后不丢失

✅ 1. 使用默认的存储目录（沙箱路径）

用户数据默认保存在应用沙箱内的 preferences 目录，如：

/data/storage/el2/base/haps/entry/files/preferences/

HarmonyOS 在应用更新（如 HAP 升级）时不会清除这些目录，因此使用该路径的数据会被保留。

⚠️ 避免使用 /cache 或 /temp 目录，这些目录可能在系统回收空间时被清除。

✅ 2. 避免不必要的清除操作

• 不要在 onStart()、onInitialize() 等生命周期函数中误删整个 Preferences 文件或目录。

• 不建议使用 clear() 除非明确用户需要重置设置。

✅ 3. 使用稳定的 Key 和文件名

• 确保 Preference 文件名不随版本或模块变动而变化。

• 对于设置项的 key（如 'font_size'），避免使用硬编码字符串，建议统一用常量管理。

const PREF_KEYS = {
  FONT_SIZE: 'font_size',
  DARK_MODE: 'dark_mode',
};

✅ 4. 可选：备份机制

若对数据持久性有更高要求，可在重要设置更改时进行：

• 云同步（如果账号体系支持）

• 写入备份文件（如 JSON）至 files/ 目录

• 导出到外部持久化存储（需权限）

📌 总结：存储用户偏好的推荐做法

如你需要在多个模块或页面中统一管理这些设置，也可以封装一个设置管理类 SettingsManager，集中读写配置项。需要我帮你写个这类管理类示例代码吗？