HarmonyOS 鸿蒙Next如何构建闭源HAR

使用约束

1. 闭源HAR仅支持API 9的Stage工程。
2. HAR包不支持在module.json5中配置ability、extension组件。
3. HAR包不支持pages路由配置。
4. HAR包自身的构建打包不支持本地的依赖项（本地的har包）。

操作步骤

步骤 1

新建工程时选择API 9的Stage模型，工程创建完成后，新建“Static Library”模块。

步骤 2

编写代码。

library // HAR根目录

├─libs// 存放用户自定义引用的Native库，一般为.so文件

└─src

│└─main

│├─cpp

│ │├─types // 定义Native API对外暴露的接口

││ │ └─liblibrary

││ │     ├─index.d.ts

││ │     └─package.json

││ ├─CMakeLists.txt // CMake配置文件

││ └─npmlib.cpp // C++源码文件

│└─ets // ArkTS源码目录

││ └─components

││    └─mainpage

││        └─MainPage.ets

│├─resources // 资源目录，用于存放资源文件，如图片、多媒体、字符串等

│└─module.json5 // 模块配置文件，包含当前HAR的配置信息

├─build-profile.json5 // Hvigor编译构建所需的配置文件，包含编译选项

├─hvigorfile.ts // Hvigor构建脚本文件，包含构建当前模块的插件、自定义任务等

├─index.ets // HAR的入口文件，一般作为出口定义HAR对外提供的函数、组件等

└─oh-package.json5 // HAR的描述文件，定义HAR的基本信息、依赖项等

步骤 3

在oh-package.json5中“main”字段定义导出文件入口。若不设置“main”字段，默认以当前目录下index.ets为入口文件，依据.ets>.ts>.js的顺序依次检索。以将ets/components/mainpage/MainPage.ets文件设置为入口文件为例：

{
  "main": "./src/main/ets/components/mainpage/MainPage.ets",
}

步骤 4

在当前HAR模块的build-profile.json5中，将artifactType字段值设置为obfuscation。

"apiType": 'stageMode',

"buildOption":
{
  "artifactType": "obfuscation", // 定义产物类型，obfuscation表示为使用混淆模式
}

步骤 5

选中HAR模块的根目录，点击Build > Make Module '<module-name>'启动构建。

构建完成后，build目录下生成闭源HAR包产物。