目录

实验特性

为了打造更敏捷流畅的使用体验,新版本的Hvigor带来了一系列的编译构建性能优化实验特性,这些优化特性将显著提高工程的编译速度,降低峰值内存占用等。由于部分优化方案仍处于试验性阶段,您可能在这些特性中体验到效率的提升,也可能在特定场景中遇到待完善的问题,因此,这些特性提供了开关,用户可以根据业务需求开启后使用。

优化任务增量判断

优化方案:

优化结果:减少编译时间。

开启方式:在hvigor-config.json5中添加以下字段,开启任务增量判断优化。从DevEco Studio 5.1.1 Beta1版本开始支持。

"properties": {
  "hvigor.incremental.optimization": true
}

可能影响:如果用户在自定义任务的增量输入/输出判断中引用了全局变量,在任务执行时这些变量可能会改变,如果改变,会导致下一次构建时,相关任务增量判断失效,任务重新执行。

优化任务调度

优化方案:

优化结果:减少编译时间。

开启方式:在hvigor-config.json5中添加以下字段,开启任务调度优化。从DevEco Studio 5.1.1 Beta1版本开始支持。

"properties": {
  "hvigor.task.schedule.optimization": true
}

可能影响:无影响。

文件写入磁盘

优化方案:

优化结果:减少内存占用。

开启方式:在hvigor-config.json5中添加以下字段开启。

"properties": {
  "ohos.arkCompile.singleFileEmit": true
}

可能影响:单文件解析后写入磁盘的时序被提前,可能导致用户自定义源码插桩插件在文件写入磁盘后执行,无法生效。

  • 仅在debug模式下生效。
  • 当进行代码覆盖率编译时,该字段不生效。

开启ArkTS编译时AST(抽象语法树)合一

优化方案:

优化结果:降低编译峰值内存、缩短全量编译时间。

开启方式:在hvigor-config.json5中添加以下字段开启。从26.0.0版本开始支持。

"properties": {
  "ohos.rollup.transform.useUnifiedAst": true
}

可能影响:无影响。

优化编译中间产物生成

优化方案:

优化结果:减少编译时间和内存占用。

开启方式:在hvigor-config.json5中添加以下字段开启。

"properties": {
  "ohos.arkCompile.noEmitJs": true
}

可能影响:无影响。

以下场景均不支持该字段,配置后也会生成中间态的js代码:

增量判断模块级跳过

使用场景:

从DevEco Studio 6.0.0 Beta3版本开始,如果有频繁修改代码进行增量构建的需求,可开启开关优化增量编译速度。

使用约束:

优化方案:

优化结果:减少增量构建编译时间。

开启方式:点击File > Settings(macOS为DevEco Studio > Preferences/Settings) > Build, Execution, Deployment > Build Tools > Hvigor,勾选Enable module level incremental skip for incremental build。

可能影响:不满足使用约束条件的,可能会导致开关失效或者编译问题。

通过Hvigor执行ohpm install

从DevEco Studio 6.0.0 Beta3版本开始,Hvigor增加一个开关Enable ohpm execution by hvigor,该开关有两个使用场景,具体如下。

开启方式

使用场景一

开启开关后,可通过excludeNodeByName方法排除一个不存在的模块。

  1. 按照以上方式开启开关Enable ohpm execution by hvigor。
  2. 在工程级build-profile.json5的module字段下,添加工程中不存在的模块,如testModule。

  3. 调用excludeNodeByName方法,排除不存在的模块testModule。

  4. 执行构建成功。

使用场景二

调用setDependenciesOpt、setOverrides等方法动态修改oh-package.json5中的依赖信息后,执行sync或build等操作时,DevEco Studio会执行两次ohpm install操作,开启开关后,Hvigor仅执行一次ohpm install,可提升构建的效率。

通过IClang提升C++增量编译效率

使用场景:

从DevEco Studio 6.0.1 Beta1版本开始,如果需要频繁修改某个cpp源文件,可开启IClang相关的开关,提升C++增量编译效率。IClang是一项C++函数级增量编译优化技术,详细介绍请参考毕昇编译器。

使用约束:

开启方式:

可能影响:build-profile.json5文件会纳入项目版本管理,在该文件中增加-iclang参数后,项目其他开发人员会被动开启该实验特性。因此请在充分验证功能正确性后,再通过配置文件上传到代码仓。

通过enableIncrementalSoCompress提升so文件增量编译效率

使用场景:

从DevEco Studio 6.1.0 Beta1版本开始,如果工程中包含大量so文件并开启了压缩so体积的配置开关(module.json5的compressNativeLibs或hvigor-config.json5的ohos.pack.compressLevel),可开启enableIncrementalSoCompress开关,提升增量编译效率。开启开关后,如果so文件内容未改变,构建HAP/HSP时会复用上一次构建已经压缩好的so,加快打包速度。

开启方式:

工程级build-profile.json5中,在buildOption中将enableIncrementalSoCompress参数配置为true。

"buildOption": {
  "packOptions": {
    "enableIncrementalSoCompress": true
  }
}

通过syncNative提升sync阶段C++编译效率

使用场景:

从26.0.0版本开始,如果工程中有较多Native模块且频繁sync的需求,可开启开关优化sync阶段编译速度。

优化方案:

优化结果:提升sync阶段C++编译效率。

开启方式:

可能影响:如果在hvigorfile.ts脚本的compileNative任务阶段有自定义插件或任务,开启开关后,由于compileNative任务不会被执行,会导致自定义插件或任务未执行。