Configuración y uso de Gradle Groovy - Amazon CodeCatalyst

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 () para la autenticación. PAT 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 Packages (Paquetes).

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

  5. Selecciona Conectar al repositorio.

  6. En el cuadro de diálogo Conectar al repositorio, selecciona Gradle Groovy de la lista de clientes del administrador de paquetes.

  7. Necesitarás un token de acceso personal (PAT) para autenticar a Gradle Groovy. CodeCatalyst Si ya tienes uno, puedes usarlo. Si no, puedes crear uno aquí.

    1. Elige Crear token.

    2. Selecciona Copiar para copiar tuPAT.

      aviso

      No podrá PAT volver a verlo ni copiarlo después de cerrar el cuadro de diálogo.

  8. Actualiza tu archivo de propiedades de Gradle con tus credenciales de acceso. Reemplazar username con tu CodeCatalyst nombre de usuario y reemplázalo PAT con tu token de acceso CodeCatalyst personal. Puede utilizar cualquier valor para spaceUsername y spacePassword siempre y cuando utilice los mismos valores en los pasos siguientes.

    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 Sustituye los siguientes valores. Puede utilizar cualquier valor para spaceName siempre y cuando utilice los mismos valores en los pasos siguientes.

    nota

    Si está copiando las instrucciones de la consola, los siguientes valores deberían actualizarse automáticamente y no cambiarse.

    • Reemplazar space_name con el nombre de su CodeCatalyst espacio.

    • Reemplazar proj_name con el nombre de tu CodeCatalyst proyecto.

    • Reemplazar repo_name con 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 tu proyecto, elimina 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 Packages (Paquetes).

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

  5. Selecciona Conectar al repositorio.

  6. En el cuadro de diálogo Conectar al repositorio, selecciona Gradle de la lista de clientes del administrador de paquetes.

  7. Necesitarás un token de acceso personal (PAT) para autenticar a Gradle. CodeCatalyst Si ya tienes uno, puedes usarlo. Si no, puedes crear uno aquí.

    1. Elige Crear token.

    2. Selecciona Copiar para copiar tuPAT.

      aviso

      No podrá PAT volver a verlo ni copiarlo después de cerrar el cuadro de diálogo.

  8. Actualiza tu archivo de propiedades de Gradle con tus credenciales de acceso. Reemplazar username con tu CodeCatalyst nombre de usuario y reemplázalo PAT con tu token de acceso CodeCatalyst personal. Puede utilizar cualquier valor para spaceUsername y spacePassword siempre y cuando utilice los mismos valores en los pasos siguientes.

    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. Sustituya los valores siguientes.

    nota

    Si está copiando las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.

    • Reemplazar spaceName con el nombre y el valor utilizado en el paso anterior.

    • Reemplazar space_name con el nombre de tu CodeCatalyst espacio.

    • Reemplazar proj_name con el nombre de tu CodeCatalyst proyecto.

    • Reemplazar repo_name con 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.

Obtiene 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

Para instalar paquetes desde repositorios de paquetes públicos 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. Asegúrate de que tu repositorio haya agregado el repositorio de puerta de enlace desde el que deseas realizar la instalación como conexión ascendente. Para ello, sigue las instrucciones que se indican en el repositorio de paquetes público que quieres añadir como repositorio previo Añadir un repositorio ascendente y elige el repositorio de paquetes público.

Para obtener más información sobre la solicitud de paquetes desde los repositorios originales, 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 de su proyecto, elija Paquetes.

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

  4. Selecciona Conectar al repositorio.

  5. En el cuadro de diálogo Conectar al repositorio, selecciona Gradle Groovy de la lista de clientes del administrador de paquetes.

  6. Necesitarás un token de acceso personal (PAT) para autenticar a Gradle. CodeCatalyst Si ya tienes uno, puedes usarlo. Si no, puedes crear uno aquí.

    1. Elige Crear token.

    2. Selecciona Copiar para copiar tuPAT.

      aviso

      No podrá PAT volver a verlo ni copiarlo después de cerrar el cuadro de diálogo.

  7. Actualiza tu archivo de propiedades de Gradle con tus credenciales de acceso. Reemplazar username con tu CodeCatalyst nombre de usuario y reemplázalo PAT con tu token de acceso CodeCatalyst personal. Puede utilizar cualquier valor para spaceUsername y spacePassword siempre y cuando utilice los mismos valores en los pasos siguientes.

    spaceUsername=username spacePassword=PAT
  8. Añade el maven-publish plugin a la plugins sección del build.gradle archivo 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. Sustituya los siguientes valores.

    nota

    Si está copiando las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.

    • Reemplazar space_name con el nombre de su CodeCatalyst espacio.

    • Reemplazar proj_name con el nombre de tu CodeCatalyst proyecto.

    • Reemplazar repo_name con 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 complemento genera un POM archivo basado en groupIdartifactId, y version especificado en la publishing sección.

  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ías ver el paquete en la lista de paquetes de tu 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

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

Método 1: coloca PAT el gradle.properties

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

nota

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

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

Para crear 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 puedes encontrar tu perfil de usuario si vas a la página de miembros de un proyecto o espacio y eliges tu nombre en la lista de miembros.

  2. En PATnombre, introduce un nombre descriptivo para tuPAT.

  3. En Fecha de caducidad, deje la fecha predeterminada o elija el icono del calendario para seleccionar una fecha personalizada. La fecha de caducidad se establece de forma predeterminada en un 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 origen.

  5. Guarda el PAT secreto en un lugar seguro.

    importante

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

A continuación, actualice build.gradle el archivo 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: coloca el PAT en un archivo separado

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

Primero, crea un PAT si no tienes uno.

Para crear 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 puedes encontrar tu perfil de usuario si vas a la página de miembros de un proyecto o espacio y eliges tu nombre en la lista de miembros.

  2. En PATnombre, introduce un nombre descriptivo para tuPAT.

  3. En Fecha de caducidad, deje la fecha predeterminada o elija el icono del calendario para seleccionar una fecha personalizada. La fecha de caducidad se establece de forma predeterminada en un 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 origen.

  5. Guarda el PAT secreto en un lugar seguro.

    importante

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

Para poner el suyo PAT en un archivo separado
  1. Actualiza tu build.gradle archivo con el siguiente fragmento. Reemplazar space_name, proj_name, y repo_name con su nombre CodeCatalyst de usuario, nombre del espacio, nombre del proyecto y nombre del repositorio de paquetes.

    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 su PAT nombre en el archivo que se especificó en su build.gradle archivo:

    echo "codecatalystArtifactsToken=PAT" > fileName