【HarmonyOS NEXT】har 包的构建生成过程

Har模块文件结构

构建HAR

打包规则

• 开源HAR除了默认不需要打包的文件（build、node_modules、oh_modules、.cxx、.previewer、.hvigor、.gitignore、.ohpmignore）和.gitignore/.ohpmignore中配置的文件，cpp工程的CMakeLists.txt，buildProfile.json5文件中配置的混淆相关文件，其余文件都会被打进HAR包中。
• 闭源HAR只会将特定的文件（资源文件、配置文件、编译过程中使用的ets文件、readme和changelog等声明文件、license等证书文件）打包HAR包中。

构建开源HAR

1. 修改新建HAR模块时生成的build-profile.json5默认模板，将obfuscation下的enable字段改为false或删除整个obfuscation配置参数。

{"apiType": "stageMode","buildOption": {},"buildOptionSet": [{"name": "release","arkOptions": {// 开源har相关参数"obfuscation": {"ruleOptions": {// true表示进行混淆，false表示不进行混淆。默认为true"enable": false,]},// consumerFiles中指定的混淆配置文件会在构建依赖这个library的工程或library时被应用"consumerFiles": ["./consumer-rules.txt"]}},},],"targets": [{"name": "default"}]
}

2. 对于开源har，若部分工程源文件无需构建到HAR包中，可在module目录下新建.ohpmignore文件，配置打包时要忽略的文件，支持正则表达式写法。将无需打包进HAR包的文件/文件夹名称写入.ohpmignore文件中。DevEco Studio构建时将过滤掉.ohpmignore文件中所包含的文件/文件夹。

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

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

构建闭源HAR

DevEco Studio支持闭源HAR构建，通过对代码进行编译混淆，生成闭源HAR。在不共享源码的情况下，通过闭源HAR对外提供组件、资源等，可以实现多个模块或者多个工程共享组件、资源等。

 1. 新建的HAR模块在编译模式为release模式时默认为构建闭源HAR，即build-profile.json5文件中obfuscation下的enable字段为true。

{"apiType": "stageMode","buildOption": {},"buildOptionSet": [{"name": "release","arkOptions": {// 闭源har相关参数"obfuscation": {"ruleOptions": {// true表示进行混淆，false表示不进行混淆。默认为true"enable": true,// 混淆规则文件"files": ["./obfuscation-rules.txt"]},// consumerFiles中指定的混淆配置文件会在构建依赖这个library的工程或library时被应用"consumerFiles": ["./consumer-rules.txt"]}},},],"targets": [{"name": "default"}]
}

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

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

根据工程特性，mgplayer_hms 采用构建闭源HAR 的方式。

模块级build-profile.json5的示例如下所示：

{"apiType": "stageMode",  //API类型，支持FA(faMode) 和 Stage(stageMode)模型"showInServiceCenter": true,  //是否在服务中心展示"buildOption": {  //配置项目在构建过程中使用的相关配置//配置筛选har依赖.so资源文件的过滤规则"nativeLib": {"filter": {//按照.so文件的优先级顺序，打包最高优先级的.so文件"pickFirsts": ["**/1.so"],//按照.so文件的优先级顺序，打包最低优先级的.so文件"pickLasts": ["**/2.so"],//排除的.so文件"excludes": ["**/3.so", //排除所有名称为“3”的so文件"**/x86_64/*.so //排除所有x86_64架构的so文件],//允许当.so重名冲突时，使用高优先级的.so文件覆盖低优先级的.so文件"enableOverride": true}},"sourceOption": {   //使用不同的标签对源代码进行分类，以便在构建过程中对不同的源代码进行不同的处理"workers": []},//cpp相关编译配置"externalNativeOptions": {"path": "./src/main/cpp/CMakeLists.txt",  //CMake配置文件，提供CMake构建脚本"arguments": "",  //传递给CMake的可选编译参数"abiFilters": [  //用于设置本机的ABI编译环境"arm64-v8a","x86_64"],"cppFlags": ""  //设置C++编译器的可选参数},//ArkTS编译配置"arkOptions":{"types":[]  //配置d.ts/d.ets的相对路径或包名，用于使用自定义的声明类型},},"buildOptionSet": [  //buildOption的集合，{"name": "release",  //定义buildOption的名字，取值有default、debug 和 release，也可自定义"arkOptions": {"obfuscation": {  //针对release模式下的配置"ruleOptions": {"enable": true,   // 默认为true"files": [   //混淆文件的相对路径"./obfuscation-rules.txt"]},"consumerFiles": './consumer-rules.txt' //仅Static Library模块可配置：默认导出的混淆规则}},"debuggable": true,  //定义编译模式是否为debug"copyFrom": "release",  //从指定的buildOption中复制相关配置"resOptions": {},//cpp相关编译配置"externalNativeOptions": {"path": "./src/main/cpp/CMakeLists.txt",  //CMake配置文件，提供CMake构建脚本"arguments": "",  //传递给CMake的可选编译参数"abiFilters": [  //用于设置本机的ABI编译环境"arm64-v8a","x86_64"],"cppFlags": ""  //设置C++编译器的可选参数},"sourceOption": {   //使用不同的标签对源代码进行分类，以便在构建过程中对不同的源代码进行不同的处理"workers": []},//配置筛选har依赖.so资源文件的过滤规则"nativeLib": {"filter": {//按照.so文件的优先级顺序，打包最高优先级的.so文件"pickFirsts": ["**/1.so"],//按照.so文件的优先级顺序，打包最低优先级的.so文件"pickLasts": ["**/2.so"],//排除的.so文件"excludes": ["**/3.so"],//允许当.so重名冲突时，使用高优先级的.so文件覆盖低优先级的.so文件"enableOverride": true}},}],"buildModeBinder": [   //构建模式与构建配置的关联配置,通过该配置可以将不同的构建配置和target进行组合，并绑定到对应的构建模式上,其中构建模式需要在工程级别的构建模式列表中{"buildModeName": "debug","mappings": [   //构建模式绑定中的具体映射表，描述的是target和构建配置的一对一的关系{"targetName": "default","buildOptionName": "release"}]}],"targets": [  //定义的target，开发者可以定制不同的target，具体请参考配置多目标构建产物章节{"name": "default",},{"name": "ohosTest",}    ]
}