Skip to content

Commit

Permalink
docs: 汉化 Stability 稳定性
Browse files Browse the repository at this point in the history
  • Loading branch information
xxxxue committed Aug 13, 2022
1 parent fb4ee4e commit e31774d
Show file tree
Hide file tree
Showing 20 changed files with 62 additions and 59 deletions.
2 changes: 1 addition & 1 deletion console.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Console

> Stability: 2 - Stable
> 稳定性: 稳定
控制台模块提供了一个和Web浏览器中相似的用于调试的控制台。用于输出一些调试信息、中间结果等。
console模块中的一些函数也可以直接作为全局函数使用,例如log, print等。
Expand Down
8 changes: 4 additions & 4 deletions coordinatesBasedAutomation.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@

# 基于坐标的触摸模拟

> Stability: 2 - Stable
> 稳定性: 稳定
本章节介绍了一些使用坐标进行点击、滑动的函数。这些函数有的需要安卓7.0以上,有的需要root权限。

Expand Down Expand Up @@ -35,7 +35,7 @@ longClick(300, 500);

# 安卓7.0以上的触摸和手势模拟

> Stability: 2 - Stable
> 稳定性: 稳定
**注意以下命令只有Android7.0及以上才有效**

Expand Down Expand Up @@ -109,7 +109,7 @@ gestures([0, 500, [800, 300], [500, 1000]],

# RootAutomator

> Stability: 2 - Stable
> 稳定性: 稳定
RootAutomator是一个使用root权限来模拟触摸的对象,用它可以完成触摸与多点触摸,并且这些动作的执行没有延迟。

Expand Down Expand Up @@ -194,7 +194,7 @@ ra.exit();

# 使用root权限点击和滑动的简单命令

> Stability: 1 - Experimental
> 稳定性: 实验
注意:本章节的函数在后续版本很可能有改动!请勿过分依赖本章节函数的副作用。推荐使用`RootAutomator`代替本章节的触摸函数。

Expand Down
2 changes: 1 addition & 1 deletion device.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Device

> Stability: 2 - Stable
> 稳定性: 稳定
device模块提供了与设备有关的信息与操作,例如获取设备宽高,内存使用率,IMEI,调整设备亮度、音量等。

Expand Down
2 changes: 1 addition & 1 deletion dialogs.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Dialogs

> Stability: 2 - Stable
> 稳定性: 稳定
dialogs 模块提供了简单的对话框支持,可以通过对话框和用户进行交互。最简单的例子如下:
```
Expand Down
21 changes: 12 additions & 9 deletions documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,22 +10,25 @@

由于Auto.js处于活跃的更新和开发状态,API可能随时有变动,我们用Stability来标记模块、函数的稳定性。这些标记包括:

```txt
Stability: 0 - Deprecated
```
稳定性: 弃用
弃用的函数、模块或特性,在未来的更新中将很快会被移除或更改。应该在脚本中移除对这些函数的使用,以免后续出现意料之外的问题。
弃用的函数、模块或特性,
在未来的更新中将很快会被移除或更改。应该在脚本中移除对这些函数的使用,以免后续出现意料之外的问题。
```

```txt
Stability: 1 - Experimental
```
稳定性: 实验
实验性的函数、模块或特性,在未来的更新中可能会更改或移除。应该谨慎使用这些函数或模块,或者仅用作临时或试验用途。
实验性的函数、模块或特性,
在未来的更新中可能会更改或移除。应该谨慎使用这些函数或模块,或者仅用作临时或试验用途。
```

```txt
Stability: 2 - Stable
```
稳定性: 稳定
稳定的函数、模块或特性,在未来的更新中这些模块已有的函数一般不会被更改,会保证后向兼容性。
稳定的函数、模块或特性,
在未来的更新中这些模块已有的函数一般不会被更改,会保证后向兼容性。
```

## 如何阅读本文档
Expand Down
2 changes: 1 addition & 1 deletion engines.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Engines

> Stability: 2 - Stable
> 稳定性: 稳定
engines 模块包含了一些与脚本环境、脚本运行、脚本引擎有关的函数,包括运行其他脚本,关闭脚本等。

Expand Down
8 changes: 4 additions & 4 deletions events.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Events

> Stability: 2 - Stable
> 稳定性: 稳定
events 模块提供了监听手机通知、按键、触摸的接口。您可以用他配合自动操作函数完成自动化工作。

Expand Down Expand Up @@ -362,7 +362,7 @@ events.on("notification", function(n){

# KeyEvent

> Stability: 2 - Stable
> 稳定性: 稳定
## KeyEvent.getAction()

Expand Down Expand Up @@ -397,7 +397,7 @@ events.on("notification", function(n){

# keys

> Stability: 2 - Stable
> 稳定性: 稳定
按键事件中所有可用的按键名称为:

Expand All @@ -409,7 +409,7 @@ events.on("notification", function(n){

# EventEmitter

> Stability: 2 - Stable
> 稳定性: 稳定
## EventEmitter.defaultMaxListeners

Expand Down
2 changes: 1 addition & 1 deletion files.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Files

> Stability: 2 - Stable
> 稳定性: 稳定
files模块提供了一些常见的文件处理,包括文件读写、移动、复制、删掉等。

Expand Down
2 changes: 1 addition & 1 deletion http.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# HTTP

> Stability: 2 - Stable
> 稳定性: 稳定
http模块提供一些进行http请求的函数。

Expand Down
4 changes: 2 additions & 2 deletions images.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# colors

> Stability: 2 - Stable
> 稳定性: 稳定
在Auto.js有两种方式表示一个颜色。

Expand Down Expand Up @@ -138,7 +138,7 @@ log(colors.equals(0xFF112233, 0xFF223344));

# Images

> Stability: 2 - Stable
> 稳定性: 稳定
images模块提供了一些手机设备中常见的图片处理函数,包括截图、读写图片、图片剪裁、旋转、二值化、找色找图等。

Expand Down
2 changes: 1 addition & 1 deletion media.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Media

> Stability: 2 - Stable
> 稳定性: 稳定
media模块提供多媒体编程的支持。目前仅支持音乐播放和媒体文件扫描。后续会结合UI加入视频播放等功能。

Expand Down
2 changes: 1 addition & 1 deletion modules.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# module (模块)

> Stability: 2 - Stable
> 稳定性: 稳定
Auto.js 有一个简单的模块加载系统。 在 Auto.js 中,文件和模块是一一对应的(每个文件被视为一个独立的模块)。

Expand Down
2 changes: 1 addition & 1 deletion sensors.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Sensors

> Stability: 2 - Stable
> 稳定性: 稳定
sensors 模块提供了获取手机上的传感器的信息的支持,这些传感器包括距离传感器、光线光感器、重力传感器、方向传感器等。需要指出的是,脚本只能获取传感器的数据,**不能模拟或伪造传感器的数据和事件**,因此诸如模拟摇一摇的功能是无法实现的。

Expand Down
4 changes: 2 additions & 2 deletions shell.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ shell即Unix Shell,在类Unix系统提供与操作系统交互的一系列命

# shell函数

> Stability: 2 - Stable
> 稳定性: 稳定
## shell(cmd[, root])
* cmd {string} 要执行的命令
Expand All @@ -35,7 +35,7 @@ if(result.code == 0){

# Shell

> Stability: 2 - Stable
> 稳定性: 稳定
shell函数通过用来一次性执行单条命令并获取结果。如果有多条命令需要执行,用Shell对象的效率更高。这是因为,每次运行shell函数都会打开一个单独的shell进程并在运行结束后关闭他,这个过程需要一定的时间;而Shell对象自始至终使用同一个shell进程。

Expand Down
2 changes: 1 addition & 1 deletion storages.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Storages

> Stability: 2 - Stable
> 稳定性: 稳定
storages模块提供了保存简单数据、用户配置等的支持。保存的数据除非应用被卸载或者被主动删除,否则会一直保留。

Expand Down
2 changes: 1 addition & 1 deletion threads.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Threads

> Stability: 1 - Experiment
> 稳定性: 实验
threads 模块提供了多线程支持,可以启动新线程来运行脚本。

Expand Down
2 changes: 1 addition & 1 deletion timers.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Timers

> Stability: 2 - Stable
> 稳定性: 稳定
timers 模块暴露了一个全局的 API,用于在某个未来时间段调用调度函数。 因为定时器函数是全局的,所以使用该 API 无需调用 timers.***

Expand Down
Loading

0 comments on commit e31774d

Please sign in to comment.