HarmonyOS Next DevEco Studio 构建任务指南

3.1 Hook

• assembleHap: 编译构建 hap 模块的 Hook 任务。
• assembleHsp: 编译构建 hsp 模块的 Hook 任务。
• assembleHar: 编译构建 har 模块的 Hook 任务。
• assembleApp: 编译构建 app 模块的 Hook 任务。
• assembleDevHqf: 支持增量部署的 Hook 任务。
• HotReloadBuild: HotReloadArkTS 前置 Hook 任务。
• PreviewBuild: PreviewArkTS 前置 Hook 任务。
• buildHotReloadResource: 热加载资源相关前置 Hook 任务。
• PreviewHookCompileResource: 预览时资源编译处理是否支持 Restool 增量方式编译的 Hook 任务。
• GenerateBuildProfile: 生成 BuildProfile.ets 文件的 Hook 任务。
• BuildUnitTestHook: 单元测试编译资源相关前置 Hook 任务。
• buildPreviewerResource: 预览资源相关前置 Hook 任务。
• compileNative: native 资源相关前置 Hook 任务。
• UnitTestBuild: UnitTestArkTS 前置 Hook 任务。
• test: 使用命令行执行 Local Test 的 Hook 任务。
• onDeviceTest: 使用命令行执行 Instrument Test 的 Hook 任务。

3.2 ArkTS

• CompileArkTS/BuildArkTS: 调用 loader 编译 ArkTS 源码。
• PreviewArkTS: 预览模式下，调用 loader 编译 ArkTS 源码。
• HotReloadArkTS: 热加载场景下，调用 loader 编译 ArkTS 源码。
• OhosTestCompileArkTS/OhosTestBuildArkTS: ohos 测试场景下，调用 loader 编译 ArkTS 源码。
• HarCompileArkTS/HarBuildArkTS: 构建 HAR 包场景下，调用 loader 编译 ArkTS 源码。
• UnitTestArkTS: 单元测试场景下，调用 loader 编译 ArkTS 源码。

3.3 JS

• CompileJS/BuildJS: 调用 loader 编译 js 源码。
• OhosTestCompileJS/OhosTestCompileJS: ohos 测试场景下，调用 loader 编译 js 源码。

3.4 Resources

• ProcessResource: 处理和生成用文件方式编译资源的中间文件。
• PreviewProcessResource: 预览场景下，处理和生成用文件方式编译资源的中间文件。
• CompileResource: 调用 restool 编译资源。
• PreviewCompileResource: 预览场景下，调用 restool 编译资源。
• ProcessLibs: 收集 hap 和 har 依赖中的.so 文件。

3.5 Package

• PackageHap: 调用打包工具打 hap 包。
• PackageHar: 调用打包工具打 har 包。
• PackageHsp: 调用打包工具打 hsp 包。
• PackageApp: 调用打包工具打 app 包。
• PackageHqf: 调用打包工具打增量包。
• PackageSharedHar: 调用打包工具打 hsp 模块的 har 包。
• PackageSharedTgz: 调用打包工具将 hsp 模块生成的未签名 hap 和 har 包打包成 tgz 包。
• PackageSignHar: 调用打包工具打带签名的 har 包，当前仅在 daemon 模式下生效。

3.6 Sign

• SignHap: 调用签名工具给 hap 包签名。
• SignHsp: 调用签名工具给 hsp 包签名。
• SignApp: 调用签名工具给 app 包签名。
• SignHqf: 调用签名工具给增量包签名。
• SignModuleRemoteHsp: 调用签名工具给模块级 ohpm 仓上的 hsp 包签名。
• SignProjectRemoteHsp: 调用签名工具给工程级 ohpm 仓上的 hsp 包签名。

3.7 Verification

• PreBuild: 模块级预检查任务。
• PreBuildApp: 工程级预检查任务。
• PreCheckSyscap: syscap 相关配置预检查任务。

3.8 Generate

• GenerateLoaderJson: 生成 loader.json 文件。
• GenerateMetadata: 生成 metadata.json 文件。
• SyscapTransform: syscap 转换任务。
• MakePackInfo: 生成模块级别的 pack.info。
• MakeProjectPackInfo: 生成工程级别的 pack.info。
• ProcessPackageJson: 对 package.json 文件进行处理。
• ProcessOHPackageJson: 对 oh_package.json5 文件进行处理。
• GeneratePackRes: 生成 pack.res 文件。
• CreateBuildProfile: 生成 hap/hsp 的 BuildProfile.ets 文件。
• CreateHarBuildProfile: 生成 har 的 BuildProfile.ets 文件。
• PrepareQuickfix: 通过校验获取增量文件并输出到 quiekfix.json 文件中。

3.9 Config

• ProcessProfile: 处理 module.json5 文件。
• PrepareSharedHarResource: 生成打包 shared library 的 package.json 和 module.json。
• UnitTestProcessProfile: UnitTestBuild 场景处理构建中间产物 module.json 文件。
• MergeProfile: 合并 module.json5 文件。
• PreviewUpdateAssets: 预览模式下，Stage 模型在编译预览代码前更新前置任务生成的 module.json 和 main_pages.json 文件。

3.10 Native

• BuildNativeWithNinja: 将 native 代码编译成 so 文件。
• BuildNativeWithCmake: 用 CMake 编译 CPP 源码。

3.11 Help

• tasks: 查看 hvigor 的全部任务及详情。
• taskTree: 查看当前工程涉及的任务树。

3.12 Other

• ReplaceUnitTestIndexFile: 单元测试替换入口文件。
• ReplacePreviewerPage: 接受预览器提供的参数替换页面文件中的参数。
• OhosTestCopyMockConfigJson: 测试框架执行 mock 时将 mock-config.json 拷贝到测试包中。
• clean: 清理生成的 Build 目录。
• collectCoverage: 基于仪表打点数据生成覆盖率统计报表。

3.13 Sync

• init: 初始化工程。

3.14 Init

该任务类型与 Sync 下的 init 不同，该过程中无具体任务，主要负责执行调用 hvigor 前的准备工作。