基于 OpenHarmony 开源代码研发的设备和业务应用满足 OpenHarmony 开源兼容性定义的技术要求，完成兼容性测试。本文详细介绍基于小型系统兼容性测试过程，指导完成测试。

兼容性测试执行环境搭建

①安装 python

建议安装 python3.7 及以上版本，笔者使用的是 python3.8.3，官方下载链接：

第一步，安装文件 python-3.8.3.exe，可根据需求选择默认安装或自定义安装。笔者选择的是自定义安装。

第二步，选择要安装的软件工具类，点击 Next。

第三步，选择安装位置路径，并选择 install 安装。

第四步，等待安装完成。

第五步，检查是否安装成功。

打开 cmd，输入 python –V，若显示出 python 对应版本则表示安装成功。

②安装 pip

在 C 盘用户文件夹下新建 pip 文件夹，创建 pip.ini 文件。

打开 pip.ini 文件配置 pip 源，例如：

[global]index-url = 

在 cmd 中执行命令：

pip install setuptools

④安装 pyserial

在 cmd 中执行命令：

pip install pyserial

pyserial 版本大于等于 3.3。

⑤安装 rsa

在 cmd 中执行命令：

pip install rsa

rsa 版本大于等于 4.0。

小型系统兼容性测试

①测试组网​

小型系统设备通过串口、网口或者 WiFi 和测试 Windows/NFS 连接。

②NFS 服务器部署​Windows 工作台部署 NFS：NFS 服务器是用来存储测试用例和测试脚本，通过 NFS 的方式挂载在被测设备上去执行测试用例。

下载并安装 haneWIN NFS 服务器；打开 haneWIN NFS 服务器，点击“编辑输出表文件”设置路径。

例如在 D 盘新建 work 文件夹，当作共享目录。路径设置为：

d:\work -public -alldirs -name:nfs

说明：exports 配置文件格式：共享目录路径，选项 1，选项 2，选项 n …

-name：指定 NFS 共享名称，如-name:share-alldirs：标记允许子目录被作为挂载点-public：允许公开

重启 NFS 服务器：关闭 haneWIN NFS 服务窗口，然后重启 NFS 服务。

重启方法：开始菜单“haneWIN 软件”的“重启所有服务”（用管理员权限）。

重启完成之中，打开 haneWIN NFS 服务器窗口，确认共享目录配置成功。

③被测设备 NFS 挂载

被测设备 IP 配置：Windows 工作台通过串口连接被测设备，命令行模式下输入 ifconfig，配置 IP 地址跟 Windows 工作台的 IP 地址在同一个网段。

配置方法，例如：

ifconfig eth0 192.168.1.10 netmask 255.255.255.0 gateway 192.168.1.1

配置完 ping 一下 Windows 工作台的 IP 地址，ping 成功说明正常可用。

被测设备 NFS 挂载配置测试，在被测设备输入如下命令，无报错即挂载成功：

mkdir –p /nfsmount -t nfs -o nolock,addr=xx.xx.196.233 xx.xx.196.233:/d/work /nfs

说明：xx.xx.196.233 为 NFS 服务器 IP 地址。

注意：如果 ping Windows 工作台的 IP 成功，但是挂载不成功，可以尝试禁用 Windows 防火墙。

Windows 工作台查看 NFS 挂载设备是否成功：在 haneWIN NFS 服务窗口，查看“挂载设备”下是否挂载成功。

兼容性测试套件编译

登录版本编译服务器，执行兼容性测试套件编译。

第一步，打开：

vendor{product_name}{product_name}\config.json

添加 XTS 子系统到编译组件中：

"subsystem": "test",  "components": [     { "component": "xts_acts", "features":[] },     { "component": "xts_tools", "features":[] }   ]},

第二步，执行编译。

进入版本代码根目录，执行编译命令：

1.hb set 回车2.选择对应产品3. hb build --gn-args build_xts=true

第三步，查看编译结果。

在 out{product_name}{product_name}\suites 目录下生成兼容性测试套件，acts 即为编译出来的可执行测试文件。

兼容性测试套件执行

将编译出的可执行测试文件 acts 放到 Windows 目录下。

登录下面网站，选择对应版本分支下的小型系统，下载 resource 文件，拷贝到 acts 目录下。

说明：resource 是兼容性测试用例执行依赖的资源文件。

修改 acts\config\user_config.xml 的配置。配置小型系统设备（ipcamera）的 com 和 NfsServer 节点。

举例：NfsServer IP 为 10.61.196.233，port 为 2049，NFS 共享目录为 D:\work，串口是 COM7，波特率 115200。

配置如下图：

说明：打开 haneWIN NFS 服务器，可以查看 NFS 服务器端口。

在 Windows 工作台上进入测试套件目录 acts，直接执行 run.bat。

run.bat 界面启动后，输入测试用例执行指令。

方法一：全量执行：run acts

方法二：模块执行：run –l 模块名，例如：run –l ActsSamgrTest，等待执行完成。

查看兼容性测试报告

进入 acts\reports\，查看当前的执行记录，打开“summary_report.html”可以查看到测试报告。

summary_report.html 内容示例：

总结

本文详细介绍了小型系统兼容性测试的过程，包括环境搭建、配置、编译、执行，以及查看兼容性测试报告。