deeke-script-app 1.5.6 → 1.5.8

package/@deekeScript/@type/interface/UiObject.d.ts

@@ -107,6 +107,33 @@ declare global {
          */
         public length(): number;
 
+        /**
+         * 获取多个子控件
+         * @param uiSelector 查询条件
+         */
+        public findChildren(uiSelector: UiSelector): UiObject[];
+
+        /**
+         * 获取一个子控件
+         * @param uiSelector 查询条件
+         */
+        public findChild(uiSelector: UiSelector): UiObject;
+
+        /**
+         * 获取子控件数量
+         */
+        public childCount(): number;
+
+        /**
+         * 获取父控件
+         */
+        public parent(): UiObject;
+
+        /**
+         * 获取控件的层级
+         */
+        public depth(): number;
+
         /**
          * 获取控件的绘制顺序
          */
@@ -117,22 +144,25 @@ declare global {
          */
         public isSelected(): boolean;
 
+        /**
+        * 判断控件是否可以点击
+        */
+        public isClickable(): boolean;
+
         /**
          * 判断控件是否可以长按
          */
         public isLongClickable(): boolean;
 
         /**
-         * 判断控件是否可以点击
-         */
-        public isClickable(): boolean;
+        * 判断控件是否可以选中
+        */
+        public isCheckable(): boolean;
 
         /**
-         * 判断控件是否可以编辑
-         */
-        public isEditable(): boolean;
-
-        // public isFocusable(): boolean;
+        * 判断控件是否被选中
+        */
+        public isChecked(): boolean;
 
         /**
          * 判断控件是否可用
@@ -140,96 +170,121 @@ declare global {
         public isEnabled(): boolean;
 
         /**
-         * 判断控件是否是密码控件
+        * 判断控件是否获得焦点
+        */
+        public isFocusable(): boolean;
+
+        /**
+         * 获取控件是否获得焦点
          */
-        public isPassword(): boolean;
+        public isFocused(): boolean;
+
 
         /**
          * 判断控件是否可以滚动
          */
         public isScrollable(): boolean;
 
+
         /**
          * 判断控件是否对用户可见
          */
         public isVisibleToUser(): boolean;
 
+
         /**
-         * 判断控件是否被选中
+         * 判断控件是否可以编辑
          */
-        public isChecked(): boolean;
+        public isEditable(): boolean;
 
         /**
-         * 判断控件是否可以选中
+         * 判断控件是否是密码控件
          */
-        public isCheckable(): boolean;
+        public isPassword(): boolean;
+
+        /**
+         * 获取控件的className
+         */
+        public className(): string;
+
+        /**
+         * 获取控件的包名
+         */
+        public getPackageName(): string;
+
 
         /**
          * 设置控件是否可以点击
          * @param clickable 是否可以点击
          */
-        public setClickable(clickable: boolean): boolean;
+        public setClickable(clickable: boolean): UiObject;
 
         /**
          * 设置控件是否可以被长按
          * @param longClickable 是否可以长按
          */
-        public setLongClickable(longClickable: boolean): boolean;
+        public setLongClickable(longClickable: boolean): UiObject;
 
         /**
          * 设置控件是否可以编辑
          * @param editable 是否可以编辑
          */
-        public setEditable(editable: boolean): boolean;
+        public setEditable(editable: boolean): UiObject;
 
         /**
          * 设置控件是否可用
          * @param enabled 是否可用
          */
-        public setEnabled(enabled: boolean): boolean;
+        public setEnabled(enabled: boolean): UiObject;
 
-        //public setCheckable(checkable: boolean): boolean
+        /**
+         * 设置控件是否可以选中
+         * @param checkable 是否可以选中
+         */
+        public setCheckable(checkable: boolean): boolean
 
         /**
          * 设置控件是否选中
          * @param checked 是否选中
          */
-        public setChecked(checked: boolean): boolean
+        public setChecked(checked: boolean): UiObject
 
         /**
-         * 设置控件是否获得焦点
-         * @param focusable 是否可获得焦点
+         * 设置控件是否选中
+         * @param selected 是否选中
          */
-        public setFocusable(focusable: boolean): boolean
+        public setSelected(selected: boolean): UiObject
 
         /**
-         * 设置是否用户可见
-         * @param visibleToUser 是否对用户可见
+         * 设置控件是否获得焦点
+         * @param focusable 是否可获得焦点
          */
-        public setVisibleToUser(visibleToUser: boolean): boolean
+        public setFocusable(focusable: boolean): UiObject
 
         /**
-         * 设置是否获得焦点
-         * @param focused 是否获得焦点
+         * 设置控件是否获得焦点
+         * @param focusable 是否获得焦点
          */
-        public setFocused(focused: boolean): boolean
-
-        //public setScrollable(scrollable: boolean): boolean
+        public setFocused(focusable: boolean): UiObject
 
         /**
-         * 设置是否选中
-         * @param selected 是否选中
+         * 设置控件是否可以滚动
+         * @param scrollable 是否可以滚动
          */
-        public setSelected(selected: boolean): boolean
+        public setScrollable(scrollable: boolean): UiObject
 
         /**
          * 
          * 设置是否是密码控件
          * @param password 是否是密码控件
          */
-        public setPassword(password: boolean): boolean
+        public setPassword(password: boolean): UiObject
 
-        //public setContentDescription(contentDescription: string): boolean
+        /**
+         * 设置是否用户可见
+         * @param visibleToUser 是否对用户可见
+         */
+        public setVisibleToUser(visibleToUser: boolean): UiObject
     }
 }
 export { };

package/README.md

@@ -1,35 +1,67 @@
-## DeekeScript应用代码
-
-**DeekeScript/deekeScript** 是采用DeekeScript框架开发✨模拟点击（代替人工操控基于Android的移动设备）✨类产品的模版。在环境安装好之后，拉取本仓库到本地，即可开启美妙的旅途~~
-
-**最终能开发出什么样的应用❓请移步查阅：
-[https://github.com/DeekeScript/ad-deeke](https://github.com/DeekeScript/ad-deeke)**
-
-
-## 使用步骤
-
-
-### 安装前准备
-> 请移步到<a target="_blank" href="https://doc.deeke.cn">https://doc.deeke.cn</a> 或者 <a target="_blank" href="https://deekescript.github.io/">https://deekescript.github.io/</a>
->
-> 阅读上述文档内容，并且安装相关软件和依赖
-
-### 安装方式一：npm安装方式【推荐】
->
-> 步骤一：创建文件夹
-> 
-> 步骤二：执行下面的脚本
-```npm i deeke-script-app```
-
-### 安装方式二：git&npm安装方式
->
-> git clone https://github.com/DeekeScript/deekeScript.git ./
-> 
-> npm install
-
-### 编写代码
-> 请在src下创建代码文件
-
-
-## Tips 📢
-> 文件夹@deekeScript请不要删除，此代码会提供代码提示能力~
+# DeekeScript 应用开发模板
+
+## 📖 项目简介
+
+**DeekeScript** 是一个专为Android自动化脚本开发设计的强大框架，核心能力是为开发者快速打造一站式商业化自动化应用
+
+本项目是DeekeScript的初始库demo，为您提供了一个完整的开发模板，帮助您快速上手DeekeScript开发。
+
+## 🌟 主要特性
+
+- **模拟点击操作** - 精确模拟用户点击、滑动等操作
+- **图像识别** - 基于图像匹配的智能识别功能
+- **多线程支持** - 支持并发任务处理
+- **丰富的API** - 提供完整的设备控制、网络请求、存储等API
+- **TypeScript支持** - 完整的类型定义，提供智能代码提示
+- **模块化设计** - 支持模块化开发，代码结构清晰
+
+## 🔗 相关链接
+
+### 官方资源
+- **官方网站**: [https://deeke.cn](https://deeke.cn)
+- **官方文档**: [https://doc.deeke.cn](https://doc.deeke.cn)
+
+- **完整应用示例**: [https://github.com/DeekeScript/ad-deeke](https://github.com/DeekeScript/ad-deeke)
+
+## 🚀 快速开始
+
+### 环境准备
+
+在开始使用之前，请确保您已经：
+
+1. 阅读了官方文档：[https://doc.deeke.cn](https://doc.deeke.cn)
+2. 安装了相关软件和依赖
+3. 配置了Android开发环境
+
+### 安装方式
+
+#### 方式一：npm安装（推荐）
+
+```bash
+npm i deeke-script-app
+```
+
+#### 方式二：Git克隆
+
+```bash
+git clone https://github.com/DeekeScript/deekeScript.git ./
+npm install
+```
+
+### 项目结构
+
+```
+Typescript/
+├── @deekeScript/          # TypeScript类型定义文件（请勿删除）
+│   └── @type/
+├── src/                   # 源代码目录
+│   ├── index.js          # 主入口文件
+│   ├── task/             # 任务相关代码
+│   └── statistics/       # 统计相关代码
+├── script/               # 编译后的脚本文件
+├── test/                 # 测试文件
+└── images/               # 图片资源
+```
+
+
+**开始您的DeekeScript开发之旅吧！** 🎉