鸿蒙应用开发应用内字体大小调节

1 数据管理概述

在移动互联网蓬勃发展的今天，移动应用给我们生活带来了极大的便利，这些便利的本质在于数据的互联互通。因此在应用的开发中数据存储占据了非常重要的位置，HarmonyOS 应用开发也不例外。

本文将为您介绍 HarmonyOS 提供的数据管理能力之一首选项。

2 什么是首选项

首选项为应用提供 Key-Value 键值型的数据存储能力，支持应用持久化轻量级数据，并对其进行增删改查等。该存储对象中的数据会被缓存在内存中，因此它可以获得更快的存取速度，下面详细介绍下首选项的开发过程。

3 首选项运作机制

首选项的特点是：

1、以 Key-Value 形式存储数据

Key 是不重复的关键字，Value 是数据值。

2、非关系型数据库

区别于关系型数据库，它不保证遵循 ACID（Atomicity, Consistency, Isolation and Durability）特性，数据之间无关系。

进程中每个文件仅存在一个 Preferences 实例，应用获取到实例后，可以从中读取数据，或者将数据存入实例中。通过调用 flush 方法可以将实例中的数据回写到文件里。

与关系数据库的区别

分类	关系型数据库	首选项
数据库类型	关系型	非关系型
使用场景	提供复杂场景下的本地数据库管理机制	对 Key-Value 结构的数据进行存取和持久化操作
存储方式	SQLite 数据库	文件
约束与限制	1. 连接池最大 4 个 2. 同一时间只支持一个写操作	1. 建议数据不超一万条 2.Key 为 string 型

4 常用接口介绍

常用接口有：保存数据（put）、获取数据（get）、是否包含指定的 key（has）、删除数据（delete）、数据持久化（flush）等，后面依次详细介绍接口使用。

常用接口使用前提

1、需要导入@ohos.data.preferences 模块到 PreferencesUtil 开发环境中，实例名字命名为 dataPreferences，同时定义两个常量 PREFERENCES_NAME 和 KEY_APP_FONT_SIZE。（注：把常用接口封装在 PreferencesUtil 工具类里面，为了方便后面代码直接调用）相关代码实现如下：

// PreferencesUtil.ets
import dataPreferences from '@ohos.data.preferences';
   ...
  const PREFERENCES_NAME = 'myPreferences'; // 首选项名字
  const KEY_APP_FONT_SIZE = 'appFontSize';  // 首选项 Key 字段

2、需要在 entryAbility 的 onCreate 方法获取首选项实例，以便后续能进行保存、读取、删除等操作，获取实例需要上下文 context 和文件名字 PREFERENCES_NAME，相关代码实现如下：

// entryAbility.ets  
  onCreate(want, launchParam) {
    Logger.info(TAG, 'onCreate');
    globalThis.abilityWant = want;
    // 创建首选项
    PreferencesUtil.createFontPreferences(this.context);
    ...
  }
// PreferencesUtil.ets  
  createFontPreferences(context) {
    globalThis.getFontPreferences = (() => {
      // 获取首选项实例
      let preferences: Promise = dataPreferences.getPreferences(context, PREFERENCES_NAME);
      return preferences;
    });
  }

保存数据（put）

1、在 entryAbility 的 onCreate 方法，调用 PreferencesUtil.saveDefaultFontSize 保存默认数据，先用 has 方法判断当前 key 是否有存在，如果没有就通过 put 方法把用户数据保存起来，该方法通过 key-value 键值对方式保存，常量 KEY_APP_FONT_SIZE 作为 key，用户数据 fontSize 作为 value，再通过 flush 方法把数据保存到文件，相关代码实现如下：

// entryAbility.ets  
  onCreate(want, launchParam) {
    Logger.info(TAG, 'onCreate');
    globalThis.abilityWant = want;
    ...
    // 设置字体默认大小
    PreferencesUtil.saveDefaultFontSize(Constants.SET_SIZE_STANDARD);
  }
// PreferencesUtil.ets    
  saveDefaultFontSize(fontSize: number) {
    globalThis.getFontPreferences().then((preferences) => {
      // 判断保存的 key 是否存在
      preferences.has(KEY_APP_FONT_SIZE).then(async (isExist) => {
        Logger.info(TAG, 'preferences has changeFontSize is ' + isExist);
        if (!isExist) {
          // 保存数据
          await preferences.put(KEY_APP_FONT_SIZE, fontSize);
          preferences.flush();
        }
      }).catch((err) => {
        Logger.error(TAG, 'Has the value failed with err: ' + err);
      });
    }).catch((err) => {
      Logger.error(TAG, 'Get the preferences failed, err: ' + err);
    });
  }

2、在 SetFontSizePage 页面，当手指移动 Slider 滑动条时，在 onChange 方法回调当前进度值，把当前进度值通过 PreferencesUtil.saveChangeFontSize 方法保存起来，再通过 flush 方法把数据保存到文件，相关代码实现如下：

// SetFontSizePage.ets
  build() {
    Row() {
      Slider({
       ...
      }).onChange((value: number) => {
          // 保存当前进度值
          PreferencesUtil.saveChangeFontSize(this.changeFontSize);
      })
    }
  }
// PreferencesUtil.ets 
  saveChangeFontSize(fontSize: number) {
    globalThis.getFontPreferences().then(async (preferences) => {
      // 保存数据
      await preferences.put(KEY_APP_FONT_SIZE, fontSize);
      preferences.flush();
    }).catch((err) => {
      Logger.error(TAG, 'put the preferences failed, err: ' + err);
    });
  }

获取数据（get）

在 HomePage 的 onPageShow 方法，调用 PreferencesUtil.getChangeFontSize 方法获取用户数据，调用 get 方法获取，该方法通过 key-value 键值对方式读取，常量 KEY_APP_FONT_SIZE 作为 key，默认数据 fontSize 作为 value，把的到的结果赋值给变量 fontSize，通过 return 方式把值返回去，相关代码实现如下：

// HomePage.ets
  onPageShow() {
    PreferencesUtil.getChangeFontSize().then((value) => {
      this.changeFontSize = value;
      Logger.info(TAG, 'Get the value of changeFontSize: ' + this.changeFontSize);
    });
  }
// PreferencesUtil.ets 
  async getChangeFontSize() {
    let fontSize: number = 0;
    const preferences = await globalThis.getFontPreferences();
    fontSize = await preferences.get(KEY_APP_FONT_SIZE, fontSize);
    return fontSize;
  }

是否包含指定的 key（has）

通过 has 方法判断首选项中是否包含指定的 key，保证指定的 key 不会被重复保存，相关代码实现如下：

// PreferencesUtil.ets    
  saveDefaultFontSize(fontSize: number) {
    globalThis.getFontPreferences().then((preferences) => {
      // 判断保存的 key 是否存在
      preferences.has(KEY_APP_FONT_SIZE).then(async (isExist) => {
        Logger.info(TAG, 'preferences has changeFontSize is ' + isExist);
      }).catch((err) => {
        Logger.error(TAG, 'Has the value failed with err: ' + err);
      });
    }).catch((err) => {
      Logger.error(TAG, 'Get the preferences failed, err: ' + err);
    });
  }

数据持久化（flush）

通过 flush 方法把应用数据保存到文件中，使得应用数据保存期限变长，相关代码实现如下：

// PreferencesUtil.ets 
  saveChangeFontSize(fontSize: number) {
    globalThis.getFontPreferences().then(async (preferences) => {
      // 保存数据
      await preferences.put(KEY_APP_FONT_SIZE, fontSize);
     // 数据持久化
      preferences.flush();
    }).catch((err) => {
      Logger.error(TAG, 'put the preferences failed, err: ' + err);
    });
  }

删除数据（delete）

删除首选项数据需要获取 preferences 实例，用 delete 方法删除指定的 key 所对应的值，常量 KEY_APP_FONT_SIZE 作为 key，通过 Promise 异步回调是否删除成功，相关代码实现如下：

// PreferencesUtil.ets 
  async deleteChangeFontSize() {
    const preferences: dataPreferences.Preferences = await globalThis.getFontPreferences();
    // 删除数据
    let deleteValue = preferences.delete(KEY_APP_FONT_SIZE);
    deleteValue.then(() => {
      Logger.info(TAG, 'Succeeded in deleting the key appFontSize.');
    }).catch((err) => {
      Logger.error(TAG, 'Failed to delete the key appFontSize. Cause: ' + err);
    });
  }