Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Complemento de Android para Gradle 3.2.0 (septiembre de 2018)
Esta versión del complemento para Android requiere lo siguiente:
|
Versión mínima |
Versión predeterminada |
Notas |
Gradle |
4.6 |
4.6 |
Para obtener más información, consulta cómo actualizar Gradle. |
Herramientas de desarrollo del SDK |
28.0.3 |
28.0.3 |
Instala o configura las herramientas de compilación del SDK. |
3.2.1 (octubre de 2018)
Con esta actualización, ya no es necesario especificar la versión de las herramientas de compilación de SDK. El complemento de Android para Gradle ahora usa la versión 28.0.3 de forma predeterminada.
Funciones nuevas
-
Compatibilidad con compilación de Android App Bundles: El paquete de aplicación es un formato de carga nuevo que incluye todos los recursos y códigos compilados de la app, a la vez que se aplaza la generación del APK y el proceso de firma en Google Play Store. Ya no es necesario compilar, firmar y administrar varios APK, y los usuarios obtienen descargas de menor tamaño optimizadas para su dispositivo. Si quieres obtener más información, consulta Acerca de Android App Bundles.
-
Compatibilidad con velocidades de compilación incremental mejoradas cuando se usan los procesadores de anotaciones: La DSL de AnnotationProcessorOptions
ahora amplía CommandLineArgumentProvider
, que te permite a ti o al autor del procesador de anotaciones anotar los argumentos del procesador usando anotaciones de tipo de propiedad de compilación incremental.
El uso de esas anotaciones mejora la corrección y el rendimiento de las compilaciones limpias incrementales y almacenadas en caché. Para obtener más información, consulta Cómo pasar argumentos a procesadores de anotaciones.
-
Herramienta de migración para AndroidX: Cuando se usa el complemento de Android para Gradle 3.2.0 con Android 3.2 y versiones posteriores, puedes migrar las dependencias de Maven y las locales del proyecto para usar las nuevas bibliotecas de AndroidX. A tal fin, selecciona Refactor > Migrate to AndroidX en la barra de menú. El uso de esta herramienta de migración también configura las siguientes marcas como true
en el archivo gradle.properties
:
-
android.useAndroidX
: Cuando se establece esta marca en true
, el complemento para Android usa la biblioteca de AndroidX apropiada en lugar de una biblioteca de compatibilidad. Si no se especifica la marca, el complemento la configura como false
de forma predeterminada.
-
android.enableJetifier
: Cuando se establece esta marca en true
, el complemento para Android reescribe sus objetos binarios a fin de migrar automáticamente las bibliotecas de terceros existentes para usar las dependencias de AndroidX. Si no se especifica la marca, el complemento la configura como false
de forma predeterminada. Puedes configurarla en true
solo si android.useAndroidX
también está configurado en true
; de lo contrario, se mostrará un error de compilación.
Para obtener más información, consulta la descripción general de AndroidX.
-
Reductor de código nuevo, R8: R8 es una herramienta nueva de reducción y ofuscación de código que reemplaza a ProGuard. Puedes comenzar a usar la versión preliminar de R8 incluyendo lo siguiente en el archivo gradle.properties
del proyecto:
android.enableR8 = true
android.enableR8 = true
Cambios en el comportamiento
-
La eliminación de accesos directos con D8 ahora está habilitada de forma predeterminada.
-
AAPT2 ahora está en el repositorio de Maven de Google. Para usar AAPT2, asegúrate de tener la dependencia google()
en el archivo build.gradle
, como se muestra a continuación:
buildscript {
repositories {
google() // here
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.0'
}
}
allprojects {
repositories {
google() // and here
jcenter()
}
buildscript {
repositories {
google() // here
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.0'
}
}
allprojects {
repositories {
google() // and here
jcenter()
}
-
El multidex nativo ahora está habilitado de forma predeterminada. Las versiones anteriores de Android Studio habilitaban multidex nativo cuando se implementaba la versión de depuración de una app en un dispositivo con el nivel de API 21 de Android o una versión posterior. Independientemente de si haces una implementación en un dispositivo o compilas un APK para actualización, el complemento de Android para Gradle habilita multidex nativo en todos los módulos con minSdkVersion=21
o una versión posterior.
-
El complemento ahora aplica una versión mínima de los complementos protobuf (0.8.6), Kotlin (1.2.50) y Crashlytics (1.25.4).
-
El complemento de módulo de funciones, com.android.feature
, ahora aplica el uso de solo letras, dígitos y guiones bajos cuando se especifica un nombre de módulo. Por ejemplo, si el nombre del módulo incluye guiones, se mostrará un error. Este comportamiento coincide con el del complemento de funciones dinámicas.
Correcciones de errores
- Ahora se puede almacenar JavaCompile en la memoria caché en proyectos con vinculación de datos
(Error #69243050).
- Se mejoró la elusión de compilación para módulos de biblioteca con vinculación de datos
(Error #77539932).
- Ahora puedes volver a habilitar la configuración on demand si la inhabilitaste en versiones anteriores debido a errores de compilación impredecibles
(Error #77910727).
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-09-05 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[],[],null,["\u003cbr /\u003e\n\nAndroid Gradle Plugin 3.2.0 (September 2018)\n\nThis version of the Android plugin requires the following:\n\n| | Minimum version | Default version | Notes |\n|----------------:|:---------------:|:---------------:|:----------------------------------------------------------------------------------------------------------:|\n| Gradle | 4.6 | 4.6 | To learn more, see [updating Gradle](/build/releases/gradle-plugin?buildsystem=ndk-build#updating-gradle). |\n| SDK Build Tools | 28.0.3 | 28.0.3 | [Install](/studio/intro/update#sdk-manager) or [configure](/tools/releases/build-tools) SDK Build Tools. |\n\n**3.2.1 (October 2018)**\n\nWith this update, you no longer need to specify a version for the SDK Build\nTools. The Android Gradle plugin now uses version 28.0.3 by default.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nNew features\n\n- **Support for building Android App Bundles:** The app bundle is a new upload\n format that includes all your app's compiled code and resources while\n deferring APK generation and signing to the Google Play Store. You no longer\n have to build, sign, and manage multiple APKs, and users get smaller downloads\n that are optimized for their device. To learn more, read\n [About Android App Bundles](/guide/app-bundle).\n\n- **Support for improved incremental build speeds when using annotation processors:**\n The [`AnnotationProcessorOptions`](https://google.github.io/android-gradle-dsl/current/com.android.build.gradle.internal.dsl.AnnotationProcessorOptions.html)\n DSL now extends [`CommandLineArgumentProvider`](https://docs.gradle.org/current/javadoc/org/gradle/process/CommandLineArgumentProvider.html),\n which enables either you or the annotation processor author to annotate\n arguments for the processor using\n [incremental build property type annotations](https://docs.gradle.org/current/userguide/more_about_tasks.html#sec:up_to_date_checks).\n Using these annotations improves the correctness and performance of\n incremental and cached clean builds. To learn more, read\n [Pass arguments to annotation processors](/studio/build/dependencies#processor-arguments).\n\n- **Migration tool for AndroidX:** When using Android Gradle plugin 3.2.0 with\n Android 3.2 and higher, you can migrate your project's local and Maven\n dependencies to use the new AndroidX libraries by selecting **Refactor \\\u003e\n Migrate to AndroidX** from the menu bar. Using this migration tool also sets\n the following flags to `true` in your `gradle.properties` file:\n\n - **`android.useAndroidX`:** When set to `true`, the Android plugin uses the\n appropriate AndroidX library instead of a Support Library. When this flag\n is not specified, the plugin sets it to `false` by default.\n\n - **`android.enableJetifier`:** When set to `true`, the Android plugin\n automatically migrates existing third-party libraries to use AndroidX by\n rewriting their binaries. When this flag is not specified, the plugin sets\n it to `false` by default. You can set this flag to `true` only while\n `android.useAndroidX` is also set to `true`, otherwise you get a build error.\n\n To learn more, read the [AndroidX overview](/topic/libraries/support-library/androidx-overview).\n- **New code shrinker, R8:** R8 is a new tool for code shrinking and obfuscation\n that replaces ProGuard. You can start using the preview version of R8 by\n including the following in your project's `gradle.properties` file:\n\n ```groovy\n android.enableR8 = true\n \n ``` \n\n ```kotlin\n android.enableR8 = true\n \n ```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nBehavior changes\n\n- Desugaring with D8 is now enabled by default.\n\n- AAPT2 is now on Google's Maven repo. To use AAPT2, make sure that you\n have the `google()` dependency in your `build.gradle`\n file, as shown below:\n\n ```groovy\n buildscript {\n repositories {\n google() // here\n jcenter()\n }\n dependencies {\n classpath 'com.android.tools.build:gradle:3.2.0'\n }\n }\n allprojects {\n repositories {\n google() // and here\n jcenter()\n }\n \n ``` \n\n ```kotlin\n buildscript {\n repositories {\n google() // here\n jcenter()\n }\n dependencies {\n classpath 'com.android.tools.build:gradle:3.2.0'\n }\n }\n allprojects {\n repositories {\n google() // and here\n jcenter()\n }\n \n ```\n- Native multidex is now enabled by default. Previous versions of Android\n Studio enabled native multidex when deploying the debug version of an app to a\n device running Android API level 21 or higher. Now, whether you're deploying\n to a device or building an APK for release, the Android Gradle plugin\n enables native multidex for all modules that set\n `minSdkVersion=21` or higher.\n\n- The plugin now enforces a minimum version of the protobuf plugin (0.8.6),\n Kotlin plugin (1.2.50), and Crashlytics plugin (1.25.4).\n\n- The feature module plugin,`com.android.feature`, now\n enforces the use of only letters, digits, and underscores when specifying\n a module name. For example, if your feature module name includes dashes,\n you get a build error. This behavior matches that of the dynamic feature\n plugin.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nBug fixes\n\n- JavaCompile is now cacheable in projects with data binding. ([Issue #69243050](https://issuetracker.google.com/69243050))\n- Better compile avoidance for library modules with data binding. ([Issue #77539932](https://issuetracker.google.com/77539932))\n- You can now re-enable [configure-on-demand](https://docs.gradle.org/current/userguide/multi_project_builds.html#sec:configuration_on_demand) if you've disable it in earlier versions due to some unpredictable build errors. ([Issue #77910727](https://issuetracker.google.com/77910727))\n\n\u003cbr /\u003e"]]