diff --git a/zh-cn/application-dev/ability/ability-assistant-guidelines.md b/zh-cn/application-dev/ability/ability-assistant-guidelines.md index e52b515f72ea5da8893067a8669c614c8987445a..02ac9057198c5b78f334879c8fbbafd1cb1f2510 100644 --- a/zh-cn/application-dev/ability/ability-assistant-guidelines.md +++ b/zh-cn/application-dev/ability/ability-assistant-guidelines.md @@ -87,7 +87,15 @@ Ability assistant（Ability助手，简称为aa）是实现应用、原子化服 ``` aa dump -a ``` - + ![aa-dump-a](figures/aa-dump-a.png) + ``` + aa dump -l + ``` + ![aa-dump-l](figures/aa-dump-l.png) + ``` + aa dump -i 12 + ``` +![aa-dump-i](figures/aa-dump-i.png) - **force-stop** 通过bundle name强制停止一个进程。 diff --git a/zh-cn/application-dev/ability/ability-delegator.md b/zh-cn/application-dev/ability/ability-delegator.md index a2d8cd109fa1224b1c7e32179f8f7916ef57105d..aab7f699807e8ff43b87ba84ab96bc1162e96ac0 100755 --- a/zh-cn/application-dev/ability/ability-delegator.md +++ b/zh-cn/application-dev/ability/ability-delegator.md @@ -1,13 +1,19 @@ # 测试框架使用指导 -Delegator测试框架是OpenHarmony提供的一套开发者应用自测试框架，旨在为开发者提供针对应用的自测试环境。开发者可以通过delegator类启动对应Ability，并通过Delegator类提供的能力对Ability进行生命周期切换和监听，同时支持shellCMD输入和测试结果打印显示等功能。 +## 概述 +Delegator测试框架是OpenHarmony提供的一套开发者应用自测试框架，旨在为开发者提供针对应用的自测试环境。开发者可以通过delegator类启动对应Ability，并通过Delegator类提供的能力对Ability进行生命周期切换和监听，同时支持shellCMD输入和测试结果打印显示等功能。 + +## 约束与限制 + +测试框架相关接口只能在测试hap包中使用，只有通过`aa test`命令或者IDE启动测试环境后相关接口才能生效。 + ## 测试框架启动 -测试框架启动有两种方式，方式一：通过aa test命令启动，方式二：通过IDE启动。 +测试框架启动有两种方式，方式一：通过`aa test`命令启动，方式二：通过IDE启动。 ### aa test启动 -开发者可通过 aa test 命令启动启动测试框架，开发者可以自行指定使用的runner以及runner所在hap包的package name/module name，具体命令示例如下: +开发者可通过 `aa test` 命令启动启动测试框架，开发者可以自行指定使用的runner以及runner所在hap包的package name/module name，具体命令示例如下: **FA模型：** @@ -24,12 +30,12 @@ aa test -m com.example.myapplicationfaets -s unittest OpenHarmonyTestRunner -s c | -p | 是 | TestRunner所在hap包的package name，FA模型使用。 | | -m | 是 | TestRunner所在hap包的module name，stage模型使用。 | | -s unittest | 是 | 启用的TestRunner名称，TestRunner名称和文件名需要保持一致。 | -| -w | 否 | 测试用例超时时间，如果未指定，测试框架会一直等待测试代码调用finishTest才退出。 | -| -s | 否 | 支持以key-value的方式输入任何参数，输入的参数可通过AbilityDelegatorArgs.parameters以key-value的方式获取。 | +| -w | 否 | 测试用例超时时间，单位为秒，如果未指定，测试框架会一直等待测试代码调用finishTest才退出。 | +| -s | 否 | 支持以key-value的方式输入任何参数，输入的参数可通过AbilityDelegatorArgs.parameters以key-value的方式获取。示例：-s classname myTest，key为classname，value为myTest。 | ### IDE启动 -IDE文档中介绍，待IDE文档上库补充链接。 +IDE启动相关介绍见 [IDE指导网址](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-openharmony-test-framework-0000001263160453#section1034420367508)。 ## TestRunner介绍 diff --git a/zh-cn/application-dev/ability/fa-brief.md b/zh-cn/application-dev/ability/fa-brief.md index ed07318babf11a7d681891d04ff99b681830b1e1..ee4bd1c1680d875b8189bf84fb4090f5b5cbec02 100644 --- a/zh-cn/application-dev/ability/fa-brief.md +++ b/zh-cn/application-dev/ability/fa-brief.md @@ -26,6 +26,8 @@ Ability框架在API 8及更早版本使用FA模型。FA模型中Ability分为Pag 其他类型Ability的生命周期可参考PageAbility生命周期去除前后台切换以及`onShow`的部分进行理解。 开发者可以在 `app.js/app.ets` 中重写生命周期函数，在对应的生命周期函数内处理应用相应逻辑。 +目前`app.js`环境中仅支持onCreate和onDestroy回调，`app.ets`环境支持全量生命周期回调。 + ## 进程线程模型 应用独享独立进程，Ability独享独立线程，应用进程在Ability第一次启动时创建，并为启动的Ability创建线程，应用启动后再启动应用内其他Ability，会为每一个Ability创建相应的线程。每个Ability绑定一个独立的JSRuntime实例，因此Ability之间是隔离的。 diff --git a/zh-cn/application-dev/ability/fa-pageability.md b/zh-cn/application-dev/ability/fa-pageability.md index a59708cb0d67dd641a643c68d4b196bb336acf3d..724b309120b5eab643bb891f4b77bb4b68c34672 100644 --- a/zh-cn/application-dev/ability/fa-pageability.md +++ b/zh-cn/application-dev/ability/fa-pageability.md @@ -29,7 +29,7 @@ Ability生命周期是Ability被调度到INACTIVE、ACTIVE、BACKGROUND等各个 ![fa-pageAbility-lifecycle](figures/fa-pageAbility-lifecycle.png) -PageAbility提供命周期回调，开发者可以在`app.js/app.ets`中重写生命周期相关回调函数 。 +PageAbility提供命周期回调，开发者可以在`app.js/app.ets`中重写生命周期相关回调函数 。目前`app.js`环境中仅支持onCreate和onDestroy回调，`app.ets`环境支持全量生命周期回调。 ## 开发指导 ### featureAbility接口说明 diff --git a/zh-cn/application-dev/ability/figures/aa-dump-a.PNG b/zh-cn/application-dev/ability/figures/aa-dump-a.PNG new file mode 100755 index 0000000000000000000000000000000000000000..ae8d41f65f68d73895be5bbbb539c0d220b2a9a5 Binary files /dev/null and b/zh-cn/application-dev/ability/figures/aa-dump-a.PNG differ diff --git a/zh-cn/application-dev/ability/figures/aa-dump-i.PNG b/zh-cn/application-dev/ability/figures/aa-dump-i.PNG new file mode 100755 index 0000000000000000000000000000000000000000..12998c5ba3e7d667d1147b6e825f8d110d5c5c5e Binary files /dev/null and b/zh-cn/application-dev/ability/figures/aa-dump-i.PNG differ diff --git a/zh-cn/application-dev/ability/figures/aa-dump-l.PNG b/zh-cn/application-dev/ability/figures/aa-dump-l.PNG new file mode 100755 index 0000000000000000000000000000000000000000..a6797eef284990e3fa25e71562ac8afbddf0821d Binary files /dev/null and b/zh-cn/application-dev/ability/figures/aa-dump-l.PNG differ diff --git a/zh-cn/application-dev/ability/figures/fa-package-info.png b/zh-cn/application-dev/ability/figures/fa-package-info.png index 7b660dce47e3873279f9bdf587b1bd290384843b..7117b264d03b66eb33655d7cf7e939e820a4cab4 100644 Binary files a/zh-cn/application-dev/ability/figures/fa-package-info.png and b/zh-cn/application-dev/ability/figures/fa-package-info.png differ