Auto.js 3.0.0 文档
+Auto.js 4.1.0 文档
索引 | @@ -77,8 +77,9 @@
目录
目录
-
@@ -117,10 +123,14 @@
- console.warn([data][, ...args])
- console.error([data][, ...args])
- console.assert(value, message) +
- console.time([label]) +
- console.timeEnd(label) +
- console.trace([data][, ...args])
- console.input(data[, ...args])
- console.rawInput(data[, ...args])
- console.setSize(w, h)
- console.setPosition(x, y) +
- console.setGlobalLogConfig(config)
- print(text)
目录
目录
目录
-
-
- images.requestScreenCapture([landscape]) -
- images.captureScreen() -
- images.captureScreen(path) -
- images.pixel(image, x, y) -
- images.copy(img) -
- images.save(image, path[, format = "png", quality = 100]) +
- 图片处理
- images.read(path)
- images.load(url) +
- images.copy(img) +
- images.save(image, path[, format = "png", quality = 100])
- images.fromBase64(base64)
- images.toBase64(img[, format = "png", quality = 100])
- images.fromBytes(bytes)
- images.toBytes(img[, format = "png", quality = 100])
- images.clip(img, x, y, w, h) +
- images.resize(img, size[, interpolation]) +
- images.scale(img, fx, fy[, interpolation]) +
- images.rotate(img, degress[, x, y]) +
- images.concat(img1, image2[, direction]) +
- images.grayscale(img) +
- image.threshold(img, threshold, maxVal[, type]) +
- images.adaptiveThreshold(img, maxValue, adaptiveMethod, thresholdType, blockSize, C) +
- images.cvtColor(img, code[, dstCn]) +
- images.inRange(img, lowerBound, upperBound) +
- images.interval(img, color, interval) +
- images.blur(img, size[, anchor, type]) +
- images.medianBlur(img, size) +
- images.gaussianBlur(img, size[, sigmaX, sigmaY, type]) +
- images.matToImage(mat) +
- 找图找色 +
- images.requestScreenCapture([landscape]) +
- images.captureScreen() +
- images.captureScreen(path) +
- images.pixel(image, x, y)
- images.findColor(image, color, options)
- images.findColorInRegion(img, color, x, y[, width, height, threshold])
- images.findColorEquals(img, color[, x, y, width, height]) @@ -482,6 +510,21 @@
- images.detectsColor(image, color, x, y[, threshold = 16, algorithm = "diff"])
- images.findImage(img, template[, options])
- images.findImageInRegion(img, template, x, y[, width, height, threshold]) +
- images.matchTemplate(img, template, options) +
目录
-
@@ -552,6 +602,7 @@
目录
- selector() +
- UiSelector.algorithm(algorithm)
- UiSelector.text(str)
- UiSelector.textContains(str)
- UiSelector.textStartsWith(prefix) @@ -933,35 +984,30 @@
- 新建一个文件夹，命名为项目名称。 -
- 在该文件夹下新建脚本，或者移动脚本到该文件夹，命名为main.js，表示主脚本。脚本打包后将会从该脚本开始运行。 -
- 把其他资源或脚本放在该文件夹，并通过相对路径引用。 -
- 通过文件夹菜单的"打包"功能来打包该项目 -
- 新建一个文件夹，命名为项目名称。 -
- 在该文件夹下新建脚本，或者移动脚本到该文件夹，命名为main.js，表示主脚本。脚本打包后将会从该脚本开始运行。 -
- 在该文件夹下新建一个project.json的文件，其内容如下：
{ -"name": "项目名称", -"versionName": "1.0.0", -"versionCode": 1, -"packageName": "org.autojs.example", -"main": "main.js", -"launchConfig": { - "hideLogs": true +如何使打包的应用不显示主界面#
+需要使用项目功能。新建项目后，修改项目下的
+project.json文件，增加以下条目："launchConfig": { + "hideLogs": true } +例如：
+
其中，项目名称改为自己的项目名称，"org.autojs.example"改成自己的包名，下面的"launchConfig"表示启动配置，"hideLogs"表示隐藏日志。{ + "name": "项目名称", + "versionName": "1.0.0", + "versionCode": 1, + "packageName": "org.autojs.example", + "main": "main.js", + "launchConfig": { + "hideLogs": true + } } -
- - 通过文件夹菜单的"打包"功能来打包该项目 -
综述#
Q & A#
如何定时运行脚本#
点击脚本右边的菜单按钮->更多->定时任务即可定时运行脚本，但是必须保持Auto.js后台运行(自启动白名单、电源管理白名单等)。同时，可以在脚本的开头使用device.wakeUp()来唤醒屏幕；但是，Auto.js没有解锁屏幕的功能，因此难以在有锁屏密码的设备上达到效果。
如何把图片和脚本一起打包，或者打包多个脚本#
-如果除了单脚本以外还有其他脚本、图片、音乐等资源一起打包，则需要使用项目打包功能。
--
-
定时任何如何获取外部参数#
+如果一个脚本是用intent"启动"的，比如定时任务中的特定事件（网络状态变化等）触发而启动的，则可以通过engines.myEngine().execArgv.intent获取启动的intent，从而获取外部参数。
如何把图片和脚本一起打包，或者打包多个脚本#
+如果除了单脚本以外还有其他脚本、图片、音乐等资源一起打包，则需要使用项目功能。
+点击Auto.js的"+"号，选择项目，填写项目名称、包名等信息以后，点击"√"即可新建一个项目。可以在项目中放多个脚本、模块、资源文件，点击项目工具栏的apk打包图标即可打包一个项目，点击工具栏可以重新配置项目。
例如，主脚本要读取同一文件夹下的图片1.png，再执行找图，则可以通过images.read("./1.png")来读取，其中"./1.png"表示同一目录1.png图片；ui中的图片控件要引用同一文件夹的2.png图片则为<img src="file://2.png"/>。Auto.js内置的函数和模块都支持相对路径，但是，其他情况则需要使用files.path()函数来把相对路径转换为绝对路径。
目前Auto.js还不支持项目的图形化管理，后续会加入。
-如何使打包的应用不显示主界面#
-需要使用项目打包功能。
--
-
有关项目打包和配置的更多信息，参见项目与项目配置(待补)。
+"launchConfig"表示启动配置，"hideLogs"表示隐藏日志。
+参见项目与项目配置。
Auto.js自带的模块和函数中没有的功能如何实现#
由于Auto.js支持直接调用Android的API，对于Auto.js没有内置的函数，可以直接通过修改Android代码为JavaScript代码实现。例如旋转图片的Android代码为：
import android.graphics.Bitmap;
@@ -1060,7 +1106,7 @@ app.getPackageName(appName)#
用其他应用查看文件。文件不存在的情况由查看文件的应用处理。
如果找不出可以查看该文件的应用，则抛出ActivityNotException。
@@ -1068,7 +1114,7 @@ app.viewFile(path)#
用其他应用编辑文件。文件不存在的情况由编辑文件的应用处理。
如果找不出可以编辑该文件的应用，则抛出ActivityNotException。
@@ -1132,17 +1178,36 @@ app.sendEmail(options)#
-- options <Object> 选项，包括：
-action <string> 意图的Action，指意图要完成的动作，是一个字符串常量，比如"android.intent.action.SEND"。当action以"android.intent.action"开头时，可以省略前缀，直接用"SEND"代替。常见的action参见常用的意图动作。type <string> 意图的MimeType，表示和该意图直接相关的数据的类型，表示比如"text/plain"为纯文本类型。data <string> 意图的Data，表示和该意图直接相关的数据，是一个Uri, 可以是文件路径或者Url等。例如要打开一个文件, action为"android.intent.action.VIEW", data为"file:///sdcard/1.txt"。category <Array> 意图的类别。比较少用。packageName <string> 目标包名className <string> 目标Activity或Service等组件的名称extras <Object> 以键值对构成的这个Intent的Extras(额外信息)。提供该意图的其他信息，例如发送邮件时的邮件标题、邮件正文。options <Object> 选项，包括：
+
+action <string> 意图的Action，指意图要完成的动作，是一个字符串常量，比如"android.intent.action.SEND"。当action以"android.intent.action"开头时，可以省略前缀，直接用"SEND"代替。参见Actions。
+type <string> 意图的MimeType，表示和该意图直接相关的数据的类型，表示比如"text/plain"为纯文本类型。
+data <string> 意图的Data，表示和该意图直接相关的数据，是一个Uri, 可以是文件路径或者Url等。例如要打开一个文件, action为"android.intent.action.VIEW", data为"file:///sdcard/1.txt"。
+category <Array> 意图的类别。比较少用。参见Categories。
+packageName <string> 目标包名
+className <string> 目标Activity或Service等组件的名称
+extras <Object> 以键值对构成的这个Intent的Extras(额外信息)。提供该意图的其他信息，例如发送邮件时的邮件标题、邮件正文。参见Extras。
+flags <Array> intent的标识，字符串数组，例如["activity_new_task", "grant_read_uri_permission"]。参见Flags。
+[v4.1.0新增]
+root <Boolea> 是否以root权限启动、发送该intent。使用该参数后，不能使用context.startActivity()等方法，而应该直接使用诸如app.startActivity({...})的方法。
+[v4.1.0新增]
+
@@ -1154,19 +1219,75 @@ app.sendEmail(options)安卓Intent或参考Android指南: Intent。
+context.startActivity(i);
+需要注意的是，除非应用专门暴露Activity出来，否则在没有root权限的情况下使用intent是无法跳转到特定Activity、应用的特定界面的。例如我们能通过Intent跳转到QQ的分享界面，是因为QQ对外暴露了分享的Activity；而在没有root权限的情况下，我们无法通过intent跳转到QQ的设置界面，因为QQ并没有暴露这个Activity。
+但如果有root权限，则在intent的参数加上"root": true即可。例如使用root权限跳转到Auto.js的设置界面为：
+app.startActivity({
+ packageName: "org.autojs.autojs",
+ className: "org.autojs.autojs.ui.settings.SettingsActivity_",
+ root: true
+});
+
另外，关于intent的参数如何获取的问题，一些intent是意外发现并且在网络中传播的（例如跳转QQ聊天窗口是因为QQ给网页提供了跳转到客服QQ的方法），如果要自己获取活动的intent的参数，可以通过例如"intent记录"，"隐式启动"等应用拦截内部intent或者查询暴露的intent。其中拦截内部intent需要XPosed框架，或者可以通过反编译等手段获取参数。总之，没有简单直接的方法。
+更多信息，请百度安卓Intent或参考Android指南: Intent。
app.startActivity(options)#
根据选项构造一个Intent，并启动该Activity。
-app.sendBroadcast(options)#
+app.startActivity({
+ action: "SEND",
+ type: "text/plain",
+ data: "file:///sdcard/1.txt"
+});
+
app.sendBroadcast(options)#
根据选项构造一个Intent，并发送该广播。
-
+app.startService(options)#
+
+options <Object> 选项
+根据选项构造一个Intent，并启动该服务。
+app.sendBroadcast(name)#
+[v4.1.0新增]
+
+name <string> 特定的广播名称，包括：
+inspect_layout_hierarchy 布局层次分析inspect_layout_bounds 布局范围
+
+发送以上特定名称的广播可以触发Auto.js的布局分析，方便脚本调试。这些广播在Auto.js发送才有效，在打包的脚本上运行将没有任何效果。
+app.sendBroadcast("inspect_layout_bounds");
+
app.intentToShell(options)#
+[v4.1.0新增]
+
+options <Object> 选项
+根据选项构造一个Intent，转换为对应的shell的intent命令的参数。
+例如:
+shell("am start " + app.intentToShell({
+ packageName: "org.autojs.autojs",
+ className: "org.autojs.autojs.ui.settings.SettingsActivity_"
+}), true);
+
参见intent参数的规范。
+app.parseUri(uri)#
+[v4.1.0新增]
+
+uri <string> 一个代表Uri的字符串，例如"file:///sdcard/1.txt", "https://www.autojs.org"- 返回 <Uri> 一个代表Uri的对象，参见android.net.Uri。
+
+解析uri字符串并返回相应的Uri对象。即使Uri格式错误，该函数也会返回一个Uri对象，但之后如果访问该对象的scheme, path等值可能因解析失败而返回null。
+需要注意的是，在高版本Android上，由于系统限制直接在Uri暴露文件的绝对路径，因此如果uri字符串是文件file://...，返回的Uri会是诸如content://...的形式。
+app.getUriForFile(path)#
+[v4.1.0新增]
+
+path <string> 文件路径，例如"/sdcard/1.txt"- 返回 <Uri> 一个指向该文件的Uri的对象，参见android.net.Uri。
+
+从一个文件路径创建一个uri对象。需要注意的是，在高版本Android上，由于系统限制直接在Uri暴露文件的绝对路径，因此返回的Uri会是诸如content://...的形式。
+
Console#
Stability: 2 - Stable控制台模块提供了一个和Web浏览器中相似的用于调试的控制台。用于输出一些调试信息、中间结果等。
@@ -1179,8 +1300,8 @@
console.clear()#
-data ...args data <any>...args <any>
打印到控制台，并带上换行符。 可以传入多个参数，第一个参数作为主要信息，其他参数作为类似于 printf(3) 中的代替值（参数都会传给 util.format()）。
const count = 5;
@@ -1192,26 +1313,26 @@ console.log([data][, ...args])#
-data ...args data <any>...args <any>
与console.log类似，但输出结果以灰色字体显示。输出优先级低于log，用于输出观察性质的信息。
console.info([data][, ...args])#
-data ...args data <any>...args <any>
与console.log类似，但输出结果以绿色字体显示。输出优先级高于log, 用于输出重要信息。
console.warn([data][, ...args])#
-data ...args data <any>...args <any>
与console.log类似，但输出结果以蓝色字体显示。输出优先级高于info, 用于输出警告信息。
console.error([data][, ...args])#
-data ...args data <any>...args <any>
与console.log类似，但输出结果以红色字体显示。输出优先级高于warn, 用于输出错误信息。
console.assert(value, message)#
@@ -1222,10 +1343,46 @@ console.assert(value, message)#
+
console.time([label])#
+[v4.1.0新增]
+
+label <String> 计时器标签，可省略
+启动一个定时器，用以计算一个操作的持续时间。
+定时器由一个唯一的 label 标识。
+当调用 console.timeEnd() 时，可以使用相同的 label 来停止定时器，并以毫秒为单位将持续时间输出到控制台。
+重复启动同一个标签的定时器会覆盖之前启动同一标签的定时器。
+console.timeEnd(label)#
+[v4.1.0新增]
+
+label <String> 计时器标签
+停止之前通过调用 console.time() 启动的定时器，并打印结果到控制台。
+调用 console.timeEnd() 后定时器会被删除。如果不存在标签指定的定时器则会打印 NaNms。
+console.time('求和');
+var sum = 0;
+for(let i = 0; i < 100000; i++){
+ sum += i;
+}
+console.timeEnd('求和');
+// 打印 求和: xxx ms
+
+console.trace([data][, ...args])#
+[v4.1.0新增]
+
+data <any>...args <any>
+与console.log类似，同时会打印出调用这个函数所在的调用栈信息（即当前运行的文件、行数等信息）。
+console.trace('Show me');
+// 打印: (堆栈跟踪会根据被调用的跟踪的位置而变化)
+// Show me
+// at <test>:7
+
+console.input(data[, ...args])#
-data ...args data <any>...args <any>
与console.log一样输出信息，并在控制台显示输入框等待输入。按控制台的确认按钮后会将输入的字符串用eval计算后返回。
部分机型可能会有控制台不显示输入框的情况，属于bug。
@@ -1236,8 +1393,8 @@ console.assert(value, message)#
-data ...args data <any>...args <any>
与console.log一样输出信息，并在控制台显示输入框等待输入。按控制台的确认按钮后会将输入的字符串直接返回。
部分机型可能会有控制台不显示输入框的情况，属于bug。
@@ -1263,7 +1420,24 @@ console.assert(value, message)#
+console.setGlobalLogConfig(config)#
+[v4.1.0新增]
+
+config <Object> 日志配置，可选的项有：
+
+设置日志保存的路径和配置。例如把日志保存到"/sdcard/1.txt":
+console.setGlobalLogConfig({
+ "file": "/sdcard/1.txt"
+});
+
注意该函数会影响所有脚本的日志记录。
+print(text)#
@@ -2225,6 +2399,10 @@ engines.stopAllAndToast()#
返回当前脚本的脚本引擎对象(ScriptEngine)
+[v4.1.0新增]
+特别的，该对象可以通过execArgv来获取他的运行参数，包括外部参数、intent等。例如：
+log(engines.myEngine().execArgv);
+
普通脚本的运行参数通常为空，通过定时任务的广播启动的则可以获取到启动的intent。
engines.all()#
- 返回 <Array>
@@ -3297,6 +3475,23 @@ runtime.requestPermissions(permissions)Permissions Overview。（并没有用）
+runtime.loadJar(path)#
+
+path <string> jar文件路径
+加载目标jar文件，加载成功后将可以使用该Jar文件的类。
+// 加载jsoup.jar
+runtime.loadJar("./jsoup.jar");
+// 使用jsoup解析html
+importClass(org.jsoup.Jsoup);
+log(Jsoup.parse(files.read("./test.html")));
+
(jsoup是一个Java实现的解析Html DOM的库，可以在Jsoup下载)
+runtime.loadDex(path)#
+
+path <string> dex文件路径
+加载目标dex文件，加载成功后将可以使用该dex文件的类。
+因为加载jar实际上是把jar转换为dex再加载的，因此加载dex文件会比jar文件快得多。可以使用Android SDK的build tools的dx工具把jar转换为dex。
context#
全局变量。一个android.content.Context对象。
注意该对象为ApplicationContext，因此不能用于界面、对话框等的创建。
@@ -3608,60 +3803,28 @@
colors.MAGENTA#
透明，颜色值 #00000000
Images#
-Stability: 2 - Stableimages模块提供了一些手机设备中常见的图片处理函数，包括截图、读写图片、图片剪裁、找色、找图等。
-images.requestScreenCapture([landscape])#
+Stability: 2 - Stableimages模块提供了一些手机设备中常见的图片处理函数，包括截图、读写图片、图片剪裁、旋转、二值化、找色找图等。
+该模块分为两个部分，找图找色部分和图片处理部分。
+需要注意的是，image对象创建后尽量在不使用时进行回收，同时避免循环创建大量图片。因为图片是一种占用内存比较大的资源，尽管Auto.js通过各种方式（比如图片缓存机制、垃圾回收时回收图片、脚本结束时回收所有图片）尽量降低图片资源的泄漏和内存占用，但是糟糕的代码仍然可以占用大量内存。
+Image对象通过调用recycle()函数来回收。例如：
+// 读取图片
+var img = images.read("./1.png");
+//对图片进行操作
+...
+// 回收图片
+img.recycle();
+
例外的是，caputerScreen()返回的图片不需要回收。
+图片处理#
+images.read(path)#
-landscape <boolean> 布尔值， 表示将要执行的截屏是否为横屏。如果landscape为false, 则表示竖屏截图; true为横屏截图。
-向系统申请屏幕截图权限，返回是否请求成功。
-第一次使用该函数会弹出截图权限请求，建议选择“总是允许”。
-这个函数只是申请截图权限，并不会真正执行截图，真正的截图函数是captureScreen()。
-该函数在截图脚本中只需执行一次，而无需每次调用captureScreen()都调用一次。
-如果不指定landscape值，则截图方向由当前设备屏幕方向决定，因此务必注意执行该函数时的屏幕方向。
-建议在本软件界面运行该函数，在其他软件界面运行时容易出现一闪而过的黑屏现象。
-示例:
-//请求截图
-if(!requestScreenCapture()){
- toast("请求截图失败");
- exit();
-}
-//连续截图10张图片(间隔1秒)并保存到存储卡目录
-for(var i = 0; i < 10; i++){
- captureScreen("/sdcard/screencapture" + i + ".png");
- sleep(1000);
-}
-
该函数也可以作为全局函数使用。
-images.captureScreen()#
-截取当前屏幕并返回一个Image对象。
-没有截图权限时执行该函数会抛出SecurityException。
-该函数不会返回null，两次调用可能返回相同的Image对象。这是因为设备截图的更新需要一定的时间，短时间内（一般来说是16ms）连续调用则会返回同一张截图。
-截图需要转换为Bitmap格式，从而该函数执行需要一定的时间(0~20ms)。
-另外在requestScreenCapture()执行成功后需要一定时间后才有截图可用，因此如果立即调用captureScreen()，会等待一定时间后(一般为几百ms)才返回截图。
-例子:
-//请求横屏截图
-requestScreenCapture(true);
-//截图
-var img = captureScreen();
-//获取在点(100, 100)的颜色值
-var color = images.pixel(img, 100, 100);
-//显示该颜色值
-toast(colors.toString(color));
-
该函数也可以作为全局函数使用。
-images.captureScreen(path)#
-截取当前屏幕并以PNG格式保存到path中。如果文件不存在会被创建；文件存在会被覆盖。
-该函数不会返回任何值。该函数也可以作为全局函数使用。
-images.pixel(image, x, y)#
+
读取在路径path的图片文件并返回一个Image对象。如果文件不存在或者文件无法解码则返回null。
+images.load(url)#
返回图片image在点(x, y)处的像素的ARGB值。
-该值的格式为0xAARRGGBB，是一个"32位整数"(虽然JavaScript中并不区分整数类型和其他数值类型)。
-坐标系以图片左上角为原点。以图片左侧边为y轴，上侧边为x轴。
+加载在地址URL的网络图片并返回一个Image对象。如果地址不存在或者图片无法解码则返回null。
images.copy(img)#
img <Image> 图片images.save(image, path[, format = "png", quality = 100])images.read(path)#
-
-path <string> 图片路径
-读取在路径path的图片文件并返回一个Image对象。如果文件不存在或者文件无法解码则返回null。
-images.load(url)#
-
-url <string> 图片URL地址
-加载在地址URL的网络图片并返回一个Image对象。如果地址不存在或者图片无法解码则返回null。
-images.fromBase64(base64)#
+images.fromBase64(base64)#
base64 <string> 图片的Base64数据- 返回 <Image>
@@ -3745,7 +3898,263 @@ images.clip(img, x, y, w, h)#
+images.resize(img, size[, interpolation])#
+[v4.1.0新增]
+
+img <Image> 图片size <Array> 两个元素的数组[w, h]，分别表示宽度和高度；如果只有一个元素，则宽度和高度相等interpolation <string> 插值方法，可选，默认为"LINEAR"（线性插值），可选的值有：
+
+NEAREST 最近邻插值LINEAR 线性插值（默认）AREA 区域插值CUBIC 三次样条插值LANCZOS4 Lanczos插值
+参见InterpolationFlags
+返回 <Image>
+
+调整图片大小，并返回调整后的图片。例如把图片放缩为200*300：images.resize(img, [200, 300])。
+
+images.scale(img, fx, fy[, interpolation])#
+[v4.1.0新增]
+
+img <Image> 图片fx <number> 宽度放缩倍数fy <number> 高度放缩倍数interpolation <string> 插值方法，可选，默认为"LINEAR"（线性插值），可选的值有：
+
+NEAREST 最近邻插值LINEAR 线性插值（默认）AREA 区域插值CUBIC 三次样条插值LANCZOS4 Lanczos插值
+参见InterpolationFlags
+返回 <Image>
+
+放缩图片，并返回放缩后的图片。例如把图片变成原来的一半：images.scale(img, 0.5, 0.5)。
+
+images.rotate(img, degress[, x, y])#
+[v4.1.0新增]
+
+img <Image> 图片degress <number> 旋转角度。x <number> 旋转中心x坐标，默认为图片中点y <number> 旋转中心y坐标，默认为图片中点- 返回 <Image>
+
+将图片逆时针旋转degress度，返回旋转后的图片对象。
+例如逆时针旋转90度为images.rotate(img, 90)。
+images.concat(img1, image2[, direction])#
+[v4.1.0新增]
+
+img1 <Image> 图片1img2 <Image> 图片2- direction <string> 连接方向，默认为"RIGHT"，可选的值有：
+LEFT 将图片2接到图片1左边RIGHT 将图片2接到图片1右边TOP 将图片2接到图片1上边BOTTOM 将图片2接到图片1下边
+
+- 返回 <Image>
+
+连接两张图片，并返回连接后的图像。如果两张图片大小不一致，小的那张将适当居中。
+images.grayscale(img)#
+[v4.1.0新增]
+
+img <Image> 图片- 返回 <Image>
+
+灰度化图片，并返回灰度化后的图片。
+image.threshold(img, threshold, maxVal[, type])#
+[v4.1.0新增]
+
+img <Image> 图片threshold <number> 阈值maxVal <number> 最大值type <string> 阈值化类型，默认为"BINARY"，参见ThresholdTypes, 可选的值:
+
+BINARY BINARY_INV TRUNCTOZEROTOZERO_INVOTSUTRIANGLE
+返回 <Image>
+
+将图片阈值化，并返回处理后的图像。可以用这个函数进行图片二值化。例如：images.threshold(img, 100, 255, "BINARY")，这个代码将图片中大于100的值全部变成255，其余变成0，从而达到二值化的效果。如果img是一张灰度化图片，这个代码将会得到一张黑白图片。
+可以参考有关博客（比如threshold函数的使用）或者OpenCV文档threshold。
+images.adaptiveThreshold(img, maxValue, adaptiveMethod, thresholdType, blockSize, C)#
+[v4.1.0新增]
+
+img <Image> 图片maxValue <number> 最大值adaptiveMethod <string> 在一个邻域内计算阈值所采用的算法，可选的值有：
+MEAN_C 计算出领域的平均值再减去参数C的值GAUSSIAN_C 计算出领域的高斯均值再减去参数C的值
+thresholdType <string> 阈值化类型，可选的值有：
+BINARYBINARY_INV
+blockSize <number> 邻域块大小C <number> 偏移值调整量- 返回 <Image>
+
+对图片进行自适应阈值化处理，并返回处理后的图像。
+可以参考有关博客（比如threshold与adaptiveThreshold）或者OpenCV文档adaptiveThreshold。
+images.cvtColor(img, code[, dstCn])#
+[v4.1.0新增]
+
+img <Image> 图片code <string> 颜色空间转换的类型，可选的值有一共有205个（参见ColorConversionCodes），这里只列出几个：
+BGR2GRAY BGR转换为灰度BGR2HSV BGR转换为HSV - ``
+
+dstCn <number> 目标图像的颜色通道数量，如果不填写则根据其他参数自动决定。- 返回 <Image>
+
+对图像进行颜色空间转换，并返回转换后的图像。
+可以参考有关博客（比如颜色空间转换）或者OpenCV文档cvtColor。
+images.inRange(img, lowerBound, upperBound)#
+[v4.1.0新增]
+
+img <Image> 图片lowerBound <string> | <number> 颜色下界upperBound <string> | <number> 颜色下界- 返回 <Image>
+
+将图片二值化，在lowerBound~upperBound范围以外的颜色都变成0，在范围以内的颜色都变成255。
+例如images.inRange(img, "#000000", "#222222")。
+images.interval(img, color, interval)#
+[v4.1.0新增]
+
+将图片二值化，在color-interval ~ color+interval范围以外的颜色都变成0，在范围以内的颜色都变成255。这里对color的加减是对每个通道而言的。
+例如images.interval(img, "#888888", 16)，每个通道的颜色值均为0x88，加减16后的范围是[0x78, 0x98]，因此这个代码将把#787878~#989898的颜色变成#FFFFFF，而把这个范围以外的变成#000000。
+images.blur(img, size[, anchor, type])#
+[v4.1.0新增]
+
+img <Image> 图片size <Array> 定义滤波器的大小，如[3, 3]anchor <Array> 指定锚点位置(被平滑点)，默认为图像中心type <string> 推断边缘像素类型，默认为"DEFAULT"，可选的值有：
+CONSTANT iiiiii|abcdefgh|iiiiiii with some specified iREPLICATE aaaaaa|abcdefgh|hhhhhhhREFLECT fedcba|abcdefgh|hgfedcbWRAP cdefgh|abcdefgh|abcdefgREFLECT_101 gfedcb|abcdefgh|gfedcbaTRANSPARENT uvwxyz|abcdefgh|ijklmnoREFLECT101 same as BORDER_REFLECT_101DEFAULT same as BORDER_REFLECT_101ISOLATED do not look outside of ROI
+- 返回 <Image>
+
+对图像进行模糊（平滑处理），返回处理后的图像。
+可以参考有关博客（比如实现图像平滑处理）或者OpenCV文档blur。
+images.medianBlur(img, size)#
+[v4.1.0新增]
+
+img <Image> 图片size <Array> 定义滤波器的大小，如[3, 3]- 返回 <Image>
+
+对图像进行中值滤波，返回处理后的图像。
+可以参考有关博客（比如实现图像平滑处理）或者OpenCV文档blur。
+images.gaussianBlur(img, size[, sigmaX, sigmaY, type])#
+[v4.1.0新增]
+
+img <Image> 图片size <Array> 定义滤波器的大小，如[3, 3]sigmaX <number> x方向的标准方差，不填写则自动计算sigmaY <number> y方向的标准方差，不填写则自动计算type <string> 推断边缘像素类型，默认为"DEFAULT"，参见images.blur- 返回 <Image>
+
+对图像进行高斯模糊，返回处理后的图像。
+可以参考有关博客（比如实现图像平滑处理）或者OpenCV文档GaussianBlur。
+images.matToImage(mat)#
+[v4.1.0新增]
+
+mat <Mat> OpenCV的Mat对象- 返回 <Image>
+
+把Mat对象转换为Image对象。
+找图找色#
+images.requestScreenCapture([landscape])#
+
+landscape <boolean> 布尔值， 表示将要执行的截屏是否为横屏。如果landscape为false, 则表示竖屏截图; true为横屏截图。
+向系统申请屏幕截图权限，返回是否请求成功。
+第一次使用该函数会弹出截图权限请求，建议选择“总是允许”。
+这个函数只是申请截图权限，并不会真正执行截图，真正的截图函数是captureScreen()。
+该函数在截图脚本中只需执行一次，而无需每次调用captureScreen()都调用一次。
+如果不指定landscape值，则截图方向由当前设备屏幕方向决定，因此务必注意执行该函数时的屏幕方向。
+建议在本软件界面运行该函数，在其他软件界面运行时容易出现一闪而过的黑屏现象。
+示例:
+
//请求截图
+if(!requestScreenCapture()){
+ toast("请求截图失败");
+ exit();
+}
+//连续截图10张图片(间隔1秒)并保存到存储卡目录
+for(var i = 0; i < 10; i++){
+ captureScreen("/sdcard/screencapture" + i + ".png");
+ sleep(1000);
+}
+
该函数也可以作为全局函数使用。
+images.captureScreen()#
+截取当前屏幕并返回一个Image对象。
+没有截图权限时执行该函数会抛出SecurityException。
+该函数不会返回null，两次调用可能返回相同的Image对象。这是因为设备截图的更新需要一定的时间，短时间内（一般来说是16ms）连续调用则会返回同一张截图。
+截图需要转换为Bitmap格式，从而该函数执行需要一定的时间(0~20ms)。
+另外在requestScreenCapture()执行成功后需要一定时间后才有截图可用，因此如果立即调用captureScreen()，会等待一定时间后(一般为几百ms)才返回截图。
+例子:
+//请求横屏截图
+requestScreenCapture(true);
+//截图
+var img = captureScreen();
+//获取在点(100, 100)的颜色值
+var color = images.pixel(img, 100, 100);
+//显示该颜色值
+toast(colors.toString(color));
+
该函数也可以作为全局函数使用。
+images.captureScreen(path)#
+
+path <string> 截图保存路径
+截取当前屏幕并以PNG格式保存到path中。如果文件不存在会被创建；文件存在会被覆盖。
+该函数不会返回任何值。该函数也可以作为全局函数使用。
+images.pixel(image, x, y)#
+返回图片image在点(x, y)处的像素的ARGB值。
+该值的格式为0xAARRGGBB，是一个"32位整数"(虽然JavaScript中并不区分整数类型和其他数值类型)。
+坐标系以图片左上角为原点。以图片左侧边为y轴，上侧边为x轴。
+images.findColor(image, color, options)#
image <Image> 图片color <number> | <string> 要寻找的颜色的RGB值。如果是一个整数，则以0xRRGGBB的形式代表RGB值（A通道会被忽略）；如果是字符串，则以"#RRGGBB"代表其RGB值。images.findColorEquals(img, color[, x, y, width, height])#
+images.matchTemplate(img, template, options)#
+
[v4.1.0新增]
+
+img <Image> 大图片template <Image> 小图片（模板）options <Object> 找图选项：
+- 返回 <MatchingResult>
+
+在大图片中搜索小图片，并返回搜索结果MatchingResult。该函数可以用于找图时找出多个位置，可以通过max参数控制最大的结果数量。也可以对匹配结果进行排序、求最值等操作。
+MatchingResult#
+[v4.1.0新增]
+matches#
+
+- <Array> 匹配结果的数组。
+
+数组的元素是一个Match对象：
+
+point <Point> 匹配位置similarity <number> 相似度
+例如:
+
var result = images.matchTemplate(img, template, {
+ max: 100
+});
+result.matches.forEach(match => {
+ log("point = " + match.point + ", similarity = " + match.similarity);
+});
+
points#
+
+- <Array> 匹配位置的数组。
+
+first()#
+
+- 返回 <Match>
+
+第一个匹配结果。如果没有任何匹配，则返回null。
+last()#
+
+- 返回 <Match>
+
+最后一个匹配结果。如果没有任何匹配，则返回null。
+leftmost()#
+
+- 返回 <Match>
+
+位于大图片最左边的匹配结果。如果没有任何匹配，则返回null。
+topmost()#
+
+- 返回 <Match>
+
+位于大图片最上边的匹配结果。如果没有任何匹配，则返回null。
+rightmost()#
+
+- 返回 <Match>
+
+位于大图片最右边的匹配结果。如果没有任何匹配，则返回null。
+bottommost()#
+
+- 返回 <Match>
+
+位于大图片最下边的匹配结果。如果没有任何匹配，则返回null。
+best()#
+
+- 返回 <Match>
+
+相似度最高的匹配结果。如果没有任何匹配，则返回null。
+worst()#
+
+- 返回 <Match>
+
+相似度最低的匹配结果。如果没有任何匹配，则返回null。
+sortBy(cmp)#
+
+- cmp <Function>|<string> 比较函数，或者是一个字符串表示排序方向。例如"left"表示将匹配结果按匹配位置从左往右排序、"top"表示将匹配结果按匹配位置从上往下排序，"left-top"表示将匹配结果按匹配位置从左往右、从上往下排序。方向包括
left（左）, top （上）, right （右）, bottom（下）。
+- <MatchingResult>
+
+对匹配结果进行排序，并返回排序后的结果。
+var result = images.matchTemplate(img, template, {
+ max: 100
+});
+log(result.sortBy("top-right"));
+
Image#
表示一张图片，可以是截图的图片，或者本地读取的图片，或者从网络获取的图片。
Image.getWidth()#
返回以像素为单位图片宽度。
@@ -3942,6 +4438,7 @@ Image.pixel(x, y)#
findColor, findImage返回的对象。表示一个点（坐标）。
Point.x#
@@ -4210,7 +4707,7 @@ media.getMusicCurrentPosition()#
Stability: 2 - Stable
Auto.js 有一个简单的模块加载系统。 在 Auto.js 中，文件和模块是一一对应的（每个文件被视为一个独立的模块）。
例子，假设有一个名为 foo.js 的文件：
-const circle = require('circle.js');
+var circle = require('circle.js');
console.log("半径为 4 的圆的面积是 %d", circle.area(4));
在第一行中，foo.js 加载了同一目录下的 circle.js 模块。
circle.js 文件的内容为：
@@ -4218,7 +4715,9 @@ module (模块)auto();
auto.waitFor()#
检查无障碍服务是否已经启用，如果没有启用则跳转到无障碍服务启用界面，并等待无障碍服务启动；当无障碍服务启动后脚本会继续运行。
+因为该函数是阻塞的，因此除非是有协程特性，否则不能在ui模式下运行该函数，建议在ui模式下使用auto()函数。
auto.setMode(mode)#
mode <string> 模式auto.setMode(mode)#
+[v4.1.0新增]
+
+flags <string> | <Array> 一些标志，来启用和禁用某些特性，包括：
+findOnUiThread 使用该特性后，选择器搜索时会在主进程进行。该特性用于解决线程安全问题导致的次生问题，不过目前貌似已知问题并不是线程安全问题。useUsageStats 使用该特性后，将会以"使用情况统计"服务的结果来检测当前正在运行的应用包名（需要授予"查看使用情况统计"权限)。如果觉得currentPackage()返回的结果不太准确，可以尝试该特性。useShell 使用该特性后，将使用shell命令获取当前正在运行的应用的包名、活动名称，但是需要root权限。
+
+启用有关automator的一些特性。例如：
+
auto.setFlags(["findOnUiThread", "useShell"]);
+
auto.serivce#
+[v4.1.0新增]
+
+获取无障碍服务。如果无障碍服务没有启动，则返回null。
+
+auto.windows#
+[v4.1.0新增]
+
+- <Array>
+
+当前所有窗口(AccessibilityWindowInfo)的数组，可能包括状态栏、输入法、当前应用窗口，弹出窗口、悬浮窗、分屏应用窗口等。可以分别获取每个窗口的布局信息。
+该函数需要Android 5.0以上才能运行。
+auto.root#
+[v4.1.0新增]
+
+- <UiObject>
+
+当前窗口的布局根元素。如果无障碍服务未启动或者WindowFilter均返回false，则会返回null。
+如果不设置windowFilter，则当前窗口即为活跃的窗口（获取到焦点、正在触摸的窗口）；如果设置了windowFilter，则获取的是过滤的窗口中的第一个窗口。
+如果系统是Android5.0以下，则始终返回当前活跃的窗口的布局根元素。
+auto.rootInActiveWindow#
+[v4.1.0新增]
+
+- <UiObject>
+
+当前活跃的窗口（获取到焦点、正在触摸的窗口）的布局根元素。如果无障碍服务未启动则为null。
+auto.setWindowFilter(filter)#
+[v4.1.0新增]
+
+filter <Function> 参数为窗口(AccessibilityWindowInfo)，返回值为Boolean的函数。
+设置窗口过滤器。这个过滤器可以决定哪些窗口是目标窗口，并影响选择器的搜索。例如，如果想要选择器在所有窗口（包括状态栏、输入法等）中搜索，只需要使用以下代码：
+auto.setWindowFilter(function(window){
+ //不管是如何窗口，都返回true，表示在该窗口中搜索
+ return true;
+});
+
又例如，当前使用了分屏功能，屏幕上有Auto.js和QQ两个应用，但我们只想选择器对QQ界面进行搜索，则：
+auto.setWindowFilter(function(window){
+ // 对于应用窗口，他的title属性就是应用的名称，因此可以通过title属性来判断一个应用
+ return window.title == "QQ";
+});
+
选择器默认是在当前活跃的窗口中搜索，不会搜索诸如悬浮窗、状态栏之类的，使用WindowFilter则可以控制搜索的窗口。
+需要注意的是， 如果WindowFilter返回的结果均为false，则选择器的搜索结果将为空。
+另外setWindowFilter函数也会影响auto.windowRoots的结果。
+该函数需要Android 5.0以上才有效。
+auto.windowRoots#
+[v4.1.0新增]
+
+- <Array>
+
+返回当前被WindowFilter过滤的窗口的布局根元素组成的数组。
+如果系统是Android5.0以下，则始终返回当前活跃的窗口的布局根元素的数组。
SimpleActionAutomator#
Stability: 2 - StableSimpleActionAutomator提供了一些模拟简单操作的函数，例如点击文字、模拟按键等。这些函数可以直接作为全局函数使用。
click(text[, i])#
@@ -4402,6 +4968,18 @@ selector()创建一个新的选择器。但一般情况不需要使用该函数，因为可以直接用相应条件的语句创建选择器。
由于历史遗留原因，本不应该这样设计(不应该让id(), text()等作为全局函数，而是应该用By.id(), By.text())，但为了后向兼容性只能保留这个设计。
这样的API设计会污染全局变量，后续可能会支持"去掉这些全局函数而使用By.*"的选项。
+UiSelector.algorithm(algorithm)#
+[v4.1.0新增]
+
+algorithm <string> 搜索算法，可选的值有：
+DFS 深度优先算法，选择器的默认算法BFS 广度优先算法
+
+指定选择器的搜索算法。例如：
+log(selector().text("文本").algorithm("BFS").find());
+
广度优先在控件所在层次较低时，或者布局的层次不多时，通常能更快找到控件。
UiSelector.text(str)#
str <string> 控件文本clearImmediate(id)
用户界面: UI#
ui模块提供了编写用户界面的支持。
-带有ui的脚本的第一行必须使用"ui"指定ui模式，否则脚本将不会以ui模式运行。正确示范:
+带有ui的脚本的的最前面必须使用"ui";指定ui模式，否则脚本将不会以ui模式运行。正确示范:
"ui";
//脚本的其他代码
-
界面是由视图(View)组成的。View分成两种，控件(Widget)和布局(Layout)。控件(Widget)用来具体显示文字、图片、网页等，比如文本控件(text)用来显示文字，按钮控件(button)则可以显示一个按钮并提供点击效果，图片控件(img)则用来显示来自网络或者文件的图片，除此之外还有输入框控件(input)、进度条控件(progressbar)、单选复选框控件(checkbox)等；布局(Layout)则是装着一个或多个控件的"容器"，用于控制在他里面的控件的位置，比如垂直布局(vertical)会把他里面的控件从上往下依次显示(即纵向排列)，水平布局(horizontal)则会把他里面的控件从左往右依次显示(即横向排列)，以及帧布局(frame)，他会把他里面的控件直接在左上角显示，如果有多个控件，后面的控件会重叠在前面的控件上。
+字符串"ui"的前面可以有注释、空行和空格[v4.1.0新增]，但是不能有其他代码。
+界面是由视图(View)组成的。View分成两种，控件(Widget)和布局(Layout)。控件(Widget)用来具体显示文字、图片、网页等，比如文本控件(text)用来显示文字，按钮控件(button)则可以显示一个按钮并提供点击效果，图片控件(img)则用来显示来自网络或者文件的图片，除此之外还有输入框控件(input)、进度条控件(progressbar)、单选复选框控件(checkbox)等；布局(Layout)则是装着一个或多个控件的"容器"，用于控制在他里面的控件的位置，比如垂直布局(vertical)会把他里面的控件从上往下依次显示(即纵向排列)，水平布局(horizontal)则会把他里面的控件从左往右依次显示(即横向排列)，以及帧布局(frame)，他会把他里面的控件直接在左上角显示，如果有多个控件，后面的控件会重叠在前面的控件上。
我们使用xml来编写界面，并通过ui.layout()函数指定界面的布局xml。举个例子：
"ui";
ui.layout(
diff --git a/app/src/main/assets/docs/app.html b/app/src/main/assets/docs/app.html
index ca798aa33..b67caca8d 100644
--- a/app/src/main/assets/docs/app.html
+++ b/app/src/main/assets/docs/app.html
@@ -2,8 +2,8 @@
- App | Auto.js 3.0.0 文档
-
+ App | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -97,6 +97,11 @@
目录
- app.intent(options)
- app.startActivity(options)
- app.sendBroadcast(options)
+- app.startService(options)
+- app.sendBroadcast(name)
+- app.intentToShell(options)
+- app.parseUri(uri)
+- app.getUriForFile(path)
@@ -173,7 +178,7 @@ app.getPackageName(appName)#
用其他应用查看文件。文件不存在的情况由查看文件的应用处理。
如果找不出可以查看该文件的应用，则抛出ActivityNotException。
@@ -181,7 +186,7 @@ app.viewFile(path)#
用其他应用编辑文件。文件不存在的情况由编辑文件的应用处理。
如果找不出可以编辑该文件的应用，则抛出ActivityNotException。
@@ -245,17 +250,36 @@ app.sendEmail(options)#
-- options <Object> 选项，包括：
-action <string> 意图的Action，指意图要完成的动作，是一个字符串常量，比如"android.intent.action.SEND"。当action以"android.intent.action"开头时，可以省略前缀，直接用"SEND"代替。常见的action参见常用的意图动作。type <string> 意图的MimeType，表示和该意图直接相关的数据的类型，表示比如"text/plain"为纯文本类型。data <string> 意图的Data，表示和该意图直接相关的数据，是一个Uri, 可以是文件路径或者Url等。例如要打开一个文件, action为"android.intent.action.VIEW", data为"file:///sdcard/1.txt"。category <Array> 意图的类别。比较少用。packageName <string> 目标包名className <string> 目标Activity或Service等组件的名称extras <Object> 以键值对构成的这个Intent的Extras(额外信息)。提供该意图的其他信息，例如发送邮件时的邮件标题、邮件正文。options <Object> 选项，包括：
+
+action <string> 意图的Action，指意图要完成的动作，是一个字符串常量，比如"android.intent.action.SEND"。当action以"android.intent.action"开头时，可以省略前缀，直接用"SEND"代替。参见Actions。
+type <string> 意图的MimeType，表示和该意图直接相关的数据的类型，表示比如"text/plain"为纯文本类型。
+data <string> 意图的Data，表示和该意图直接相关的数据，是一个Uri, 可以是文件路径或者Url等。例如要打开一个文件, action为"android.intent.action.VIEW", data为"file:///sdcard/1.txt"。
+category <Array> 意图的类别。比较少用。参见Categories。
+packageName <string> 目标包名
+className <string> 目标Activity或Service等组件的名称
+extras <Object> 以键值对构成的这个Intent的Extras(额外信息)。提供该意图的其他信息，例如发送邮件时的邮件标题、邮件正文。参见Extras。
+flags <Array> intent的标识，字符串数组，例如["activity_new_task", "grant_read_uri_permission"]。参见Flags。
+[v4.1.0新增]
+root <Boolea> 是否以root权限启动、发送该intent。使用该参数后，不能使用context.startActivity()等方法，而应该直接使用诸如app.startActivity({...})的方法。
+[v4.1.0新增]
+
@@ -267,18 +291,74 @@ app.sendEmail(options)安卓Intent或参考Android指南: Intent。
+context.startActivity(i);
+需要注意的是，除非应用专门暴露Activity出来，否则在没有root权限的情况下使用intent是无法跳转到特定Activity、应用的特定界面的。例如我们能通过Intent跳转到QQ的分享界面，是因为QQ对外暴露了分享的Activity；而在没有root权限的情况下，我们无法通过intent跳转到QQ的设置界面，因为QQ并没有暴露这个Activity。
+但如果有root权限，则在intent的参数加上"root": true即可。例如使用root权限跳转到Auto.js的设置界面为：
+app.startActivity({
+ packageName: "org.autojs.autojs",
+ className: "org.autojs.autojs.ui.settings.SettingsActivity_",
+ root: true
+});
+
另外，关于intent的参数如何获取的问题，一些intent是意外发现并且在网络中传播的（例如跳转QQ聊天窗口是因为QQ给网页提供了跳转到客服QQ的方法），如果要自己获取活动的intent的参数，可以通过例如"intent记录"，"隐式启动"等应用拦截内部intent或者查询暴露的intent。其中拦截内部intent需要XPosed框架，或者可以通过反编译等手段获取参数。总之，没有简单直接的方法。
+更多信息，请百度安卓Intent或参考Android指南: Intent。
app.startActivity(options)#
根据选项构造一个Intent，并启动该Activity。
-app.sendBroadcast(options)#
+app.startActivity({
+ action: "SEND",
+ type: "text/plain",
+ data: "file:///sdcard/1.txt"
+});
+
app.sendBroadcast(options)#
根据选项构造一个Intent，并发送该广播。
+app.startService(options)#
+
+options <Object> 选项
+根据选项构造一个Intent，并启动该服务。
+app.sendBroadcast(name)#
+[v4.1.0新增]
+
+name <string> 特定的广播名称，包括：
+inspect_layout_hierarchy 布局层次分析inspect_layout_bounds 布局范围
+
+发送以上特定名称的广播可以触发Auto.js的布局分析，方便脚本调试。这些广播在Auto.js发送才有效，在打包的脚本上运行将没有任何效果。
+app.sendBroadcast("inspect_layout_bounds");
+
app.intentToShell(options)#
+[v4.1.0新增]
+
+options <Object> 选项
+根据选项构造一个Intent，转换为对应的shell的intent命令的参数。
+例如:
+shell("am start " + app.intentToShell({
+ packageName: "org.autojs.autojs",
+ className: "org.autojs.autojs.ui.settings.SettingsActivity_"
+}), true);
+
参见intent参数的规范。
+app.parseUri(uri)#
+[v4.1.0新增]
+
+uri <string> 一个代表Uri的字符串，例如"file:///sdcard/1.txt", "https://www.autojs.org"- 返回 <Uri> 一个代表Uri的对象，参见android.net.Uri。
+
+解析uri字符串并返回相应的Uri对象。即使Uri格式错误，该函数也会返回一个Uri对象，但之后如果访问该对象的scheme, path等值可能因解析失败而返回null。
+需要注意的是，在高版本Android上，由于系统限制直接在Uri暴露文件的绝对路径，因此如果uri字符串是文件file://...，返回的Uri会是诸如content://...的形式。
+app.getUriForFile(path)#
+[v4.1.0新增]
+
+path <string> 文件路径，例如"/sdcard/1.txt"- 返回 <Uri> 一个指向该文件的Uri的对象，参见android.net.Uri。
+
+从一个文件路径创建一个uri对象。需要注意的是，在高版本Android上，由于系统限制直接在Uri暴露文件的绝对路径，因此返回的Uri会是诸如content://...的形式。
diff --git a/app/src/main/assets/docs/assets/fonts.css b/app/src/main/assets/docs/assets/fonts.css
new file mode 100644
index 000000000..40e557983
--- /dev/null
+++ b/app/src/main/assets/docs/assets/fonts.css
@@ -0,0 +1,48 @@
+/* latin-ext */
+@font-face {
+ font-family: 'Lato';
+ font-style: italic;
+ font-weight: 400;
+ src: local('Lato Italic'), local('Lato-Italic'), url(fonts/S6u8w4BMUTPHjxsAUi-qJCY.woff2) format('woff2');
+ unicode-range: U+0100-024F, U+0259, U+1E00-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
+ }
+ /* latin */
+ @font-face {
+ font-family: 'Lato';
+ font-style: italic;
+ font-weight: 400;
+ src: local('Lato Italic'), local('Lato-Italic'), url(fonts/S6u8w4BMUTPHjxsAXC-q.woff2) format('woff2');
+ unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+ }
+ /* latin-ext */
+ @font-face {
+ font-family: 'Lato';
+ font-style: normal;
+ font-weight: 400;
+ src: local('Lato Regular'), local('Lato-Regular'), url(fonts/S6uyw4BMUTPHjxAwXjeu.woff2) format('woff2');
+ unicode-range: U+0100-024F, U+0259, U+1E00-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
+ }
+ /* latin */
+ @font-face {
+ font-family: 'Lato';
+ font-style: normal;
+ font-weight: 400;
+ src: local('Lato Regular'), local('Lato-Regular'), url(fonts/S6uyw4BMUTPHjx4wXg.woff2) format('woff2');
+ unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+ }
+ /* latin-ext */
+ @font-face {
+ font-family: 'Lato';
+ font-style: normal;
+ font-weight: 700;
+ src: local('Lato Bold'), local('Lato-Bold'), url(fonts/S6u9w4BMUTPHh6UVSwaPGR_p.woff2) format('woff2');
+ unicode-range: U+0100-024F, U+0259, U+1E00-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
+ }
+ /* latin */
+ @font-face {
+ font-family: 'Lato';
+ font-style: normal;
+ font-weight: 700;
+ src: local('Lato Bold'), local('Lato-Bold'), url(fonts/S6u9w4BMUTPHh6UVSwiPGQ.woff2) format('woff2');
+ unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+ }
\ No newline at end of file
diff --git a/app/src/main/assets/docs/assets/fonts/S6u9w4BMUTPHh6UVSwiPGQ.woff2 b/app/src/main/assets/docs/assets/fonts/S6u9w4BMUTPHh6UVSwiPGQ.woff2
new file mode 100644
index 000000000..d88f1af8c
Binary files /dev/null and b/app/src/main/assets/docs/assets/fonts/S6u9w4BMUTPHh6UVSwiPGQ.woff2 differ
diff --git a/app/src/main/assets/docs/assets/fonts/S6uyw4BMUTPHjx4wXg.woff2 b/app/src/main/assets/docs/assets/fonts/S6uyw4BMUTPHjx4wXg.woff2
new file mode 100644
index 000000000..b14c76cab
Binary files /dev/null and b/app/src/main/assets/docs/assets/fonts/S6uyw4BMUTPHjx4wXg.woff2 differ
diff --git a/app/src/main/assets/docs/canvas.html b/app/src/main/assets/docs/canvas.html
index 46bfd8c1d..15d58806a 100644
--- a/app/src/main/assets/docs/canvas.html
+++ b/app/src/main/assets/docs/canvas.html
@@ -2,8 +2,8 @@
- Canvas | Auto.js 3.0.0 文档
-
+ Canvas | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/console.html b/app/src/main/assets/docs/console.html
index 3a12754ca..30ca88cf2 100644
--- a/app/src/main/assets/docs/console.html
+++ b/app/src/main/assets/docs/console.html
@@ -2,8 +2,8 @@
- Console | Auto.js 3.0.0 文档
-
+ Console | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -84,10 +84,14 @@
目录
- console.warn([data][, ...args])
- console.error([data][, ...args])
- console.assert(value, message)
+- console.time([label])
+- console.timeEnd(label)
+- console.trace([data][, ...args])
- console.input(data[, ...args])
- console.rawInput(data[, ...args])
- console.setSize(w, h)
- console.setPosition(x, y)
+- console.setGlobalLogConfig(config)
- print(text)
@@ -107,8 +111,8 @@ console.clear()#
-data ...args data <any>...args <any>
打印到控制台，并带上换行符。 可以传入多个参数，第一个参数作为主要信息，其他参数作为类似于 printf(3) 中的代替值（参数都会传给 util.format()）。
const count = 5;
@@ -120,26 +124,26 @@ console.log([data][, ...args])#
-data ...args data <any>...args <any>
与console.log类似，但输出结果以灰色字体显示。输出优先级低于log，用于输出观察性质的信息。
console.info([data][, ...args])#
-data ...args data <any>...args <any>
与console.log类似，但输出结果以绿色字体显示。输出优先级高于log, 用于输出重要信息。
console.warn([data][, ...args])#
-data ...args data <any>...args <any>
与console.log类似，但输出结果以蓝色字体显示。输出优先级高于info, 用于输出警告信息。
console.error([data][, ...args])#
-data ...args data <any>...args <any>
与console.log类似，但输出结果以红色字体显示。输出优先级高于warn, 用于输出错误信息。
console.assert(value, message)#
@@ -150,10 +154,46 @@ console.assert(value, message)#
+
console.time([label])#
+[v4.1.0新增]
+
+label <String> 计时器标签，可省略
+启动一个定时器，用以计算一个操作的持续时间。
+定时器由一个唯一的 label 标识。
+当调用 console.timeEnd() 时，可以使用相同的 label 来停止定时器，并以毫秒为单位将持续时间输出到控制台。
+重复启动同一个标签的定时器会覆盖之前启动同一标签的定时器。
+console.timeEnd(label)#
+[v4.1.0新增]
+
+label <String> 计时器标签
+停止之前通过调用 console.time() 启动的定时器，并打印结果到控制台。
+调用 console.timeEnd() 后定时器会被删除。如果不存在标签指定的定时器则会打印 NaNms。
+console.time('求和');
+var sum = 0;
+for(let i = 0; i < 100000; i++){
+ sum += i;
+}
+console.timeEnd('求和');
+// 打印 求和: xxx ms
+
+console.trace([data][, ...args])#
+[v4.1.0新增]
+
+data <any>...args <any>
+与console.log类似，同时会打印出调用这个函数所在的调用栈信息（即当前运行的文件、行数等信息）。
+console.trace('Show me');
+// 打印: (堆栈跟踪会根据被调用的跟踪的位置而变化)
+// Show me
+// at <test>:7
+
+console.input(data[, ...args])#
-data ...args data <any>...args <any>
与console.log一样输出信息，并在控制台显示输入框等待输入。按控制台的确认按钮后会将输入的字符串用eval计算后返回。
部分机型可能会有控制台不显示输入框的情况，属于bug。
@@ -164,8 +204,8 @@ console.assert(value, message)#
-data ...args data <any>...args <any>
与console.log一样输出信息，并在控制台显示输入框等待输入。按控制台的确认按钮后会将输入的字符串直接返回。
部分机型可能会有控制台不显示输入框的情况，属于bug。
@@ -191,7 +231,24 @@ console.assert(value, message)#
+console.setGlobalLogConfig(config)#
+[v4.1.0新增]
+
+config <Object> 日志配置，可选的项有：
+
+设置日志保存的路径和配置。例如把日志保存到"/sdcard/1.txt":
+console.setGlobalLogConfig({
+ "file": "/sdcard/1.txt"
+});
+
注意该函数会影响所有脚本的日志记录。
+print(text)#
diff --git a/app/src/main/assets/docs/coordinates-based-automation.html b/app/src/main/assets/docs/coordinates-based-automation.html
index 2a3cd81fb..4854db8f4 100644
--- a/app/src/main/assets/docs/coordinates-based-automation.html
+++ b/app/src/main/assets/docs/coordinates-based-automation.html
@@ -2,8 +2,8 @@
- 基于坐标的触摸模拟 | Auto.js 3.0.0 文档
-
+ 基于坐标的触摸模拟 | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/device.html b/app/src/main/assets/docs/device.html
index 39d288ea2..865171b4f 100644
--- a/app/src/main/assets/docs/device.html
+++ b/app/src/main/assets/docs/device.html
@@ -2,8 +2,8 @@
- Device | Auto.js 3.0.0 文档
-
+ Device | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/dialogs.html b/app/src/main/assets/docs/dialogs.html
index 29ae1be51..2e8d7a3b5 100644
--- a/app/src/main/assets/docs/dialogs.html
+++ b/app/src/main/assets/docs/dialogs.html
@@ -2,8 +2,8 @@
- Dialogs | Auto.js 3.0.0 文档
-
+ Dialogs | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -99,6 +99,9 @@
目录
- 事件:
multi_choice
- 事件:
input
- 事件:
input_change
+- dialog.getProgress()
+- dialog.getMaxProgress()
+- dialog.getActionButton(action)
@@ -271,11 +274,11 @@ dialogs.build(properties)<string> | <number> 对话框列表的选项的文字颜色
itemsSelectMode <string> 对话框列表的选项选择模式，可以为:
select 普通选择模式singleChoice 单选模式multiChoice 多选模式single 单选模式multi 多选模式
itemsSelectedIndex <number> | <Array> 对话框列表中？？？itemsSelectedIndex <number> | <Array> 对话框列表中预先选中的项目索引，如果是单选模式为一个索引；多选模式则为数组positive <string> 对话框确定按钮的文字内容(最右边按钮)positiveColor <string> | <number> 对话框确定按钮的文字颜色(最右边按钮)neutral <string> 对话框中立按钮的文字内容(最左边按钮)dialogs.build(properties)#
+
+- 返回 <number>
+
+获取当前进度条的进度值，是一个整数
+dialog.getMaxProgress()#
+
+- 返回 <number>
+
+获取当前进度条的最大进度值，是一个整数
+dialog.getActionButton(action)#
+
+action <string> 动作，包括:
+positive negativeneutral
+
+
diff --git a/app/src/main/assets/docs/documentation.html b/app/src/main/assets/docs/documentation.html
index 2d07b665c..3e314ef11 100644
--- a/app/src/main/assets/docs/documentation.html
+++ b/app/src/main/assets/docs/documentation.html
@@ -2,8 +2,8 @@
- 关于本文档 | Auto.js 3.0.0 文档
-
+ 关于本文档 | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/engines.html b/app/src/main/assets/docs/engines.html
index f58ed3d8f..3f9419288 100644
--- a/app/src/main/assets/docs/engines.html
+++ b/app/src/main/assets/docs/engines.html
@@ -2,8 +2,8 @@
- Engines | Auto.js 3.0.0 文档
-
+ Engines | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -185,6 +185,10 @@
engines.stopAllAndToast()#
返回当前脚本的脚本引擎对象(ScriptEngine)
+[v4.1.0新增]
+特别的，该对象可以通过execArgv来获取他的运行参数，包括外部参数、intent等。例如：
+log(engines.myEngine().execArgv);
+
普通脚本的运行参数通常为空，通过定时任务的广播启动的则可以获取到启动的intent。
engines.all()#
- 返回 <Array>
diff --git a/app/src/main/assets/docs/events.html b/app/src/main/assets/docs/events.html
index b3f436607..b601d5e00 100644
--- a/app/src/main/assets/docs/events.html
+++ b/app/src/main/assets/docs/events.html
@@ -2,8 +2,8 @@
- Events | Auto.js 3.0.0 文档
-
+ Events | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/files.html b/app/src/main/assets/docs/files.html
index a182e972d..01ffe297d 100644
--- a/app/src/main/assets/docs/files.html
+++ b/app/src/main/assets/docs/files.html
@@ -2,8 +2,8 @@
- Files | Auto.js 3.0.0 文档
-
+ Files | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/floaty.html b/app/src/main/assets/docs/floaty.html
index c68ae3a6a..145e078fd 100644
--- a/app/src/main/assets/docs/floaty.html
+++ b/app/src/main/assets/docs/floaty.html
@@ -2,8 +2,8 @@
- Floaty | Auto.js 3.0.0 文档
-
+ Floaty | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/globals.html b/app/src/main/assets/docs/globals.html
index 0635fe447..1301d20e8 100644
--- a/app/src/main/assets/docs/globals.html
+++ b/app/src/main/assets/docs/globals.html
@@ -2,8 +2,8 @@
- 全局变量与函数 | Auto.js 3.0.0 文档
-
+ 全局变量与函数 | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -90,6 +90,8 @@
目录
- requiresApi(api)
- requiresAutojsVersion(version)
- runtime.requestPermissions(permissions)
+- runtime.loadJar(path)
+- runtime.loadDex(path)
- context
@@ -232,6 +234,23 @@ runtime.requestPermissions(permissions)Permissions Overview。（并没有用）
+runtime.loadJar(path)#
+
+path <string> jar文件路径
+加载目标jar文件，加载成功后将可以使用该Jar文件的类。
+// 加载jsoup.jar
+runtime.loadJar("./jsoup.jar");
+// 使用jsoup解析html
+importClass(org.jsoup.Jsoup);
+log(Jsoup.parse(files.read("./test.html")));
+
(jsoup是一个Java实现的解析Html DOM的库，可以在Jsoup下载)
+runtime.loadDex(path)#
+
+path <string> dex文件路径
+加载目标dex文件，加载成功后将可以使用该dex文件的类。
+因为加载jar实际上是把jar转换为dex再加载的，因此加载dex文件会比jar文件快得多。可以使用Android SDK的build tools的dx工具把jar转换为dex。
context#
全局变量。一个android.content.Context对象。
注意该对象为ApplicationContext，因此不能用于界面、对话框等的创建。
diff --git a/app/src/main/assets/docs/http.html b/app/src/main/assets/docs/http.html
index 1d49d5480..d3f85e40f 100644
--- a/app/src/main/assets/docs/http.html
+++ b/app/src/main/assets/docs/http.html
@@ -2,8 +2,8 @@
- HTTP | Auto.js 3.0.0 文档
-
+ HTTP | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/images.html b/app/src/main/assets/docs/images.html
index 9e009677e..7cb1f7c3d 100644
--- a/app/src/main/assets/docs/images.html
+++ b/app/src/main/assets/docs/images.html
@@ -2,8 +2,8 @@
- colors | Auto.js 3.0.0 文档
-
+ colors | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -100,19 +100,35 @@
目录
- colors.MAGENTA
- colors.TRANSPARENT
- Images
-- images.requestScreenCapture([landscape])
-- images.captureScreen()
-- images.captureScreen(path)
-- images.pixel(image, x, y)
-- images.copy(img)
-- images.save(image, path[, format = "png", quality = 100])
+- 图片处理
- images.read(path)
- images.load(url)
+- images.copy(img)
+- images.save(image, path[, format = "png", quality = 100])
- images.fromBase64(base64)
- images.toBase64(img[, format = "png", quality = 100])
- images.fromBytes(bytes)
- images.toBytes(img[, format = "png", quality = 100])
- images.clip(img, x, y, w, h)
+- images.resize(img, size[, interpolation])
+- images.scale(img, fx, fy[, interpolation])
+- images.rotate(img, degress[, x, y])
+- images.concat(img1, image2[, direction])
+- images.grayscale(img)
+- image.threshold(img, threshold, maxVal[, type])
+- images.adaptiveThreshold(img, maxValue, adaptiveMethod, thresholdType, blockSize, C)
+- images.cvtColor(img, code[, dstCn])
+- images.inRange(img, lowerBound, upperBound)
+- images.interval(img, color, interval)
+- images.blur(img, size[, anchor, type])
+- images.medianBlur(img, size)
+- images.gaussianBlur(img, size[, sigmaX, sigmaY, type])
+- images.matToImage(mat)
+- 找图找色
+- images.requestScreenCapture([landscape])
+- images.captureScreen()
+- images.captureScreen(path)
+- images.pixel(image, x, y)
- images.findColor(image, color, options)
- images.findColorInRegion(img, color, x, y[, width, height, threshold])
- images.findColorEquals(img, color[, x, y, width, height])
@@ -120,6 +136,21 @@ 目录
- images.detectsColor(image, color, x, y[, threshold = 16, algorithm = "diff"])
- images.findImage(img, template[, options])
- images.findImageInRegion(img, template, x, y[, width, height, threshold])
+- images.matchTemplate(img, template, options)
+
+
+- MatchingResult
- Image
@@ -246,60 +277,28 @@ colors.MAGENTA#
透明，颜色值 #00000000
Images#
-Stability: 2 - Stableimages模块提供了一些手机设备中常见的图片处理函数，包括截图、读写图片、图片剪裁、找色、找图等。
-images.requestScreenCapture([landscape])#
-
-landscape <boolean> 布尔值， 表示将要执行的截屏是否为横屏。如果landscape为false, 则表示竖屏截图; true为横屏截图。
-向系统申请屏幕截图权限，返回是否请求成功。
-第一次使用该函数会弹出截图权限请求，建议选择“总是允许”。
-这个函数只是申请截图权限，并不会真正执行截图，真正的截图函数是captureScreen()。
-该函数在截图脚本中只需执行一次，而无需每次调用captureScreen()都调用一次。
-如果不指定landscape值，则截图方向由当前设备屏幕方向决定，因此务必注意执行该函数时的屏幕方向。
-建议在本软件界面运行该函数，在其他软件界面运行时容易出现一闪而过的黑屏现象。
-示例:
-
//请求截图
-if(!requestScreenCapture()){
- toast("请求截图失败");
- exit();
-}
-//连续截图10张图片(间隔1秒)并保存到存储卡目录
-for(var i = 0; i < 10; i++){
- captureScreen("/sdcard/screencapture" + i + ".png");
- sleep(1000);
-}
-
该函数也可以作为全局函数使用。
-images.captureScreen()#
-截取当前屏幕并返回一个Image对象。
-没有截图权限时执行该函数会抛出SecurityException。
-该函数不会返回null，两次调用可能返回相同的Image对象。这是因为设备截图的更新需要一定的时间，短时间内（一般来说是16ms）连续调用则会返回同一张截图。
-截图需要转换为Bitmap格式，从而该函数执行需要一定的时间(0~20ms)。
-另外在requestScreenCapture()执行成功后需要一定时间后才有截图可用，因此如果立即调用captureScreen()，会等待一定时间后(一般为几百ms)才返回截图。
-例子:
-//请求横屏截图
-requestScreenCapture(true);
-//截图
-var img = captureScreen();
-//获取在点(100, 100)的颜色值
-var color = images.pixel(img, 100, 100);
-//显示该颜色值
-toast(colors.toString(color));
-
该函数也可以作为全局函数使用。
-images.captureScreen(path)#
+Stability: 2 - Stableimages模块提供了一些手机设备中常见的图片处理函数，包括截图、读写图片、图片剪裁、旋转、二值化、找色找图等。
+该模块分为两个部分，找图找色部分和图片处理部分。
+需要注意的是，image对象创建后尽量在不使用时进行回收，同时避免循环创建大量图片。因为图片是一种占用内存比较大的资源，尽管Auto.js通过各种方式（比如图片缓存机制、垃圾回收时回收图片、脚本结束时回收所有图片）尽量降低图片资源的泄漏和内存占用，但是糟糕的代码仍然可以占用大量内存。
+Image对象通过调用recycle()函数来回收。例如：
+// 读取图片
+var img = images.read("./1.png");
+//对图片进行操作
+...
+// 回收图片
+img.recycle();
+
例外的是，caputerScreen()返回的图片不需要回收。
+图片处理#
+images.read(path)#
截取当前屏幕并以PNG格式保存到path中。如果文件不存在会被创建；文件存在会被覆盖。
-该函数不会返回任何值。该函数也可以作为全局函数使用。
-images.pixel(image, x, y)#
+ 读取在路径path的图片文件并返回一个Image对象。如果文件不存在或者文件无法解码则返回null。
+images.load(url)#
返回图片image在点(x, y)处的像素的ARGB值。
-该值的格式为0xAARRGGBB，是一个"32位整数"(虽然JavaScript中并不区分整数类型和其他数值类型)。
-坐标系以图片左上角为原点。以图片左侧边为y轴，上侧边为x轴。
+ 加载在地址URL的网络图片并返回一个Image对象。如果地址不存在或者图片无法解码则返回null。
images.copy(img)#
img <Image> 图片images.save(image, path[, format = "png", quality = 100])images.read(path)#
-
-path <string> 图片路径
-读取在路径path的图片文件并返回一个Image对象。如果文件不存在或者文件无法解码则返回null。
-images.load(url)#
-
-url <string> 图片URL地址
-加载在地址URL的网络图片并返回一个Image对象。如果地址不存在或者图片无法解码则返回null。
-images.fromBase64(base64)#
+images.fromBase64(base64)#
base64 <string> 图片的Base64数据- 返回 <Image>
@@ -383,7 +372,263 @@ images.clip(img, x, y, w, h)#
+images.resize(img, size[, interpolation])#
+[v4.1.0新增]
+
+img <Image> 图片size <Array> 两个元素的数组[w, h]，分别表示宽度和高度；如果只有一个元素，则宽度和高度相等interpolation <string> 插值方法，可选，默认为"LINEAR"（线性插值），可选的值有：
+
+NEAREST 最近邻插值LINEAR 线性插值（默认）AREA 区域插值CUBIC 三次样条插值LANCZOS4 Lanczos插值
+参见InterpolationFlags
+返回 <Image>
+
+调整图片大小，并返回调整后的图片。例如把图片放缩为200*300：images.resize(img, [200, 300])。
+
+images.scale(img, fx, fy[, interpolation])#
+[v4.1.0新增]
+
+img <Image> 图片fx <number> 宽度放缩倍数fy <number> 高度放缩倍数interpolation <string> 插值方法，可选，默认为"LINEAR"（线性插值），可选的值有：
+
+NEAREST 最近邻插值LINEAR 线性插值（默认）AREA 区域插值CUBIC 三次样条插值LANCZOS4 Lanczos插值
+参见InterpolationFlags
+返回 <Image>
+
+放缩图片，并返回放缩后的图片。例如把图片变成原来的一半：images.scale(img, 0.5, 0.5)。
+
+images.rotate(img, degress[, x, y])#
+[v4.1.0新增]
+
+img <Image> 图片degress <number> 旋转角度。x <number> 旋转中心x坐标，默认为图片中点y <number> 旋转中心y坐标，默认为图片中点- 返回 <Image>
+
+将图片逆时针旋转degress度，返回旋转后的图片对象。
+例如逆时针旋转90度为images.rotate(img, 90)。
+images.concat(img1, image2[, direction])#
+[v4.1.0新增]
+
+img1 <Image> 图片1img2 <Image> 图片2- direction <string> 连接方向，默认为"RIGHT"，可选的值有：
+LEFT 将图片2接到图片1左边RIGHT 将图片2接到图片1右边TOP 将图片2接到图片1上边BOTTOM 将图片2接到图片1下边
+
+- 返回 <Image>
+
+连接两张图片，并返回连接后的图像。如果两张图片大小不一致，小的那张将适当居中。
+images.grayscale(img)#
+[v4.1.0新增]
+
+img <Image> 图片- 返回 <Image>
+
+灰度化图片，并返回灰度化后的图片。
+image.threshold(img, threshold, maxVal[, type])#
+[v4.1.0新增]
+
+img <Image> 图片threshold <number> 阈值maxVal <number> 最大值type <string> 阈值化类型，默认为"BINARY"，参见ThresholdTypes, 可选的值:
+
+BINARY BINARY_INV TRUNCTOZEROTOZERO_INVOTSUTRIANGLE
+返回 <Image>
+
+将图片阈值化，并返回处理后的图像。可以用这个函数进行图片二值化。例如：images.threshold(img, 100, 255, "BINARY")，这个代码将图片中大于100的值全部变成255，其余变成0，从而达到二值化的效果。如果img是一张灰度化图片，这个代码将会得到一张黑白图片。
+可以参考有关博客（比如threshold函数的使用）或者OpenCV文档threshold。
+images.adaptiveThreshold(img, maxValue, adaptiveMethod, thresholdType, blockSize, C)#
+[v4.1.0新增]
+
+img <Image> 图片maxValue <number> 最大值adaptiveMethod <string> 在一个邻域内计算阈值所采用的算法，可选的值有：
+MEAN_C 计算出领域的平均值再减去参数C的值GAUSSIAN_C 计算出领域的高斯均值再减去参数C的值
+thresholdType <string> 阈值化类型，可选的值有：
+BINARYBINARY_INV
+blockSize <number> 邻域块大小C <number> 偏移值调整量- 返回 <Image>
+
+对图片进行自适应阈值化处理，并返回处理后的图像。
+可以参考有关博客（比如threshold与adaptiveThreshold）或者OpenCV文档adaptiveThreshold。
+images.cvtColor(img, code[, dstCn])#
+[v4.1.0新增]
+
+img <Image> 图片code <string> 颜色空间转换的类型，可选的值有一共有205个（参见ColorConversionCodes），这里只列出几个：
+BGR2GRAY BGR转换为灰度BGR2HSV BGR转换为HSV - ``
+
+dstCn <number> 目标图像的颜色通道数量，如果不填写则根据其他参数自动决定。- 返回 <Image>
+
+对图像进行颜色空间转换，并返回转换后的图像。
+可以参考有关博客（比如颜色空间转换）或者OpenCV文档cvtColor。
+images.inRange(img, lowerBound, upperBound)#
+[v4.1.0新增]
+
+img <Image> 图片lowerBound <string> | <number> 颜色下界upperBound <string> | <number> 颜色下界- 返回 <Image>
+
+将图片二值化，在lowerBound~upperBound范围以外的颜色都变成0，在范围以内的颜色都变成255。
+例如images.inRange(img, "#000000", "#222222")。
+images.interval(img, color, interval)#
+[v4.1.0新增]
+
+将图片二值化，在color-interval ~ color+interval范围以外的颜色都变成0，在范围以内的颜色都变成255。这里对color的加减是对每个通道而言的。
+例如images.interval(img, "#888888", 16)，每个通道的颜色值均为0x88，加减16后的范围是[0x78, 0x98]，因此这个代码将把#787878~#989898的颜色变成#FFFFFF，而把这个范围以外的变成#000000。
+images.blur(img, size[, anchor, type])#
+[v4.1.0新增]
+
+img <Image> 图片size <Array> 定义滤波器的大小，如[3, 3]anchor <Array> 指定锚点位置(被平滑点)，默认为图像中心type <string> 推断边缘像素类型，默认为"DEFAULT"，可选的值有：
+CONSTANT iiiiii|abcdefgh|iiiiiii with some specified iREPLICATE aaaaaa|abcdefgh|hhhhhhhREFLECT fedcba|abcdefgh|hgfedcbWRAP cdefgh|abcdefgh|abcdefgREFLECT_101 gfedcb|abcdefgh|gfedcbaTRANSPARENT uvwxyz|abcdefgh|ijklmnoREFLECT101 same as BORDER_REFLECT_101DEFAULT same as BORDER_REFLECT_101ISOLATED do not look outside of ROI
+- 返回 <Image>
+
+对图像进行模糊（平滑处理），返回处理后的图像。
+可以参考有关博客（比如实现图像平滑处理）或者OpenCV文档blur。
+images.medianBlur(img, size)#
+[v4.1.0新增]
+
+img <Image> 图片size <Array> 定义滤波器的大小，如[3, 3]- 返回 <Image>
+
+对图像进行中值滤波，返回处理后的图像。
+可以参考有关博客（比如实现图像平滑处理）或者OpenCV文档blur。
+images.gaussianBlur(img, size[, sigmaX, sigmaY, type])#
+[v4.1.0新增]
+
+img <Image> 图片size <Array> 定义滤波器的大小，如[3, 3]sigmaX <number> x方向的标准方差，不填写则自动计算sigmaY <number> y方向的标准方差，不填写则自动计算type <string> 推断边缘像素类型，默认为"DEFAULT"，参见images.blur- 返回 <Image>
+
+对图像进行高斯模糊，返回处理后的图像。
+可以参考有关博客（比如实现图像平滑处理）或者OpenCV文档GaussianBlur。
+images.matToImage(mat)#
+[v4.1.0新增]
+
+mat <Mat> OpenCV的Mat对象- 返回 <Image>
+
+把Mat对象转换为Image对象。
+找图找色#
+images.requestScreenCapture([landscape])#
+
+landscape <boolean> 布尔值， 表示将要执行的截屏是否为横屏。如果landscape为false, 则表示竖屏截图; true为横屏截图。
+向系统申请屏幕截图权限，返回是否请求成功。
+第一次使用该函数会弹出截图权限请求，建议选择“总是允许”。
+这个函数只是申请截图权限，并不会真正执行截图，真正的截图函数是captureScreen()。
+该函数在截图脚本中只需执行一次，而无需每次调用captureScreen()都调用一次。
+如果不指定landscape值，则截图方向由当前设备屏幕方向决定，因此务必注意执行该函数时的屏幕方向。
+建议在本软件界面运行该函数，在其他软件界面运行时容易出现一闪而过的黑屏现象。
+示例:
+
//请求截图
+if(!requestScreenCapture()){
+ toast("请求截图失败");
+ exit();
+}
+//连续截图10张图片(间隔1秒)并保存到存储卡目录
+for(var i = 0; i < 10; i++){
+ captureScreen("/sdcard/screencapture" + i + ".png");
+ sleep(1000);
+}
+
该函数也可以作为全局函数使用。
+images.captureScreen()#
+截取当前屏幕并返回一个Image对象。
+没有截图权限时执行该函数会抛出SecurityException。
+该函数不会返回null，两次调用可能返回相同的Image对象。这是因为设备截图的更新需要一定的时间，短时间内（一般来说是16ms）连续调用则会返回同一张截图。
+截图需要转换为Bitmap格式，从而该函数执行需要一定的时间(0~20ms)。
+另外在requestScreenCapture()执行成功后需要一定时间后才有截图可用，因此如果立即调用captureScreen()，会等待一定时间后(一般为几百ms)才返回截图。
+例子:
+//请求横屏截图
+requestScreenCapture(true);
+//截图
+var img = captureScreen();
+//获取在点(100, 100)的颜色值
+var color = images.pixel(img, 100, 100);
+//显示该颜色值
+toast(colors.toString(color));
+
该函数也可以作为全局函数使用。
+images.captureScreen(path)#
+
+path <string> 截图保存路径
+截取当前屏幕并以PNG格式保存到path中。如果文件不存在会被创建；文件存在会被覆盖。
+该函数不会返回任何值。该函数也可以作为全局函数使用。
+images.pixel(image, x, y)#
+返回图片image在点(x, y)处的像素的ARGB值。
+该值的格式为0xAARRGGBB，是一个"32位整数"(虽然JavaScript中并不区分整数类型和其他数值类型)。
+坐标系以图片左上角为原点。以图片左侧边为y轴，上侧边为x轴。
+images.findColor(image, color, options)#
image <Image> 图片color <number> | <string> 要寻找的颜色的RGB值。如果是一个整数，则以0xRRGGBB的形式代表RGB值（A通道会被忽略）；如果是字符串，则以"#RRGGBB"代表其RGB值。images.findColorEquals(img, color[, x, y, width, height])#
+images.matchTemplate(img, template, options)#
+
[v4.1.0新增]
+
+img <Image> 大图片template <Image> 小图片（模板）options <Object> 找图选项：
+- 返回 <MatchingResult>
+
+在大图片中搜索小图片，并返回搜索结果MatchingResult。该函数可以用于找图时找出多个位置，可以通过max参数控制最大的结果数量。也可以对匹配结果进行排序、求最值等操作。
+MatchingResult#
+[v4.1.0新增]
+matches#
+
+- <Array> 匹配结果的数组。
+
+数组的元素是一个Match对象：
+
+point <Point> 匹配位置similarity <number> 相似度
+例如:
+
var result = images.matchTemplate(img, template, {
+ max: 100
+});
+result.matches.forEach(match => {
+ log("point = " + match.point + ", similarity = " + match.similarity);
+});
+
points#
+
+- <Array> 匹配位置的数组。
+
+first()#
+
+- 返回 <Match>
+
+第一个匹配结果。如果没有任何匹配，则返回null。
+last()#
+
+- 返回 <Match>
+
+最后一个匹配结果。如果没有任何匹配，则返回null。
+leftmost()#
+
+- 返回 <Match>
+
+位于大图片最左边的匹配结果。如果没有任何匹配，则返回null。
+topmost()#
+
+- 返回 <Match>
+
+位于大图片最上边的匹配结果。如果没有任何匹配，则返回null。
+rightmost()#
+
+- 返回 <Match>
+
+位于大图片最右边的匹配结果。如果没有任何匹配，则返回null。
+bottommost()#
+
+- 返回 <Match>
+
+位于大图片最下边的匹配结果。如果没有任何匹配，则返回null。
+best()#
+
+- 返回 <Match>
+
+相似度最高的匹配结果。如果没有任何匹配，则返回null。
+worst()#
+
+- 返回 <Match>
+
+相似度最低的匹配结果。如果没有任何匹配，则返回null。
+sortBy(cmp)#
+
+- cmp <Function>|<string> 比较函数，或者是一个字符串表示排序方向。例如"left"表示将匹配结果按匹配位置从左往右排序、"top"表示将匹配结果按匹配位置从上往下排序，"left-top"表示将匹配结果按匹配位置从左往右、从上往下排序。方向包括
left（左）, top （上）, right （右）, bottom（下）。
+- <MatchingResult>
+
+对匹配结果进行排序，并返回排序后的结果。
+var result = images.matchTemplate(img, template, {
+ max: 100
+});
+log(result.sortBy("top-right"));
+
Image#
表示一张图片，可以是截图的图片，或者本地读取的图片，或者从网络获取的图片。
Image.getWidth()#
返回以像素为单位图片宽度。
@@ -580,6 +912,7 @@ Image.pixel(x, y)#
findColor, findImage返回的对象。表示一个点（坐标）。
Point.x#
diff --git a/app/src/main/assets/docs/index.html b/app/src/main/assets/docs/index.html
index eb58ec90b..770dccdec 100644
--- a/app/src/main/assets/docs/index.html
+++ b/app/src/main/assets/docs/index.html
@@ -2,8 +2,8 @@
- Index | Auto.js 3.0.0 文档
-
+ Index | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/keys.html b/app/src/main/assets/docs/keys.html
index 5bf46617e..521833d9b 100644
--- a/app/src/main/assets/docs/keys.html
+++ b/app/src/main/assets/docs/keys.html
@@ -2,8 +2,8 @@
- Keys | Auto.js 3.0.0 文档
-
+ Keys | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/media.html b/app/src/main/assets/docs/media.html
index 68c9a7991..ec975664f 100644
--- a/app/src/main/assets/docs/media.html
+++ b/app/src/main/assets/docs/media.html
@@ -2,8 +2,8 @@
- Media | Auto.js 3.0.0 文档
-
+ Media | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/modules.html b/app/src/main/assets/docs/modules.html
index 06c952263..823b5edb8 100644
--- a/app/src/main/assets/docs/modules.html
+++ b/app/src/main/assets/docs/modules.html
@@ -2,8 +2,8 @@
- module (模块) | Auto.js 3.0.0 文档
-
+ module (模块) | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -83,7 +83,7 @@
目录
module (模块)#
Stability: 2 - StableAuto.js 有一个简单的模块加载系统。 在 Auto.js 中，文件和模块是一一对应的（每个文件被视为一个独立的模块）。
例子，假设有一个名为 foo.js 的文件：
-const circle = require('circle.js');
+var circle = require('circle.js');
console.log("半径为 4 的圆的面积是 %d", circle.area(4));
在第一行中，foo.js 加载了同一目录下的 circle.js 模块。
circle.js 文件的内容为：
@@ -91,7 +91,9 @@ module (模块)
- 综述 | Auto.js 3.0.0 文档
-
+ 综述 | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/qa.html b/app/src/main/assets/docs/qa.html
index 2aaf28af5..bc39a66e4 100644
--- a/app/src/main/assets/docs/qa.html
+++ b/app/src/main/assets/docs/qa.html
@@ -2,8 +2,8 @@
- Q & A | Auto.js 3.0.0 文档
-
+ Q & A | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -76,8 +76,9 @@
目录
- Q & A
@@ -89,35 +90,30 @@ 目录
Q & A#
如何定时运行脚本#
点击脚本右边的菜单按钮->更多->定时任务即可定时运行脚本，但是必须保持Auto.js后台运行(自启动白名单、电源管理白名单等)。同时，可以在脚本的开头使用device.wakeUp()来唤醒屏幕；但是，Auto.js没有解锁屏幕的功能，因此难以在有锁屏密码的设备上达到效果。
-如何把图片和脚本一起打包，或者打包多个脚本#
-如果除了单脚本以外还有其他脚本、图片、音乐等资源一起打包，则需要使用项目打包功能。
-
-- 新建一个文件夹，命名为项目名称。
-- 在该文件夹下新建脚本，或者移动脚本到该文件夹，命名为main.js，表示主脚本。脚本打包后将会从该脚本开始运行。
-- 把其他资源或脚本放在该文件夹，并通过相对路径引用。
-- 通过文件夹菜单的"打包"功能来打包该项目
-
+定时任何如何获取外部参数#
+如果一个脚本是用intent"启动"的，比如定时任务中的特定事件（网络状态变化等）触发而启动的，则可以通过engines.myEngine().execArgv.intent获取启动的intent，从而获取外部参数。
+如何把图片和脚本一起打包，或者打包多个脚本#
+如果除了单脚本以外还有其他脚本、图片、音乐等资源一起打包，则需要使用项目功能。
+点击Auto.js的"+"号，选择项目，填写项目名称、包名等信息以后，点击"√"即可新建一个项目。可以在项目中放多个脚本、模块、资源文件，点击项目工具栏的apk打包图标即可打包一个项目，点击工具栏可以重新配置项目。
例如，主脚本要读取同一文件夹下的图片1.png，再执行找图，则可以通过images.read("./1.png")来读取，其中"./1.png"表示同一目录1.png图片；ui中的图片控件要引用同一文件夹的2.png图片则为<img src="file://2.png"/>。Auto.js内置的函数和模块都支持相对路径，但是，其他情况则需要使用files.path()函数来把相对路径转换为绝对路径。
-目前Auto.js还不支持项目的图形化管理，后续会加入。
-如何使打包的应用不显示主界面#
-需要使用项目打包功能。
-
-- 新建一个文件夹，命名为项目名称。
-- 在该文件夹下新建脚本，或者移动脚本到该文件夹，命名为main.js，表示主脚本。脚本打包后将会从该脚本开始运行。
-- 在该文件夹下新建一个project.json的文件，其内容如下：
{
-"name": "项目名称",
-"versionName": "1.0.0",
-"versionCode": 1,
-"packageName": "org.autojs.example",
-"main": "main.js",
-"launchConfig": {
- "hideLogs": true
+如何使打包的应用不显示主界面#
+需要使用项目功能。新建项目后，修改项目下的project.json文件，增加以下条目：
+"launchConfig": {
+ "hideLogs": true
}
+
例如：
+{
+ "name": "项目名称",
+ "versionName": "1.0.0",
+ "versionCode": 1,
+ "packageName": "org.autojs.example",
+ "main": "main.js",
+ "launchConfig": {
+ "hideLogs": true
+ }
}
-
其中，项目名称改为自己的项目名称，"org.autojs.example"改成自己的包名，下面的"launchConfig"表示启动配置，"hideLogs"表示隐藏日志。
-- 通过文件夹菜单的"打包"功能来打包该项目
-
-有关项目打包和配置的更多信息，参见项目与项目配置(待补)。
+"launchConfig"表示启动配置，"hideLogs"表示隐藏日志。
+参见项目与项目配置。
Auto.js自带的模块和函数中没有的功能如何实现#
由于Auto.js支持直接调用Android的API，对于Auto.js没有内置的函数，可以直接通过修改Android代码为JavaScript代码实现。例如旋转图片的Android代码为：
import android.graphics.Bitmap;
diff --git a/app/src/main/assets/docs/sensors.html b/app/src/main/assets/docs/sensors.html
index f4c768df1..92acf0635 100644
--- a/app/src/main/assets/docs/sensors.html
+++ b/app/src/main/assets/docs/sensors.html
@@ -2,8 +2,8 @@
- Sensors | Auto.js 3.0.0 文档
-
+ Sensors | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/shell.html b/app/src/main/assets/docs/shell.html
index 3457d550d..92521f322 100644
--- a/app/src/main/assets/docs/shell.html
+++ b/app/src/main/assets/docs/shell.html
@@ -2,8 +2,8 @@
- shell函数 | Auto.js 3.0.0 文档
-
+ shell函数 | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/storages.html b/app/src/main/assets/docs/storages.html
index 382c36d2e..e9cb9b39a 100644
--- a/app/src/main/assets/docs/storages.html
+++ b/app/src/main/assets/docs/storages.html
@@ -2,8 +2,8 @@
- Storages | Auto.js 3.0.0 文档
-
+ Storages | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/threads.html b/app/src/main/assets/docs/threads.html
index d36ade17a..08dc2bfe1 100644
--- a/app/src/main/assets/docs/threads.html
+++ b/app/src/main/assets/docs/threads.html
@@ -2,8 +2,8 @@
- Threads | Auto.js 3.0.0 文档
-
+ Threads | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/timers.html b/app/src/main/assets/docs/timers.html
index 264743d5d..e7b586748 100644
--- a/app/src/main/assets/docs/timers.html
+++ b/app/src/main/assets/docs/timers.html
@@ -2,8 +2,8 @@
- Timers | Auto.js 3.0.0 文档
-
+ Timers | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/ui.html b/app/src/main/assets/docs/ui.html
index 3e830c804..784a9458e 100644
--- a/app/src/main/assets/docs/ui.html
+++ b/app/src/main/assets/docs/ui.html
@@ -2,8 +2,8 @@
- 用户界面: UI | Auto.js 3.0.0 文档
-
+ 用户界面: UI | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -191,11 +191,12 @@
目录
用户界面: UI#
ui模块提供了编写用户界面的支持。
-带有ui的脚本的第一行必须使用"ui"指定ui模式，否则脚本将不会以ui模式运行。正确示范:
+带有ui的脚本的的最前面必须使用"ui";指定ui模式，否则脚本将不会以ui模式运行。正确示范:
"ui";
//脚本的其他代码
-
界面是由视图(View)组成的。View分成两种，控件(Widget)和布局(Layout)。控件(Widget)用来具体显示文字、图片、网页等，比如文本控件(text)用来显示文字，按钮控件(button)则可以显示一个按钮并提供点击效果，图片控件(img)则用来显示来自网络或者文件的图片，除此之外还有输入框控件(input)、进度条控件(progressbar)、单选复选框控件(checkbox)等；布局(Layout)则是装着一个或多个控件的"容器"，用于控制在他里面的控件的位置，比如垂直布局(vertical)会把他里面的控件从上往下依次显示(即纵向排列)，水平布局(horizontal)则会把他里面的控件从左往右依次显示(即横向排列)，以及帧布局(frame)，他会把他里面的控件直接在左上角显示，如果有多个控件，后面的控件会重叠在前面的控件上。
+字符串"ui"的前面可以有注释、空行和空格[v4.1.0新增]，但是不能有其他代码。
+界面是由视图(View)组成的。View分成两种，控件(Widget)和布局(Layout)。控件(Widget)用来具体显示文字、图片、网页等，比如文本控件(text)用来显示文字，按钮控件(button)则可以显示一个按钮并提供点击效果，图片控件(img)则用来显示来自网络或者文件的图片，除此之外还有输入框控件(input)、进度条控件(progressbar)、单选复选框控件(checkbox)等；布局(Layout)则是装着一个或多个控件的"容器"，用于控制在他里面的控件的位置，比如垂直布局(vertical)会把他里面的控件从上往下依次显示(即纵向排列)，水平布局(horizontal)则会把他里面的控件从左往右依次显示(即横向排列)，以及帧布局(frame)，他会把他里面的控件直接在左上角显示，如果有多个控件，后面的控件会重叠在前面的控件上。
我们使用xml来编写界面，并通过ui.layout()函数指定界面的布局xml。举个例子：
"ui";
ui.layout(
diff --git a/app/src/main/assets/docs/util.html b/app/src/main/assets/docs/util.html
index 95a7ab292..b759edac7 100644
--- a/app/src/main/assets/docs/util.html
+++ b/app/src/main/assets/docs/util.html
@@ -2,8 +2,8 @@
- Util | Auto.js 3.0.0 文档
-
+ Util | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
diff --git a/app/src/main/assets/docs/widgets-based-automation.html b/app/src/main/assets/docs/widgets-based-automation.html
index d0dc5fecf..857f7dfdc 100644
--- a/app/src/main/assets/docs/widgets-based-automation.html
+++ b/app/src/main/assets/docs/widgets-based-automation.html
@@ -2,8 +2,8 @@
- 基于控件的操作 | Auto.js 3.0.0 文档
-
+ 基于控件的操作 | Auto.js 4.1.0 文档
+
@@ -61,7 +61,7 @@
- Auto.js 3.0.0 文档
+ Auto.js 4.1.0 文档
索引 |
@@ -78,6 +78,13 @@
目录
- auto([mode])
- auto.waitFor()
- auto.setMode(mode)
+- auto.setFlags(flags)
+- auto.serivce
+- auto.windows
+- auto.root
+- auto.rootInActiveWindow
+- auto.setWindowFilter(filter)
+- auto.windowRoots
- SimpleActionAutomator
@@ -92,6 +99,7 @@ 目录
- UiSelector
- selector()
+- UiSelector.algorithm(algorithm)
- UiSelector.text(str)
- UiSelector.textContains(str)
- UiSelector.textStartsWith(prefix)
@@ -222,6 +230,7 @@ auto([mode])auto();
auto.waitFor()#
检查无障碍服务是否已经启用，如果没有启用则跳转到无障碍服务启用界面，并等待无障碍服务启动；当无障碍服务启动后脚本会继续运行。
+因为该函数是阻塞的，因此除非是有协程特性，否则不能在ui模式下运行该函数，建议在ui模式下使用auto()函数。
auto.setMode(mode)#
mode <string> 模式auto.setMode(mode)#
+[v4.1.0新增]
+
+flags <string> | <Array> 一些标志，来启用和禁用某些特性，包括：
+findOnUiThread 使用该特性后，选择器搜索时会在主进程进行。该特性用于解决线程安全问题导致的次生问题，不过目前貌似已知问题并不是线程安全问题。useUsageStats 使用该特性后，将会以"使用情况统计"服务的结果来检测当前正在运行的应用包名（需要授予"查看使用情况统计"权限)。如果觉得currentPackage()返回的结果不太准确，可以尝试该特性。useShell 使用该特性后，将使用shell命令获取当前正在运行的应用的包名、活动名称，但是需要root权限。
+
+启用有关automator的一些特性。例如：
+
auto.setFlags(["findOnUiThread", "useShell"]);
+
auto.serivce#
+[v4.1.0新增]
+
+获取无障碍服务。如果无障碍服务没有启动，则返回null。
+
+auto.windows#
+[v4.1.0新增]
+
+- <Array>
+
+当前所有窗口(AccessibilityWindowInfo)的数组，可能包括状态栏、输入法、当前应用窗口，弹出窗口、悬浮窗、分屏应用窗口等。可以分别获取每个窗口的布局信息。
+该函数需要Android 5.0以上才能运行。
+auto.root#
+[v4.1.0新增]
+
+- <UiObject>
+
+当前窗口的布局根元素。如果无障碍服务未启动或者WindowFilter均返回false，则会返回null。
+如果不设置windowFilter，则当前窗口即为活跃的窗口（获取到焦点、正在触摸的窗口）；如果设置了windowFilter，则获取的是过滤的窗口中的第一个窗口。
+如果系统是Android5.0以下，则始终返回当前活跃的窗口的布局根元素。
+auto.rootInActiveWindow#
+[v4.1.0新增]
+
+- <UiObject>
+
+当前活跃的窗口（获取到焦点、正在触摸的窗口）的布局根元素。如果无障碍服务未启动则为null。
+auto.setWindowFilter(filter)#
+[v4.1.0新增]
+
+filter <Function> 参数为窗口(AccessibilityWindowInfo)，返回值为Boolean的函数。
+设置窗口过滤器。这个过滤器可以决定哪些窗口是目标窗口，并影响选择器的搜索。例如，如果想要选择器在所有窗口（包括状态栏、输入法等）中搜索，只需要使用以下代码：
+auto.setWindowFilter(function(window){
+ //不管是如何窗口，都返回true，表示在该窗口中搜索
+ return true;
+});
+
又例如，当前使用了分屏功能，屏幕上有Auto.js和QQ两个应用，但我们只想选择器对QQ界面进行搜索，则：
+auto.setWindowFilter(function(window){
+ // 对于应用窗口，他的title属性就是应用的名称，因此可以通过title属性来判断一个应用
+ return window.title == "QQ";
+});
+
选择器默认是在当前活跃的窗口中搜索，不会搜索诸如悬浮窗、状态栏之类的，使用WindowFilter则可以控制搜索的窗口。
+需要注意的是， 如果WindowFilter返回的结果均为false，则选择器的搜索结果将为空。
+另外setWindowFilter函数也会影响auto.windowRoots的结果。
+该函数需要Android 5.0以上才有效。
+auto.windowRoots#
+[v4.1.0新增]
+
+- <Array>
+
+返回当前被WindowFilter过滤的窗口的布局根元素组成的数组。
+如果系统是Android5.0以下，则始终返回当前活跃的窗口的布局根元素的数组。
SimpleActionAutomator#
Stability: 2 - StableSimpleActionAutomator提供了一些模拟简单操作的函数，例如点击文字、模拟按键等。这些函数可以直接作为全局函数使用。
click(text[, i])#
@@ -363,6 +438,18 @@ selector()创建一个新的选择器。但一般情况不需要使用该函数，因为可以直接用相应条件的语句创建选择器。
由于历史遗留原因，本不应该这样设计(不应该让id(), text()等作为全局函数，而是应该用By.id(), By.text())，但为了后向兼容性只能保留这个设计。
这样的API设计会污染全局变量，后续可能会支持"去掉这些全局函数而使用By.*"的选项。
+UiSelector.algorithm(algorithm)#
+[v4.1.0新增]
+
+algorithm <string> 搜索算法，可选的值有：
+DFS 深度优先算法，选择器的默认算法BFS 广度优先算法
+
+指定选择器的搜索算法。例如：
+log(selector().text("文本").algorithm("BFS").find());
+
广度优先在控件所在层次较低时，或者布局的层次不多时，通常能更快找到控件。
UiSelector.text(str)#
str <string> 控件文本
+ UI中使用协程
+
+
+);
+
+continuation.delay(5000);
+if (!requestScreenCapture()) {
+ dialogs.alert("请授予软件截图权限").await();
+}
+
+
+// 退出应用对话框
+ui.emitter.on("back_pressed", function (e) {
+ e.consumed = true;
+ let exit = dialogs.confirm("确定要退出程序").await();
+ if (exit) {
+ ui.finish();
+ }
+});
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\345\215\217\347\250\213/ui\344\270\255\344\275\277\347\224\250\345\215\217\347\250\213/project.json" "b/app/src/main/assets/sample/\345\215\217\347\250\213/ui\344\270\255\344\275\277\347\224\250\345\215\217\347\250\213/project.json"
new file mode 100644
index 000000000..8afb2e9cb
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\215\217\347\250\213/ui\344\270\255\344\275\277\347\224\250\345\215\217\347\250\213/project.json"
@@ -0,0 +1,11 @@
+{
+ "name": "协程UI示例",
+ "main": "main.js",
+ "ignore": [
+ "build"
+ ],
+ "packageName": "com.example.cont.ui",
+ "versionName": "1.0.0",
+ "versionCode": 1,
+ "useFeatures": ["continuation"]
+}
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/hello.txt" "b/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/hello.txt"
new file mode 100644
index 000000000..9be9bcf84
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/hello.txt"
@@ -0,0 +1 @@
+Nothing
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/main.js" "b/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/main.js"
new file mode 100644
index 000000000..9e93812af
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/main.js"
@@ -0,0 +1,54 @@
+// 注意，要使用协程这个特性，必须使用项目功能，并且在project.json配置好features属性
+
+
+// delay不同于sleep，不会阻塞当前线程
+function delay(millis) {
+ var cont = continuation.create();
+ setTimeout(()=>{
+ cont.resume();
+ }, millis);
+ cont.await();
+}
+
+// 异步IO例子，在另一个线程读取文件，读取完成后返回当前线程继续执行
+function read(path) {
+ var cont = continuation.create();
+ threads.start(function(){
+ try {
+ cont.resume(files.read(path));
+ }catch(err){
+ cont.resumeError(err);
+ }
+ });
+ return cont.await();
+}
+
+// 使用Promise和协程的例子
+function add(a, b) {
+ return new Promise(function(resolve, reject) {
+ var sum = a + b;
+ resolve(sum);
+ });
+}
+
+toastLog("Hello, Continuation!");
+
+//3秒后发出提示
+setTimeout(()=>{
+ toastLog("3秒后....");
+}, 3000);
+
+// 你可以尝试把delay更换成sleep，看会发生什么！
+delay(6000);
+toastLog("6秒后...");
+
+try {
+ toastLog("读取文件hello.txt: " + read("./hello.txt"));
+}catch(err){
+ console.error(err);
+}
+
+var sum = add(1, 2).await();
+toastLog("1 + 2 = " + sum);
+
+
diff --git "a/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/project.json" "b/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/project.json"
new file mode 100644
index 000000000..dccfca878
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\215\217\347\250\213/\345\215\217\347\250\213HelloWorld/project.json"
@@ -0,0 +1,11 @@
+{
+ "name": "协程HelloWorld",
+ "main": "main.js",
+ "ignore": [
+ "build"
+ ],
+ "packageName": "com.example.cont.helloworld",
+ "versionName": "1.0.0",
+ "versionCode": 1,
+ "useFeatures": ["continuation"]
+}
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\345\233\276\347\211\207\345\244\204\347\220\206.js" "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\345\233\276\347\211\207\345\244\204\347\220\206.js"
new file mode 100644
index 000000000..654c56ad7
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\345\233\276\347\211\207\345\244\204\347\220\206.js"
@@ -0,0 +1,142 @@
+"ui";
+
+var url = "https://www.autojs.org/assets/uploads/files/1540386817060-918021-20160416200702191-185324559.jpg";
+var logo = null;
+var currentImg = null;
+
+events.on("exit", function(){
+ if(logo != null){
+ logo.recycle();
+ }
+ if(currentImg != null){
+ currentImg.recycle();
+ }
+});
+
+ui.layout(
+
+ ![]()
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+);
+
+//把一张图片设置到图片控件中
+function setImage(img) {
+ ui.run(() => {
+ ui.img.setImageBitmap(img.bitmap);
+ var oldImg = currentImg;
+ //不能立即回收currentImg，因为此时img控件还在使用它，应该在下次消息循环再回收它
+ ui.post(()=>{
+ if(oldImg != null){
+ oldImg.recycle();
+ }
+ });
+ currentImg = img;
+ });
+}
+
+//启动一个处理图片的线程
+var imgProcess = threads.start(function () {
+ setInterval(() => { }, 1000);
+});
+
+//处理图片的函数，把任务交给图片处理线程处理
+function processImg(process) {
+ imgProcess.setTimeout(() => {
+ if (logo == null) {
+ logo = images.load(url);
+ }
+ //处理图片
+ var result = process(logo);
+ //把处理后的图片设置到图片控件中
+ setImage(result);
+ }, 0);
+}
+
+var degress = 0;
+
+ui.rotate.on("click", () => {
+ processImg(img => {
+ degress += 90;
+ //旋转degress角度
+ return images.rotate(img, degress);
+ });
+});
+
+ui.concat.on("click", () => {
+ processImg(img => {
+ if(currentImg == null){
+ toast("请先点击其他按钮，再点击本按钮");
+ return img.clone();
+ }
+ //把currentImg拼接在img右边
+ return images.concat(img, currentImg, "right");
+ });
+});
+
+ui.grayscale.on("click", () => {
+ processImg(img => {
+ //灰度化
+ return images.grayscale(img);
+ });
+});
+
+ui.binary.on("click", () => {
+ processImg(img => {
+ var g = images.grayscale(img);
+ //二值化，取灰度为30到200之间的图片
+ var result = images.threshold(g, 100, 200);
+ g.recycle();
+ return result;
+ });
+});
+
+ui.adaptiveBinary.on("click", () => {
+ processImg(img => {
+ var g = images.grayscale(img);
+ //自适应二值化，最大值为200，块大小为25
+ var result = images.adaptiveThreshold(g, 200, "MEAN_C", "BINARY", 25, 10);
+ g.recycle();
+ return result;
+ });
+});
+
+ui.hsv.on("click", () => {
+ processImg(img => {
+ //RGB转HSV
+ return images.cvtColor(img, "BGR2HSV");
+ });
+});
+
+ui.blur.on("click", () => {
+ processImg(img => {
+ //模糊
+ return images.blur(img, [10, 10]);
+ });
+});
+
+ui.medianBlur.on("click", () => {
+ processImg(img => {
+ //中值滤波
+ return images.medianBlur(img, 5);
+ });
+});
+
+ui.gaussianBlur.on("click", () => {
+ processImg(img => {
+ //高斯模糊
+ return images.gaussianBlur(img, [5, 5]);
+ });
+});
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/block.png" "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/block.png"
new file mode 100644
index 000000000..c0944e12d
Binary files /dev/null and "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/block.png" differ
diff --git "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/mario.png" "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/mario.png"
new file mode 100644
index 000000000..042671c69
Binary files /dev/null and "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/mario.png" differ
diff --git "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/super_mario.jpg" "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/super_mario.jpg"
new file mode 100644
index 000000000..373502ece
Binary files /dev/null and "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/super_mario.jpg" differ
diff --git "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\346\211\200\346\234\211\351\227\256\345\217\267\346\226\271\345\235\227.js" "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\346\211\200\346\234\211\351\227\256\345\217\267\346\226\271\345\235\227.js"
new file mode 100644
index 000000000..ddea51e99
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\346\211\200\346\234\211\351\227\256\345\217\267\346\226\271\345\235\227.js"
@@ -0,0 +1,11 @@
+
+var superMario = images.read("./super_mario.jpg");
+var block = images.read("./block.png");
+
+var result = images.matchTemplate(superMario, block, {
+ threshold: 0.8
+}).matches;
+toastLog(result);
+
+superMario.recycle();
+block.recycle();
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\351\227\256\345\217\267\346\226\271\345\235\227\345\271\266\347\224\273\345\207\272\344\275\215\347\275\256.js" "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\351\227\256\345\217\267\346\226\271\345\235\227\345\271\266\347\224\273\345\207\272\344\275\215\347\275\256.js"
new file mode 100644
index 000000000..8b25049be
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\351\227\256\345\217\267\346\226\271\345\235\227\345\271\266\347\224\273\345\207\272\344\275\215\347\275\256.js"
@@ -0,0 +1,23 @@
+
+var superMario = images.read("./super_mario.jpg");
+var block = images.read("./block.png");
+var points = images.matchTemplate(superMario, block, {
+ threshold: 0.8
+}).points;
+
+toastLog(points);
+
+var canvas = new Canvas(superMario);
+var paint = new Paint();
+paint.setColor(colors.parseColor("#2196F3"));
+points.forEach(point => {
+ canvas.drawRect(point.x, point.y, point.x + block.width, point.y + block.height, paint);
+});
+var image = canvas.toImage();
+images.save(image, "/sdcard/tmp.png");
+
+app.viewFile("/sdcard/tmp.png");
+
+superMario.recycle();
+block.recycle();
+image.recycle();
diff --git "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\351\251\254\351\207\214\345\245\245.js" "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\351\251\254\351\207\214\345\245\245.js"
new file mode 100644
index 000000000..6285cbef4
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\346\211\276\345\233\276/\346\211\276\345\207\272\351\251\254\351\207\214\345\245\245.js"
@@ -0,0 +1,8 @@
+
+var superMario = images.read("./super_mario.jpg");
+var mario = images.read("./mario.png");
+var point = findImage(superMario, mario);
+toastLog(point);
+
+superMario.recycle();
+mario.recycle();
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\350\216\267\345\217\226\347\275\221\347\273\234\345\233\276\347\211\207\345\271\266\344\277\235\345\255\230.js" "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\350\216\267\345\217\226\347\275\221\347\273\234\345\233\276\347\211\207\345\271\266\344\277\235\345\255\230.js"
index 971725ee3..c73eade1e 100644
--- "a/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\350\216\267\345\217\226\347\275\221\347\273\234\345\233\276\347\211\207\345\271\266\344\277\235\345\255\230.js"
+++ "b/app/src/main/assets/sample/\345\233\276\347\211\207\344\270\216\345\233\276\350\211\262\345\244\204\347\220\206/\350\216\267\345\217\226\347\275\221\347\273\234\345\233\276\347\211\207\345\271\266\344\277\235\345\255\230.js"
@@ -1,5 +1,5 @@
//这个是Auto.js图标的地址
-var url = "http://www.autojs.org/assets/uploads/profile/3-profileavatar.png";
+var url = "https://www.autojs.org/assets/uploads/profile/3-profileavatar.png";
var logo = images.load(url);
//保存到路径/sdcard/auto.js.png
images.save(logo, "/sdcard/auto.js.png");
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\345\244\215\346\235\202\347\225\214\351\235\242/\345\276\205\345\212\236\344\272\213\351\241\271.js" "b/app/src/main/assets/sample/\345\244\215\346\235\202\347\225\214\351\235\242/\345\276\205\345\212\236\344\272\213\351\241\271.js"
new file mode 100644
index 000000000..6f08f2e3e
--- /dev/null
+++ "b/app/src/main/assets/sample/\345\244\215\346\235\202\347\225\214\351\235\242/\345\276\205\345\212\236\344\272\213\351\241\271.js"
@@ -0,0 +1,115 @@
+"ui";
+
+importClass(android.graphics.Paint);
+
+ui.layout(
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
邮箱
-
+
diff --git "a/app/src/main/assets/sample/\345\244\215\346\235\202\347\225\214\351\235\242/\351\237\263\344\271\220\346\265\217\350\247\210\345\231\250.js" "b/app/src/main/assets/sample/\345\244\215\346\235\202\347\225\214\351\235\242/\351\237\263\344\271\220\346\265\217\350\247\210\345\231\250.js"
index f3d6f9497..0664fbdc3 100644
--- "a/app/src/main/assets/sample/\345\244\215\346\235\202\347\225\214\351\235\242/\351\237\263\344\271\220\346\265\217\350\247\210\345\231\250.js"
+++ "b/app/src/main/assets/sample/\345\244\215\346\235\202\347\225\214\351\235\242/\351\237\263\344\271\220\346\265\217\350\247\210\345\231\250.js"
@@ -1,20 +1,39 @@
"ui";
-//音乐文件的后缀名
-var musicExts = [".mp3", ".wma", ".rm", ".wav", ".mid", ".ape", ".flac"];
-//扫描路径
-var path = files.getSdcardPath();
-//保存音乐文件列表的数组
-var musicFiles = [];
+var IconView = (function() {
+ //继承ui.Widget
+ util.extend(IconView, ui.Widget);
+
+ function IconView() {
+ //调用父类构造函数
+ ui.Widget.call(this);
+ //自定义属性color，定义按钮颜色
+ this.defineAttr("icon", (view, name, defaultGetter) => {
+ return this._icon;
+ }, (view, name, value, defaultSetter) => {
+ this._icon = value;
+ view.setImageResource(value);
+ });
+ }
+ IconView.prototype.render = function() {
+ return (
+ ![]()
+ );
+ }
+ ui.registerWidget("icon", IconView);
+ return IconView;
+})();
+
+var apps = [];
ui.layout(
- 
+
-
@@ -22,38 +41,31 @@ ui.layout(
);
-ui.files.setDataSource(musicFiles);
+ui.apps.setDataSource(musicFiles);
-ui.files.on("item_click", function(item, pos){
- media.playMusic(item.path, 1);
+ui.apps.on("item_click", function(item, pos){
+ toast(item);
});
//启动线程来扫描音乐文件
threads.start(function () {
- listMuiscFiles(path, musicFiles);
+ listApps(apps);
ui.run(()=> {
ui.progressbar.setVisility(8);
});
});
-function listMuiscFiles(dir, list) {
- //遍历该文件夹的文件
- files.listDir(dir).forEach(fileName => {
- var path = files.join(dir, fileName);
- //如果是子文件夹则继续扫描子文件夹的文件
- if (files.isDir(path)) {
- listMuiscFiles(path, list);
- return;
- }
- for (var i = 0; i < musicExts.length; i++) {
- //如果文件名的后缀是音乐格式
- if (fileName.endsWith(musicExts[i])) {
- //则把它添加到列表中
- list.push({
- name: fileName,
- path: path
- });
- }
- }
- });
+function listApps(apps) {
+ var pm = context.getPackageManager();
+ let list = pm.getInstalledPackages(0);
+ for(let i = 0; i < list.size(); i++){
+ let p = list.get(i);
+ apps.push({
+ appName: p.applicationInfo.loadLabel(pm).toString(),
+ packageName: p.packageName,
+ versionName: p.versionName,
+ versionCode: p.versionCode,
+ icon: p.applicationInfo.loadIcon(pm)
+ });
+ }
}
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\346\216\247\345\210\266\345\217\260/\344\277\235\345\255\230\346\227\245\345\277\227.js" "b/app/src/main/assets/sample/\346\216\247\345\210\266\345\217\260/\344\277\235\345\255\230\346\227\245\345\277\227.js"
new file mode 100644
index 000000000..f93f6cb67
--- /dev/null
+++ "b/app/src/main/assets/sample/\346\216\247\345\210\266\345\217\260/\344\277\235\345\255\230\346\227\245\345\277\227.js"
@@ -0,0 +1,7 @@
+console.setGlobalLogConfig({
+ file: "/sdcard/log.txt"
+});
+console.log(1);
+console.log(2);
+console.error(3);
+app.viewFile("/sdcard/log.txt");
diff --git "a/app/src/main/assets/sample/\346\216\247\345\210\266\345\217\260/\346\216\247\345\210\266\345\217\260\347\244\272\344\276\213.js" "b/app/src/main/assets/sample/\346\216\247\345\210\266\345\217\260/\346\216\247\345\210\266\345\217\260\347\244\272\344\276\213.js"
index 6af4d3e46..e70afe406 100644
--- "a/app/src/main/assets/sample/\346\216\247\345\210\266\345\217\260/\346\216\247\345\210\266\345\217\260\347\244\272\344\276\213.js"
+++ "b/app/src/main/assets/sample/\346\216\247\345\210\266\345\217\260/\346\216\247\345\210\266\345\217\260\347\244\272\344\276\213.js"
@@ -6,3 +6,9 @@ console.log("这是黑色");
console.info("这是红色");
console.warn("这是蓝色");
console.error("这是绿色=_=");
+hey();
+
+function hey() {
+ console.trace("打印日志行数");
+}
+
diff --git "a/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\345\210\227\350\241\250\346\216\247\344\273\266.js" "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\345\210\227\350\241\250\346\216\247\344\273\266.js"
index fed03fcb2..e85afede2 100644
--- "a/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\345\210\227\350\241\250\346\216\247\344\273\266.js"
+++ "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\345\210\227\350\241\250\346\216\247\344\273\266.js"
@@ -6,6 +6,7 @@ ui.layout(
@@ -28,6 +29,14 @@ var items = [
ui.list.setDataSource(items);
-ui.list.on("item_click", function(i, item, itemView, listView){
+ui.list.on("item_click", function(item, i, itemView, listView){
toast("被点击的人名字为: " + item.name + "，年龄为: " + item.age);
-});
\ No newline at end of file
+});
+
+ui.list.on("item_bind", function(itemView, itemHolder){
+ itemView.deleteItem.on("click", function(){
+ let item = itemHolder.item;
+ toast("被删除的人名字为: " + item.name + "，年龄为: " + item.age);
+ items.splice(itemHolder.position, 1);
+ });
+})
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\345\215\241\347\211\207\345\270\203\345\261\200.js" "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\345\215\241\347\211\207\345\270\203\345\261\200.js"
new file mode 100644
index 000000000..d726ed826
--- /dev/null
+++ "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\345\215\241\347\211\207\345\270\203\345\261\200.js"
@@ -0,0 +1,42 @@
+"ui";
+
+ui.layout(
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+);
+
diff --git "a/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\344\275\277\347\224\250\351\205\215\347\275\256\345\213\276\351\200\211\346\241\206.js" "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\344\275\277\347\224\250\351\205\215\347\275\256\345\213\276\351\200\211\346\241\206.js"
new file mode 100644
index 000000000..154db38eb
--- /dev/null
+++ "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\344\275\277\347\224\250\351\205\215\347\275\256\345\213\276\351\200\211\346\241\206.js"
@@ -0,0 +1,18 @@
+"ui";
+
+var PrefCheckBox = require('./自定义控件-模块-配置勾选框.js');
+
+ui.layout(
+
+
+);
+
+ui.btn.on("click", function(){
+ toast("配置1为" + PrefCheckBox.getPref().get("perf1"));
+ toast("配置2为" + PrefCheckBox.getPref().get("perf2"));
+});
+
+
diff --git "a/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\345\270\203\345\261\200\346\250\241\346\235\277.js" "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\345\270\203\345\261\200\346\250\241\346\235\277.js"
new file mode 100644
index 000000000..73a7a4813
--- /dev/null
+++ "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\345\270\203\345\261\200\346\250\241\346\235\277.js"
@@ -0,0 +1,41 @@
+"ui";
+
+var InputLayout = (function() {
+ //继承至ui.Widget
+ util.extend(InputLayout, ui.Widget);
+
+ function InputLayout() {
+ ui.Widget.call(this);
+ this.defineAttr("hint", (view, attr, value, defineSetter)=>{
+ view._hint.setText(value);
+ });
+ this.defineAttr("text", (view, attr, value, defineSetter)=>{
+ view._input.setText(value);
+ });
+ }
+ InputLayout.prototype.render = function() {
+ return (
+
+
+ );
+ }
+ InputLayout.prototype.getInput = function() {
+ return this.view._input.getText();
+ };
+ ui.registerWidget("input-layout", InputLayout);
+ return InputLayout;
+})();
+
+ui.layout(
+
+
+);
+
+ui.ok.on("click", function(){
+ toast("名字是：" + ui.name.widget.getInput() + ", 年龄是：" + ui.age.widget.getInput());
+});
\ No newline at end of file
diff --git "a/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\345\270\246\351\242\234\350\211\262\346\214\211\351\222\256.js" "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\345\270\246\351\242\234\350\211\262\346\214\211\351\222\256.js"
new file mode 100644
index 000000000..a53b1921d
--- /dev/null
+++ "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\345\270\246\351\242\234\350\211\262\346\214\211\351\222\256.js"
@@ -0,0 +1,50 @@
+"ui";
+
+var ColoredButton = (function() {
+ //继承ui.Widget
+ util.extend(ColoredButton, ui.Widget);
+
+ function ColoredButton() {
+ //调用父类构造函数
+ ui.Widget.call(this);
+ //自定义属性color，定义按钮颜色
+ this.defineAttr("color", (view, name, defaultGetter) => {
+ return this._color;
+ }, (view, name, value, defaultSetter) => {
+ this._color = value;
+ view.attr("backgroundTint", value);
+ });
+ //自定义属性onClick，定义被点击时执行的代码
+ this.defineAttr("onClick", (view, name, defaultGetter) => {
+ return this._onClick;
+ }, (view, name, value, defaultSetter) => {
+ this._onClick = value;
+ });
+ }
+ ColoredButton.prototype.render = function() {
+ return (
+
+ );
+ }
+ ColoredButton.prototype.onViewCreated = function(view) {
+ view.on("click", () => {
+ if (this._onClick) {
+ eval(this._onClick);
+ }
+ });
+ }
+ ui.registerWidget("colored-button", ColoredButton);
+ return ColoredButton;
+})();
+
+ui.layout(
+
+
+);
+
+function hello() {
+ alert("Hello ~");
+
+}
diff --git "a/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\346\250\241\345\235\227-\351\205\215\347\275\256\345\213\276\351\200\211\346\241\206.js" "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\346\250\241\345\235\227-\351\205\215\347\275\256\345\213\276\351\200\211\346\241\206.js"
new file mode 100644
index 000000000..5ac0c983f
--- /dev/null
+++ "b/app/src/main/assets/sample/\347\225\214\351\235\242\346\216\247\344\273\266/\350\207\252\345\256\232\344\271\211\346\216\247\344\273\266-\346\250\241\345\235\227-\351\205\215\347\275\256\345\213\276\351\200\211\346\241\206.js"
@@ -0,0 +1,47 @@
+
+//这个自定义控件是一个勾选框checkbox，能够保存自己的勾选状态，在脚本重新启动时能恢复状态
+var PrefCheckBox = (function() {
+ //继承至ui.Widget
+ util.extend(PrefCheckBox, ui.Widget);
+
+ function PrefCheckBox() {
+ //调用父类构造函数
+ ui.Widget.call(this);
+ //自定义属性key，定义在配置中保存时的key
+ this.defineAttr("key");
+ }
+ PrefCheckBox.prototype.render = function() {
+ return (
+ instance;
-
- public static App getApp() {
- return instance.get();
- }
-
- public void onCreate() {
- super.onCreate();
- GlobalAppContext.set(this);
- instance = new WeakReference<>(this);
- setUpStaticsTool();
- setUpDebugEnvironment();
- init();
- }
-
- private void setUpStaticsTool() {
- if (BuildConfig.DEBUG)
- return;
- new FlurryAgent.Builder()
- .withLogEnabled(BuildConfig.DEBUG)
- .build(this, "D42MH48ZN4PJC5TKNYZD");
- }
-
-
- private void setUpDebugEnvironment() {
- Thread.setDefaultUncaughtExceptionHandler(new CrashHandler(ErrorReportActivity.class));
- }
-
- private void init() {
- FlowManager.init(FlowConfig.builder(this)
- .addDatabaseConfig(DatabaseConfig.builder(TimedTaskDatabase.class)
- .modelNotifier(DirectModelNotifier.get())
- .build())
- .build());
- ThemeColorManager.setDefaultThemeColor(new ThemeColor(getResources().getColor(R.color.colorPrimary), getResources().getColor(R.color.colorPrimaryDark), getResources().getColor(R.color.colorAccent)));
- ThemeColorManager.init(this);
- AutoJs.initInstance(this);
- if (Pref.isRunningVolumeControlEnabled()) {
- GlobalKeyObserver.init();
- }
- setupDrawableImageLoader();
- TimedTaskScheduler.setupRepeating(this);
- MobileAds.initialize(this, Constants.ADMOB_APP_ID);
- }
-
- private void setupDrawableImageLoader() {
- Drawables.setDefaultImageLoader(new ImageLoader() {
- @Override
- public void loadInto(ImageView imageView, Uri uri) {
- GlideApp.with(App.this)
- .load(uri)
- .into(imageView);
- }
-
- @Override
- public void loadIntoBackground(View view, Uri uri) {
- GlideApp.with(App.this)
- .load(uri)
- .into(new SimpleTarget() {
- @Override
- public void onResourceReady(Drawable resource, Transition transition) {
- view.setBackground(resource);
- }
- });
- }
-
- @Override
- public Drawable load(View view, Uri uri) {
- throw new UnsupportedOperationException();
- }
-
- @Override
- public void load(View view, Uri uri, DrawableCallback drawableCallback) {
- GlideApp.with(App.this)
- .load(uri)
- .into(new SimpleTarget() {
- @Override
- public void onResourceReady(Drawable resource, Transition transition) {
- drawableCallback.onLoaded(resource);
- }
- });
- }
-
- @Override
- public void load(View view, Uri uri, BitmapCallback bitmapCallback) {
- GlideApp.with(App.this)
- .asBitmap()
- .load(uri)
- .into(new SimpleTarget() {
- @Override
- public void onResourceReady(Bitmap resource, Transition transition) {
- bitmapCallback.onLoaded(resource);
- }
- });
- }
- });
- }
-
-
-}
diff --git a/app/src/main/java/org/autojs/autojs/App.kt b/app/src/main/java/org/autojs/autojs/App.kt
new file mode 100644
index 000000000..2dde69f34
--- /dev/null
+++ b/app/src/main/java/org/autojs/autojs/App.kt
@@ -0,0 +1,178 @@
+package org.autojs.autojs
+
+import android.annotation.SuppressLint
+import android.content.Context
+import android.content.Intent
+import android.graphics.Bitmap
+import android.graphics.drawable.Drawable
+import android.net.Uri
+import androidx.multidex.MultiDexApplication
+import android.view.View
+import android.widget.ImageView
+import androidx.localbroadcastmanager.content.LocalBroadcastManager
+import com.bumptech.glide.Glide
+import com.bumptech.glide.request.target.SimpleTarget
+import com.bumptech.glide.request.transition.Transition
+import com.evernote.android.job.JobRequest
+import com.flurry.android.FlurryAgent
+import com.squareup.leakcanary.LeakCanary
+import com.stardust.app.GlobalAppContext
+import com.stardust.autojs.core.ui.inflater.ImageLoader
+import com.stardust.autojs.core.ui.inflater.util.Drawables
+import com.stardust.theme.ThemeColor
+import com.tencent.bugly.Bugly
+import com.tencent.bugly.crashreport.CrashReport
+import org.autojs.autojs.autojs.AutoJs
+import org.autojs.autojs.autojs.key.GlobalKeyObserver
+import org.autojs.autojs.external.receiver.DynamicBroadcastReceivers
+import org.autojs.autojs.theme.ThemeColorManagerCompat
+import org.autojs.autojs.timing.TimedTaskManager
+import org.autojs.autojs.timing.TimedTaskScheduler
+import org.autojs.autojs.tool.CrashHandler
+import org.autojs.autojs.ui.error.ErrorReportActivity
+import java.lang.ref.WeakReference
+import java.util.*
+
+/**
+ * Created by Stardust on 2017/1/27.
+ */
+
+class App : MultiDexApplication() {
+ lateinit var dynamicBroadcastReceivers: DynamicBroadcastReceivers
+ private set
+
+ override fun onCreate() {
+ super.onCreate()
+ GlobalAppContext.set(this)
+ instance = WeakReference(this)
+ setUpStaticsTool()
+ setUpDebugEnvironment()
+ init()
+ }
+
+ private fun setUpStaticsTool() {
+ if (BuildConfig.DEBUG)
+ return
+ FlurryAgent.Builder()
+ .withLogEnabled(BuildConfig.DEBUG)
+ .build(this, "D42MH48ZN4PJC5TKNYZD")
+ }
+
+ private fun setUpDebugEnvironment() {
+ Bugly.isDev = false
+ val crashHandler = CrashHandler(ErrorReportActivity::class.java)
+
+ val strategy = CrashReport.UserStrategy(applicationContext)
+ strategy.setCrashHandleCallback(crashHandler)
+
+ CrashReport.initCrashReport(applicationContext, BUGLY_APP_ID, false, strategy)
+
+ crashHandler.setBuglyHandler(Thread.getDefaultUncaughtExceptionHandler())
+ Thread.setDefaultUncaughtExceptionHandler(crashHandler)
+ if (LeakCanary.isInAnalyzerProcess(this)) {
+ // This process is dedicated to LeakCanary for heap analysis.
+ // You should not init your app in this process.
+ return
+ }
+ //LeakCanary.install(this);
+
+ }
+
+ private fun init() {
+ ThemeColorManagerCompat.init(this, ThemeColor(resources.getColor(R.color.colorPrimary), resources.getColor(R.color.colorPrimaryDark), resources.getColor(R.color.colorAccent)))
+ AutoJs.initInstance(this)
+ if (Pref.isRunningVolumeControlEnabled()) {
+ GlobalKeyObserver.init()
+ }
+ setupDrawableImageLoader()
+ TimedTaskScheduler.init(this)
+ initDynamicBroadcastReceivers()
+ }
+
+ @SuppressLint("CheckResult")
+ private fun initDynamicBroadcastReceivers() {
+ dynamicBroadcastReceivers = DynamicBroadcastReceivers(this)
+ val localActions = ArrayList()
+ val actions = ArrayList()
+ TimedTaskManager.getInstance().allIntentTasks
+ .filter { task -> task.action != null }
+ .doOnComplete {
+ if (localActions.isNotEmpty()) {
+ dynamicBroadcastReceivers.register(localActions, true)
+ }
+ if (actions.isNotEmpty()) {
+ dynamicBroadcastReceivers.register(actions, false)
+ }
+ LocalBroadcastManager.getInstance(applicationContext).sendBroadcast(Intent(
+ DynamicBroadcastReceivers.ACTION_STARTUP
+ ))
+ }
+ .subscribe({
+ if (it.isLocal) {
+ localActions.add(it.action)
+ } else {
+ actions.add(it.action)
+ }
+ }, { it.printStackTrace() })
+
+
+ }
+
+ private fun setupDrawableImageLoader() {
+ Drawables.setDefaultImageLoader(object : ImageLoader {
+ override fun loadInto(imageView: ImageView, uri: Uri) {
+ Glide.with(imageView)
+ .load(uri)
+ .into(imageView)
+ }
+
+ override fun loadIntoBackground(view: View, uri: Uri) {
+ Glide.with(view)
+ .load(uri)
+ .into(object : SimpleTarget() {
+ override fun onResourceReady(resource: Drawable, transition: Transition?) {
+ view.background = resource
+ }
+ })
+ }
+
+ override fun load(view: View, uri: Uri): Drawable {
+ throw UnsupportedOperationException()
+ }
+
+ override fun load(view: View, uri: Uri, drawableCallback: ImageLoader.DrawableCallback) {
+ Glide.with(view)
+ .load(uri)
+ .into(object : SimpleTarget() {
+ override fun onResourceReady(resource: Drawable, transition: Transition?) {
+ drawableCallback.onLoaded(resource)
+ }
+ })
+ }
+
+ override fun load(view: View, uri: Uri, bitmapCallback: ImageLoader.BitmapCallback) {
+ Glide.with(view)
+ .asBitmap()
+ .load(uri)
+ .into(object : SimpleTarget() {
+ override fun onResourceReady(resource: Bitmap, transition: Transition?) {
+ bitmapCallback.onLoaded(resource)
+ }
+ })
+ }
+ })
+ }
+
+ companion object {
+
+ private val TAG = "App"
+ private val BUGLY_APP_ID = "19b3607b53"
+
+ private lateinit var instance: WeakReference
+
+ val app: App
+ get() = instance.get()!!
+ }
+
+
+}
diff --git a/app/src/main/java/org/autojs/autojs/Constants.java b/app/src/main/java/org/autojs/autojs/Constants.java
index 01f8446c7..0995244ce 100644
--- a/app/src/main/java/org/autojs/autojs/Constants.java
+++ b/app/src/main/java/org/autojs/autojs/Constants.java
@@ -6,13 +6,5 @@
public final class Constants {
- public static final String LOG_TAG_ADMOB = "Admob";
- public static final String ADMOB_APP_ID = "ca-app-pub-5495978608535144~9896346219";
- public static final String ADMOB_SPLASH_BANNER_ID = "ca-app-pub-5495978608535144/3281269730";
- public static final String ADMOB_INTERSTITIAL_ID = "ca-app-pub-5495978608535144/7282625313";
- public static final String ADMOB_APK_BUILDER_REWARD_ID = "ca-app-pub-5495978608535144/2977306962";
- public static final String ADMOB_BANNER_TEST_ID = "ca-app-pub-3940256099942544/6300978111";
- public static final String ADMOB_INTERSTITIAL_TEST_ID = "ca-app-pub-3940256099942544/1033173712";
- public static final String ADMOB_REWARD_VIDEO_TEST_ID = "ca-app-pub-3940256099942544/5224354917";
}
diff --git a/app/src/main/java/org/autojs/autojs/Main.java b/app/src/main/java/org/autojs/autojs/Main.java
deleted file mode 100644
index ce90c40d0..000000000
--- a/app/src/main/java/org/autojs/autojs/Main.java
+++ /dev/null
@@ -1,735 +0,0 @@
-package org.autojs.autojs;
-
-import org.mozilla.javascript.Context;
-import org.mozilla.javascript.ContextAction;
-import org.mozilla.javascript.Function;
-import org.mozilla.javascript.GeneratedClassLoader;
-import org.mozilla.javascript.Kit;
-import org.mozilla.javascript.NativeArray;
-import org.mozilla.javascript.RhinoException;
-import org.mozilla.javascript.Script;
-import org.mozilla.javascript.Scriptable;
-import org.mozilla.javascript.ScriptableObject;
-import org.mozilla.javascript.SecurityController;
-import org.mozilla.javascript.commonjs.module.ModuleScope;
-import org.mozilla.javascript.commonjs.module.Require;
-import org.mozilla.javascript.tools.SourceReader;
-import org.mozilla.javascript.tools.ToolErrorReporter;
-import org.mozilla.javascript.tools.shell.Global;
-import org.mozilla.javascript.tools.shell.QuitAction;
-import org.mozilla.javascript.tools.shell.SecurityProxy;
-import org.mozilla.javascript.tools.shell.ShellConsole;
-import org.mozilla.javascript.tools.shell.ShellContextFactory;
-
-import java.io.File;
-import java.io.FileNotFoundException;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.PrintStream;
-import java.io.UnsupportedEncodingException;
-import java.lang.ref.ReferenceQueue;
-import java.lang.ref.SoftReference;
-import java.net.URI;
-import java.net.URISyntaxException;
-import java.nio.charset.Charset;
-import java.security.MessageDigest;
-import java.security.NoSuchAlgorithmException;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Map;
-
-/**
- * The shell program.
- *
- * Can execute scripts interactively or in batch mode at the command line.
- * An example of controlling the JavaScript engine.
- *
- * @author Norris Boyd
- */
-public class Main {
- public static ShellContextFactory
- shellContextFactory = new ShellContextFactory();
-
- public static Global global = new Global();
- static protected ToolErrorReporter errorReporter;
- static protected int exitCode = 0;
- static private final int EXITCODE_RUNTIME_ERROR = 3;
- static private final int EXITCODE_FILE_NOT_FOUND = 4;
- static boolean processStdin = true;
- static List fileList = new ArrayList();
- static List modulePath;
- static String mainModule;
- static boolean sandboxed = false;
- static boolean useRequire = false;
- static Require require;
- private static SecurityProxy securityImpl;
- private final static ScriptCache scriptCache = new ScriptCache(32);
-
- static {
- global.initQuitAction(new IProxy(IProxy.SYSTEM_EXIT));
- }
-
- /**
- * Proxy class to avoid proliferation of anonymous classes.
- */
- private static class IProxy implements ContextAction, QuitAction {
- private static final int PROCESS_FILES = 1;
- private static final int EVAL_INLINE_SCRIPT = 2;
- private static final int SYSTEM_EXIT = 3;
-
- private int type;
- String[] args;
- String scriptText;
-
- IProxy(int type) {
- this.type = type;
- }
-
- public Object run(Context cx) {
- if (useRequire) {
- require = global.installRequire(cx, modulePath, sandboxed);
- }
- if (type == PROCESS_FILES) {
- processFiles(cx, args);
- } else if (type == EVAL_INLINE_SCRIPT) {
- evalInlineScript(cx, scriptText);
- } else {
- throw Kit.codeBug();
- }
- return null;
- }
-
- public void quit(Context cx, int exitCode) {
- if (type == SYSTEM_EXIT) {
- System.exit(exitCode);
- return;
- }
- throw Kit.codeBug();
- }
- }
-
- /**
- * Main entry point.
- *
- * Process arguments as would a normal Java program. Also
- * create a new Context and associate it with the current thread.
- * Then set up the execution environment and begin to
- * execute scripts.
- */
- public static void main(String args[]) {
- try {
- if (Boolean.getBoolean("rhino.use_java_policy_security")) {
- initJavaPolicySecuritySupport();
- }
- } catch (SecurityException ex) {
- ex.printStackTrace(System.err);
- }
-
- int result = exec(args);
- if (result != 0) {
- System.exit(result);
- }
- }
-
- /**
- * Execute the given arguments, but don't System.exit at the end.
- */
- public static int exec(String origArgs[]) {
- errorReporter = new ToolErrorReporter(false, global.getErr());
- shellContextFactory.setErrorReporter(errorReporter);
- String[] args = processOptions(origArgs);
- if (exitCode > 0) {
- return exitCode;
- }
- if (processStdin) {
- fileList.add(null);
- }
- if (true) {
- global.init(shellContextFactory);
- }
- IProxy iproxy = new IProxy(IProxy.PROCESS_FILES);
- iproxy.args = args;
- shellContextFactory.call(iproxy);
-
- return exitCode;
- }
-
- static void processFiles(Context cx, String[] args) {
- // define "arguments" array in the top-level object:
- // need to allocate new array since newArray requires instances
- // of exactly Object[], not ObjectSubclass[]
- Object[] array = new Object[args.length];
- System.arraycopy(args, 0, array, 0, args.length);
- Scriptable argsObj = cx.newArray(global, array);
- global.defineProperty("arguments", argsObj,
- ScriptableObject.DONTENUM);
-
- for (String file : fileList) {
- try {
- processSource(cx, file);
- } catch (IOException ioex) {
- Context.reportError(ToolErrorReporter.getMessage(
- "msg.couldnt.read.source", file, ioex.getMessage()));
- exitCode = EXITCODE_FILE_NOT_FOUND;
- } catch (RhinoException rex) {
- ToolErrorReporter.reportException(
- cx.getErrorReporter(), rex);
- exitCode = EXITCODE_RUNTIME_ERROR;
- } catch (VirtualMachineError ex) {
- // Treat StackOverflow and OutOfMemory as runtime errors
- ex.printStackTrace();
- String msg = ToolErrorReporter.getMessage(
- "msg.uncaughtJSException", ex.toString());
- Context.reportError(msg);
- exitCode = EXITCODE_RUNTIME_ERROR;
- }
- }
- }
-
- static void evalInlineScript(Context cx, String scriptText) {
- try {
- Script script = cx.compileString(scriptText, "", 1, null);
- if (script != null) {
- script.exec(cx, getShellScope());
- }
- } catch (RhinoException rex) {
- ToolErrorReporter.reportException(
- cx.getErrorReporter(), rex);
- exitCode = EXITCODE_RUNTIME_ERROR;
- } catch (VirtualMachineError ex) {
- // Treat StackOverflow and OutOfMemory as runtime errors
- ex.printStackTrace();
- String msg = ToolErrorReporter.getMessage(
- "msg.uncaughtJSException", ex.toString());
- Context.reportError(msg);
- exitCode = EXITCODE_RUNTIME_ERROR;
- }
- }
-
- public static Global getGlobal() {
- return global;
- }
-
- static Scriptable getShellScope() {
- return getScope(null);
- }
-
- static Scriptable getScope(String path) {
- if (useRequire) {
- // If CommonJS modules are enabled use a module scope that resolves
- // relative ids relative to the current URL, file or working directory.
- URI uri;
- if (path == null) {
- // use current directory for shell and -e switch
- uri = new File(System.getProperty("user.dir")).toURI();
- } else {
- // find out whether this is a file path or a URL
- if (SourceReader.toUrl(path) != null) {
- try {
- uri = new URI(path);
- } catch (URISyntaxException x) {
- // fall back to file uri
- uri = new File(path).toURI();
- }
- } else {
- uri = new File(path).toURI();
- }
- }
- return new ModuleScope(global, uri, null);
- } else {
- return global;
- }
- }
-
- /**
- * Parse arguments.
- */
- public static String[] processOptions(String args[]) {
- String usageError;
- goodUsage:
- for (int i = 0; ; ++i) {
- if (i == args.length) {
- return new String[0];
- }
- String arg = args[i];
- if (!arg.startsWith("-")) {
- processStdin = false;
- fileList.add(arg);
- mainModule = arg;
- String[] result = new String[args.length - i - 1];
- System.arraycopy(args, i + 1, result, 0, args.length - i - 1);
- return result;
- }
- if (arg.equals("-version")) {
- if (++i == args.length) {
- usageError = arg;
- break goodUsage;
- }
- int version;
- try {
- version = Integer.parseInt(args[i]);
- } catch (NumberFormatException ex) {
- usageError = args[i];
- break goodUsage;
- }
- if (!Context.isValidLanguageVersion(version)) {
- usageError = args[i];
- break goodUsage;
- }
- shellContextFactory.setLanguageVersion(version);
- continue;
- }
- if (arg.equals("-opt") || arg.equals("-O")) {
- if (++i == args.length) {
- usageError = arg;
- break goodUsage;
- }
- int opt;
- try {
- opt = Integer.parseInt(args[i]);
- } catch (NumberFormatException ex) {
- usageError = args[i];
- break goodUsage;
- }
- if (opt == -2) {
- // Compatibility with Cocoon Rhino fork
- opt = -1;
- } else if (!Context.isValidOptimizationLevel(opt)) {
- usageError = args[i];
- break goodUsage;
- }
- shellContextFactory.setOptimizationLevel(opt);
- continue;
- }
- if (arg.equals("-encoding")) {
- if (++i == args.length) {
- usageError = arg;
- break goodUsage;
- }
- String enc = args[i];
- shellContextFactory.setCharacterEncoding(enc);
- continue;
- }
- if (arg.equals("-strict")) {
- shellContextFactory.setStrictMode(true);
- shellContextFactory.setAllowReservedKeywords(false);
- errorReporter.setIsReportingWarnings(true);
- continue;
- }
- if (arg.equals("-fatal-warnings")) {
- shellContextFactory.setWarningAsError(true);
- continue;
- }
- if (arg.equals("-e")) {
- processStdin = false;
- if (++i == args.length) {
- usageError = arg;
- break goodUsage;
- }
- if (false) {
- global.init(shellContextFactory);
- }
- IProxy iproxy = new IProxy(IProxy.EVAL_INLINE_SCRIPT);
- iproxy.scriptText = args[i];
- shellContextFactory.call(iproxy);
- continue;
- }
- if (arg.equals("-require")) {
- useRequire = true;
- continue;
- }
- if (arg.equals("-sandbox")) {
- sandboxed = true;
- useRequire = true;
- continue;
- }
- if (arg.equals("-modules")) {
- if (++i == args.length) {
- usageError = arg;
- break goodUsage;
- }
- if (modulePath == null) {
- modulePath = new ArrayList();
- }
- modulePath.add(args[i]);
- useRequire = true;
- continue;
- }
- if (arg.equals("-w")) {
- errorReporter.setIsReportingWarnings(true);
- continue;
- }
- if (arg.equals("-f")) {
- processStdin = false;
- if (++i == args.length) {
- usageError = arg;
- break goodUsage;
- }
- if (args[i].equals("-")) {
- fileList.add(null);
- } else {
- fileList.add(args[i]);
- mainModule = args[i];
- }
- continue;
- }
- if (arg.equals("-sealedlib")) {
- global.setSealedStdLib(true);
- continue;
- }
- if (arg.equals("-debug")) {
- shellContextFactory.setGeneratingDebug(true);
- continue;
- }
- if (arg.equals("-?") ||
- arg.equals("-help")) {
- // print usage message
- global.getOut().println(
- ToolErrorReporter.getMessage("msg.shell.usage", Main.class.getName()));
- exitCode = 1;
- return null;
- }
- usageError = arg;
- break goodUsage;
- }
- // print error and usage message
- global.getOut().println(
- ToolErrorReporter.getMessage("msg.shell.invalid", usageError));
- global.getOut().println(
- ToolErrorReporter.getMessage("msg.shell.usage", Main.class.getName()));
- exitCode = 1;
- return null;
- }
-
- private static void initJavaPolicySecuritySupport() {
- Throwable exObj;
- try {
- Class cl = Class.forName
- ("org.mozilla.javascript.tools.shell.JavaPolicySecurity");
- securityImpl = (SecurityProxy) cl.newInstance();
- SecurityController.initGlobal(securityImpl);
- return;
- } catch (ClassNotFoundException ex) {
- exObj = ex;
- } catch (IllegalAccessException ex) {
- exObj = ex;
- } catch (InstantiationException ex) {
- exObj = ex;
- } catch (LinkageError ex) {
- exObj = ex;
- }
- throw Kit.initCause(new IllegalStateException(
- "Can not load security support: " + exObj), exObj);
- }
-
- /**
- * Evaluate JavaScript source.
- *
- * @param cx the current context
- * @param filename the name of the file to compile, or null
- * for interactive mode.
- * @throws IOException if the source could not be read
- * @throws RhinoException thrown during evaluation of source
- */
- public static void processSource(Context cx, String filename)
- throws IOException {
- if (filename == null || filename.equals("-")) {
- Scriptable scope = getShellScope();
- Charset cs;
- String charEnc = shellContextFactory.getCharacterEncoding();
- if (charEnc != null) {
- cs = Charset.forName(charEnc);
- } else {
- cs = Charset.defaultCharset();
- }
- ShellConsole console = global.getConsole(cs);
- if (filename == null) {
- // print implementation version
- console.println(cx.getImplementationVersion());
- }
-
- int lineno = 1;
- boolean hitEOF = false;
- while (!hitEOF) {
- String[] prompts = global.getPrompts(cx);
- String prompt = null;
- if (filename == null)
- prompt = prompts[0];
- console.flush();
- String source = "";
-
- // Collect lines of source to compile.
- while (true) {
- String newline;
- try {
- newline = console.readLine(prompt);
- } catch (IOException ioe) {
- console.println(ioe.toString());
- break;
- }
- if (newline == null) {
- hitEOF = true;
- break;
- }
- source = source + newline + "\n";
- lineno++;
- if (cx.stringIsCompilableUnit(source))
- break;
- prompt = prompts[1];
- }
- try {
- Script script = cx.compileString(source, "", lineno, null);
- if (script != null) {
- Object result = script.exec(cx, scope);
- // Avoid printing out undefined or function definitions.
- if (result != Context.getUndefinedValue() &&
- !(result instanceof Function &&
- source.trim().startsWith("function"))) {
- try {
- console.println(Context.toString(result));
- } catch (RhinoException rex) {
- ToolErrorReporter.reportException(
- cx.getErrorReporter(), rex);
- }
- }
- // NativeArray h = global.history;
- //h.put((int) h.getLength(), h, source);
- }
- } catch (RhinoException rex) {
- ToolErrorReporter.reportException(
- cx.getErrorReporter(), rex);
- exitCode = EXITCODE_RUNTIME_ERROR;
- } catch (VirtualMachineError ex) {
- // Treat StackOverflow and OutOfMemory as runtime errors
- ex.printStackTrace();
- String msg = ToolErrorReporter.getMessage(
- "msg.uncaughtJSException", ex.toString());
- Context.reportError(msg);
- exitCode = EXITCODE_RUNTIME_ERROR;
- }
- }
- console.println();
- console.flush();
- } else if (useRequire && filename.equals(mainModule)) {
- require.requireMain(cx, filename);
- } else {
- processFile(cx, getScope(filename), filename);
- }
- }
-
- public static void processFileNoThrow(Context cx, Scriptable scope, String filename) {
- try {
- processFile(cx, scope, filename);
- } catch (IOException ioex) {
- Context.reportError(ToolErrorReporter.getMessage(
- "msg.couldnt.read.source", filename, ioex.getMessage()));
- exitCode = EXITCODE_FILE_NOT_FOUND;
- } catch (RhinoException rex) {
- ToolErrorReporter.reportException(
- cx.getErrorReporter(), rex);
- exitCode = EXITCODE_RUNTIME_ERROR;
- } catch (VirtualMachineError ex) {
- // Treat StackOverflow and OutOfMemory as runtime errors
- ex.printStackTrace();
- String msg = ToolErrorReporter.getMessage(
- "msg.uncaughtJSException", ex.toString());
- Context.reportError(msg);
- exitCode = EXITCODE_RUNTIME_ERROR;
- }
- }
-
- public static void processFile(Context cx, Scriptable scope, String filename)
- throws IOException {
- if (securityImpl == null) {
- processFileSecure(cx, scope, filename, null);
- } else {
- //securityImpl.callProcessFileSecure(cx, scope, filename);
- }
- }
-
- static void processFileSecure(Context cx, Scriptable scope,
- String path, Object securityDomain)
- throws IOException {
-
- boolean isClass = path.endsWith(".class");
- Object source = readFileOrUrl(path, !isClass);
-
- byte[] digest = getDigest(source);
- String key = path + "_" + cx.getOptimizationLevel();
- ScriptReference ref = scriptCache.get(key, digest);
- Script script = ref != null ? ref.get() : null;
-
- if (script == null) {
- if (isClass) {
- script = loadCompiledScript(cx, path, (byte[]) source, securityDomain);
- } else {
- String strSrc = (String) source;
- // Support the executable script #! syntax: If
- // the first line begins with a '#', treat the whole
- // line as a comment.
- if (strSrc.length() > 0 && strSrc.charAt(0) == '#') {
- for (int i = 1; i != strSrc.length(); ++i) {
- int c = strSrc.charAt(i);
- if (c == '\n' || c == '\r') {
- strSrc = strSrc.substring(i);
- break;
- }
- }
- }
- script = cx.compileString(strSrc, path, 1, securityDomain);
- }
- scriptCache.put(key, digest, script);
- }
-
- if (script != null) {
- script.exec(cx, scope);
- }
- }
-
- private static byte[] getDigest(Object source) {
- byte[] bytes, digest = null;
-
- if (source != null) {
- if (source instanceof String) {
- try {
- bytes = ((String) source).getBytes("UTF-8");
- } catch (UnsupportedEncodingException ue) {
- bytes = ((String) source).getBytes();
- }
- } else {
- bytes = (byte[]) source;
- }
- try {
- MessageDigest md = MessageDigest.getInstance("MD5");
- digest = md.digest(bytes);
- } catch (NoSuchAlgorithmException nsa) {
- // Should not happen
- throw new RuntimeException(nsa);
- }
- }
-
- return digest;
- }
-
- private static Script loadCompiledScript(Context cx, String path,
- byte[] data, Object securityDomain)
- throws FileNotFoundException {
- if (data == null) {
- throw new FileNotFoundException(path);
- }
- // XXX: For now extract class name of compiled Script from path
- // instead of parsing class bytes
- int nameStart = path.lastIndexOf('/');
- if (nameStart < 0) {
- nameStart = 0;
- } else {
- ++nameStart;
- }
- int nameEnd = path.lastIndexOf('.');
- if (nameEnd < nameStart) {
- // '.' does not exist in path (nameEnd < 0)
- // or it comes before nameStart
- nameEnd = path.length();
- }
- String name = path.substring(nameStart, nameEnd);
- try {
- GeneratedClassLoader loader = SecurityController.createLoader(cx.getApplicationClassLoader(), securityDomain);
- Class clazz = loader.defineClass(name, data);
- loader.linkClass(clazz);
- if (!Script.class.isAssignableFrom(clazz)) {
- throw Context.reportRuntimeError("msg.must.implement.Script");
- }
- return (Script) clazz.newInstance();
- } catch (IllegalAccessException iaex) {
- Context.reportError(iaex.toString());
- throw new RuntimeException(iaex);
- } catch (InstantiationException inex) {
- Context.reportError(inex.toString());
- throw new RuntimeException(inex);
- }
- }
-
- public static InputStream getIn() {
- return getGlobal().getIn();
- }
-
- public static void setIn(InputStream in) {
- getGlobal().setIn(in);
- }
-
- public static PrintStream getOut() {
- return getGlobal().getOut();
- }
-
- public static void setOut(PrintStream out) {
- getGlobal().setOut(out);
- }
-
- public static PrintStream getErr() {
- return getGlobal().getErr();
- }
-
- public static void setErr(PrintStream err) {
- getGlobal().setErr(err);
- }
-
- /**
- * Read file or url specified by path.
- *
- * @return file or url content as byte[] or as String if
- * convertToString is true.
- */
- private static Object readFileOrUrl(String path, boolean convertToString)
- throws IOException {
- return SourceReader.readFileOrUrl(path, convertToString,
- shellContextFactory.getCharacterEncoding());
- }
-
- static class ScriptReference extends SoftReference
![安卓Intent](#app_app_sendemail_options
type: "image/png",
data: "file:///sdcard/1.png"
});
-app.startActivity(i);
-</code></pre><p>更多信息，请百度<a href=){kind=link}
![#](#images_images_clip_
<pre><code>var src = images.read("/sdcard/1.png");
var clip = images.clip(src, 100, 100, 400, 400);
images.save(clip, "/sdcard/clip.png");
-</code></pre><h2>images.findColor(image, color, options)<span><a class=){kind=link}