6.6.2 - Alpha5 - README.md 完善项目构建与运行相关内容

README.md

@@ -159,16 +159,21 @@ AutoJs6 在 Auto.js 最终项目的基础上, 于 `2021/12/01` 进行二次开
 ###### 2025/01/03
 
 * `新增` ui.statusBarAppearanceLight/statusBarAppearanceLightBy/navigationBarColor 等方法
+* `新增` 设置页面增加 "文件扩展名" 设置选项
+* `新增` 主题色设置页面增加新布局支持 (颜色库分组/主题色定位/颜色搜索/历史记录/调色盘增强等)
 * `修复` Android 15 状态栏背景颜色与主题色不一致的问题
 * `修复` plugins.load 方法无法正常加载插件的问题 _[`issue #290`](http://issues.autojs6.com/290)_
 * `修复` dx 库在 Android 7.x 无法正常使用的问题 _[`issue #293`](http://issues.autojs6.com/293)_
 * `修复` ScriptRuntime 使用 require 引用内置模块时可能出现的同步状态异常 (试修) _[`issue #298`](http://issues.autojs6.com/298)_
 * `修复` notice 模块缺失 getBuilder 等扩展方法的问题 _[`issue #301`](http://issues.autojs6.com/301)_
 * `修复` shizuku/shell 等方法无法接受字符串参数的问题 _[`issue #310`](http://issues.autojs6.com/310)_
+* `修复` colors.pixel 方法无法接受单通道图像参数的问题 _[`issue #350`](http://issues.autojs6.com/350)_
 * `修复` engines.execScript/execScriptFile 等方法执行脚本时默认工作路径异常
 * `修复` floaty.window/floaty.rawWindow 无法在子线程执行的问题
 * `修复` ui.inflate 返回值丢失 attr/on/click 等原型方法的问题
+* `修复` 布局分析页面生成代码时可能导致应用崩溃的问题 _[`issue #288`](http://issues.autojs6.com/288)_
 * `修复` 代码编辑器跳转到行尾时可能跳转到下一行起始位置的问题
+* `修复` 设置页面连续快速点击对话框类型项目时可能导致应用崩溃的问题
 * `优化` 精简打包应用模板 APK 文件大小
 * `优化` 打包页面支持 Pinyin 库选项
 * `优化` 打包应用主活动页面优化状态栏背景及文字颜色
@@ -176,7 +181,9 @@ AutoJs6 在 Auto.js 最终项目的基础上, 于 `2021/12/01` 进行二次开
 * `优化` 部分控件主题色与背景色对比度过低时的视觉体验
 * `优化` 应用内页面导航栏设置为透明或半透明以增强视觉体验
 * `优化` UI 模式状态栏及导航栏默认为 `md_grey_50` 色值且设置为亮色模式
-* `优化` 长按应用主页 "文件" 标签可切换浮动按钮可见状态
+* `优化` 应用主页 "文件" 标签支持通过长按切换浮动按钮可见状态
+* `优化` 应用主页抽屉无障碍服务开关支持与脚本代码同步
+* `优化` 代码编辑器标题文字支持字体大小自适应
 * `优化` 日志页面浮动按钮可见状态与列表滚动操作联动
 * `优化` 脚本项目配置文件 project.json 支持更多打包选项 _[`issue #305`](http://issues.autojs6.com/305)_ _[`issue #306`](http://issues.autojs6.com/306)_
 * `优化` 脚本项目配置文件 project.json 支持选项名称宽松匹配及别名兼容
@@ -318,12 +325,12 @@ AutoJs6 在 Auto.js 最终项目的基础上, 于 `2021/12/01` 进行二次开
 
 #### Android Studio 准备
 
-下载 `Android Studio Meerkat | 2024.3.1` 版本 (按需选择其一):
+下载 `Android Studio Meerkat | 2024.3.1 Patch 1` 版本 (按需选择其一):
 
-- [android-studio-2024.3.1.13-windows.exe](https://redirector.gvt1.com/edgedl/android/studio/install/2024.3.1.13/android-studio-2024.3.1.13-windows.exe) (1.22 GB)
-- [android-studio-2024.3.1.13-windows.zip](https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2024.3.1.13/android-studio-2024.3.1.13-windows.zip) (1.23 GB)
+- [android-studio-2024.3.1.14-windows.exe](https://redirector.gvt1.com/edgedl/android/studio/install/2024.3.1.14/android-studio-2024.3.1.14-windows.exe) (1.22 GB)
+- [android-studio-2024.3.1.14-windows.zip](https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2024.3.1.14/android-studio-2024.3.1.14-windows.zip) (1.23 GB)
 
-> 注: 上述版本发布时间为 2025 年 3 月 4 日. 如需下载其他版本, 或上述链接已失效, 可访问 [Android Studio 发行版本归档](https://developer.android.com/studio/archive?hl=en) 页面.
+> 注: 上述版本发布时间为 2025 年 3 月 24 日. 如需下载其他版本, 或上述链接已失效, 可访问 [Android Studio 发行版本归档](https://developer.android.com/studio/archive?hl=en) 页面.
 
 安装或解压上述文件, 运行 Android Studio 软件 (如 `"D:\android-studio\bin\studio64.exe"`).
 
@@ -367,7 +374,7 @@ SDK Tools (SDK 工具) (位于右侧窗口)
 
 AutoJs6 项目依赖的 `JDK (Java 开发工具包)` 发行版本不低于 `17`, 但建议不低于 `19`.
 
-截至 2025 年 3 月 19 日, AutoJs6 可支持 JDK 最高版本为 `24`.
+截至 2025 年 4 月 11 日, AutoJs6 可支持 JDK 最高版本为 `24`.
 
 > 注: 如果计算机系统已安装 JDK 且版本满足上述要求, 则可跳过此小节内容.
 
@@ -402,7 +409,26 @@ Gradle
 
 > 注: 上述过程可能非常耗时. 若网络条件欠佳, 可能需要重试多次 (点击 Retry 按钮).
 
-构建完成后, Android Studio 的 `Build` 标签页将出现类似 `BUILD SUCCESSFUL in 1h 17m 34s` 的消息.
+如果构建未能自动进行, 或需要再次构建项目, 可执行以下步骤:
+
+- 在 `Toolbar (工具栏)` 中, 从 `Run/Debug Configurations (运行/调试配置)` 菜单中选择 `app`, 这是 AutoJs6 的主应用
+- 点击左侧的 `Build Project (构建项目)` 按钮 (形如铁锤) 开始构建项目, 默认快捷键为 CTRL + F9
+- 等待构建完成, `Builder Output (构建输出)` 标签页将出现类似 "BUILD SUCCESSFUL in 1h 17m 34s" 的消息
+
+如果构建失败, 可将异常消息反馈到 AutoJs6 项目的 [议题 (Issues)](http://issues.autojs6.com) 页面.
+
+> 注: 关于如何构建并运行应用的更多内容, 可参阅 [Android Docs](https://developer.android.com/studio/run?hl=zh-cn)
+
+#### AutoJs6 项目部署 (运行 App)
+
+项目构建成功后, 可将项目作为应用程序 (简称 App) 部署到实体设备 (如手机/平板电脑) 或虚拟设备 (如 Android 模拟器) 中.
+
+- 在 `Toolbar (工具栏)` 中, 从 `Run/Debug Configurations (运行/调试配置)` 菜单中选择 `app`, 这是 AutoJs6 的主应用
+- 在右侧 `Available Devices (可用设备)` 菜单中, 选择需要运行项目 App 的设备 (实体设备或虚拟设备)
+- 点击右侧的 `Run (运行)` 按钮 (形如三角形) 开始运行项目, 默认快捷键为 `F10`
+- 等待部署完成, 指定设备将自动安装并运行项目 App
+
+#### AutoJs6 项目部署 (生成 APK)
 
 打包项目并生成可安装到安卓设备的 APK 文件:
 
@@ -416,6 +442,47 @@ Gradle
     - 准备好签名文件 (新建或选取), 生成已签名的发布版安装包
     - 路径示例: `"D:\AutoJs6\app\release\"`
 
+> 注: 关于如何构建应用以向用户发布的更多内容, 可参阅 [Android Docs](https://developer.android.com/build/build-for-release?hl=zh-cn)
+
+#### AutoJs6 预置 Gradle 构建任务
+
+除了构建项目 App 之外, AutoJs6 还支持一些预置的 Gradle 构建任务, 这些任务可以帮助开发者完成与项目相关的便捷操作.
+
+在 `Toolbar (工具栏)` 的 `Run/Debug Configurations (运行/调试配置)` 菜单中, 可看到各个 Gradle 预置任务, 每个任务左侧均显示带小象图标的任务标识.
+
+- AutoJs6 [inrt:assemble]
+
+组装 "inrt" 构建变体, 主要服务于 AutoJs6 脚本打包功能.
+
+AutoJs6 项目拥有不同的构建变体, 其中 "inrt" 变体用于实现 AutoJs6 的脚本打包功能, 生成打包功能依赖的模板文件 "template.apk".
+
+使用打包功能时可能会出现以下异常消息:
+
+> java.io.FileNotFoundException: template.apk
+
+这表明模板文件不存在, 需要手动运行一次 `inrt:assemble` 任务, 生成模板文件, 然后再次构建并部署 App.
+
+> 这表明模板文件不存在, 需要手动运行一次 `inrt:assemble` 任务, 生成模板文件, 然后再次构建并部署 App
+
+- AutoJs6 [app:bundle]
+
+打包 debug 版本编译过程产物, 主要服务于 [AutoJs6 声明文件](http://dts-project.autojs6.com) 项目.
+
+任务运行后生成一个 AutoJs6 项目最新的 JAR 文件, 利用 [Android d.ts Generator](https://github.com/NativeScript/android-dts-generator) (by [NativeScript](https://github.com/NativeScript)) 工具可生成 AutoJs6 主应用的声明文件 (d.ts 格式).
+
+- AutoJs6 [app:digest]
+
+附加摘要信息到 release 版本编译产生的 APK 文件, 主要服务于 AutoJs6 发布最新版本到 GitHub 前确定最终的文件名.
+
+以下为附加摘要信息前后的文件名对比:
+
+```text
+前:
+autojs6-v6.6.2-arm64-v8a.apk
+后:
+autojs6-v6.6.2-arm64-v8a-0f2a9d74.apk
+```
+
 > 参阅: [Android Docs](https://developer.android.com/studio/run?hl=zh-cn)
 
 ******