Compartir vía


Compilación y publicación de artefactos con Gradle y Azure Pipelines

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Gradle es una herramienta de compilación popular para aplicaciones Java y la herramienta de compilación principal para Android. Con Azure Pipelines, podemos agregar la tarea Gradle a nuestra definición de compilación y compilar y publicar nuestros artefactos de compilación.

Requisitos previos

Para asegurarse de que tiene todos los requisitos previos configurados, ejecute el siguiente comando en un símbolo del sistema con privilegios elevados para comprobar qué versión de Java está instalada en el equipo.

java -version

Si el comando anterior no devuelve una versión de Java, asegúrese de volver e instalar primero el JDK o JRE de Java.

Para confirmar la instalación de Gradle, ejecute el siguiente comando en un símbolo del sistema con privilegios elevados:

gradle -v

Configuración de la autenticación

  1. Seleccione Configuración de usuario y, a continuación, seleccione Tokens de acceso personal.

    Captura de pantalla que muestra cómo crear un token de acceso personal

  2. Seleccione Nuevo token y rellene los campos obligatorios. Asegúrese de seleccionar el ámbito Empaquetado>Lectura y escritura.

    Captura de pantalla que muestra cómo crear un nuevo token de acceso personal.

  3. Seleccione Crear cuando haya terminado.

  1. Copie el token y guárdelo en una ubicación segura.

  2. Cree un nuevo archivo en la carpeta .gradle y asígnele el nombre gradle.properties. La ruta de acceso a la carpeta de Gradle suele estar en %INSTALLPATH%/gradle/user/home/.gradle/.

  3. Abra el archivo gradle.properties con un editor de texto y agregue el siguiente fragmento de código:

    vstsMavenAccessToken=<PASTE_YOUR_PERSONAL_ACCESS_TOKEN_HERE>
    
  4. Cuando haya terminado, guarde el archivo.

Compilación de proyectos con la CLI de Gradle

  1. Abra el archivo build.gradle y asegúrese de que comienza con lo siguiente:

    apply plugin: 'java'
    
  2. Agregue el siguiente fragmento de código al archivo build.gradle para descargar el artefacto durante la compilación. Reemplace los marcadores de posición por los valores de groupID, artifactID y versionNumber. Por ejemplo: `compile(group: 'siteOps', name: 'odata-wrappers', version: '1.0.0.0')

    dependencies { 
        compile(group: '<YOUR_GROUP_ID>', name: '<ARTIFACT_ID>', version: '<VERSION_NUMBER>')  
    } 
    

Para probar esto, podemos crear una aplicación de consola Java de ejemplo y compilarla con Gradle.

public class HelloWorld { 
    public static void main(String[] args) { 
        System.out.println("Hello, world!"); 
    } 
} 

Ejecute el siguiente comando para compilar el proyecto. La salida de la compilación debe devolver: BUILD SUCCESSFUL

gradle build

Uso de Gradle en Azure Pipelines

  1. Ejecute el siguiente comando para crear el contenedor de Gradle gradlew.

    gradle wrapper
    
  2. Inserte los cambios en la rama remota. Necesitaremos este archivo más adelante cuando agreguemos la tarea Gradle .

  3. Vaya a la definición de canalización. Si no tiene una, cree una nueva canalización, seleccione Usar el editor clásico y, a continuación, seleccione la plantilla de Gradle .

    Captura de pantalla que muestra cómo usar la plantilla de canalización de Gradle

  4. Puede usar la configuración predeterminada con la tarea de compilación de gradlew.

    Captura de pantalla en la que se muestra la tarea de Gradle

  5. La tarea de publicación de artefactos de compilación publicará nuestro artefacto en Azure Pipelines.

    Captura de pantalla que muestra la tarea de publicación de artefactos.

  6. Cuando termine, seleccione Guardar y poner en cola.

  7. Puede ver el artefacto publicado en el resumen de la canalización una vez completada la ejecución.

    Captura de pantalla que muestra el resumen de la canalización y el artefacto publicados.