assistsx-js 0.0.1353 → 0.0.2002

package/dist/StepAsync.js

@@ -0,0 +1,264 @@
+import { AssistsXAsync } from "./AssistsXAsync";
+import { Step } from "./Step";
+export class StepAsync {
+    /**
+     * 构造函数
+     * @param step Step实例
+     */
+    constructor(step) {
+        this.step = step;
+    }
+    /**
+     * 对单个节点进行截图
+     * @param node 目标节点
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径
+     */
+    async takeScreenshotByNode(node, overlayHiddenScreenshotDelayMillis = 250) {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.takeScreenshotNodes([node], overlayHiddenScreenshotDelayMillis);
+        Step.assert(this.step.stepId);
+        return result[0];
+    }
+    /**
+     * 对多个节点进行截图
+     * @param nodes 目标节点数组
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径数组
+     */
+    async takeScreenshotNodes(nodes, overlayHiddenScreenshotDelayMillis = 250) {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.takeScreenshotNodes(nodes, overlayHiddenScreenshotDelayMillis);
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 获取所有符合条件的节点
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param filterText 文本过滤
+     * @returns 节点数组
+     */
+    async getAllNodes({ filterClass, filterViewId, filterDes, filterText, } = {}) {
+        Step.assert(this.step.stepId);
+        const nodes = await AssistsXAsync.getAllNodes({
+            filterClass,
+            filterViewId,
+            filterDes,
+            filterText,
+        });
+        Step.assert(this.step.stepId);
+        Step.assignIdsToNodes(nodes, this.step.stepId);
+        return nodes;
+    }
+    /**
+     * 启动应用
+     * @param packageName 应用包名
+     * @returns 是否启动成功
+     */
+    async launchApp(packageName) {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.launchApp(packageName);
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 获取当前应用包名
+     * @returns 包名
+     */
+    async getPackageName() {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.getPackageName();
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 通过ID查找节点
+     * @param id 节点ID
+     * @param filterClass 类名过滤
+     * @param filterText 文本过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    async findById(id, { filterClass, filterText, filterDes, } = {}) {
+        Step.assert(this.step.stepId);
+        const nodes = await AssistsXAsync.findById(id, {
+            filterClass,
+            filterText,
+            filterDes,
+        });
+        Step.assert(this.step.stepId);
+        Step.assignIdsToNodes(nodes, this.step.stepId);
+        return nodes;
+    }
+    /**
+     * 通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    async findByText(text, { filterClass, filterViewId, filterDes, } = {}) {
+        Step.assert(this.step.stepId);
+        const nodes = await AssistsXAsync.findByText(text, {
+            filterClass,
+            filterViewId,
+            filterDes,
+        });
+        Step.assert(this.step.stepId);
+        Step.assignIdsToNodes(nodes, this.step.stepId);
+        return nodes;
+    }
+    /**
+     * 通过标签查找节点
+     * @param className 类名
+     * @param filterText 文本过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    async findByTags(className, { filterText, filterViewId, filterDes, } = {}) {
+        Step.assert(this.step.stepId);
+        const nodes = await AssistsXAsync.findByTags(className, {
+            filterText,
+            filterViewId,
+            filterDes,
+        });
+        Step.assert(this.step.stepId);
+        Step.assignIdsToNodes(nodes, this.step.stepId);
+        return nodes;
+    }
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @returns 节点数组
+     */
+    async findByTextAllMatch(text) {
+        Step.assert(this.step.stepId);
+        const nodes = await AssistsXAsync.findByTextAllMatch(text);
+        Step.assert(this.step.stepId);
+        Step.assignIdsToNodes(nodes, this.step.stepId);
+        return nodes;
+    }
+    /**
+     * 检查是否包含指定文本
+     * @param text 要检查的文本
+     * @returns 是否包含
+     */
+    async containsText(text) {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.containsText(text);
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 获取所有文本
+     * @returns 文本数组
+     */
+    async getAllText() {
+        Step.assert(this.step.stepId);
+        const texts = await AssistsXAsync.getAllText();
+        Step.assert(this.step.stepId);
+        return texts;
+    }
+    /**
+     * 执行点击手势
+     * @param x 横坐标
+     * @param y 纵坐标
+     * @param duration 持续时间(毫秒)
+     * @returns 是否成功
+     */
+    async clickByGesture(x, y, duration) {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.clickByGesture(x, y, duration);
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    async longPressGestureAutoPaste(point, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.longPressGestureAutoPaste(point, text, {
+            matchedPackageName,
+            matchedText,
+            timeoutMillis,
+            longPressDuration,
+        });
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    async getAppInfo(packageName) {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.getAppInfo(packageName);
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    async performLinearGesture(startPoint, endPoint, { duration } = {}) {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.performLinearGesture(startPoint, endPoint, {
+            duration,
+        });
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 返回操作
+     * @returns 是否成功
+     */
+    async back() {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.back();
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 回到主页
+     * @returns 是否成功
+     */
+    async home() {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.home();
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 打开通知栏
+     * @returns 是否成功
+     */
+    async notifications() {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.notifications();
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 显示最近应用
+     * @returns 是否成功
+     */
+    async recentApps() {
+        Step.assert(this.step.stepId);
+        const result = await AssistsXAsync.recentApps();
+        Step.assert(this.step.stepId);
+        return result;
+    }
+    /**
+     * 获取屏幕尺寸
+     * @returns 屏幕尺寸对象
+     */
+    async getScreenSize() {
+        Step.assert(this.step.stepId);
+        const data = await AssistsXAsync.getScreenSize();
+        Step.assert(this.step.stepId);
+        return data;
+    }
+    /**
+     * 获取应用窗口尺寸
+     * @returns 应用窗口尺寸对象
+     */
+    async getAppScreenSize() {
+        Step.assert(this.step.stepId);
+        const data = await AssistsXAsync.getAppScreenSize();
+        Step.assert(this.step.stepId);
+        return data;
+    }
+}

package/dist/StepError.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 步骤执行错误类
+ * 用于携带步骤执行过程中的错误信息和当前步骤对象
+ */
+export declare class StepError extends Error {
+    /**
+     * 步骤实现函数名
+     */
+    readonly impl: string;
+    /**
+     * 步骤标签
+     */
+    readonly tag: string | undefined;
+    /**
+     * 步骤数据
+     */
+    readonly data: any | undefined;
+    /**
+     * 原始错误
+     */
+    readonly originalError: any;
+    /**
+     * 当前步骤对象
+     */
+    readonly currentStep: any | undefined;
+    constructor(message: string, impl: string, tag: string | undefined, data: any | undefined, originalError: any, currentStep: any | undefined);
+}

package/dist/StepError.js

@@ -0,0 +1,15 @@
+/**
+ * 步骤执行错误类
+ * 用于携带步骤执行过程中的错误信息和当前步骤对象
+ */
+export class StepError extends Error {
+    constructor(message, impl, tag, data, originalError, currentStep) {
+        super(message);
+        this.name = "StepError";
+        this.impl = impl;
+        this.tag = tag;
+        this.data = data;
+        this.originalError = originalError;
+        this.currentStep = currentStep;
+    }
+}

package/dist/Utils.d.ts

@@ -1,2 +1,3 @@
 export declare function sleep(ms: number): Promise<void>;
 export declare function generateUUID(): string;
+export declare function decodeBase64UTF8(base64: string): string;

package/dist/Utils.js

@@ -1,12 +1,20 @@
 // 导出工具函数
 export function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
+    return new Promise((resolve) => setTimeout(resolve, ms));
 }
 // 生成UUID
 export function generateUUID() {
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
-        const r = Math.random() * 16 | 0;
-        const v = c === 'x' ? r : (r & 0x3 | 0x8);
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
         return v.toString(16);
     });
 }
+export function decodeBase64UTF8(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return new TextDecoder("utf-8").decode(bytes);
+}

package/dist/index.d.ts

@@ -1,10 +1,13 @@
-export * from './AssistsX';
-export * from './Node';
-export * from './CallMethod';
-export * from './CallResponse';
-export * from './NodeClassValue';
-export * from './Utils';
-export * from './Bounds';
-export * from './Step';
-export * from './StepStateStore';
-export * from './WindowFlags';
+export * from "./AssistsX";
+export * from "./Node";
+export * from "./CallMethod";
+export * from "./CallResponse";
+export * from "./NodeClassValue";
+export * from "./Utils";
+export * from "./Bounds";
+export * from "./Step";
+export * from "./StepStateStore";
+export * from "./WindowFlags";
+export * from "./NodeAsync";
+export * from "./AssistsXAsync";
+export * from "./StepAsync";

package/dist/index.js

@@ -1,10 +1,13 @@
-export * from './AssistsX';
-export * from './Node';
-export * from './CallMethod';
-export * from './CallResponse';
-export * from './NodeClassValue';
-export * from './Utils';
-export * from './Bounds';
-export * from './Step';
-export * from './StepStateStore';
-export * from './WindowFlags';
+export * from "./AssistsX";
+export * from "./Node";
+export * from "./CallMethod";
+export * from "./CallResponse";
+export * from "./NodeClassValue";
+export * from "./Utils";
+export * from "./Bounds";
+export * from "./Step";
+export * from "./StepStateStore";
+export * from "./WindowFlags";
+export * from "./NodeAsync";
+export * from "./AssistsXAsync";
+export * from "./StepAsync";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistsx-js",
-  "version": "0.0.1353",
+  "version": "0.0.2002",
   "description": "assistsx-js自动化开发SDK",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -40,4 +40,4 @@
   "dependencies": {
     "pinia": "^3.0.3"
   }
-}
+}