Nota de actualización: Ricardo Costeira actualizó este tutorial para Android Studio 2023.1.1. Irina Galata escribió el original. En este tutorial, aprenderá sobre Gradle y cómo configurarlo de manera mantenible y escalable. Al final de este tutorial, podrá: Crear sus aplicaciones de Android desde la línea de comandos. Lea los archivos de compilación de Groovy y Kotlin Gradle. Gestiona dependencias con Gradle. Nota: este tutorial asume que ya estás familiarizado con los conceptos básicos del desarrollo de Android. Si es completamente nuevo en el desarrollo de Android, lea nuestros tutoriales para principiantes en el desarrollo de Android para familiarizarse con los conceptos básicos. ¿Qué es Gradle? Gradle es un sistema de automatización de compilación de código abierto. Tiene la comodidad de un DSL basado en Groovy o Kotlin y las ventajas de Ant y Maven. Con Gradle, puedes manipular fácilmente el proceso de compilación y su lógica para crear múltiples versiones de tu aplicación. Es mucho más fácil de usar y mucho más conciso y flexible en comparación con Ant o Maven solos. Primeros pasos Descargue el proyecto inicial haciendo clic en el enlace Descargar materiales en la parte superior o inferior del tutorial. Abra el proyecto en Android Studio y observe su estructura en el panel Proyecto en Android Studio: preste atención a los archivos con el ícono de elefante de Gradle y la extensión .gradle. Estos archivos los genera Android Studio automáticamente durante la creación del proyecto. Están escritos en Groovy y son responsables de procesar la construcción de su proyecto. Contienen la información necesaria sobre la estructura del proyecto, las dependencias de la biblioteca, las versiones de la biblioteca y las versiones de la aplicación que obtendrá como resultado del proceso de compilación. A partir de Android Studio Giraffe, Kotlin será el idioma predeterminado para la configuración de compilación. Los archivos Gradle escritos en Kotlin tienen la extensión .gradle.kts. Puedes ver que ya hay algunos en el proyecto, pero se agregaron manualmente. Estos son el equivalente de Kotlin a los de .gradle. Bueno, más o menos, su comportamiento es bastante diferente en este punto, pero entenderás por qué a medida que avances en el tutorial. Explorando los archivos a nivel de proyecto Busque el archivo build.gradle en el directorio raíz del proyecto. Se llama archivo build.gradle de nivel superior (nivel de proyecto). Contiene la configuración que se aplica a todos los módulos del proyecto. Abra el archivo y verá el siguiente código: // 1 buildscript { // 2 repositorios { google() mavenCentral() } // 3 dependencias { classpath «com.android.tools.build:gradle:8.2.2 » classpath «org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20» } } // 4 todos los proyectos { repositorios { google() mavenCentral() } } // 5 tareas.register(‘clean’, Eliminar) { eliminar rootProject.buildDir } Esto es lo que sucede, paso a paso: en el bloque buildscript, usted define las configuraciones necesarias para construir su proyecto. En el bloque de repositorios, agregas los nombres de los repositorios donde Gradle debe buscar los complementos que usas. El bloque de dependencias contiene las dependencias de complementos necesarias; en este caso, los complementos de Gradle y Kotlin. No coloque las dependencias de su módulo en este bloque. La estructura del bloque allprojects es similar al bloque buildscript, pero aquí defines repositorios para todos tus módulos, no para Gradle en sí. Por lo general, no define la sección de dependencias para todos los proyectos. Las dependencias para cada módulo son diferentes y deben residir en build.gradle a nivel de módulo. Una tarea representa una parte del trabajo en el proceso de construcción. Este simple limpia los archivos de compilación cuando se ejecuta. Aprenderá más sobre las tareas más adelante en este tutorial. Pasando a archivos a nivel de módulo Ahora, vaya al archivo build.gradle en el directorio del módulo de la aplicación. Contiene dependencias (bibliotecas en las que se basa un módulo) e instrucciones para el proceso de compilación. Cada módulo define su propio archivo build.gradle. // 1 complementos { id «com.android.application» id «kotlin-android» } // 2 android { // 3 espacio de nombres «com.kodeco.socializify» // 4 compileSdk 34 // 5 defaultConfig { // 6 applicationId «com.kodeco.socializify» // 7 minSdkVersion 23 // 8 targetSdkVersion 34 // 9 versionCode 1 // 10 versionName «1.0» } // 11 buildFeatures { viewBinding true } // 12 kotlin { jvmToolchain(17) } } / / 13 dependencias { árbol de archivos de implementación (incluye: [«*.jar»]dir: «libs») implementación «androidx.appcompat:appcompat:1.6.1» implementación «com.google.android.material:material:1.9.0» } El código anterior hace lo siguiente: Especifica una lista de complementos necesarios para compilar el módulo. El complemento com.android.application es necesario para configurar las configuraciones específicas de Android del proceso de compilación. Aquí también puedes usar com.android.library si estás creando un módulo de biblioteca. El complemento kotlin-android le permite utilizar el lenguaje Kotlin en su módulo. En el bloque de Android, coloca todas las opciones del módulo específicas de la plataforma. Definir un espacio de nombres es necesario para cosas como el acceso a recursos. Solía ​​estar en el archivo AndroidManifest.xml bajo la propiedad del paquete, pero ahora ha migrado. La opción compileSdk indica el nivel de API con el que se compilará su aplicación. En otras palabras, no puede utilizar funciones de una API superior a este valor. Aquí, ha establecido el valor para usar API de Android Tiramisu. El bloque defaultConfig contiene opciones que se aplicarán a todas las versiones de compilación (por ejemplo, depuración, lanzamiento, etc.) de su aplicación de forma predeterminada. El applicationId es el identificador de su aplicación. Debe ser único para poder publicar o actualizar correctamente su aplicación en Google Play Store. Si lo deja sin definir, el sistema de compilación utilizará el espacio de nombres como applicationId. Para establecer el nivel de API más bajo admitido, utilice minSdkVersion. Su aplicación no estará disponible en Play Store para los dispositivos que se ejecutan en niveles de API inferiores. Nota: Para familiarizarse más con las versiones del SDK de Android, lea nuestro tutorial que cubre ese tema. El parámetro targetSdkVersion define el nivel máximo de API en el que se ha probado su aplicación. Es decir, está seguro de que su aplicación funciona correctamente en los dispositivos con esta versión de SDK y no requiere ningún comportamiento de compatibilidad con versiones anteriores. El mejor enfoque es probar minuciosamente una aplicación utilizando la API más reciente, manteniendo el valor de targetSdkVersion igual a compileSdk. versionCode es un valor numérico para la versión de la aplicación. versionName es una cadena fácil de usar para la versión de la aplicación. El bloque buildFeatures le permite habilitar ciertas funciones, como Ver enlace o Redactar. En este caso, está haciendo lo primero. Nota: Si desea obtener más información sobre el enlace Ver, consulte nuestro tutorial al respecto. Gradle 8.2 admite JVM 17 de forma predeterminada, por lo que obliga al proyecto a usar Java 17 a través del soporte de la cadena de herramientas Java de Gradle. El bloque de dependencias contiene todas las dependencias necesarias para este módulo. Más adelante en este tutorial, encontrará más información sobre cómo administrar las dependencias de su proyecto. Nota: Para familiarizarse más con las versiones del SDK de Android, lea nuestro tutorial que cubre ese tema. Nota: Si desea obtener más información sobre el enlace Ver, consulte nuestro tutorial al respecto.

Source link