Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).

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
<a name="packages-maven-gradle"></a>

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 

**Contents**
+ [Obteniendo dependencias de CodeCatalyst](#gradle-fetch-dependencies)
+ [Obteniendo complementos de CodeCatalyst](#gradle-fetch-plugins)
+ [Obtención de paquetes de repositorios de paquetes externos mediante CodeCatalyst](#gradle-install-public)
+ [Publicar paquetes en CodeCatalyst](#gradle-publish-packages)
+ [Ejecución de una compilación de Gradle en IntelliJ IDEA](#gradle-intellij)
  + [Método 1: colocar el PAT en `gradle.properties`](#gradle-intellij-gradle-properties)
  + [Método 2: colocar el PAT en un archivo independiente](#gradle-intellij-file)

## Obteniendo dependencias de CodeCatalyst
<a name="gradle-fetch-dependencies"></a>

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 ](https://codecatalyst.aws/)

1. Vaya a su proyecto.

1. En el panel de navegación, elija **Paquetes**.

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

1. Seleccione **Establecer conexión con el repositorio**.

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

1. 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**.

   1. 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.

1. Actualice el archivo de propiedades de Gradle con sus credenciales de acceso. {{username}}Sustitú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}}
   ```

1. 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\_name}}Sustitúyalo por CodeCatalyst el nombre del espacio.
   + {{proj\_name}}Sustitúyalo por CodeCatalyst el nombre de tu proyecto.
   + {{repo\_name}}Sustitú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)
   }
   ```

1. (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
<a name="gradle-fetch-plugins"></a>

De forma predeterminada, Gradle resolverá los complementos desde el [portal de complementos de Gradle](https://plugins.gradle.org/) 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/.](https://codecatalyst.aws/)

1. Vaya a su proyecto.

1. En el panel de navegación, elija **Paquetes**.

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

1. Seleccione **Establecer conexión con el repositorio**.

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

1. 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**.

   1. 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.

1. Actualice el archivo de propiedades de Gradle con sus credenciales de acceso. {{username}}Sustitú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}}
   ```

1. 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.
   + {{spaceName}}Sustitúyalo por el valor del nombre utilizado en el paso anterior.
   + {{space\_name}}Sustitúyalo por CodeCatalyst el nombre de tu espacio.
   + {{proj\_name}}Sustitúyalo por CodeCatalyst el nombre de tu proyecto.
   + {{repo\_name}}Sustitú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](https://docs.gradle.org/current/userguide/plugins.html#sec:custom_plugin_repositories).

## Obtención de paquetes de repositorios de paquetes externos mediante CodeCatalyst
<a name="gradle-install-public"></a>

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](#gradle-fetch-dependencies) [Obteniendo complementos de CodeCatalyst](#gradle-fetch-plugins) 

1. 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](packages-upstream-repositories-add.md) 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](packages-upstream-repositories-request.md).

## Publicar paquetes en CodeCatalyst
<a name="gradle-publish-packages"></a>

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/.](https://codecatalyst.aws/)

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

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

1. Seleccione **Establecer conexión con el repositorio**.

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

1. 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**.

   1. 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.

1. Actualice el archivo de propiedades de Gradle con sus credenciales de acceso. {{username}}Sustitú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}}
   ```

1. 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'
   }
   ```

1. 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\_name}}Sustitúyalo por CodeCatalyst el nombre del espacio.
   + {{proj\_name}}Sustitúyalo por CodeCatalyst el nombre de tu proyecto.
   + {{repo\_name}}Sustitú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 complemento `maven-publish` genera un archivo POM basado en los valores `groupId`, `artifactId` y `version` especificados en la sección `publishing`.

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

   ```
   ./gradlew publish
   ```

1. 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:
+  [Building Java Libraries](https://guides.gradle.org/building-java-libraries/) 
+  [Publishing a project as a module](https://docs.gradle.org/current/userguide/publishing_setup.html) 

## Ejecución de una compilación de Gradle en IntelliJ IDEA
<a name="gradle-intellij"></a>

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`
<a name="gradle-intellij-gradle-properties"></a>

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.

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

1. 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.

1. Seleccione **Crear**.

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

1. 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
<a name="gradle-intellij-file"></a>

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.

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

1. 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.

1. Seleccione **Crear**.

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

1. 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)
           }
       }
   }
   ```

1. Escriba el PAT en el archivo especificado en su archivo `build.gradle`:

   ```
   echo "codecatalystArtifactsToken={{PAT}}" > {{fileName}}
   ```