HarmonyOS开发实战（ Beta5版）AOT编译使用指南

AOT编译使用指南

AOT(Ahead Of Time)即预先编译，在程序运行前，预先编译成高性能机器码，让程序在首次运行就能通过执行高性能机器码获得性能收益
方舟AOT编译器实现了PGO (Profile-Guided-Optimization）编译优化，即通过结合预先profiling的运行时类型等信息和静态类型信息，预先静态地生成高性能优化机器代码。
在方舟AOT编译器中，记录预先profiling运行时类型等信息的文件称为ap(ark-profile)文件。
对性能有高要求的开发者可以使用AOT编译提升应用运行性能。

使用约束

当前仅支持Stage模型的ArkTS工程
仅支持在64位的手机设备上运行
仅支持Build Mode为release时使用，但暂不支持发布上架到应用市场时使用

前置操作

打开ap采集开关（默认关闭。设备重启后，开关恢复默认状态）

hdc shell param set ark.profile true

操作步骤

步骤一 预热应用。运行应用，并进行对应的热点操作，系统会自动在设备侧生成ap文件。
步骤二 使用hdc shell命令出发AOT编译，生成机器码文件
- 输入如下命令，待命令返回后，表示编译完成
```
hdc shell bm compile -m partial {bundleName}
```
  - 说明：以bundleName为com.example.myapplication为例，输入以下命令可触发AOT编译
```
hdc shell bm compile -m partial com.example.myapplication
```
步骤三 编译完成后，检查编译状态。只有该应用下所有module都编译成功，系统才认为该应用编译成功
- 执行以下命令，通过aotCompileStatus字段查看该应用下每个module的编译状态
  - hdc shell bm dump -n {bundleName}
    - 说明：以bundleName为com.example.myapplication为例，输入以下命令可查看该应用下每个module的编译状态
      - hdc shell bm dump -n com.example.myapplication
  - aotCompileStatus 状态说明：
    状态值意义常见场景
    0 尚未进行AOT编译没有生成ap文件，或待进行AOT编译
    1 AOT编译成功 AOT编译成功
    2 AOT编译失败 AOT编译器内部错误
步骤四 应用编译成功后，重启应用。重启后会加载优化的机器码文件。
步骤五 如不需要AOT编译模式，执行以下命令清除特定应用的AOT产物。 hdc shell bm compile -r {bundleName}
- 说明：使用过程中如出现应用闪退，界面不一致，手机功耗异常增加等不稳定情况，可按照本步骤清除AOT产物

状态值	意义	常见场景
0	尚未进行AOT编译	没有生成ap文件，或待进行AOT编译
1	AOT编译成功	AOT编译成功
2	AOT编译失败	AOT编译器内部错误

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。

为了确保高效学习，建议规划清晰的学习路线，涵盖以下关键阶段：

鸿蒙（HarmonyOS NEXT）最新学习路线