assistsx-js 0.1.41 → 0.2.0

package/dist/StepAsync.d.ts

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

package/dist/StepAsync.js

@@ -1,264 +0,0 @@
-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

@@ -1,35 +0,0 @@
-/**
- * 步骤执行错误类
- * 用于携带步骤执行过程中的错误信息和当前步骤对象
- * 支持传入可选数据：message，data任何类型的数据
- */
-export declare class StepError extends Error {
-    /**
-     * 步骤实现函数名
-     */
-    readonly impl?: string;
-    /**
-     * 步骤标签
-     */
-    readonly tag?: string | undefined;
-    /**
-     * 步骤数据，可以是任何类型
-     */
-    readonly data?: any;
-    /**
-     * 原始错误
-     */
-    readonly originalError?: any;
-    /**
-     * 当前步骤对象
-     */
-    readonly currentStep?: any;
-    constructor(message?: string, data?: any, impl?: string, tag?: string | undefined, originalError?: any, currentStep?: any | undefined);
-}
-/**
- * 主动停止异常类
- * 用于表示步骤被主动停止执行
- */
-export declare class StepStopError extends StepError {
-    constructor(message?: string, data?: any);
-}

package/dist/StepError.js

@@ -1,26 +0,0 @@
-/**
- * 步骤执行错误类
- * 用于携带步骤执行过程中的错误信息和当前步骤对象
- * 支持传入可选数据：message，data任何类型的数据
- */
-export class StepError extends Error {
-    constructor(message, data, impl, tag, originalError, currentStep) {
-        super(message);
-        this.name = "StepError";
-        this.data = data;
-        this.impl = impl;
-        this.tag = tag;
-        this.originalError = originalError;
-        this.currentStep = currentStep;
-    }
-}
-/**
- * 主动停止异常类
- * 用于表示步骤被主动停止执行
- */
-export class StepStopError extends StepError {
-    constructor(message, data) {
-        super(message || "主动中断步骤", data);
-        this.name = "StepStopError";
-    }
-}

package/dist/StepStateStore.d.ts

@@ -1,14 +0,0 @@
-export type StepStatus = 'idle' | 'running' | 'completed' | 'error';
-export interface StepState {
-    status: StepStatus;
-    stepId?: string;
-    tag?: string;
-    data?: any;
-    error?: string;
-}
-export declare const useStepStore: import("pinia").StoreDefinition<"step", StepState, {}, {
-    startStep(stepId: string, tag?: string, data?: any): void;
-    completeStep(): void;
-    setError(error: string): void;
-    reset(): void;
-}>;

package/dist/StepStateStore.js

@@ -1,37 +0,0 @@
-import { defineStore } from 'pinia';
-export const useStepStore = defineStore('step', {
-    state: () => ({
-        status: 'idle',
-        stepId: undefined,
-        tag: undefined,
-        data: undefined,
-        error: undefined
-    }),
-    actions: {
-        // 开始执行步骤
-        startStep(stepId, tag, data) {
-            this.status = 'running';
-            this.stepId = stepId;
-            this.tag = tag;
-            this.data = data;
-            this.error = undefined;
-        },
-        // 完成步骤
-        completeStep() {
-            this.status = 'completed';
-        },
-        // 步骤出错
-        setError(error) {
-            this.status = 'error';
-            this.error = error;
-        },
-        // 重置状态
-        reset() {
-            this.status = 'idle';
-            this.stepId = undefined;
-            this.tag = undefined;
-            this.data = undefined;
-            this.error = undefined;
-        }
-    }
-});

package/dist/Utils.d.ts

@@ -1,3 +0,0 @@
-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,20 +0,0 @@
-// 导出工具函数
-export function sleep(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 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/WindowFlags.d.ts

@@ -1,75 +0,0 @@
-/**
- * 窗口标志位常量类
- * 定义了各种窗口行为和属性的标志位
- */
-export declare class WindowFlags {
-    /** 不获取焦点 */
-    static readonly FLAG_NOT_FOCUSABLE = 8;
-    /** 不响应触摸 */
-    static readonly FLAG_NOT_TOUCHABLE = 16;
-    /** 不拦截触摸 */
-    static readonly FLAG_NOT_TOUCH_MODAL = 32;
-    /** 监听窗外点击 */
-    static readonly FLAG_WATCH_OUTSIDE_TOUCH = 4;
-    /** 可绘制超出屏幕 */
-    static readonly FLAG_LAYOUT_NO_LIMITS = 512;
-    /** 屏幕全区域布局 */
-    static readonly FLAG_LAYOUT_IN_SCREEN = 256;
-    /** 全屏显示 */
-    static readonly FLAG_FULLSCREEN = 1024;
-    /** 背景变暗 */
-    static readonly FLAG_DIM_BEHIND = 2;
-    /** 防录屏防截图 */
-    static readonly FLAG_SECURE = 8192;
-    /** 保持常亮 */
-    static readonly FLAG_KEEP_SCREEN_ON = 128;
-    /** 锁屏时可见 */
-    static readonly FLAG_SHOW_WHEN_LOCKED = 524288;
-    /** 解锁屏幕 */
-    static readonly FLAG_DISMISS_KEYGUARD = 4194304;
-    /** 点亮屏幕 */
-    static readonly FLAG_TURN_SCREEN_ON = 2097152;
-    /** 自动锁屏（不常用） */
-    static readonly FLAG_ALLOW_LOCK_WHILE_SCREEN_ON = 128;
-    /** 显示墙纸 */
-    static readonly FLAG_SHOW_WALLPAPER = 1048576;
-    /** 强制硬件加速 */
-    static readonly FLAG_HARDWARE_ACCELERATED = 16777216;
-    /**
-     * 获取标志位的十六进制表示
-     * @param flag 标志位值
-     * @returns 十六进制字符串
-     */
-    static toHex(flag: number): string;
-    /**
-     * 检查是否包含指定标志位
-     * @param flags 当前标志位组合
-     * @param flag 要检查的标志位
-     * @returns 是否包含该标志位
-     */
-    static hasFlag(flags: number, flag: number): boolean;
-    /**
-     * 添加标志位
-     * @param flags 当前标志位组合
-     * @param flag 要添加的标志位
-     * @returns 新的标志位组合
-     */
-    static addFlag(flags: number, flag: number): number;
-    /**
-     * 移除标志位
-     * @param flags 当前标志位组合
-     * @param flag 要移除的标志位
-     * @returns 新的标志位组合
-     */
-    static removeFlag(flags: number, flag: number): number;
-    /**
-     * 获取所有标志位的描述信息
-     * @returns 标志位描述对象数组
-     */
-    static getAllFlags(): Array<{
-        name: string;
-        value: number;
-        hex: string;
-        description: string;
-    }>;
-}