6.6.2 - Alpha5 - README.md 完善项目构建与运行相关内容
This commit is contained in:
@@ -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)
|
||||
|
||||
******
|
||||
|
||||
Reference in New Issue
Block a user