From 0fd8862defee078bdea4354e6c7bdd0f7fa22bc1 Mon Sep 17 00:00:00 2001
From: zhouke <zhouke35@huawei.com>
Date: Thu, 5 Jan 2023 19:30:44 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85testfwk=5Farkxtest=20chanlogs?=
 =?UTF-8?q?.=20Signed-off-by:=20<zhouke35@huawei.com>?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: zhouke <zhouke35@huawei.com>
---
 .../changelogs-testfwk_arkxtest.md            | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_3.2.8.1/changelogs-testfwk_arkxtest.md

diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.8.1/changelogs-testfwk_arkxtest.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.8.1/changelogs-testfwk_arkxtest.md
new file mode 100644
index 0000000000..c02fc74dca
--- /dev/null
+++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.8.1/changelogs-testfwk_arkxtest.md
@@ -0,0 +1,41 @@
+# 测试子系统ChangeLog
+
+## cl.testfwk_arkxtest.1 On、Driver、Component类接口新增支持异常处理
+
+API8原有接口废弃，API9新增替代接口，API9接口支持异常处理，需使用try catch捕获接口抛出的异常。
+
+## 变更影响
+
+此变更影响@ohos.uitest提供的api9-JS接口。用户此前在测试用例开发中使用了@ohos.uitest-api9接口的，需要进行适配才可以在新版本SDK环境正常编译通过。
+
+## 关键的接口/组件变更
+
+- 废弃API8原有的`By`类，在API9中使用`On`类代替，`On`类接口新增支持异常处理机制；类内接口名称保持不变，**例外**：`By#key`接口替换为`On.id`。
+- 废弃API8原有的`By`类，在API9中使用`On`类代替。
+- 废弃API8原有的`UiDriver`类，在API9中使用`Driver`类代替，`Driver`类接口新增支持异常处理机制；类内接口名称保持不变。
+- 废弃API8原有的`UiComponent`类，在API9中使用`Component`类代替，`Component`类接口新增支持异常处理机制；类内接口名称保持不变。
+
+## 适配指导
+
+### 1.适配接口名称变更
+
+可按照如下规则做类名替换：
+
+- `By-->On`
+- `BY-->ON`
+- `UiDriver-->Driver`
+- `UiComponent-->Component`
+
+### 2.捕获处理异常
+
+使用try-catch处理接口捕获可能抛出的异常，例如：
+
+```typescript
+import {Driver,ON,Component} from '@ohos.uitest'
+
+try {
+    let driver = Driver.create();
+} catch (error) {
+    // error handle; error.code为错误码
+}
+```
\ No newline at end of file
-- 
GitLab