OpenHarmony DevEco Studio使用指南-测试框架/命令行工具

OpenHarmony测试框架

DevEco Studio支持OpenHarmony应用/服务基于设备(真机、模拟器)运行的测试框架，提供测试用例执行能力，提供用例编写基础接口，输出测试结果，支持用户开发简洁易用的自动化测试脚本。

JS、ArkTS的操作步骤相同，以下以ArkTS为例介绍创建测试用例、运行测试用例。

创建测试用例

1. 在工程目录下打开待测试模块下的ets文件，将光标置于代码中任意位置，单击右键 > Show Context Actions > Create Ohos Test或快捷键Alt+enter > Create Ohos Test创建测试类。

2. 在弹出的Create Ohos Test窗口，输入或选择如下参数。

• Testing library：测试类型，默认为DECC-ArkTSUnit，JS语言默认为DECC-JSUnit
• ArkTS name：创建的测试套件名称。测试套件为包含了测试用例的文件。测试套件名称要求在工程目录范围内具有唯一性，且不能使用逗号、横线、空格以及\ / : * ? “”< > | （）&等特殊字符。
• Destination package：测试套件存放的位置，建议存放在待测试模块的test目录下。

3. DevEco Studio在ohosTest目录下自动生成对应的测试类。在测试类中，DevEco Studio会生成对应方法的用例模板，具体测试代码需要开发者根据业务逻辑进行开发，具体请参考：

说明

您也可以手动在ohosTest > ets > test文件夹下创建测试用例，手动创建后，需要在List.test.ets文件中添加创建的用例类。

测试用例名称应保持唯一性，并且不能使用逗号、横线、空格以及\ / : * ? “”< > | （）&等特殊字符。

运行测试用例

使用DevEco Studio运行测试用例前，需要将设备与电脑进行连接，将工程编译成带签名信息的HAP，再安装到真机设备上运行，具体请参考​​应用/服务运行​​。

运行测试用例，可以采用如下几种方式来运行。

• 在工程目录中，单击右键 > Run'测试类名称'，执行测试。

• 打开测试套件，单击对应方法左侧按钮。

• 如果要根据自定义的配置执行Ohos Test，在​​创建测试用例运行任务​​后，通过如下方式的其中之一，执行Ohos Test：

     ○  在工具栏主菜单单击Run > Run'测试名称'。

     ○  在DevEco Studio的右上角，选择测试任务，然后单击右侧的

按钮，执行Ohos Test。

执行完测试任务后，查看测试结果。

创建测试用例运行任务

可选操作，默认情况下，测试用例可直接运行，如果需要自定义测试用例运行任务，可通过如下方法进行设置。

1. 在工具栏主菜单单击Run>Edit Configurations进入Run/Debug Configurations界面。
2. 在Run/Debug Configurations界面，单击+按钮，在弹出的下拉菜单中，单击OpenHarmony Test。

3. 根据实际情况，配置Ohos Test的运行参数。 然后单击OK，完成配置。

命令行工具

ohsdkmgr使用指导

ohsdkmgr（单击​​链接获取​​）是一个OpenHarmony SDK命令行管理工具，支持查看、安装和卸载OpenHarmony SDK，当前仅适用DevEco Studio 3.0 Release（3.0.0.993）以前的版本。

解压ohsdkmgr工具包后，请在ohsdkmgr所在的目录打开CMD命令行工具，然后执行ohsdkmgr相关命令。

查看SDK组件

显示本地和远程组件命令格式如下：

ohsdkmgr list --[options] [<component>]

关于options参数，请参考​​Options选项说明​​。<component>表示组件，取值包括ets/js/native/toolchains/previewer。

查询SDK组件的示例如下所示：

• 显示指定路径下所有组件的安装情况：

ohsdkmgr list --sdk-directory="/data/sdk"

• 显示ArkTS组件所有API Version的最新版本：

ohsdkmgr list ets

安装SDK组件

安装一个或多个SDK组件命令格式如下：

ohsdkmgr install --[options] <component1> [<component2>]

关于options参数，请参考​​Options选项说明​​​。<component>表示组件，具体写法请参考​​查看SDK组件​​中关于组件写法的介绍。

安装SDK组件的示例如下所示：

• 安装ArkTS SDK最高API Version下的最新版本，并指定了SDK存储路径

ohsdkmgr install --sdk-directory="/data/sdk" ets

• 同时安装API Version为8的ArkTS SDK和JS SDK，默认安装路径为ohsdkmgr工具根目录的上一级目录。

ohsdkmgr install ets:8 js:8

• 安装ArkTS SDK指定API Version版本，需要使用http代理来安装，代理信息文件通过config参数进行指定。

ohsdkmgr install ets:8 --config="/data/sdk/config.properties"

其中，config参数指定的配置文件config.properties中包含代理服务器信息和SDK存储路径。

sdk-directory="/data/sdk"
proxy-type=http
proxy=host:port

• 安装comp.txt中指定的组件，并安装到指定的目录。

ohsdkmgr install --component-file="/data/sdk/comp.txt" --sdk-directory="/data/sdk"

其中，comp.txt中包含的内容举例如下所示：

ets:8
js:8
native:8
toolchains
previewer

卸载SDK组件

卸载一个或多个SDK组件命令格式如下：

ohsdkmgr uninstall --[options] <component1> [<component2>]

关于options参数，请参考​​Options选项说明​​​。<component>表示组件，具体写法请参考​​查看SDK组件​​中关于组件写法的介绍。

卸载SDK组件的示例如下所示：

• 卸载本地的ArkTS SDK，可以指定具体的API Version，如果不指定，则会卸载最高API Version的最新版本。

ohsdkmgr uninstall ets:8

• 同时卸载本地已安装的API Version为8的最新ArkTS SDK和JS SDK版本。

ohsdkmgr uninstall ets:8  js:8

查看ohsdkmgr版本

查看ohsdkmgr版本号的命令格式为：

ohsdkmgr version | --version

查看ohsdkmgr帮助

查看ohsdkmgr帮助文档的命令格式为：

ohsdkmgr help | --help

Options选项说明

Options是ohsdkmgr的可选配置参数，这些参数可以直接在命令行中执行外，还可以将这些参数配置到ohsdkmgr配置文件（ohsdkmgr工具默认配置文件路径为ohsdkmanager/conf/config.properties）中。

说明

config=<filePath>、component-file=<filePath>和accept-license参数只能在命令行中执行，不能写到配置文件中。

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ohos-sdk-command-line-tool-0000001263280431-V3​​