深入解析 OpenHarmony 构建系统-4-OHOSLoader类

在OpenHarmony操作系统构建过程中，OHOSLoader类扮演着至关重要的角色。这个类负责加载和解析构建配置，生成必要的构建文件，并确保构建过程的顺利进行。本文将深入分析OHOSLoader类的实现细节，揭示其如何管理构建配置，并生成系统所需的各类文件。

类初始化与配置解析

OHOSLoader类的初始化过程涉及到多个配置文件的加载和解析。这些文件包括subsystem_config.json、platforms.build等，它们定义了构建过程中所需的子系统和平台配置。

import os
import jsonclass LoadInterface:# 假设这是一个接口类，定义了一些基础方法和属性def __init__(self):self.config = Noneself.args_dict = {}class OHOSLoader(LoadInterface):def __init__(self):super().__init__()# 初始化各种配置路径和参数self.source_root_dir = ""  # 源代码根目录self.gn_root_out_dir = ""  # GN 构建输出目录self.os_level = ""  # 操作系统级别self.target_cpu = ""  # 目标 CPU 架构self.target_os = ""  # 目标操作系统self.config_output_relpath = ""  # 配置输出相对路径self.config_output_dir = ""  # 配置输出绝对路径self.target_arch = ""  # 目标架构self.subsystem_config_file = ""  # 子系统配置文件路径self.subsystem_config_overlay_file = ""  # 子系统配置覆盖文件路径self.platforms_config_file = ""  # 平台配置文件路径self.exclusion_modules_config_file = ""  # 排除模块配置文件路径self.example_subsystem_file = ""  # 示例子系统文件路径self.build_example = ""  # 是否构建示例self.scalable_build = ""  # 是否可伸缩构建self.build_platform_name = ""  # 构建平台名称self.build_xts = ""  # 是否构建 XTS 测试self.ignore_api_check = ""  # 是否忽略 API 检查self.load_test_config = ""  # 是否加载测试配置self.subsystem_configs = ""  # 子系统配置self._subsystem_info = ""  # 子系统信息self.skip_partlist_check = ""  # 是否跳过部分列表检查def __post_init__(self):# 初始化源代码根目录self.source_root_dir = self.config.root_path + '/'# 初始化 GN 构建输出目录self.gn_root_out_dir = self.config.out_path if not self.config.out_path.startswith('/') else os.path.relpath(self.config.out_path, self.config.root_path)# 初始化操作系统级别，默认为 "standard"self.os_level = self.config.os_level if self.config.os_level else "standard"# 初始化目标 CPU 架构，默认为 "arm"self.target_cpu = self.config.target_cpu if self.config.target_cpu else "arm"# 初始化目标操作系统，默认为 "ohos"self.target_os = self.config.target_os if self.config.target_os else "ohos"# 初始化配置输出相对路径self.config_output_relpath = os.path.join(self.gn_root_out_dir, 'build_configs')# 初始化配置输出绝对路径self.config_output_dir = os.path.join(self.source_root_dir, self.config_output_relpath)# 初始化目标架构self.target_arch = '{}_{}'.format(self.target_os, self.target_cpu)# 初始化子系统配置文件路径self.subsystem_config_file = os.path.join(self.config.root_path, 'out/preloader', self.config.product, 'subsystem_config.json')# 初始化平台配置文件路径self.platforms_config_file = os.path.join(self.config.root_path, 'out/preloader', self.config.product, 'platforms.build')# 初始化排除模块配置文件路径self.exclusion_modules_config_file = os.path.join(self.config.root_path, 'out/preloader', self.config.product, 'exclusion_modules.json')# 初始化示例子系统文件路径self.example_subsystem_file = os.path.join(self.config.root_path, 'build', 'subsystem_config_example.json')# 读取编译标准允许文件compile_standard_allow_file = os.path.join(self.config.root_path, 'out/preloader', self.config.product, 'compile_standard_whitelist.json')compile_standard_allow_info = read_json_file(compile_standard_allow_file)bundle_subsystem_allow_list = compile_standard_allow_info.get("bundle_subsystem_error", [])# 检查配置参数self._check_args()# 获取构建示例标志self.build_example = self.args_dict.get('build_example')if not self.build_example:self.example_subsystem_file = ""# 获取可伸缩构建标志self.scalable_build = self.args_dict.get('scalable_build')# 获取构建平台名称self.build_platform_name = self.args_dict.get('build_platform_name')# 获取构建 XTS 测试标志self.build_xts = self.args_dict.get('build_xts')# 获取忽略 API 检查标志self.ignore_api_check = self.args_dict.get('ignore_api_check')# 获取加载测试配置标志self.load_test_config = self.args_dict.get('load_test_config')# 获取跳过部分列表检查标志self.skip_partlist_check = self.args_dict.get('skip_partlist_check')# 扫描子系统配置self.subsystem_configs = subsystem_scan.scan(self.subsystem_config_file,self.example_subsystem_file,self.source_root_dir)# 获取子系统信息self._subsystem_info = subsystem_info.get_subsystem_info(self.subsystem_config_file,self.example_subsystem_file,self.source_root_dir,self.config_output_relpath,self.os_level)# 获取覆盖组件overrided_components = self._override_components()# 获取平台信息self._platforms_info = platforms_loader.get_platforms_info(self.platforms_config_file,self.source_root_dir,self.gn_root_out_dir,self.target_arch,self.config_output_relpath,self.scalable_build)# 获取变体工具链self.variant_toolchains = self._platforms_info.get('variant_toolchain_info').get('platform_toolchain')# 获取所有平台self._all_platforms = self.variant_toolchains.keys()# 获取构建平台self.build_platforms = self._get_build_platforms()# 加载 OHOS 构建信息self.parts_config_info = load_ohos_build.get_parts_info(self.source_root_dir,self.config_output_relpath,self._subsystem_info,self.variant_toolchains,self.target_arch,self.ignore_api_check,self.exclusion_modules_config_file,self.load_test_config,overrided_components,bundle_subsystem_allow_list,self.skip_partlist_check,self.build_xts)# 获取部件目标self.parts_targets = self.parts_config_info.get('parts_targets')# 获取伪目标self.phony_targets = self.parts_config_info.get('phony_target')# 获取部件信息self.parts_info = self.parts_config_info.get('parts_info')# 获取所有平台的部件self.target_platform_parts = self._get_platforms_all_parts()# 获取所有平台的存根self.target_platform_stubs = self._get_platforms_all_stubs()# 获取所需构建的部件列表self.required_parts_targets_list = self._get_required_build_parts_list()# 获取所需伪目标self.required_phony_targets = self._get_required_phony_targets()# 获取所需构建的目标self.required_parts_targets = self._get_required_build_targets()def _override_components(self):# 获取覆盖组件信息# 这里可以根据需要实现具体的覆盖逻辑return {}def _get_build_platforms(self):# 获取构建平台# 这里可以根据需要实现具体的平台获取逻辑return []def _get_platforms_all_parts(self):# 获取所有平台的部件# 这里可以根据需要实现具体的部件获取逻辑return {}def _get_platforms_all_stubs(self):# 获取所有平台的存根# 这里可以根据需要实现具体的存根获取逻辑return {}def _get_required_build_parts_list(self):# 获取所需构建的部件列表# 这里可以根据需要实现具体的部件列表获取逻辑return []def _get_required_phony_targets(self):# 获取所需伪目标# 这里可以根据需要实现具体的伪目标获取逻辑return []def _get_required_build_targets(self):# 获取所需构建的目标# 这里可以根据需要实现具体的构建目标获取逻辑return []def read_json_file(file_path):# 读取 JSON 文件with open(file_path, 'r') as file:return json.load(file)

在__post_init__方法中，类成员变量被进一步初始化和配置。这包括设置源根目录、输出目录、目标CPU架构等。此外，还进行了一些必要的检查，如配置文件的存在性和有效性。

构建参数检查

构建参数的正确性是构建成功的关键。OHOSLoader类提供了多个方法来检查构建参数，包括子系统配置文件、平台配置文件等。

@throw_exception
def _check_args(self):LogUtil.hb_info("Checking all build args...")# 检查子系统配置文件if not read_json_file(self.subsystem_config_file):self.subsystem_config_file = os.path.join(self.source_root_dir, 'build/subsystem_config.json')if not read_json_file(self.subsystem_config_file):raise OHOSException("Cannot get the content from platform config file, \please check whether the corresponding file('out/preloader/{}/subsystem_config.json' or \'build/subsystem_config.json') is written correctly.".format(self.config.product), "2001")

生成系统能力文件

系统能力文件（SystemCapability.json）是OpenHarmony构建过程中的一个重要组成部分，它定义了系统支持的各种能力。

@throw_exception
def _generate_syscap_files(self):pre_syscap_info_path = os.path.dirname(self.platforms_config_file)system_path = os.path.join(self.source_root_dir, os.path.join(os.path.dirname(self.platforms_config_file), "system/"))syscap_product_dict = read_json_file(os.path.join(pre_syscap_info_path, "syscap.json"))syscap_info_list = self.parts_config_info.get('syscap_info')target_syscap_with_part_name_list = []target_syscap_list = []target_syscap_for_init_list = []all_syscap_list = []for syscap in syscap_info_list:if syscap['component'] not in self.required_parts_targets_list:continueif 'syscap' not in syscap or syscap['syscap'] is None \or len(syscap['syscap']) == 0 or syscap['syscap'] == [""]:continuefor syscap_string in syscap['syscap']:all_syscap_list.append(syscap_string.split('=')[0].strip())

生成平台列表和部件信息

OHOSLoader类还负责生成平台列表和部件信息文件，这些信息对于构建过程中的依赖管理和目标配置至关重要。

@throw_exception
def _generate_platforms_list(self):platforms_list_gni_file = os.path.join(self.config_output_dir,"platforms_list.gni")_platforms = set(self.build_platforms)_gni_file_content = ['target_platform_list = [', '  "{}"'.format('",\n  "'.join(_platforms)), ']','kits_platform_list = [', '  "{}",'.format('",\n  "'.join(_platforms))]if 'phone' not in self.build_platforms:_gni_file_content.append('  "phone"')_gni_file_content.append(']')write_file(platforms_list_gni_file, '\n'.join(_gni_file_content))LogUtil.hb_info("generate platforms list to '{}'".format(platforms_list_gni_file))

总结

OHOSLoader类是OpenHarmony构建系统的核心组件之一，它通过加载和解析构建配置文件，生成系统所需的各类文件，确保构建过程的顺利进行。本文详细分析了OHOSLoader类的实现，展示了其在构建过程中的关键作用。通过深入理解这个类的功能，开发者可以更好地掌握OpenHarmony的构建系统，从而更高效地进行系统开发和定制。