# compatibility

**Repository Path**: xuhanlin02/compatibility

## Basic Information

- **Project Name**: compatibility
- **Description**: XTS认证指导
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-02-28
- **Last Updated**: 2023-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenHarmony 兼容性自测试指南

#### XTS子系统介绍
XTS子系统是OpenHarmony生态认证测试套件的集合，当前包括:
1. acts（application compatibility test suite）应用兼容性测试套件，看护北向HAP兼容、OpenHarmony开发API兼容。
2. dcts（distributed compatibility test suite）分布式兼容性测试套，看护分布式兼容性。
3. hats（hardware abstract test suite)硬件抽象兼容性测试套，看护HDI层接口。

对于标准系统设备，以上3个XTS测试项均为必测项。

#### 认证套件获取指南
当前OpenHarmony 3.2 Release版本暂未发布，自测时可取用已发布的3.2 Beta4、3.2 Beta5版本的测试套件测试
相关资源下载地址：

OpenHarmony 3.2 Beta4 ：https://repo.huaweicloud.com/harmonyos/os/3.2-Beta4/dayu200_standard_arm32.tar.gz

OpenHarmony 3.2 Beta5 ：https://repo.huaweicloud.com/harmonyos/os/3.2-Beta5/dayu200_standard_arm32_20230201.tar.gz

下载全量包后，取压缩包中suites文件夹即可，需要将文件夹存放在不含中文及空格的目录下。

#### python环境准备

XTS测试框架依赖Python环境，需要按照Python环境，由于暂未适配过高版本的python，当前安装python 3.8.9
加速下载地址：
    https://repo.huaweicloud.com/python/3.8.9/python-3.8.9-amd64.exe

安装时请勾选 "将python添加到环境变量" 选项,安装完成后在cmd窗口安装以下python组件
1.  setuptools组件 : 
    python -m pip install setuptools
2.  pyserial组件 : 
    python -m pip install pyserial
3.  rsa组件 : 
    python -m pip install rsa

#### 测试资源文件获取

XTS测试依赖部分测试资源文件，此部分文件需要手动下载添加到测试文件夹中，resource资源文件下载： git clone https://gitee.com/openharmony-sig/compatibility.git

下载完成后，取\resource\compatibility\test_suite\resource\master\standard system\ 下的resource资源文件夹到对应的测试文件夹。

#### 测试执行

双击acts测试文件夹内的run.bat文件启动测试窗口，输入 list 可查看当前设备连接情况，输入 run acts 即可开始应用兼容性测试套件。

备注：
1. dcts 测试依赖分布式盒子辅助设备
2. acts 测试套件较多，执行需要较长时间，测试期间，请勿操作设备

#### 报告查看

测试完成后，测试报告在对应测试文件夹内的reports文件夹，双击其中的 summary_report.html 即可查看完整报告，其中非pass项需要进行复测
复测命令为：  run -l 套件名称;套件名称

#### 相关链接：
1. 官方兼容性测评说明：https://www.openharmony.cn/certification/document/guid