HarmonyOS 开发核心知识点总结（一）

multiton 启动模式为多实例模式，每次调用 startAbility() 方法时，都会在应用进程中创建一个新的该类型 UIAbility 实例。即在最近任务列表中可以看到有多个该类型的 UIAbility 实例。这种情况下可以将 UIAbility 配置为 multiton（多实例模式）。

specified 启动模式 specified 启动模式为指定实例模式，针对一些特殊场景使用（例如文档应用中每次新建文档希望都能新建一个文档实例，重复打开一个已保存的文档希望打开的都是同一个文档实例）。

七、HTTP 数据请求

设置请求方式 支持 GET、POST、HEAD、PUT、DELETE、TRACE、CONNECT、OPTIONS 方法，默认为 GET。

1. 创建 HttpRequest 对象 调用 createHttp() 方法，创建 HttpRequest 对象。 提醒：每一个 httpRequest 对应一个 HTTP 请求任务，不可复用。

let context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
let httpRequest = http.createHttp();

2. 订阅 HTTP 响应头事件 调用该对象的 on() 方法，订阅 HTTP 响应头事件，此接口会比 request 请求先返回。可以根据业务需要订阅此消息。

// 从 API 8 开始，使用 on('headersReceive', Callback) 替代 on('headerReceive', AsyncCallback)
httpRequest.on('headersReceive', (header) => {
  console.info('header: ' + JSON.stringify(header));
});

3. 发起 HTTP 请求，解析服务器响应事件 调用该对象的 request() 方法，传入 HTTP 请求的 url 地址和可选参数，发起网络请求，按照实际业务需要，解析返回结果。

httpRequest.request(
  "EXAMPLE_URL",
  {
    method: http.RequestMethod.POST,
    header: { 'Content-Type': 'application/json' },
    extraData: "data to send",
    expectDataType: http.HttpDataType.STRING,
    usingCache: true,
    priority: 1,
    connectTimeout: 60000,
    readTimeout: 60000,
    usingProtocol: http.HttpProtocol.HTTP1_1,
    usingProxy: false,
    caPath: '/path/to/cacert.pem',
    clientCert: {
      certPath: '/path/to/client.pem',
      keyPath: '/path/to/client.key',
      certType: http.CertType.PEM,
      keyPassword: "passwordToKey"
    },
    multiFormDataList: [
      {
        name: "Part1",
        contentType: 'text/plain',
        data: 'Example data',
        remoteFileName: 'example.txt'
      },
      {
        name: "Part2",
        contentType: 'text/plain',
        filePath: `${context.filesDir}/fileName.txt`,
        remoteFileName: 'fileName.txt'
      }
    ]
  },
  (err: BusinessError, data: http.HttpResponse) => {
    if (!err) {
      console.info('Result:' + JSON.stringify(data.result));
      console.info('code:' + JSON.stringify(data.responseCode));
      console.info('header:' + JSON.stringify(data.header));
      console.info('cookies:' + JSON.stringify(data.cookies));
      // 8+
      // 当该请求使用完毕时，调用 destroy 方法主动销毁。
      httpRequest.destroy();
    } else {
      console.error('error:' + JSON.stringify(err));
      // 取消订阅 HTTP 响应头事件。
      httpRequest.off('headersReceive');
      // 当该请求使用完毕时，调用 destroy 方法主动销毁。
      httpRequest.destroy();
    }
  }
);

八、RichEditor

参考官方文档了解富文本编辑器组件的使用。

九、安全控件通用属性

markAnchor(value: Position): T 设置安全控件在位置定位时的锚点，以控件左上角作为基准点进行偏移。

十、背景设置

backgroundBrightness(params: BackgroundBrightnessOptions): T 设置组件背景提亮效果。 BackgroundBrightnessOptions: 设置组件背景提亮效果，包括：亮度变化速率，提亮程度。

十一、多设备交互

焦点导航事件适配 使用键盘、电视遥控器、车机摇杆或旋钮等非指向性输入设备与应用程序进行间接交互时，建议将页面中可操作元素设置为可获焦状态，并配置获焦视觉效果，以保证交互体验。

获焦：组件获焦时，遵循子组件优先原则。若子组件需获焦，其所有祖先组件均需可获焦。容器组件需获焦时，其子组件应不可获焦，并配置点击事件。 部分组件默认可获焦，如 Button、TextInput 等基础组件和 Column、Row 等容器组件。若组件有获焦能力但默认不可获焦，如 Text、Image 等组件，可设置通用属性 focusable(true) 使其可获焦。 走焦：触发走焦时，系统遍历组件树中可走焦的组件。不同按键触发不同的走焦逻辑。例如，TAB 键走焦遵循 Z 字型遍历逻辑；方向键走焦遵循十字型移动逻辑。除了系统默认的走焦逻辑，开发者可以通过 tabIndex 自定义走焦逻辑。

十二、应用上下文 Context

el1 与 el2 文件之间的区别 三级目录 el1/和 el2/：代表不同文件加密类型。 el1（设备级加密区）：设备开机后可访问的数据区。 el2（用户级加密区）：设备开机后，需解锁对应用户的锁屏界面（密码、指纹、人脸等方式或无密码状态）至少一次，才能访问加密数据区。 应用若无特殊需求，应将数据存放在 EL2 加密目录下，以保障数据安全。对于需要在用户解锁前访问的文件，如时钟、闹铃、壁纸等，应将这些文件存放在设备级加密区（EL1）。

获取和修改加密分区 应用文件加密是一种保护数据安全的方法，可以使得文件在未经授权访问的情况下得到保护。在不同的场景下，应用需要不同程度的文件保护。 在实际应用中，开发者需要根据不同场景的需求选择合适的加密分区，从而保护应用数据的安全。通过合理使用不同级别的加密分区，可以有效提升应用数据的安全性。关于不同分区的权限说明，详见 ContextConstant 的 AreaMode。

• EL1：对于私有文件，如闹铃、壁纸等，应用可以将这些文件放到设备级加密分区（EL1）中，以保证在用户输入密码前就可以被访问。
• EL2：对于更敏感的文件，如个人隐私信息等，应用可以将这些文件放到更高级别的加密分区（EL2）中，以保证更高的安全性。
• EL3：对于应用中的记录步数、文件下载、音乐播放，需要在锁屏时读写和创建新文件，放在（EL3）的加密分区比较合适。
• EL4：对于用户安全信息相关的文件，锁屏时不需要读写文件、也不能创建文件，放在（EL4）的加密分区更合适。
• EL5：对于用户隐私敏感数据文件，锁屏后默认不可读写，如果锁屏后需要读写文件，则锁屏前可以调用 Access 接口申请继续读写文件，或者锁屏后也需要创建新文件且可读写，放在（EL5）的应用级加密分区更合适。

要实现获取和设置当前加密分区，可以通过读写 Context 的 area 属性来实现。

// EntryAbility.ets
import { UIAbility, contextConstant, AbilityConstant, Want } from '@kit.AbilityKit';
export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    // 存储普通信息前，切换到 EL1 设备级加密
    this.context.area = contextConstant.AreaMode.EL1;
    // 存储普通信息
    // 存储敏感信息前，切换到 EL2 用户级加密
    this.context.area = contextConstant.AreaMode.EL2;
    // 存储敏感信息
    // 存储敏感信息前，切换到 EL3 用户级加密
    this.context.area = contextConstant.AreaMode.EL3;
    // 存储敏感信息
    // 存储敏感信息前，切换到 EL4 用户级加密
    this.context.area = contextConstant.AreaMode.EL4;
    // 存储敏感信息
    // 存储敏感信息前，切换到 EL5 应用级加密
    this.context.area = contextConstant.AreaMode.EL5;
    // 存储敏感信息
  }
}

// Index.ets
import { contextConstant, common } from '@kit.AbilityKit';
@Entry @Component
struct Page_Context {
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  build() {
    Column() {
      List({ initialIndex: 0 }) {
        ListItem() {
          Row() {
            // ...
          }.onClick(() => {
            // 存储普通信息前，切换到 EL1 设备级加密
            if (this.context.area === contextConstant.AreaMode.EL2) {
              // 获取 area
              this.context.area = contextConstant.AreaMode.EL1;
              // 修改 area
              this.getUIContext().getPromptAction().showToast({ message: 'SwitchToEL1' });
            }
            // 存储普通信息
          })
        }
        ListItem() {
          Row() {
            // ...
          }.onClick(() => {
            // 存储敏感信息前，切换到 EL2 用户级加密
            if (this.context.area === contextConstant.AreaMode.EL1) {
              // 获取 area
              this.context.area = contextConstant.AreaMode.EL2;
              // 修改 area
              this.getUIContext().getPromptAction().showToast({ message: 'SwitchToEL2' });
            }
            // 存储敏感信息
          })
        }
      }
    }
  }
}

十三、image

object-fit 类型说明