assistsx-js 0.0.1 → 0.0.12

package/README-DEV.md

@@ -0,0 +1,350 @@
+### 基本用法
+
+```typescript
+import { AssistsX, Node } from 'assistsx-js';
+
+// 获取所有节点
+const nodes: Node[] = AssistsX.getAllNodes();
+
+// 通过ID查找节点
+const nodeList: Node[] = AssistsX.findById('target_id');
+
+// 点击第一个节点
+if (nodeList.length > 0) {
+  AssistsX.click(nodeList[0]);
+}
+
+// 执行手势点击
+AssistsX.gestureClick(100, 200, 50); // 在(100,200)位置点击，持续50ms
+```
+
+### 节点对象的常用操作
+
+```typescript
+const node: Node = nodeList[0];
+
+// 设置节点文本
+node.setNodeText('new text');
+
+// 节点点击
+node.click();
+
+// 节点长按
+node.longClick();
+
+// 节点滚动
+node.scrollForward();
+node.scrollBackward();
+
+// 获取节点在屏幕中的位置
+const bounds = node.getBoundsInScreen();
+console.log(bounds);
+
+// 节点截图
+const imagePath = await node.takeScreenshot();
+```
+
+### 复杂查找与遍历
+
+```typescript
+// 通过文本查找节点
+const textNodes = AssistsX.findByText('确定');
+
+// 通过标签查找节点
+const tagNodes = AssistsX.findByTags('android.widget.Button', { filterText: '提交' });
+
+// 获取节点的所有子节点
+const children = node.getChildren();
+```
+
+## 主要类型说明
+
+### AssistsX
+
+- 提供静态方法用于节点查找、手势操作、系统操作等。
+- 常用方法：
+  - `getAllNodes`：获取所有节点
+  - `findById`、`findByText`、`findByTags`：多种查找方式
+  - `click`、`longClick`、`gestureClick`：节点点击与手势
+  - `takeScreenshotNodes`：节点截图
+  - `launchApp`、`back`、`home`、`notifications`、`recentApps`：系统操作
+
+### Node
+
+- 表示界面上的一个可交互元素，包含属性和操作方法。
+- 主要属性：
+  - `nodeId`、`text`、`des`、`viewId`、`className`
+  - `isScrollable`、`isClickable`、`isEnabled`
+- 主要方法：
+  - `setNodeText(text: string)`：设置文本
+  - `click()`、`longClick()`：点击/长按
+  - `scrollForward()`、`scrollBackward()`：滚动
+  - `getBoundsInScreen()`：获取屏幕位置
+  - `takeScreenshot()`：节点截图
+  - `findById`、`findByText`、`findByTags`：在当前节点范围内查找
+
+## 典型场景
+
+### 1. 自动化测试
+
+```typescript
+// 启动应用
+AssistsX.launchApp('com.example.app');
+
+// 等待并点击登录按钮
+const loginBtn = AssistsX.findByText('登录');
+if (loginBtn.length > 0) {
+  loginBtn[0].click();
+}
+
+// 检查是否包含某文本
+const hasText = AssistsX.containsText('登录成功');
+```
+
+### 2. 界面元素操作
+
+```typescript
+// 查找输入框并输入文本
+const input = AssistsX.findById('input_field');
+if (input.length > 0) {
+  input[0].setNodeText('测试文本');
+}
+
+// 查找并点击提交按钮
+const submit = AssistsX.findByText('提交');
+if (submit.length > 0) {
+  submit[0].click();
+}
+```
+
+### 3. 手势操作
+
+```typescript
+// 简单点击
+AssistsX.gestureClick(100, 200, 50);
+
+// 节点手势点击（支持偏移）
+const node = AssistsX.findById('target')[0];
+await node.nodeGestureClick({ 
+  offsetX: 10, 
+  offsetY: 10,
+  clickDuration: 50 
+});
+
+// 双击操作
+await node.nodeGestureClickByDouble({
+  clickInterval: 200
+});
+```
+
+### 4. 滚动和导航
+
+```typescript
+// 系统导航
+AssistsX.back();      // 返回
+AssistsX.home();      // 主页
+AssistsX.notifications(); // 通知栏
+
+// 滚动操作
+const scrollable = AssistsX.findByTags('android.widget.ScrollView')[0];
+scrollable.scrollForward();
+scrollable.scrollBackward();
+```
+
+## 步骤器（Step）使用说明
+
+步骤器提供了一种结构化的方式来组织和执行自动化操作，支持步骤的生命周期管理、状态控制和界面操作。
+
+### 基本用法
+
+```typescript
+import { Step } from 'assistsx-js';
+
+// 定义步骤实现
+async function loginStep(step: Step): Promise<Step | undefined> {
+    // 启动应用
+    step.launchApp('com.example.app');
+    
+    // 查找用户名输入框并输入
+    const usernameInput = step.findById('username_input');
+    if (usernameInput.length > 0) {
+        usernameInput[0].setNodeText('user123');
+    }
+    
+    // 查找密码输入框并输入
+    const passwordInput = step.findById('password_input');
+    if (passwordInput.length > 0) {
+        passwordInput[0].setNodeText('password123');
+    }
+    
+    // 点击登录按钮
+    const loginButton = step.findByText('登录');
+    if (loginButton.length > 0) {
+        loginButton[0].click();
+    }
+    
+    // 返回 undefined 表示步骤结束
+    return undefined;
+}
+
+// 运行步骤
+await Step.run(loginStep, {
+    tag: 'login',           // 步骤标签
+    data: { user: 'test' }, // 步骤数据
+    delayMs: 1000          // 步骤延迟
+});
+```
+
+### 步骤链式调用
+
+```typescript
+async function step1(step: Step): Promise<Step | undefined> {
+    // 执行某些操作
+    // ...
+    
+    // 返回下一个步骤
+    return step.next(step2, { tag: 'step2' });
+}
+
+async function step2(step: Step): Promise<Step | undefined> {
+    // 执行某些操作
+    // ...
+    
+    // 重复当前步骤
+    if (needRepeat) {
+        return step.repeat();
+    }
+    
+    // 返回下一个步骤
+    return step.next(step3, { tag: 'step3' });
+}
+
+async function step3(step: Step): Promise<Step | undefined> {
+    // 执行最后的操作
+    // ...
+    
+    // 步骤结束
+    return undefined;
+}
+
+// 运行步骤链
+await Step.run(step1, { tag: 'step1' });
+```
+
+### 异步操作处理
+
+```typescript
+async function asyncStep(step: Step): Promise<Step | undefined> {
+    // 等待异步操作
+    await step.delay(1000);
+    
+    // 执行异步方法
+    const result = await step.await(async () => {
+        // 异步操作
+        return 'result';
+    });
+    
+    // 节点截图
+    const node = step.findById('target')[0];
+    const imagePath = await step.takeScreenshotByNode(node);
+    
+    return undefined;
+}
+```
+
+## Step API 文档
+
+### 静态方法
+
+#### `Step.run(impl, options)`
+运行步骤实现。
+- `impl`: `(step: Step) => Promise<Step | undefined>` - 步骤实现函数
+- `options`: 
+  - `tag?: string` - 步骤标签
+  - `data?: any` - 步骤数据
+  - `delayMs?: number` - 步骤延迟时间(毫秒)，默认 1000
+
+#### `Step.stop()`
+停止当前步骤执行。
+
+### 实例属性
+
+- `stepId: string` - 步骤ID
+- `repeatCount: number` - 步骤重复执行次数
+- `tag?: string` - 步骤标签
+- `data?: any` - 步骤数据
+- `delayMs: number` - 步骤延迟时间(毫秒)
+
+### 实例方法
+
+#### 步骤控制
+- `next(impl, options)` - 创建下一个步骤
+- `repeat(options)` - 重复当前步骤
+- `delay(ms)` - 延迟执行
+- `await<T>(method)` - 等待异步方法执行完成
+
+#### 节点操作
+- `getAllNodes(options)` - 获取所有符合条件的节点
+- `findById(id, options)` - 通过ID查找节点
+- `findByText(text, options)` - 通过文本查找节点
+- `findByTags(className, options)` - 通过标签查找节点
+- `findByTextAllMatch(text)` - 查找所有匹配文本的节点
+- `findFirstParentByTags(className)` - 查找第一个匹配标签的父节点
+
+#### 界面操作
+- `takeScreenshotByNode(node, delay)` - 对单个节点进行截图
+- `takeScreenshotNodes(nodes, delay)` - 对多个节点进行截图
+- `gestureClick(x, y, duration)` - 执行点击手势
+- `back()` - 返回操作
+- `home()` - 回到主页
+- `notifications()` - 打开通知栏
+- `recentApps()` - 显示最近应用
+
+#### 应用控制
+- `launchApp(packageName)` - 启动应用
+- `getPackageName()` - 获取当前应用包名
+
+#### 其他操作
+- `containsText(text)` - 检查是否包含指定文本
+- `getAllText()` - 获取所有文本
+- `getScreenSize()` - 获取屏幕尺寸
+- `getAppScreenSize()` - 获取应用窗口尺寸
+
+## 最佳实践
+
+1. 步骤组织
+   - 将复杂的自动化流程拆分为多个步骤
+   - 每个步骤专注于完成特定的任务
+   - 使用有意义的标签和数据来标识步骤
+
+2. 错误处理
+   ```typescript
+   async function robustStep(step: Step): Promise<Step | undefined> {
+       try {
+           const node = step.findById('target')[0];
+           if (!node) {
+               throw new Error('Target node not found');
+           }
+           // ... 其他操作
+       } catch (error) {
+           console.error(`Step failed: ${error.message}`);
+           // 可以选择重试或执行其他步骤
+           return step.repeat({ delayMs: 2000 });
+       }
+   }
+   ```
+
+3. 步骤复用
+   ```typescript
+   // 创建可复用的步骤
+   function createLoginStep(username: string, password: string) {
+       return async function(step: Step): Promise<Step | undefined> {
+           // ... 登录逻辑
+           return undefined;
+       }
+   }
+
+   // 在不同地方复用
+   await Step.run(createLoginStep('user1', 'pass1'));
+   await Step.run(createLoginStep('user2', 'pass2'));
+   ``` 

package/README.md

@@ -1,388 +1,132 @@
-# AssistsX
+# AssistsX JS
 
-Android WebView 辅助功能库，提供了一系列用于与 Android WebView 交互的 TypeScript 类型和方法，支持节点查找、手势操作、界面自动化等能力。
+一个支持通过Web端实现Android平台自动化脚本的JS库，支持元素节点查找、获取节点文本、节点截图、执行手势动作、提供步骤器实现复杂自动化业务等一系列自动化脚本开发能力支持
 
-## 安装
+# AssistsX JS运行平台
+开发的自动化脚本需要运行在Android端[AssistsX](https://www.pgyer.com/SqGaCx8C)中，所以开发前需要先在手机安装[AssistsX](https://www.pgyer.com/SqGaCx8C)
 
-```bash
-npm install assistsx
-```
+**扫码下载**
 
-## 快速开始
+<img width="112" alt="image" src="https://github.com/user-attachments/assets/c28ecc41-01f8-4e52-9ddc-80dc5c6d0ed5" />
 
-### 基本用法
+**下载链接：[https://www.pgyer.com/SqGaCx8C](https://www.pgyer.com/SqGaCx8C)**
 
-```typescript
-import { AssistsX, Node } from 'assistsx';
+> 下载安装后会默认安装一个示例插件，可长按删除
 
-// 获取所有节点
-const nodes: Node[] = AssistsX.getAllNodes();
+# 示例源码安装运行
 
-// 通过ID查找节点
-const nodeList: Node[] = AssistsX.findById('target_id');
+源码：[https://github.com/ven-coder/assistsx-js-simple](https://github.com/ven-coder/assistsx-js-simple)
 
-// 点击第一个节点
-if (nodeList.length > 0) {
-  AssistsX.click(nodeList[0]);
-}
+## 本地安装运行
 
-// 执行手势点击
-AssistsX.gestureClick(100, 200, 50); // 在(100,200)位置点击，持续50ms
-```
+### 1. 安装[AssistsX](https://www.pgyer.com/SqGaCx8C)
 
-### 节点对象的常用操作
+安装前请先在手机安装[AssistsX](https://www.pgyer.com/SqGaCx8C)
 
-```typescript
-const node: Node = nodeList[0];
+### 2. 插件包传至手机
+下载本示例源码后（*前提`npm`环境配置好*）
+1. 终端依次运行命令：`npm install`，`npm run build`
+2. 编译完成后将`dist`文件夹压缩为`.zip`文件，然后将`.zip`文件传至手机。
+3. 手机打开[AssistsX](https://www.pgyer.com/SqGaCx8C)，点击+号->本地添加->选择传至手机的`zip`压缩包
 
-// 设置节点文本
-node.setNodeText('new text');
 
-// 节点点击
-node.click();
+<img src="https://github.com/user-attachments/assets/7dc27910-be61-473b-8900-f09c16ca5f46" width="250">
 
-// 节点长按
-node.longClick();
+## 局域网加载运行
+> 确保手机与电脑处于同一个局域网
+### 1. 安装[AssistsX](https://www.pgyer.com/SqGaCx8C)
+加载运行前请先在手机安装[AssistsX](https://www.pgyer.com/SqGaCx8C)
 
-// 节点滚动
-node.scrollForward();
-node.scrollBackward();
+### 2. 启动项目
+下载本示例源码后，终端依次运行命令：`npm install`，`npm run dev`
 
-// 获取节点在屏幕中的位置
-const bounds = node.getBoundsInScreen();
-console.log(bounds);
-
-// 节点截图
-const imagePath = await node.takeScreenshot();
-```
+### 3. 加载插件
+手机打开[AssistsX](https://www.pgyer.com/SqGaCx8C)，点击+号->扫描局域网->点击扫描到插件+号
 
-### 复杂查找与遍历
+<img src="https://github.com/user-attachments/assets/d0f24763-266e-4e3c-bd64-a63be9e6c68c" width="250"/>
 
-```typescript
-// 通过文本查找节点
-const textNodes = AssistsX.findByText('确定');
-
-// 通过标签查找节点
-const tagNodes = AssistsX.findByTags('android.widget.Button', { filterText: '提交' });
-
-// 获取节点的所有子节点
-const children = node.getChildren();
+# 快速开始
+## 1. 创建项目
+- 创建`vite`模版项目：`npm create vite@latest assistsx-helloword -- --template vue`
+- 安装`assistsx-js`依赖：`npm install assistsx-js@latest`
+## 2. 创建插件配置
+在项目目录`public`下创建文件`assistsx_plugin_config.json`文件，将以下`json`复制粘贴到文件中
 ```
-
-## 主要类型说明
-
-### AssistsX
-
-- 提供静态方法用于节点查找、手势操作、系统操作等。
-- 常用方法：
-  - `getAllNodes`：获取所有节点
-  - `findById`、`findByText`、`findByTags`：多种查找方式
-  - `click`、`longClick`、`gestureClick`：节点点击与手势
-  - `takeScreenshotNodes`：节点截图
-  - `launchApp`、`back`、`home`、`notifications`、`recentApps`：系统操作
-
-### Node
-
-- 表示界面上的一个可交互元素，包含属性和操作方法。
-- 主要属性：
-  - `nodeId`、`text`、`des`、`viewId`、`className`
-  - `isScrollable`、`isClickable`、`isEnabled`
-- 主要方法：
-  - `setNodeText(text: string)`：设置文本
-  - `click()`、`longClick()`：点击/长按
-  - `scrollForward()`、`scrollBackward()`：滚动
-  - `getBoundsInScreen()`：获取屏幕位置
-  - `takeScreenshot()`：节点截图
-  - `findById`、`findByText`、`findByTags`：在当前节点范围内查找
-
-## 典型场景
-
-### 1. 自动化测试
-
-```typescript
-// 启动应用
-AssistsX.launchApp('com.example.app');
-
-// 等待并点击登录按钮
-const loginBtn = AssistsX.findByText('登录');
-if (loginBtn.length > 0) {
-  loginBtn[0].click();
+{
+  "name": "AssistsX示例",
+  "version": "1.0.0",
+  "description": "AssistsX示例",
+  "isShowOverlay": true,
+  "needScreenCapture": true,
+  "packageName": "com.assistsx.example",
+  "main": "index.html",
+  "icon": "vite.svg",
+  "overlayTitle": "AssistsX示例"
 }
-
-// 检查是否包含某文本
-const hasText = AssistsX.containsText('登录成功');
 ```
-
-### 2. 界面元素操作
-
-```typescript
-// 查找输入框并输入文本
-const input = AssistsX.findById('input_field');
-if (input.length > 0) {
-  input[0].setNodeText('测试文本');
+## 3. 编写脚本插件
+写一个最简单的，点击微信搜索进入搜索页面
+```agsl
+const handleClick = () => {
+  AssistsX.findById("com.tencent.mm:id/jha")[0].click()
 }
+```
 
-// 查找并点击提交按钮
-const submit = AssistsX.findByText('提交');
-if (submit.length > 0) {
-  submit[0].click();
-}
+增加一个测试按钮调用这个方法
+```agsl
+<button type="button" @click="handleClick">测试按钮</button>
 ```
 
-### 3. 手势操作
+## 4. 加载插件
+1. 通过[AssistsX](https://www.pgyer.com/SqGaCx8C)局域网加载插件
+> 加载插件前需要配置项目允许局域网访问，在文件`vite.config.js`添加以下配置
+```
+export default defineConfig({
+  plugins: [vue()],
+  server: {
+    host: '0.0.0.0', // 允许局域网访问
+    port: 5173
+  },
+})
+```
+运行项目`npm run dev`以便`AssistsX`直接加载
 
-```typescript
-// 简单点击
-AssistsX.gestureClick(100, 200, 50);
+1. 打开`AssistsX`，扫描局域网插件添加
 
-// 节点手势点击（支持偏移）
-const node = AssistsX.findById('target')[0];
-await node.nodeGestureClick({ 
-  offsetX: 10, 
-  offsetY: 10,
-  clickDuration: 50 
-});
+<img src="https://github.com/user-attachments/assets/d0f24763-266e-4e3c-bd64-a63be9e6c68c" width="250"/>
 
-// 双击操作
-await node.nodeGestureClickByDouble({
-  clickInterval: 200
-});
-```
+3. 测试插件：点击开始，打开微信消息列表，点击测试按钮
 
-### 4. 滚动和导航
+<img src="https://github.com/user-attachments/assets/e6e59149-ed78-42de-81a7-c3476b5472e6" width="250"/>
 
-```typescript
-// 系统导航
-AssistsX.back();      // 返回
-AssistsX.home();      // 主页
-AssistsX.notifications(); // 通知栏
 
-// 滚动操作
-const scrollable = AssistsX.findByTags('android.widget.ScrollView')[0];
-scrollable.scrollForward();
-scrollable.scrollBackward();
-```
+<br/>
+<br/>
 
-## 注意事项
-
-1. 使用前提
-   - 确保 Android WebView 中已注入 `assistsx` 对象
-   - 确保有足够的权限（如辅助功能权限）
-
-2. 性能建议
-   - 避免频繁查找节点，建议复用查找结果
-   - 截图等耗时操作请合理使用
-
-3. 异步操作
-   - 截图、手势等操作为异步方法，需使用 `await`
-   - 建议使用 try-catch 处理异常
-
-4. 节点状态
-   - 操作前建议检查节点的 `isEnabled`、`isClickable` 等状态
-   - 使用 `isVisible` 确认节点是否可见
-
-## API 文档
-
-详细的 API 文档请参考源码中的 TypeScript 类型定义和注释说明。
-
-## 问题反馈
-
-如有问题或建议，欢迎提交 Issue 或 Pull Request。
-
-## 步骤器（Step）使用说明
-
-步骤器提供了一种结构化的方式来组织和执行自动化操作，支持步骤的生命周期管理、状态控制和界面操作。
-
-### 基本用法
-
-```typescript
-import { Step } from 'assistsx';
-
-// 定义步骤实现
-async function loginStep(step: Step): Promise<Step | undefined> {
-    // 启动应用
-    step.launchApp('com.example.app');
-    
-    // 查找用户名输入框并输入
-    const usernameInput = step.findById('username_input');
-    if (usernameInput.length > 0) {
-        usernameInput[0].setNodeText('user123');
-    }
-    
-    // 查找密码输入框并输入
-    const passwordInput = step.findById('password_input');
-    if (passwordInput.length > 0) {
-        passwordInput[0].setNodeText('password123');
-    }
-    
-    // 点击登录按钮
-    const loginButton = step.findByText('登录');
-    if (loginButton.length > 0) {
-        loginButton[0].click();
-    }
-    
-    // 返回 undefined 表示步骤结束
-    return undefined;
-}
+**[API开发文档](https://github.com/ven-coder/assistsx-js/blob/main/README-DEV.md)**
 
-// 运行步骤
-await Step.run(loginStep, {
-    tag: 'login',           // 步骤标签
-    data: { user: 'test' }, // 步骤数据
-    delayMs: 1000          // 步骤延迟
-});
-```
+## 🙋有问题欢迎反馈交流
 
-### 步骤链式调用
+| QQ交流群| 个人微信 |
+|:---------:|:-----------:|
+| <img src="https://github.com/user-attachments/assets/732c38a5-7473-44ca-be76-d1fabb27aa5d" width=200/> | <img src="https://github.com/user-attachments/assets/b805f5a0-223b-415d-a34b-7659aa0bdf0a" width=200/>
 
-```typescript
-async function step1(step: Step): Promise<Step | undefined> {
-    // 执行某些操作
-    // ...
-    
-    // 返回下一个步骤
-    return step.next(step2, { tag: 'step2' });
-}
+# 💝 支持开源
 
-async function step2(step: Step): Promise<Step | undefined> {
-    // 执行某些操作
-    // ...
-    
-    // 重复当前步骤
-    if (needRepeat) {
-        return step.repeat();
-    }
-    
-    // 返回下一个步骤
-    return step.next(step3, { tag: 'step3' });
-}
+开源不易，您的支持是我坚持的动力！
 
-async function step3(step: Step): Promise<Step | undefined> {
-    // 执行最后的操作
-    // ...
-    
-    // 步骤结束
-    return undefined;
-}
+如果AssistsX JS对您的项目有帮助，可以通过以下方式支持我喔：
 
-// 运行步骤链
-await Step.run(step1, { tag: 'step1' });
-```
+### ⭐ Star支持
+- 给项目点个Star，让更多开发者发现这个框架
+- 分享给身边的朋友和同事
 
-### 异步操作处理
-
-```typescript
-async function asyncStep(step: Step): Promise<Step | undefined> {
-    // 等待异步操作
-    await step.delay(1000);
-    
-    // 执行异步方法
-    const result = await step.await(async () => {
-        // 异步操作
-        return 'result';
-    });
-    
-    // 节点截图
-    const node = step.findById('target')[0];
-    const imagePath = await step.takeScreenshotByNode(node);
-    
-    return undefined;
-}
-```
+### 💰 赞助支持
+- [爱发电支持](https://afdian.com/a/vencoder) - 您的每一份支持都是我们前进的动力
+- 一杯Coffee的微信赞赏
+
+<img width="200" alt="image" src="https://github.com/user-attachments/assets/3862a40c-631c-4ab0-b1e7-00ec3e3e00ad" />
+
+**定制开发可联系个人微信: x39598**
 
-## Step API 文档
-
-### 静态方法
-
-#### `Step.run(impl, options)`
-运行步骤实现。
-- `impl`: `(step: Step) => Promise<Step | undefined>` - 步骤实现函数
-- `options`: 
-  - `tag?: string` - 步骤标签
-  - `data?: any` - 步骤数据
-  - `delayMs?: number` - 步骤延迟时间(毫秒)，默认 1000
-
-#### `Step.stop()`
-停止当前步骤执行。
-
-### 实例属性
-
-- `stepId: string` - 步骤ID
-- `repeatCount: number` - 步骤重复执行次数
-- `tag?: string` - 步骤标签
-- `data?: any` - 步骤数据
-- `delayMs: number` - 步骤延迟时间(毫秒)
-
-### 实例方法
-
-#### 步骤控制
-- `next(impl, options)` - 创建下一个步骤
-- `repeat(options)` - 重复当前步骤
-- `delay(ms)` - 延迟执行
-- `await<T>(method)` - 等待异步方法执行完成
-
-#### 节点操作
-- `getAllNodes(options)` - 获取所有符合条件的节点
-- `findById(id, options)` - 通过ID查找节点
-- `findByText(text, options)` - 通过文本查找节点
-- `findByTags(className, options)` - 通过标签查找节点
-- `findByTextAllMatch(text)` - 查找所有匹配文本的节点
-- `findFirstParentByTags(className)` - 查找第一个匹配标签的父节点
-
-#### 界面操作
-- `takeScreenshotByNode(node, delay)` - 对单个节点进行截图
-- `takeScreenshotNodes(nodes, delay)` - 对多个节点进行截图
-- `gestureClick(x, y, duration)` - 执行点击手势
-- `back()` - 返回操作
-- `home()` - 回到主页
-- `notifications()` - 打开通知栏
-- `recentApps()` - 显示最近应用
-
-#### 应用控制
-- `launchApp(packageName)` - 启动应用
-- `getPackageName()` - 获取当前应用包名
-
-#### 其他操作
-- `containsText(text)` - 检查是否包含指定文本
-- `getAllText()` - 获取所有文本
-- `getScreenSize()` - 获取屏幕尺寸
-- `getAppScreenSize()` - 获取应用窗口尺寸
-
-## 最佳实践
-
-1. 步骤组织
-   - 将复杂的自动化流程拆分为多个步骤
-   - 每个步骤专注于完成特定的任务
-   - 使用有意义的标签和数据来标识步骤
-
-2. 错误处理
-   ```typescript
-   async function robustStep(step: Step): Promise<Step | undefined> {
-       try {
-           const node = step.findById('target')[0];
-           if (!node) {
-               throw new Error('Target node not found');
-           }
-           // ... 其他操作
-       } catch (error) {
-           console.error(`Step failed: ${error.message}`);
-           // 可以选择重试或执行其他步骤
-           return step.repeat({ delayMs: 2000 });
-       }
-   }
-   ```
-
-3. 步骤复用
-   ```typescript
-   // 创建可复用的步骤
-   function createLoginStep(username: string, password: string) {
-       return async function(step: Step): Promise<Step | undefined> {
-           // ... 登录逻辑
-           return undefined;
-       }
-   }
-
-   // 在不同地方复用
-   await Step.run(createLoginStep('user1', 'pass1'));
-   await Step.run(createLoginStep('user2', 'pass2'));
-   ``` 
+**感谢所有的支持者，得到你们的支持我将会更加完善开源库的能力！** 🚀

package/dist/AssistsX.js

@@ -204,7 +204,7 @@ export class AssistsX {
      * @returns 节点数组
      */
     static findByTextAllMatch(text) {
-        const response = this.call(CallMethod.findByTextAllMatch, { args: text });
+        const response = this.call(CallMethod.findByTextAllMatch, { args: { text } });
         return Node.fromJSONArray(response.getDataOrDefault("[]"));
     }
     /**
@@ -213,7 +213,7 @@ export class AssistsX {
      * @returns 是否包含
      */
     static containsText(text) {
-        const response = this.call(CallMethod.containsText, { args: text });
+        const response = this.call(CallMethod.containsText, { args: { text } });
         return response.getDataOrDefault(false);
     }
     /**
@@ -230,7 +230,7 @@ export class AssistsX {
      * @returns 父节点
      */
     static findFirstParentByTags(className) {
-        const response = this.call(CallMethod.findFirstParentByTags, { args: className });
+        const response = this.call(CallMethod.findFirstParentByTags, { args: { className } });
         return Node.create(response.getDataOrDefault("{}"));
     }
     /**

package/dist/Node.d.ts

@@ -93,7 +93,7 @@ export declare class Node {
      * @param filterDes 描述过滤
      * @returns 节点数组
      */
-    findByTags(className: string, { filterText, filterViewId, filterDes }: {
+    findByTags(className: string, { filterText, filterViewId, filterDes }?: {
         filterText?: string;
         filterViewId?: string;
         filterDes?: string;

package/dist/Node.js

@@ -54,7 +54,7 @@ export class Node {
      * @param filterDes 描述过滤
      * @returns 节点数组
      */
-    findByTags(className, { filterText, filterViewId, filterDes }) {
+    findByTags(className, { filterText, filterViewId, filterDes } = {}) {
         Step.assert(this.stepId);
         const result = AssistsX.findByTags(className, { filterText, filterViewId, filterDes, node: this });
         Step.assignIdsToNodes(result, this.stepId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistsx-js",
-  "version": "0.0.1",
+  "version": "0.0.12",
   "description": "assistsx-js自动化开发SDK",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/AssistsX.ts

@@ -230,7 +230,7 @@ export class AssistsX {
      * @returns 节点数组
      */
     public static findByTextAllMatch(text: string): Node[] {
-        const response = this.call(CallMethod.findByTextAllMatch, { args: text });
+        const response = this.call(CallMethod.findByTextAllMatch, { args: { text } });
         return Node.fromJSONArray(response.getDataOrDefault("[]"));
     }
 
@@ -240,7 +240,7 @@ export class AssistsX {
      * @returns 是否包含
      */
     public static containsText(text: string): boolean {
-        const response = this.call(CallMethod.containsText, { args: text });
+        const response = this.call(CallMethod.containsText, { args: { text } });
         return response.getDataOrDefault(false);
     }
 
@@ -259,7 +259,7 @@ export class AssistsX {
      * @returns 父节点
      */
     public static findFirstParentByTags(className: string): Node {
-        const response = this.call(CallMethod.findFirstParentByTags, { args: className });
+        const response = this.call(CallMethod.findFirstParentByTags, { args: { className } });
         return Node.create(response.getDataOrDefault("{}"));
     }
 

package/src/Node.ts

@@ -116,7 +116,7 @@ export class Node {
      * @param filterDes 描述过滤
      * @returns 节点数组
      */
-    public findByTags(className: string, { filterText, filterViewId, filterDes }: { filterText?: string, filterViewId?: string, filterDes?: string, }): Node[] {
+    public findByTags(className: string, { filterText, filterViewId, filterDes }: { filterText?: string, filterViewId?: string, filterDes?: string, } = {}): Node[] {
         Step.assert(this.stepId);
         const result = AssistsX.findByTags(className, { filterText, filterViewId, filterDes, node: this });
         Step.assignIdsToNodes(result, this.stepId);