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

This commit is contained in:
SuperMonster003
2025-04-11 15:17:52 +08:00
parent 97011d3794
commit 0092344adb
30 changed files with 1265 additions and 227 deletions

View File

@@ -326,12 +326,12 @@ AutoJs6 разработан на основе финальной версии
#### Подготовка 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)
> Примечание: Указанная версия была выпущена 4 March 2025 г.. Для загрузки других версий или если указанная ссылка недействительна, посетите страницу [архива версий Android Studio](https://developer.android.com/studio/archive?hl=en).
> Примечание: Указанная версия была выпущена 24 March 2025 г.. Для загрузки других версий или если указанная ссылка недействительна, посетите страницу [архива версий Android Studio](https://developer.android.com/studio/archive?hl=en).
Установите или распакуйте указанные файлы, запустите программное обеспечение Android Studio (например, `"D:\android-studio\bin\studio64.exe"`).
@@ -375,7 +375,7 @@ SDK Tools (SDK Инструменты) (находится в правом ок
Для проекта AutoJs6 требуется версия `JDK (Java Development Kit)` не ниже `17`, но рекомендуется не ниже `19`.
По состоянию на 19 March 2025 г. AutoJs6 поддерживает JDK максимальной версии `24`.
По состоянию на 11 April 2025 г. AutoJs6 поддерживает JDK максимальной версии `24`.
> Примечание: Если на компьютере уже установлен JDK и версия соответствует указанным требованиям, этот раздел можно пропустить.
@@ -410,9 +410,28 @@ Gradle
> Примечание: Процесс может занять много времени. При плохом состоянии сети возможно потребуется несколько попыток (нажмите кнопку Retry).
После завершения сборки на вкладке `Build` в Android Studio появится сообщение типа `BUILD SUCCESSFUL in 1h 17m 34s`.
Если сборка не может быть выполнена автоматически или вам нужно пересобрать проект, выполните следующие шаги:
Упакуйте проект и создайте файл APK для установки на устройство Android:
- В меню `Run/Debug Configurations` на панели инструментов выберите `app`, это основное приложение AutoJs6
- Нажмите кнопку `Build Project` (иконка молотка) слева, чтобы начать сборку проекта. Стандартное сочетание клавиш — CTRL + F9
- Дождитесь завершения сборки. Во вкладке `Builder Output` появится сообщение вроде "BUILD SUCCESSFUL in 1h 17m 34s"
Если сборка не удалась, вы можете сообщить об ошибке на странице [Issues](http://issues.autojs6.com) проекта AutoJs6.
> Примечание: Для получения дополнительной информации о том, как собрать и запустить приложение, смотрите [Android Docs](https://developer.android.com/studio/run?hl=en)
#### Развертывание проекта AutoJs6 (Запуск приложения)
После успешной сборки проекта его можно развернуть как приложение (App) на физическом устройстве (например, телефон/планшет) или на виртуальном устройстве (например, Android-эмулятор).
- На панели инструментов выберите `app` в меню `Run/Debug Configurations`, это основное приложение AutoJs6
- В выпадающем списке `Available Devices` справа выберите устройство, на котором должно запускаться приложение проекта (физическое или виртуальное)
- Нажмите кнопку `Run` (иконка треугольника) справа, чтобы запустить приложение. Стандартное сочетание клавиш — `F10`
- Дождитесь завершения развертывания; выбранное устройство автоматически установит и запустит приложение проекта
#### Развертывание проекта AutoJs6 (Создание APK)
Упакуйте проект и создайте APK-файл, который можно установить на устройства Android:
- Отладочная версия (Debug Version)
- `Build (Сборка)` -> `Build Bundle(s) / APK(s)` -> `Build APK(s)`
@@ -424,6 +443,47 @@ Gradle
- Подготовьте файл подписи (создайте или выберите), создайте подписанный релизный APK файл
- Пример пути: `"D:\AutoJs6\app\release\"`
> Примечание: Для получения дополнительной информации о том, как собрать приложение для выпуска, смотрите [Android Docs](https://developer.android.com/build/build-for-release?hl=en)
#### Предопределенные задачи сборки Gradle для AutoJs6
Помимо сборки приложения проекта, AutoJs6 поддерживает несколько предопределенных задач сборки Gradle, которые помогают разработчикам выполнять удобные операции, связанные с проектом.
В меню `Run/Debug Configurations` на панели инструментов вы можете увидеть различные предопределенные задачи Gradle, каждая из которых имеет значок слона слева.
- AutoJs6 [inrt:assemble]
Соберите вариант сборки "inrt", который в первую очередь предназначен для функции упаковки скриптов AutoJs6.
Проект AutoJs6 имеет различные варианты сборки. Вариант "inrt" используется для упаковки скриптов, создавая шаблонный файл "template.apk", необходимый для упаковки.
При использовании функции упаковки может возникнуть следующая ошибка:
> java.io.FileNotFoundException: template.apk
Это указывает на то, что шаблонный файл отсутствует. Вы должны вручную запустить задачу `inrt:assemble`, чтобы создать шаблонный файл, а затем пересобрать и повторно развернуть приложение.
> Примечание: Шаблонный файл отсутствует; выполните вручную задачу `inrt:assemble`, чтобы создать его, прежде чем пересобирать и развертывать приложение
- AutoJs6 [app:bundle]
Упакуйте артефакты сборки в режиме отладки, в первую очередь для проекта [определений AutoJs6](http://dts-project.autojs6.com).
После выполнения задачи генерируется последний JAR-файл проекта AutoJs6. С помощью инструмента [Android d.ts Generator](https://github.com/NativeScript/android-dts-generator) (от [NativeScript](https://github.com/NativeScript)) вы можете создать файлы определений типов (в формате d.ts) для основного приложения AutoJs6.
- AutoJs6 [app:digest]
Добавьте сводную информацию в 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)
******