OpenHarmony移植：XTS子系统之应用兼容性测试套件

PHP小丑

摘要：本文通过实例分析下ACTS应用兼容性测试套件移植案例，以及移植过程中特定的操作的原理。

本文分享自华为云社区《移植案例与原理 - XTS子系统之应用兼容性测试套件》，作者：zhushy。
XTS（X Test Suite）子系统是OpenHarmony生态认证测试套件的集合，当前包括：

acts（application compatibility test suite）应用兼容性测试套件，看护北向HAP兼容、OpenHarmony开发API兼容。
hats（Hardware Abstraction Test Suite ）硬件抽象测试套，看护HDI层接口。
dcts（Distributed Compatibility Test Suite ）分布式兼容性测试套，看护分布式兼容（待上线）

本文主要通过实例分析下ACTS应用兼容性测试套件移植案例，以及移植过程中特定的操作的原理。主要讲述的是轻量系统兼容性测试。轻量系统因系统能力限制，兼容性测试在系统初始化阶段进行；并且各设备烧录工具存在差异，导致自动化工具（xDevice工具）无法实现真正的自动适配，因此认证执行方式不对合作伙伴进行限制。流程如下：

步骤1 编译适配：XTS子系统加入到编译组件中，随版本一起编译；
步骤2 本地执行：完成兼容性测试；

1、编译适配XTS子系统
1.1 产品解决方案适配
需要在产品解决方案配置文件中增加增加xts_acts与xts_tools组件定义。下面看几个示例，文件vendor\bestechnic\xts_demo\config.json中的配置片段：

{
    "subsystem": "xts",
    "components": [
    { "component": "xts_acts", "features":
      [
      "config_ohos_xts_acts_utils_lite_kv_store_data_path = "/data"",
      "enable_ohos_test_xts_acts_use_thirdparty_lwip = true"
      ]
    },
    { "component": "xts_tools", "features":[] }
    ]
  }

文件vendor\goodix\gr5515_sk_xts_demo\config.json中的配置片段：

{
    "subsystem": "xts",
    "components": [
      { "component": "xts_acts", "features":
      [
        "config_ohos_xts_acts_utils_lite_kv_store_data_path = "/data""
      ]
      },
      { "component": "xts_tools", "features":[] }
     ]
    },

1.2 编译链接
需要通过链接选项指定需要链接的ACTS的部件编译库文件，会使用到 --whole-archive 和 --no-whole-archive这2个ld链接选项。–whole-archive 可以把在其后面出现的静态库包含的函数和变量输出到动态库，–no-whole-archive 则关掉这个特性。在文件vendor\goodix\gr5515_sk_xts_demo\BUILD.gn中，对ACTS的编译文件进行链接。其中⑴到⑵处的链接选项为编译出的属于ACTS的组件测试库文件。

executable("${fw_img_name}.elf") {
  deps = [
    "tests:drivers",
    "tests:fs_test",
    "tests:ohosdemo",
    "tests:shell_test",
    "//build/lite:ohos",
  ]
  ldflags = [
    "-Wl,--whole-archive",
    # "-lfs_test",
    # "-ldrivers_test",
    # "-lapp_hello",
    "-lshell_test",
⑴    "-lhctest",
    "-lmodule_ActsBootstrapTest",
    "-lmodule_ActsWifiIotTest",
    "-lmodule_ActsUtilsFileTest",
    "-lmodule_ActsKvStoreTest",
    "-lmodule_ActsParameterTest",
    "-lmodule_ActsSamgrTest",
    "-lhuks_test_common",
    "-lmodule_ActsHuksHalFunctionTest",
    "-lmodule_ActsDfxFuncTest",
    "-lmodule_ActsUpdaterFuncTest",
⑵    "-lmodule_ActsHieventLiteTest",
    "-Wl,--no-whole-archive",
  ]
  }

在文件vendor\bestechnic\xts_demo\config.json中，需要链接的ACTS部件测试库文件写在了bin_list里的force_link_libs里。

"bin_list": [
  {
    "elf_name": "wifiiot",
    "bsp_target_name": "best2600w_liteos",
    "signature": "false",
    "burn_name": "rtos_main",
    "enable": "true",
    "force_link_libs": [
    "bootstrap",
    "abilityms",
    "bundlems",
    "broadcast",
    "hctest",
⑴    "module_ActsParameterTest",
    "module_ActsBootstrapTest",
    "module_ActsDfxFuncTest",
    "module_ActsHieventLiteTest",
    "module_ActsSamgrTest",
⑵    "module_ActsKvStoreTest"
    ]
  },
  .......
  ],

然后在文件device\soc\bestechnic\bes2600\BUILD.gn里组装编译链接选项，相关代码片段如下：

# config bin from vendor/bestechnic/<product_name>/config.json
  foreach(bin_file, bin_list) {
    ......
  if (build_enable == "true") {
    ......
    # force link invisible function ,which ar to lib
    ldflags += [ "-Wl,--whole-archive" ]
    foreach(force_link_lib, bin_file.force_link_libs) {
      ldflags += [ "-l${force_link_lib}" ]
    }
    ldflags += [ "-lbsp${bsp_target_name}" ]
    ldflags += [ "-Wl,--no-whole-archive" ]
    ......
  }
  }

在文件vendor_asrmicro\xts_demo\config.json中，存在这样的配置片段。

"xts_list": [
    {
    "enable": "true",
    "xts_modules": [
      "ActsKvStoreTest",
      "ActsDfxFuncTest",
      "ActsHieventLiteTest",
      "ActsSamgrTest",
      "ActsParameterTest",
      "ActsWifiServiceTest",
      "ActsWifiIotTest",
      "ActsBootstrapTest"
    ]
    }
  ]

然后，在文件device_soc_asrmicro\asr582x\liteos_m\sdk\BUILD.gn文件中组装编译链接选项。

foreach(xts_item, xts_list) {
    xts_enable = xts_item.enable
    if(xts_enable == "true")
    {
    defines = [ "CFG_HARMONY_SUPPORT" ]
    ldflags += [
    "-Llibs",
    "-Wl,--whole-archive",
    "-lhctest",
    "-lbootstrap",
    "-lbroadcast",
    ]
    foreach(xts_module, xts_item.xts_modules) {
    ldflags += [ "-lmodule_${xts_module}" ]
    }
    ldflags += [ "-Wl,--no-whole-archive" ]
    }
  }

在产品解决方案配置文件中增加的bin_list、xts_list这些配置选项都不是config.json中的默认的标准选项。各个方案实现的风格差异比较大，建议使用第一种，写在文件vendor\goodix\gr5515_sk_xts_demo\BUILD.gn中会比较好。另外，需要使用hb命令触发debug版本（非debug版本不会触发测试编译）。
2、XTS子系统编译流程
2.1 hb编译构建工具读取config.json
编译构建工具hb会读取产品解决方案配置文，获取参与编译的子系统以及部件信息。XTS测试支持对各个子系统、部件的接口进行测试，产品解决方案配置了哪些子系统才会对这些配置的子系统进行测试。后文会继续解释。
2.2 XTS编译配置文件
在文件中test\xts\acts\build_lite\BUILD.gn中，定义了ACTS的测试套件。⑴处的ohos_xts_test_args表示，如果指定了具体的xts的测试套件，则只编译xts测试编译选项中指定的测试套件，后文会分析怎么在编译构建时指定测试套件。如果没有在编译构建时指定测试套件，则默认编译全部的测试套件。对于不同的内核类型，测试套件是有差异的，如⑵所示。对于轻量系统，支持的测试套件主要包含communication_lite、startup_lite、iot_hardware_lite、security_lite、hiviewdfx_lite、distributed_schedule_lite、update_lite、utils_lite等子系统及其部件。

all_features = []
  features = []
⑴  if (ohos_xts_test_args != "") {
    args = [
    "--method_name",
    "get_target_modules",
    "--arguments",
    "all_features=${ohos_xts_test_args}",
    ]
    all_features +=
      exec_script(rebase_path("//test/xts/tools/lite/build/utils.py"),
            args,
            "list lines")
  } else {
⑵    if (ohos_kernel_type == "liteos_m") {
    all_features += [
      "//test/xts/acts/communication_lite/lwip_hal:ActsLwipTest",
      "//test/xts/acts/communication_lite/wifiservice_hal:ActsWifiServiceTest",
      "//test/xts/acts/utils_lite/file_hal:ActsUtilsFileTest",
      "//test/xts/acts/startup_lite/syspara_hal:ActsParameterTest",
      "//test/xts/acts/iot_hardware_lite/iot_controller_hal:ActsWifiIotTest",
      "//test/xts/acts/utils_lite/kv_store_hal:ActsKvStoreTest",
      "//test/xts/acts/security_lite/huks/liteos_m_adapter:ActsHuksHalFunctionTest",
      "//test/xts/acts/hiviewdfx_lite/hilog_hal:ActsDfxFuncTest",
      "//test/xts/acts/hiviewdfx_lite/hievent_hal:ActsHieventLiteTest",
      "//test/xts/acts/distributed_schedule_lite/system_ability_manager_hal:ActsSamgrTest",
      "//test/xts/acts/update_lite/dupdate_hal:ActsUpdaterFuncTest",
      "//test/xts/acts/startup_lite/bootstrap_hal:ActsBootstrapTest",
    ]
    } else if (ohos_kernel_type == "liteos_a") {
    all_features += [
    ......
    ]
    } else if (ohos_kernel_type == "linux") {
    all_features += [
    ......
    ]
    }
  }

在该文件中，还有如下代码片段。可以看出，只要构建类型为debug并且没有指定notest测试编译选项时才会编译ACTS测试套。测试编译选项的指定如下所示：hb build -t notest。

if (ohos_build_type == "debug" && ohos_test_args != "notest") {
  _all_features = ""
  _product_json = rebase_path("${product_path}/config.json")
  foreach(one_feature, all_features) {
    _all_features = _all_features + one_feature + ","
  }
  _args = [
    "--method_name",
    "filter_by_subsystem",
    "--arguments",
    "testsuites=${_all_features}#product_json=${_product_json}",
  ]
  features += exec_script(rebase_path("//test/xts/tools/lite/build/utils.py"),
              _args,
              "list lines")
  }

接下来看下，如何在编译时指定特定的XTS测试套件进行编译。上文提到的ohos_xts_test_args在文件build\lite\hb_internal\build\build_process.py中，代码如下。可以看出测试套件相关的编译选项有xts和notest两种。⑵处当指定xts测试编译选项时，紧接着指定的测试套件会保存进变量ohos_xts_test_args。支持指定的测试套件，应该需要来自上文中的全部的测试套件。具体的使用示例为：hb build -t xts //test/xts/acts/communication_lite/lwip_hal:ActsLwipTest。不过这样的用法应该比较罕见，使用全量编译测试套件的就好。

@test.setter
  def test(self, test_args):
⑴    cmd_list = ['xts', 'notest']
    if test_args[0] in cmd_list:
      if test_args[0] == 'notest':
        self.register_args('ohos_test_args', 'notest')
      else:
⑵        self._test = test_args[1]
        if len(test_args) > 1:
          self.register_args('ohos_xts_test_args', self._test)
    else:
      raise OHOSException('Error: wrong input of test')

2.3 生成的测试套的库文件
成功编译后，在编译构建输出目录，如out/v200zr/xts_demo/libs，生成测试套和测试框架的库文件，XTS子系统测试套.a归档格式为:libmodule_{测试套件模块名称}.a，测试框架归档格式：libhctest.a。这些生成的文件和上文中的链接选项可以对应起来。

-rw-r--r-- 1 zhushangyuan zhushangyuan  28842 Feb 10 16:49 libhctest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan  53024 Feb 10 16:49 libhuks_test_common.a
-rw-r--r-- 1 zhushangyuan zhushangyuan  22562 Feb 10 16:49 libmodule_ActsBootstrapTest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan   7560 Feb 10 16:49 libmodule_ActsDfxFuncTest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan   6096 Feb 10 16:49 libmodule_ActsHieventLiteTest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan  96278 Feb 10 16:49 libmodule_ActsHuksHalFunctionTest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan  31346 Feb 10 16:49 libmodule_ActsKvStoreTest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan  69010 Feb 10 16:49 libmodule_ActsParameterTest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan   197120 Feb 10 16:49 libmodule_ActsSamgrTest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan   8256 Feb 10 16:49 libmodule_ActsUpdaterFuncTest.a
-rw-r--r-- 1 zhushangyuan zhushangyuan  20968 Feb 10 16:49 libmodule_ActsWifiServiceTest.a

3、移植适配XTS定制选项
在移植案例时，产品配置文件中适配XTS子系统时，有时候指定了定制选项如config_ohos_xts_acts_utils_lite_kv_store_data_path、enable_ohos_test_xts_acts_use_thirdparty_lwip等等。本小节专门看下这些定制选项。
3.1 ohos_xts_test_args
该选项声明在文件test\xts\tools\lite\build\suite_lite.gni中。前文已经了解到，编译构建命令行可以指定要编译的xts测试套件。理论上，也可以在产品解决方案配置文件中指定。注意不能同时在编译构建命令行参数中指定，会覆盖。无用的知识点又增加了。

declare_args() {
  ohos_xts_test_args = ""
}

3.2 enable_ohos_test_xts_acts_use_thirdparty_lwip
该选项enable_ohos_test_xts_acts_use_thirdparty_lwip声明在文件test\xts\acts\communication_lite\lwip_hal\BUILD.gn，默认为true。在移植适配时，继续指定该选项为true，可以说是不必要的。

declare_args() {
  enable_ohos_test_xts_acts_use_thirdparty_lwip = true
}

该选项的作用是什么呢？在文件test\xts\acts\communication_lite\lwip_hal\BUILD.gn中，⑴处表明，会依赖Liteos_m内核编译。从选项的名字和实际的作用，让人摸不着头脑。

hctest_suite("ActsLwipTest") {
  suite_name = "acts"
  sources = [ "src/lwip_func_test.c" ]
  if (enable_ohos_test_xts_acts_use_thirdparty_lwip) {
⑴  deps = [ "//kernel/liteos_m:kernel" ]
  }
  cflags = [ "-Wno-error" ]
}

3.3 config_ohos_xts_acts_utils_lite_kv_store_data_path
该选项config_ohos_xts_acts_utils_lite_kv_store_data_path声明在文件test\xts\acts\utils_lite\kv_store_hal\BUILD.gn，如下⑴处所示。注意下⑵处把这个配置define为了DATA_PATH。

declare_args() {
⑴ config_ohos_xts_acts_utils_lite_kv_store_data_path = ""
}
hctest_suite("ActsKvStoreTest") {
  suite_name = "acts"
  sources = [ "src/kvstore_func_test.c" ]
  include_dirs = [
  "src",
  "//utils/native/lite/include",
  "//base/iot_hardware/peripheral/interfaces/kits",
  ]
  cflags = [ "-Wno-error" ]
  defines =
⑵  [ "DATA_PATH="${config_ohos_xts_acts_utils_lite_kv_store_data_path}"" ]
}

在文件test\xts\acts\utils_lite\kv_store_hal\src\kvstore_func_test.c中，有如下代码。在移植适配XTS子系统时，还必须要加上这一行 “config_ohos_xts_acts_utils_lite_kv_store_data_path = “/data””。如果不加的话，config_ohos_xts_acts_utils_lite_kv_store_data_path等于空字符串“”，DATA_PATH被定义了空字符串“”，没有起到提供默认值的作用。

#ifndef DATA_PATH
#define DATA_PATH "/data"
#endif

参考站点
参考了下述站点，或者推荐读者阅读下述站点了解更多信息。

Application compatibility test suite | acts应用兼容性测试套
hardware abstraction test suite | hats兼容性测试套
Distributed Compatibility Test Suite 待上线
compatibility/ test_suite / 兼容性测试认证指导书
轻量带屏解决方案之恒玄芯片移植案例

点击关注，第一时间了解华为云新鲜技术~

[HarmonyOS] OpenHarmony移植：XTS子系统之应用兼容性测试套件

相关帖子

一键重装系统win7步骤和详细教程(免u盘)

烟雾、空气质量、温湿度…自己徒手做个环境检测设备

不止跑路，拯救误操作rm -rf /*的小伙儿

编译器优化：何为SLP矢量化

二分查找：一种效率较高的查找方法

SPI：Java的高可扩展利器

win11系统edge浏览器兼容性设置方法

win11安卓子系统怎么下载 win11安卓子系统下载方法

Win11安卓应用卡顿怎么办

ModelBox开发体验：使用YOLOv3做口罩检测

PHP小丑 LV3