鸿蒙Next本地存储功能如何使用

“在鸿蒙Next系统中，本地存储功能具体怎么操作？有没有详细的API文档或示例代码可以参考？比如我想实现应用数据的持久化存储，应该使用哪种存储方式比较合适？另外，鸿蒙Next的本地存储和之前的版本有什么区别吗？求大佬指点！”

2 回复

鸿蒙Next的本地存储？简单！用Preferences存键值对，DataShare跨应用共享，FileManager操作文件。记住：别把手机存爆了，不然代码会哭着说“存储空间不足”——它可不会自己清理你的猫片！

更多关于鸿蒙Next本地存储功能如何使用的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


鸿蒙Next（HarmonyOS NEXT）的本地存储功能主要通过用户首选项（Preferences） 实现，适用于存储少量键值对数据（如配置信息、用户设置）。以下是详细使用方法：

1. 导入模块

import { preferences } from '@kit.ArkData';

2. 获取 Preferences 实例

通过getPreferences()方法创建或打开存储文件：

// 指定文件名和模式（当前仅支持MODE_PRIVATE）
let context = ... // 获取UIAbility上下文（如通过UIAbilityContext）
let prefs = await preferences.getPreferences(context, 'mydata');

3. 写入数据

使用put()方法存储数据（支持string、number、boolean等类型）：

// 写入字符串
await prefs.put('key_string', 'Hello Harmony');
// 写入数字
await prefs.put('key_number', 100);
// 写入布尔值
await prefs.put('key_bool', true);

// 提交保存（异步操作）
await prefs.flush();

4. 读取数据

通过get()方法获取存储的值：

let stringValue = await prefs.get('key_string', 'default'); // 第二个参数为默认值
let numberValue = await prefs.get('key_number', 0);
let boolValue = await prefs.get('key_bool', false);

5. 删除数据

// 删除指定键
await prefs.delete('key_string');
// 清空所有数据
await prefs.clear();

6. 完整示例

import { preferences } from '@kit.ArkData';

async function example() {
  let context = ...; // 获取UIAbility上下文
  let prefs = await preferences.getPreferences(context, 'appData');

  // 存储数据
  await prefs.put('username', 'HarmonyUser');
  await prefs.put('score', 95);
  await prefs.flush();

  // 读取数据
  let name = await prefs.get('username', 'guest');
  let score = await prefs.get('score', 0);
  console.log(`用户：${name}，分数：${score}`);
}

注意事项

  • 数据以文件形式存储在应用沙箱内，其他应用无法访问。
  • 适合存储简单数据，大量数据建议使用关系型数据库（RDB）或分布式数据对象。
  • 所有操作均为异步，需使用await或Promise处理。

通过以上步骤即可快速实现鸿蒙Next的本地数据存储功能。

回到顶部