江油网站建设开发公司资料管理

上一篇中说明了Openharmony V3.1的编译构建流程，如何在标准系统即L2设备添加一个模块呢，在Openharmony上如何编译与运行HelloWorld此篇中有所提及，此篇对此进行详细的说明。

一、标准系统添加一个模块

在Openharmony中添加模块可以分以下三种情况，对原有的配置文件时行不同程度的修改

• 在原有的部件中添加一个模块

• 新建部件并在其中添加模块

• 新建子系统并在该子系统的部件下添加模块

以下分三种方式对添加一个模块的过程来分别分析。

二、 在原有部件中添加一个模块

1.在模块目录下配置BUILD.gn,根据类型选择对应的模板

支持的模板类型：

ohos_executable		#可执行程序
ohos_shared_library #动态库
ohos_static_library #静态库# 预编译模板
ohos_prebuilt_executable 		#预编译可执行程序
ohos_prebuilt_shared_library 	#预编译动态库
ohos_prebuilt_etc				#预编译配置

以下例子中对BUILD.gn文件中各模板的属性及配置项的注释说明

例子：

ohos_shared_library示例

import("//build/ohos.gni")
ohos_shared_library("helloworld") {source = ["",""]		# 包含的C或C++文件include_dir = ["",""] # 包含的头文件cflags = []			# 编译选项cflags_c = []cflags_CC = []ldflags = []configs = []deps = []				# 部件内模块依赖external_deps = ["part_name:module_name",]# 跨部件模块依赖定义# 定义格式为 "部件名:模块名称"# 这里依赖的模块必须是部件声明在inner_kits中的模块defines += ["",""]	# 宏定义output_name = "" 		# 可选，模块输出名output_extension = "" # 可选，模块名后缀module_install_dir = ""	# 可选，缺省在/system/lib64或/system/lib下，模块安装路径，模块安装路径，从system/,vendor/后开始指定relative_install_dir = ""	# 可选，模块安装相对路径，相对于/system/lib64或/system/lib;如果有module_install_dir配置时，该配置项不生效part_name = ""		# 必选，所属部件名称subsystem_name = ""	# 可选，子系统名称
}

ohos_executable示例

ohos_executable模板属性和ohos_shared_library基本一致。

ohos_executable("helloworld") {source = ["",""]		# 包含的C或C++文件include_dir = ["",""] # 包含的头文件
...install_enable = true	# 编译后的镜像烧录后，可执行模块默认是不安装在开发板内，如果要安装需要指定install_enable为true.
}

ohos_prebuilt_etc示例

ohos_prebuilt_etc就是将预编译的文件安装在开发板内，一般会是配置文件，例如xml,cfg等。

ohos_prebuilt_etc("helloworld") {source = ""		deps = [] 	# 部件内模块依赖module_install_dir = ""	# 可选，模块安装路径，从system/,vendor/后开始指定relative_install_dir = ""	# 可选，模块安装相对路径，相对于/system/etc;如果有module_install_dir配置时，该配置项不生效part_name = ""		# 必选，所属部件名称
}

2.修改包含该模块所属部件的bundle.json

以base/account/os_account/bundle.json为例：

此模块的BUILD.gn文件所在目录为//base/account/os_account/,

则在“sub_component”中添加"//base/account/os_account:helloworld"。

{"name": "@ohos/os_account","description": "Allowing apps to use OS account-related functions","version": "3.1","license": "Apache License 2.0","publishAs": "code-segment","segment": {"destPath": "base/account/os_account"},
..."component": {"name": "os_account_standard","subsystem": "account",
..."build": {"sub_component": ["//base/account/os_account/services:services_target","//base/account/os_account/services/accountmgr/src/appaccount:app_account_service_core","//base/account/os_account/frameworks/appaccount/native:app_account_innerkits","//base/account/os_account/frameworks/osaccount/core:os_account_core","//base/account/os_account/frameworks/common:common_target","//base/account/os_account/frameworks/osaccount/native:os_account_innerkits","//base/account/os_account/interfaces/kits/napi/appaccount:appaccount","//base/account/os_account/interfaces/kits/napi/distributedaccount:distributedaccount","//base/account/os_account/interfaces/kits/napi/osaccount:osaccount","//base/account/os_account/sa_profile:account_sa_profile","//base/account/os_account/tools:os_account_tools","//base/account/os_account:helloworld"],
...}}
}

此时再在Openharmony里执行

./build.sh --product-name rk3568

编译完成后，在//out/rk3568/account/os_account_standard/目录下可以找到编译完成的可执行文件与动态库。

三、新建部件并在其中添加模块

1. 在模块目录下配置BUILD.gn,根据类型选择需要的模板

此步与在原部件中添加一个模块的方法基本上一致，只需要注意该模块对应BUILD.gn文件中的part_name为新建部件的名称即可。

2.修改或者新建bundle.json

在原有子系统中添加一个新的部件，有两种方法，一种就是如第二点所述，在原有的bundle.json文件中添加该部件。另一种就是新建一个。注意无论哪种方式该bundle.json文件均在对应子系统所在的文件目录下。除非你修改了//build/subsystem_config.json中关于此子系统对应的路径信息。参考Openharmony的编译构建--基础篇。

以account子系统为例，添加新的子部件os_account_test.

• 首先base/account下创建目录os_account_test，此目录下新建bundle.json。内容如下

{"name": "@ohos/os_account","description": "Allowing apps to use OS account-related functions","version": "3.1","license": "Apache License 2.0","publishAs": "code-segment","segment": {"destPath": "base/account/os_account"},
..."component": {"name": "os_account_test",		# 新建的部件名称"subsystem": "account",			# 所属的子系统
...},"build": {"sub_component": [			# 部件包含的模块的gn目标
...                                  ],"inner_kits": [
...],"test": [
...]}}
}

• 添加BUILD.gn

如果在base/account/os_account_test新建BUILD.gn，则sub_component添加如下

"//base/account/os_account_test:helloworld"

• inner_kits与test

假如有提供给其它部件的接口，需要在inner_kits说明，假如有测试用例，需要在test中说明，inner_kits与test不是必选项，可以不添加。

3.//productdefine/common/products/rk3568.json文件添加部件"account:os_account_test":{}

{"product_name": "rk3568","product_company": "hihope","product_device": "rk3568","version": "2.0","type": "standard","product_build_path": "device/hihope/build","parts":{"ace:ace_engine_standard":{},"ace:napi":{},"account:os_account_standard":{},"account:os_account_test":{},"barrierfree:accessibility":{},
......}
}

至此，重新编译。在//out/rk3568/account/os_account_test/目录下会得到新增的模块下可执行文件或动态库。

后续更精彩

1.Openharmony编译构建--进阶篇2