Herramienta de automatización JavaScript que soporta servicios de accesibilidad en la plataforma Android
)
* `Mejora` El editor de código admite la determinación inteligente de la ubicación de inserción al importar clases Java y nombres de paquetes
* `Mejora` El módulo images admite el uso de rutas directamente como parámetros de imagen
* `Mejora` importPackage admite parámetros de cadena
* `Mejora` La dirección IP del modo servidor admite la importación del portapapeles con reconocimiento inteligente y conversión inteligente con la tecla de espacio
* `Mejora` El administrador de archivos admite la selección de prefijos predeterminados al crear nuevos archivos y genera automáticamente el sufijo numérico apropiado
* `Mejora` El administrador de archivos informa específicamente sobre el mensaje de excepción al ejecutar el proyecto _[`issue #268`](http://issues.autojs6.com/268)_
* `Mejora` El administrador de archivos admite más tipos y muestra símbolos de icono correspondientes (admite más de 800 tipos de archivos)
* `Mejora` Los tipos de archivos editables (jpg/doc/pdf, etc.) en el administrador de archivos han añadido botones de edición
* `Mejora` Los archivos APK en el administrador de archivos admiten la visualización de información básica, información de Manifesto y lista de permisos
* `Mejora` Los archivos de medios de audio/video en el administrador de archivos admiten la visualización de información básica e información de MediaInfo
* `Mejora` El paquete de archivo único admite el autocompletado de nombre de paquete estandarizado apropiado y el aviso de filtro de caracteres no válidos
* `Mejora` El paquete de archivo único admite la configuración automática del ícono y el incremento automático del número de versión y del nombre de versión basado en la misma aplicación de nombre de paquete instalada
* `Mejora` El archivo de configuración del paquete admite la opción abis/libs para especificar la arquitectura ABI incluidos por defecto y las bibliotecas
* `Mejora` Admite avisos de mensajes relevantes cuando las opciones abis/libs del archivo de configuración del paquete son inválidas o no están disponibles
* `Mejora` LeakCanary se excluye de la versión oficial para evitar un crecimiento innecesario
* `Mejora` Todos los comentarios en inglés en el código fuente del proyecto vienen acompañados de traducciones al chino simplificado para mejorar la legibilidad
* `Mejora` README y CHANGELOG admiten varios idiomas (Generado automáticamente por el script)
* `Mejora` Mejorar la adaptabilidad de la versión del script de construcción de Gradle
* `Mejora` Ajustes en algunas dependencias o versiones de bibliotecas locales _[`CHANGELOG.md`](http://project.autojs6.com/blob/master/app/src/main/assets-app/doc/CHANGELOG.md#v660)_
##### Para más historial de versiones, consulte
* [CHANGELOG.md](http://project.autojs6.com/blob/master/app/src/main/assets-app/doc/CHANGELOG-es.md)
******
### Compilación y construcción del proyecto
******
Para depurar o desarrollar el proyecto de código abierto AutoJs6, puedes usar [Android Studio](https://pro.autojs.org/) (producto de [Google](https://www.google.com/)) o [IntelliJ IDEA](https://www.jetbrains.com/idea/) (producto de [JetBrains](https://www.jetbrains.com/)).
Esta sección toma como ejemplo Android Studio para presentar los métodos de compilación y construcción del proyecto de código abierto AutoJs6; IntelliJ IDEA es similar.
#### Preparación de Android Studio
Descarga la versión `Android Studio Meerkat | 2024.3.1 Patch 1` (elige una según tus necesidades):
- [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)
> Nota: La fecha de lanzamiento de la versión anterior es el 24 de March de 2025. Para descargar otras versiones, o si los enlaces anteriores ya no funcionan, puedes visitar la página del [Archivo de versiones de Android Studio](https://developer.android.com/studio/archive?hl=en).
Instala o descomprime los archivos mencionados anteriormente y ejecuta el software Android Studio (por ejemplo, `"D:\android-studio\bin\studio64.exe"`).
#### Preparación del SDK de Android
> Nota: Si el sistema ya tiene instalado el SDK de Android (Kit de Desarrollo de Software de Android), puedes omitir esta sección.
En el software Android Studio, abre la página de configuración con el atajo de teclado `CTRL + ALT + S`:
```text
Appearance & Behavior (Apariencia y comportamiento) ->
System Settings (Configuración del sistema) ->
Android SDK (Kit de Desarrollo de Software de Android)
```
Si `Android SDK Location (Ubicación del SDK de Android)` está en blanco, haz clic en el botón `Edit (Editar)` a la derecha y continúa haciendo clic en `Next (Siguiente)` en la ventana emergente.
> Nota: Puede ser necesario aceptar uno o varios acuerdos durante el proceso para continuar.
Una vez que los recursos relacionados se hayan descargado e instalado, haz clic en el botón `Finish (Finalizar)`.
La ruta se completará automáticamente en `Android SDK Location (Ubicación del SDK de Android)`, completando así la preparación del SDK.
#### Preparación de herramientas del SDK de Android
AutoJs6 requiere usar algunas herramientas del SDK (como NDK y CMake).
> Nota: Si el sistema ya tiene instaladas todas las herramientas necesarias del SDK de Android para AutoJs6, puedes omitir esta sección.
En el software Android Studio, abre la página de configuración con el atajo de teclado `CTRL + ALT + S`:
```text
Appearance & Behavior (Apariencia y comportamiento) ->
System Settings (Configuración del sistema) ->
Android SDK (Kit de Desarrollo de Software de Android) ->
SDK Tools (Herramientas del SDK) (situado en la ventana de la derecha)
```
Marca `Show Package Details (Mostrar detalles del paquete)`, haz clic en NDK y CMake para asegurarte de que las versiones requeridas están seleccionadas, La información de la versión de las herramientas del SDK se encuentra en el archivo `version.properties` en el directorio raíz del proyecto AutoJs6.
#### Preparación del JDK
La versión mínima requerida del `JDK (Kit de Desarrollo de Java)` para el proyecto AutoJs6 es `17`, pero se recomienda usar una versión no inferior a `19`.
Hasta el 2 de May de 2025, AutoJs6 soporta hasta la versión `24` de JDK.
> Nota: Si el sistema ya tiene instalado JDK y cumple con los requisitos anteriores, puedes omitir esta sección.
Puedes descargar el JDK directamente desde la IDE, o desde el [sitio web de Oracle](https://www.oracle.com/java/technologies/downloads/).
En el software Android Studio, abre la página de configuración con el atajo de teclado `CTRL + ALT + S`:
```text
Build, Execution, Deployment (Compilación, ejecución, despliegue) ->
Build Tools (Herramientas de compilación) ->
Gradle
```
En `Gradle JDK`, puedes seleccionar o agregar diferentes versiones de JDK.
Si ya existe una versión adecuada de JDK (>= `17`) en la lista, simplemente selecciónala.
De lo contrario, puedes seleccionar `Download JDK (Descargar JDK)` para descargar el JDK adecuado, haz clic en el botón `Download (Descargar)` y espera a que se complete la descarga.
También puedes seleccionar `Add JDK (Añadir JDK)` para agregar un JDK local existente, ubica su directorio y completa la adición del JDK.
#### Clonación de recursos de AutoJs6
En la página principal de Android Studio, haz clic en el botón `Get from VCS (Obtener desde VCS)`.
En `URL (dirección URL)`, ingresa `https://github.com/SuperMonster003/AutoJs6.git`,
En `Directory (directorio)`, puedes cambiarlo a una ruta específica según sea necesario.
Haz clic en el botón `Clone (clonar)` y espera a que los recursos del proyecto AutoJs6 se clonen localmente en el dispositivo.
> Nota: Este proceso puede requerir la instalación de [Git (sistema de control de versiones distribuido)](https://git-scm.com/download).
#### Construcción del proyecto AutoJs6
Una vez completada la clonación, Android Studio abrirá la ventana del proyecto AutoJs6 y completará automáticamente la descarga inicial de `Dependencies (dependencias)` y el trabajo de construcción de Gradle.
> Nota: Este proceso puede ser muy largo. Si las condiciones de la red no son buenas, puede ser necesario reintentar varias veces (haga clic en el botón Retry).
If the build couldn't proceed automatically or you need to rebuild the project, follow these steps:
- From the `Run/Debug Configurations` menu in the Toolbar, select `app`, which is the main AutoJs6 application.
- Click the `Build Project` (hammer icon) button on the left to start building the project. The default shortcut is CTRL + F9.
- Wait for the build to complete. The `Builder Output` tab will display a message such as "BUILD SUCCESSFUL in 1h 17m 34s".
If the build fails, you can report the error message to the AutoJs6 project's [Issues](http://issues.autojs6.com) page..
> Nota: For more details on building and running the app, please refer to [Android Docs](https://developer.android.com/studio/run?hl=en).
#### AutoJs6 Project Deployment (Run App)
Once the project is built successfully, it can be deployed as an application (App) to a physical device (e.g., phone/tablet) or a virtual device (e.g., Android emulator)..
- In the Toolbar, select `app` from the `Run/Debug Configurations` menu, which is the main AutoJs6 application.
- In the `Available Devices` dropdown on the right, choose the device on which the project app should run (physical or virtual).
- Click the `Run` (triangle icon) button on the right to launch the app. The default shortcut is `F10`.
- Wait for the deployment to finish; the chosen device will automatically install and run the project app.
#### AutoJs6 Project Deployment (Generate APK)
Package the project and generate an APK file that can be installed on Android devices.:
- Versión de depuración (Debug Version)
- `Build (Compilar)` -> `Build Bundle(s) / APK(s)` -> `Build APK(s)`
- Generar un paquete de instalación de versión de depuración
- Ruta de ejemplo: `"D:\AutoJs6\app\build\outputs\apk\debug\"`
- Versión de lanzamiento (Release Version)
- `Build (Compilar)` -> `Generate Signed Bundle / APK`
- Selecciona la opción `APK`
- Prepara el archivo de firma (crear o seleccionar uno nuevo) para generar un paquete de instalación de versión de lanzamiento firmado
- Ruta de ejemplo: `"D:\AutoJs6\app\release\"`
> Nota: For more information on building an app for user release, please refer to [Android Docs](https://developer.android.com/build/build-for-release?hl=en).
#### Predefined Gradle Build Tasks for AutoJs6
Besides building the project App, AutoJs6 supports several predefined Gradle build tasks that help developers perform convenient project-related operations..
Under the `Run/Debug Configurations` menu in the Toolbar, you can find various predefined Gradle tasks, each indicated by an elephant icon on the left..
- AutoJs6 [inrt:assemble]
Assemble the "inrt" build variant, which primarily serves the AutoJs6 script packaging feature..
The AutoJs6 project has various build variants. The "inrt" variant is used for packaging scripts, generating the template file "template.apk" required for packaging..
When using the packaging feature, you might encounter the following error message:
> java.io.FileNotFoundException: template.apk
This indicates that the template file does not exist. You need to manually run the `inrt:assemble` task to generate the template file, then rebuild and redeploy the app..
> Nota: Si el código del proyecto principal cambia y se desea sincronizar dichos cambios con la aplicación empaquetada, es necesario volver a ejecutar la tarea `inrt:assemble` para generar los archivos de plantilla y redeplegar la aplicación
- AutoJs6 [app:bundle]
Package the outputs of the debug build process, primarily for the [AutoJs6 TypeScript definitions](http://dts-project.autojs6.com) project..
After running the task, it produces the latest JAR file for the AutoJs6 project. Using the [Android d.ts Generator](https://github.com/NativeScript/android-dts-generator) (by [NativeScript](https://github.com/NativeScript)), you can generate the type definitions (d.ts format) for the main AutoJs6 app..
- AutoJs6 [app:digest]
Append digest information to the APK produced by the release build, mainly to finalize the filename before publishing the latest version of AutoJs6 to GitHub..
Below is the comparison of filenames before and after appending the digest information:
```text
Before:
autojs6-v6.6.2-arm64-v8a.apk
After:
autojs6-v6.6.2-arm64-v8a-0f2a9d74.apk
```
> Consultar: [Android Docs](https://developer.android.com/studio/run?hl=zh-cn)
******
### Asistencia en el desarrollo de scripts
******
Para desarrollar scripts ejecutables en AutoJs6, utiliza las herramientas de desarrollo adecuadas:
- [VSCode](https://code.visualstudio.com/download) / [WebStorm](https://www.jetbrains.com/webstorm/download/) / [HBuilderX](https://www.dcloud.io/hbuilderx.html) ...
Para escribir y depurar scripts en PC, el complemento de VSCode puede conectar el PC y el teléfono:
- [AutoJs6-VSCode-Extension](http://vscext-project.autojs6.com) - Depurador de AutoJs6 (extensión para la plataforma VSCode)
Al escribir código con herramientas de desarrollo, la función de autocompletado puede ayudar al desarrollador a completar el código:
- [AutoJs6-TypeScript-Declarations](http://dts-project.autojs6.com) - Archivos de declaración de AutoJs6 (autocompletado del código)
Al escribir el código, puedes consultar la documentación sobre la API y el uso de AutoJs6 en cualquier momento:
- [AutoJs6-Documentation](http://docs-project.autojs6.com) - Documentación de la aplicación AutoJs6
Los proyectos de desarrollo de scripts existentes pueden servir como referencia e inspiración para tus propios proyectos de scripts:
- [Ant-Forest](https://github.com/TonyJiangWJ/Ant-Forest) - Script de recolección automática de energía de Ant Forest por [TonyJiangWJ](https://github.com/TonyJiangWJ)
- [Ant-Forest](https://github.com/SuperMonster003/Ant-Forest) - Script de recolección automática de energía de Ant Forest por [SuperMonster003](https://github.com/SuperMonster003)
- [autojs](https://github.com/e1399579/autojs) - Scripts útiles de Auto.js por [e1399579](https://github.com/e1399579)
- [autojsDemo](https://github.com/snailuncle/autojsDemo) - Ejemplo de demostración de Auto.js por [snailuncle](https://github.com/snailuncle)
- [Repositorios relacionados con autojs](https://github.com/topics/autojs) - Todos los repositorios relacionados con el tema autojs en GitHub
******
### Contribución
******
Agradecemos a todos los que han contribuido al desarrollo del proyecto AutoJs6.
| Contribuyentes | Número de commits | Últimas presentaciones |
|:-------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------:|
| [luckyloogn](https://github.com/luckyloogn) | [3](https://github.com/SuperMonster003/AutoJs6/commits?author=luckyloogn) | `2025/01/01` |
| [kvii](https://github.com/kvii) | [1](https://github.com/SuperMonster003/AutoJs6/commits?author=kvii) | `2024/10/16` |
| [chenguangming](https://github.com/chenguangming) `(Tom)` | [2](https://github.com/SuperMonster003/AutoJs6/pulls?q=is%3Apr+author%3Achenguangming) | `2024/05/14` |
| [LZX284](https://github.com/LZX284) `(AI)` | [17](https://github.com/SuperMonster003/AutoJs6/commits?author=LZX284) | `2023/11/19` |
| [TonyJiangWJ](https://github.com/TonyJiangWJ) | [4](https://github.com/SuperMonster003/AutoJs6/commits?author=TonyJiangWJ) | `2023/10/31` |
| [little‑alei](https://github.com/little-alei) `(抠脚本人)` | [12](https://github.com/SuperMonster003/AutoJs6/commits?author=little-alei) | `2023/07/12` |
| [aiselp](https://github.com/aiselp) | [6](https://github.com/SuperMonster003/AutoJs6/pulls?q=is%3Apr+author%3Aaiselp) | `2023/06/14` |
| [LYS86](https://github.com/LYS86) `(Lin)` | [2](https://github.com/SuperMonster003/AutoJs6/commits?author=LYS86) | `2023/06/03` |
Datos actualizados el 1 de January de 2025.
Las entradas de datos están ordenadas en orden descendente por `últimas presentaciones`.
Las nuevas Pull Requests pendientes de procesamiento se añadirán a las estadísticas de datos una vez procesadas.
Algunos contribuyentes no aparecen en [GitHub Contributors](https://github.com/SuperMonster003/AutoJs6/graphs/contributors) con sus registros de contribución vacíos, pero aún puedes verificar sus registros de contribución a través de [Pull Request](https://github.com/SuperMonster003/AutoJs6/pulls).
[//]: # (
# --------------------------------------------------------------#
# Before committing and pushing to the remote GitHub repository #
# --------------------------------------------------------------#
- CHANGELOG.md
- Update entries for AutoJs6 by checking all changed files
- Update entries for Gradle plugins [ implementation ]
- Update version name and released date
- Append related GitHub issues to changelog entries
- README.md
- The summary of the latest changelog for committing to Git [ DO NOT commit or push ]
- Update badges like [ android studio / rhino / ... ]
- Update android studio download links and version names
- Update contribution section
- Remove the part like [ alpha / beta / ... ] of VERSION_NAME in version.properties
- Update dependencies TypeScript declarations if needed.
- Re-generate documentation/markdown by running the python script
- Check the two-way versions for AutoJs6 and VSCode ext, then publish the ext to Microsoft
- Run Gradle task "app:assembleInrtRelease"
- Build APK to determine the final VERSION_BUILD field
- Run Gradle task "app:appendDigestToReleasedFiles"
- Check VERSION_BUILD in version.properties with released apks
- Commit and push to GitHub
- Publish the latest release with signed APKs
)