Configuración y uso de Gradle Groovy - Amazon CodeCatalyst
Obteniendo dependencias de CodeCatalystObteniendo complementos de CodeCatalystObtención de paquetes de repositorios de paquetes externos mediante CodeCatalystPublicar paquetes en CodeCatalystEjecución de una compilación de Gradle en IntelliJ IDEA

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración y uso de Gradle Groovy

Para usar Gradle Groovy con CodeCatalyst, debes conectar Gradle Groovy a tu repositorio de paquetes y proporcionar un token de acceso personal (PAT) para la autenticación. Puedes ver las instrucciones para conectar Gradle Groovy a tu repositorio de paquetes en la consola. CodeCatalyst

Obteniendo dependencias de CodeCatalyst

En las siguientes instrucciones, se explica cómo configurar Gradle Groovy para que busque las dependencias en el repositorio de paquetes. CodeCatalyst

Para usar Gradle Groovy para recuperar las dependencias del repositorio de paquetes CodeCatalyst

  1. Abre la consola en https://codecatalyst.aws/. CodeCatalyst

  2. Vaya a su proyecto.

  3. En el panel de navegación, elija Paquetes.

  4. Elija su repositorio de paquetes de la lista de repositorios de paquetes.

  5. Seleccione Establecer conexión con el repositorio.

  6. En el cuadro de diálogo Establecer conexión con el repositorio, seleccione Gradle Groovy en la lista de clientes de administrador de paquetes.

  7. Necesitarás un token de acceso personal (PAT) para autenticar a Gradle Groovy. CodeCatalyst Si ya tiene uno, puede utilizarlo. De lo contrario, puede crear uno aquí.

    1. Seleccione Crear token.

    2. Seleccione Copiar para copiar el PAT.

      aviso

      Después de cerrar el cuadro de diálogo, no podrá volver a ver ni copiar el PAT.

  8. Actualice el archivo de propiedades de Gradle con sus credenciales de acceso. usernameSustitúyelo por su CodeCatalyst nombre de usuario y sustitúyalo por su PAT token de acceso personal. CodeCatalyst Puedes usar cualquier valor durante spaceUsername y spacePassword siempre que utilices los mismos valores en los siguientes pasos.

    spaceUsername=username
spacePassword=PAT

  9. Para obtener las dependencias de una compilación CodeCatalyst de Gradle, copia el fragmento de maven código y agrégalo a la repositories sección del archivo de tu proyecto. build.gradle Reemplace los siguientes valores. Puedes usar cualquier valor siempre y spaceName cuando utilices los mismos valores en los siguientes pasos.

    nota

    Si va a copiar las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.

    • space_nameSustitúyalo por CodeCatalyst el nombre del espacio.

    • proj_nameSustitúyalo por CodeCatalyst el nombre de tu proyecto.

    • repo_nameSustitúyalo por el nombre CodeCatalyst del repositorio de paquetes.

    maven {
  name = 'spaceName'
  url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
  credentials(PasswordCredentials)
}

  10. (Opcional) Para usar el repositorio de CodeCatalyst paquetes como la única fuente para las dependencias de su proyecto, elimine del archivo cualquier otra sección de los build.gradle repositorios. Si tiene más de un repositorio, Gradle busca las dependencias en cada repositorio en el orden en que aparecen en la lista.

Obteniendo complementos de CodeCatalyst

De forma predeterminada, Gradle resolverá los complementos desde el portal de complementos de Gradle público. Los siguientes pasos configuran tu proyecto de Gradle para resolver los complementos del repositorio de CodeCatalyst paquetes.

Para usar Gradle para buscar complementos de tu repositorio de paquetes CodeCatalyst

  1. Abre la CodeCatalyst consola en https://codecatalyst.aws/.

  2. Vaya a su proyecto.

  3. En el panel de navegación, elija Paquetes.

  4. Elija su repositorio de paquetes de la lista de repositorios de paquetes.

  5. Seleccione Establecer conexión con el repositorio.

  6. En el cuadro de diálogo Establecer conexión con el repositorio, seleccione Gradle en la lista de clientes del administrador de paquetes.

  7. Necesitarás un token de acceso personal (PAT) para autenticar a Gradle. CodeCatalyst Si ya tiene uno, puede utilizarlo. De lo contrario, puede crear uno aquí.

    1. Seleccione Crear token.

    2. Seleccione Copiar para copiar el PAT.

      aviso

      Después de cerrar el cuadro de diálogo, no podrá volver a ver ni copiar el PAT.

  8. Actualice el archivo de propiedades de Gradle con sus credenciales de acceso. usernameSustitúyelo por su CodeCatalyst nombre de usuario y PAT sustitúyalo por su token de acceso CodeCatalyst personal. Puedes usar cualquier valor durante spaceUsername y spacePassword siempre que utilices los mismos valores en los siguientes pasos.

    spaceUsername=username
spacePassword=PAT

  9. Agregue un bloque pluginManagement a su archivo settings.gradle. El bloque pluginManagement debe aparecer antes de cualquier otra declaración en settings.gradle. Reemplace los siguientes valores.

    nota

    Si va a copiar las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.

    • spaceNameSustitúyalo por el valor del nombre utilizado en el paso anterior.

    • space_nameSustitúyalo por CodeCatalyst el nombre de tu espacio.

    • proj_nameSustitúyalo por CodeCatalyst el nombre de tu proyecto.

    • repo_nameSustitúyalo por el nombre CodeCatalyst del repositorio de paquetes.

    pluginManagement {
    repositories {
        maven {
            name = 'spaceName'
            url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
            credentials(PasswordCredentials)
        }
    }
}

    Esto garantizará que Gradle resuelva los complementos del repositorio especificado. El repositorio debe tener una conexión ascendente configurada con el portal de complementos de Gradle (gradle-plugins-store) para que los complementos de Gradle que se requieren con más frecuencia estén disponibles en la compilación. Para obtener más información, consulte la documentación de Gradle.

Obtención de paquetes de repositorios de paquetes externos mediante CodeCatalyst

Puede instalar paquetes Maven desde repositorios públicos a través de un CodeCatalyst repositorio configurándolo con una conexión ascendente a la puerta de enlace que representa el repositorio de la puerta de enlace. Los paquetes instalados desde el repositorio de la puerta de enlace se ingieren y almacenan en su repositorio. CodeCatalyst

CodeCatalyst admite los siguientes repositorios públicos de paquetes de Maven.

  • maven-central-gateway

  • google-android-gateway

  • gradle-plugins-gateway

  • commonsware-gateway

Instalación de paquetes desde repositorios públicos de paquetes de Maven

  1. Si aún no lo has hecho, configura Gradle con tu repositorio de CodeCatalyst paquetes siguiendo los pasos que se indican en o. Obteniendo dependencias de CodeCatalyst Obteniendo complementos de CodeCatalyst

  2. Compruebe que su repositorio haya añadido el repositorio de puerta de enlace desde el que desea hacer la instalación como conexión ascendente. Para ello, siga las instrucciones en Adición de un repositorio ascendente y seleccione el repositorio de paquetes público que quiera añadir como ascendente.

Para obtener más información sobre cómo solicitar paquetes desde repositorios ascendentes, consulte Solicitar una versión de paquete con repositorios ascendentes.

Publicar paquetes en CodeCatalyst

En esta sección, se describe cómo publicar una biblioteca Java creada con Gradle Groovy en un repositorio. CodeCatalyst

Para usar Gradle Groovy para publicar paquetes en un repositorio de paquetes CodeCatalyst

  1. Abre la CodeCatalyst consola en https://codecatalyst.aws/.

  2. En la página de información general del proyecto, seleccione Paquetes.

  3. Elija su repositorio de paquetes de la lista de repositorios de paquetes.

  4. Seleccione Establecer conexión con el repositorio.

  5. En el cuadro de diálogo Establecer conexión con el repositorio, seleccione Gradle Groovy en la lista de clientes de administrador de paquetes.

  6. Necesitarás un token de acceso personal (PAT) para autenticar a Gradle. CodeCatalyst Si ya tiene uno, puede utilizarlo. De lo contrario, puede crear uno aquí.

    1. Seleccione Crear token.

    2. Seleccione Copiar para copiar el PAT.

      aviso

      Después de cerrar el cuadro de diálogo, no podrá volver a ver ni copiar el PAT.

  7. Actualice el archivo de propiedades de Gradle con sus credenciales de acceso. usernameSustitúyelo por su CodeCatalyst nombre de usuario y PAT sustitúyalo por su token de acceso CodeCatalyst personal. Puedes usar cualquier valor durante spaceUsername y spacePassword siempre que utilices los mismos valores en los siguientes pasos.

    spaceUsername=username
spacePassword=PAT

  8. Primero, añada el complemento maven-publish a la sección plugins del archivo build.gradle del proyecto.

    plugins {
    id 'java-library'
    id 'maven-publish'
}

  9. A continuación, añada una sección publishing al archivo build.gradle del proyecto. Reemplace los siguientes valores.

    nota

    Si va a copiar las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.

    • space_nameSustitúyalo por CodeCatalyst el nombre del espacio.

    • proj_nameSustitúyalo por CodeCatalyst el nombre de tu proyecto.

    • repo_nameSustitúyalo por el nombre CodeCatalyst del repositorio de paquetes.

    publishing {
    publications {
        mavenJava(MavenPublication) {
            groupId = 'group-id'
            artifactId = 'artifact-id'
            version = 'version'
            from components.java
        }
    }
    repositories {
        maven {
            name = 'spaceName'
            url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
            credentials(PasswordCredentials)
        }
    }
}

    El maven-publish genera un archivo POM basado en el groupId, artifactId y version especificado en la sección publishing.

  10. Una vez completados estos cambios en build.gradle, ejecute el siguiente comando para crear el proyecto y subirlo al repositorio.

    ./gradlew publish

  11. Navegue hasta el repositorio de paquetes en la CodeCatalyst consola para comprobar que el paquete se publicó correctamente. Debería ver el paquete en la lista Paquetes del repositorio de paquetes.

Para obtener más información, consulte estos temas en el sitio web de Gradle:

Ejecución de una compilación de Gradle en IntelliJ IDEA

Puede ejecutar una compilación de Gradle en IntelliJ IDEA que extraiga dependencias de. CodeCatalyst Para autenticar a Gradle CodeCatalyst, debes usar un token de acceso personal (PAT). Puedes almacenar tu CodeCatalyst PAT en un archivo independiente gradle.properties o en otro que elijas.

Método 1: colocar el PAT en gradle.properties

Use este método si no está utilizando el archivo gradle.properties y puede sobrescribir el contenido con el PAT. Si está utilizando gradle.properties, puede modificar este método para añadir el PAT en lugar de sobrescribir el contenido del archivo.

nota

El ejemplo muestra el archivo gradle.properties ubicado en GRADLE_USER_HOME.

En primer lugar, cree un PAT si no tiene uno.

Creación de un token de acceso personal (PAT)

  1. En la barra de menú superior, elija su insignia de perfil y, a continuación, elija Mi configuración.

    sugerencia

    También puede encontrar su perfil de usuario en la página de miembros de un proyecto o espacio, seleccionando el nombre en la lista de miembros.

  2. En Nombre de PAT, introduzca un nombre descriptivo para el PAT.

  3. En Fecha de vencimiento, mantenga la fecha predeterminada o elija el icono del calendario para seleccionar una fecha personalizada. La fecha de vencimiento predeterminada es de 1 año a partir de la fecha actual.

  4. Seleccione Crear.

    También puede crear este token si elige Clonar repositorio para un repositorio de código fuente.

  5. Guarde el secreto del PAT en un lugar seguro.

    importante

    El secreto del PAT solo se muestra una vez. No podrá recuperarlo después de cerrar la ventana.

A continuación, actualice el archivo build.gradle con el siguiente fragmento:

repositories {
    maven {
        name = 'spaceName'
        url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
        credentials(PasswordCredentials)
    }
}

Método 2: colocar el PAT en un archivo independiente

Utilice este método si no desea modificar el archivo gradle.properties.

En primer lugar, cree un PAT si no tiene uno.

Creación de un token de acceso personal (PAT)

  1. En la barra de menú superior, elija su insignia de perfil y, a continuación, elija Mi configuración.

    sugerencia

    También puede encontrar su perfil de usuario en la página de miembros de un proyecto o espacio, seleccionando el nombre en la lista de miembros.

  2. En Nombre de PAT, introduzca un nombre descriptivo para el PAT.

  3. En Fecha de vencimiento, mantenga la fecha predeterminada o elija el icono del calendario para seleccionar una fecha personalizada. La fecha de vencimiento predeterminada es de 1 año a partir de la fecha actual.

  4. Seleccione Crear.

    También puede crear este token si elige Clonar repositorio para un repositorio de código fuente.

  5. Guarde el secreto del PAT en un lugar seguro.

    importante

    El secreto del PAT solo se muestra una vez. No podrá recuperarlo después de cerrar la ventana.

Colocación del PAT en un archivo independiente

  1. Actualice el archivo build.gradle con el siguiente fragmento: Sustituya space_name y repo_name por su nombre CodeCatalyst de usuario, nombre del espacio, nombre del proyecto y nombre del repositorio de paquetes. proj_name

    def props = new Properties()
file("fileName").withInputStream { props.load(it) }
                  
repositories {
        maven {
            name = 'spaceName'
            url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
            credentials(PasswordCredentials)
        }
    }
}

  2. Escriba el PAT en el archivo especificado en su archivo build.gradle:

    echo "codecatalystArtifactsToken=PAT" > fileName