A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Configuração e uso do Gradle Groovy
Para usar o Gradle Groovy com CodeCatalyst, você deve conectar o Gradle Groovy ao seu repositório de pacotes e fornecer um token de acesso pessoal (PAT) para autenticação. Você pode ver as instruções para conectar o Gradle Groovy ao seu repositório de pacotes no console. CodeCatalyst
**Contents**
+ [Buscando dependências de CodeCatalyst](#gradle-fetch-dependencies)
+ [Buscando plug-ins de CodeCatalyst](#gradle-fetch-plugins)
+ [Buscando pacotes de repositórios de pacotes externos por meio de CodeCatalyst](#gradle-install-public)
+ [Publicando pacotes em CodeCatalyst](#gradle-publish-packages)
+ [Execução de uma compilação do Gradle no IntelliJ IDEA](#gradle-intellij)
+ [Método 1: colocar o PAT em `gradle.properties`](#gradle-intellij-gradle-properties)
+ [Método 2: colocar o PAT em um arquivo separado](#gradle-intellij-file)
## Buscando dependências de CodeCatalyst
As instruções a seguir explicam como configurar o Gradle Groovy para buscar dependências no seu repositório de pacotes. CodeCatalyst
**Para usar o Gradle Groovy para buscar dependências do seu repositório de pacotes CodeCatalyst**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto.
1. No painel de navegação, selecione **Packages (pacotes)**.
1. Escolha seu repositório de pacotes na lista de repositórios de pacotes.
1. Selecione **Conectar ao repositório**.
1. Na caixa de diálogo **Conectar ao repositório**, selecione **Gradle Groovy** na lista de clientes do gerenciador de pacotes.
1. Você precisará de um token de acesso pessoal (PAT) para autenticar o Gradle Groovy. CodeCatalyst Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Selecione **Criar token**.
1. Para copiar o PAT, selecione **Copiar**.
**Atenção**
Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.
1. Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. {{username}}Substitua pelo seu CodeCatalyst nome de usuário e {{PAT}} substitua pelo seu token de acesso CodeCatalyst pessoal. Você pode usar qualquer valor durante {{spaceUsername}} e {{spacePassword}} desde que use os mesmos valores nas etapas a seguir.
```
{{spaceUsername}}={{username}}
{{spacePassword}}={{PAT}}
```
1. Para buscar dependências CodeCatalyst em uma compilação do Gradle, copie o trecho de `maven` código e adicione-o à `repositories` seção no arquivo do seu projeto. `build.gradle` Substitua os valores a seguir. Você pode usar qualquer valor{{spaceName}}, desde que use os mesmos valores nas etapas a seguir.
**nota**
Se estiver copiando as instruções do console, os valores a seguir devem ser atualizados para você e não devem ser alterados.
+ {{space\_name}}Substitua pelo nome do seu CodeCatalyst espaço.
+ {{proj\_name}}Substitua pelo nome CodeCatalyst do seu projeto.
+ {{repo\_name}}Substitua pelo nome CodeCatalyst do repositório do pacote.
```
maven {
name = '{{spaceName}}'
url = uri('https://packages.{{region}}.codecatalyst.aws/maven/{{space_name}}/{{proj_name}}/{{repo_name}}/')
credentials(PasswordCredentials)
}
```
1. (Opcional) Para usar o repositório de CodeCatalyst pacotes como a única fonte para as dependências do seu projeto, remova todas as outras seções nos repositórios do arquivo. `build.gradle` Se você tiver mais de um repositório, o Gradle pesquisará dependências em cada repositório, na ordem em que estão listadas.
## Buscando plug-ins de CodeCatalyst
Por padrão, o Gradle resolverá plug-ins do [Portal de plug-ins do Gradle](https://plugins.gradle.org/) público. As etapas a seguir configuram seu projeto Gradle para resolver plug-ins do seu repositório de CodeCatalyst pacotes.
**Para usar o Gradle para buscar plug-ins do seu repositório de pacotes CodeCatalyst**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto.
1. No painel de navegação, selecione **Packages (pacotes)**.
1. Escolha seu repositório de pacotes na lista de repositórios de pacotes.
1. Selecione **Conectar ao repositório**.
1. Na caixa de diálogo **Conectar ao repositório**, selecione **Gradle** na lista de clientes do gerenciador de pacotes.
1. Você precisará de um token de acesso pessoal (PAT) para autenticar o Gradle. CodeCatalyst Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Selecione **Criar token**.
1. Para copiar o PAT, selecione **Copiar**.
**Atenção**
Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.
1. Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. {{username}}Substitua pelo seu CodeCatalyst nome de usuário e {{PAT}} substitua pelo seu token de acesso CodeCatalyst pessoal. Você pode usar qualquer valor durante {{spaceUsername}} e {{spacePassword}} desde que use os mesmos valores nas etapas a seguir.
```
{{spaceUsername}}={{username}}
{{spacePassword}}={{PAT}}
```
1. Adicione um bloco `pluginManagement` ao seu arquivo `settings.gradle`. O bloco `pluginManagement` deve aparecer antes de qualquer outra declaração em `settings.gradle`. Substitua os valores a seguir.
**nota**
Se estiver copiando as instruções do console, os valores a seguir devem ser atualizados para você e não devem ser alterados.
+ {{spaceName}}Substitua pelo valor do nome usado na etapa anterior.
+ {{space\_name}}Substitua pelo nome do seu CodeCatalyst espaço.
+ {{proj\_name}}Substitua pelo nome CodeCatalyst do seu projeto.
+ {{repo\_name}}Substitua pelo nome CodeCatalyst do repositório do pacote.
```
pluginManagement {
repositories {
maven {
name = '{{spaceName}}'
url = uri('https://packages.{{region}}.codecatalyst.aws/maven/{{space_name}}/{{proj_name}}/{{repo_name}}/')
credentials(PasswordCredentials)
}
}
}
```
Isso garantirá que o Gradle resolva plug-ins do repositório especificado. O repositório deve ter uma conexão upstream configurada com o Portal de plug-ins do Gradle (por exemplo, `gradle-plugins-store`) para que os plug-ins do Gradle normalmente exigidos estejam disponíveis para a compilação. Para obter mais informações, consulte a [documentação do Gradle](https://docs.gradle.org/current/userguide/plugins.html#sec:custom_plugin_repositories).
## Buscando pacotes de repositórios de pacotes externos por meio de CodeCatalyst
Você pode instalar pacotes Maven de repositórios públicos por meio de um CodeCatalyst repositório configurando-o com uma conexão upstream com o gateway que representa o repositório do gateway. Os pacotes instalados do repositório do gateway são ingeridos e armazenados no seu CodeCatalyst repositório.
CodeCatalyst suporta os seguintes repositórios públicos de pacotes Maven.
+ maven-central-gateway
+ google-android-gateway
+ gradle-plugins-gateway
+ commonsware-gateway
**Para instalar pacotes de repositórios de pacotes públicos do Maven**
1. Se você ainda não o fez, configure o Gradle com seu repositório de CodeCatalyst pacotes seguindo as etapas em [Buscando dependências de CodeCatalyst](#gradle-fetch-dependencies) ou. [Buscando plug-ins de CodeCatalyst](#gradle-fetch-plugins)
1. Certifique-se de que seu repositório tenha adicionado o repositório de gateway a partir do qual você deseja instalar como uma conexão upstream. Você pode fazer isso seguindo as instruções em [Adição de um repositório upstream](packages-upstream-repositories-add.md) e escolhendo o repositório público de pacotes que deseja adicionar como upstream.
Para ter mais informações sobre como solicitar pacotes de repositórios upstream, consulte [Solicitar uma versão do pacote com repositórios upstream](packages-upstream-repositories-request.md).
## Publicando pacotes em CodeCatalyst
Esta seção descreve como publicar uma biblioteca Java criada com o Gradle Groovy em um repositório. CodeCatalyst
**Para usar o Gradle Groovy para publicar pacotes em um repositório de pacotes CodeCatalyst**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Na página de visão geral do projeto, selecione **Pacotes**.
1. Escolha seu repositório de pacotes na lista de repositórios de pacotes.
1. Selecione **Conectar ao repositório**.
1. Na caixa de diálogo **Conectar ao repositório**, selecione **Gradle Groovy** na lista de clientes do gerenciador de pacotes.
1. Você precisará de um token de acesso pessoal (PAT) para autenticar o Gradle. CodeCatalyst Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Selecione **Criar token**.
1. Para copiar o PAT, selecione **Copiar**.
**Atenção**
Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.
1. Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. {{username}}Substitua pelo seu CodeCatalyst nome de usuário e {{PAT}} substitua pelo seu token de acesso CodeCatalyst pessoal. Você pode usar qualquer valor durante {{spaceUsername}} e {{spacePassword}} desde que use os mesmos valores nas etapas a seguir.
```
{{spaceUsername}}={{username}}
{{spacePassword}}={{PAT}}
```
1. Adicione o plug-in `maven-publish` à seção `plugins` do arquivo `build.gradle` do projeto.
```
plugins {
id 'java-library'
id 'maven-publish'
}
```
1. Em seguida, adicione uma seção `publishing` ao arquivo `build.gradle` do projeto. Substitua os valores a seguir.
**nota**
Se estiver copiando as instruções do console, os valores a seguir devem ser atualizados para você e não devem ser alterados.
+ {{space\_name}}Substitua pelo nome do seu CodeCatalyst espaço.
+ {{proj\_name}}Substitua pelo nome CodeCatalyst do seu projeto.
+ {{repo\_name}}Substitua pelo nome CodeCatalyst do repositório do pacote.
```
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)
}
}
}
```
O plug-in `maven-publish` gera um arquivo POM com base no `groupId`, `artifactId` e `version` especificados na seção `publishing`.
1. Depois que essas alterações em `build.gradle` forem concluídas, execute o comando a seguir para criar o projeto e carregá-lo no repositório.
```
./gradlew publish
```
1. Navegue até o repositório de pacotes no CodeCatalyst console para verificar se o pacote foi publicado com sucesso. Você deve ver o pacote na lista **Pacotes** do seu repositório de pacotes.
Para obter mais informações, consulte os tópicos a seguir no site do Gradle:
+ [Criar bibliotecas Java](https://guides.gradle.org/building-java-libraries/)
+ [Publicar um projeto como um módulo](https://docs.gradle.org/current/userguide/publishing_setup.html)
## Execução de uma compilação do Gradle no IntelliJ IDEA
Você pode executar uma compilação do Gradle no IntelliJ IDEA que extrai dependências de. CodeCatalyst Para autenticar o Gradle com CodeCatalyst, você deve usar um token de acesso pessoal (PAT). Você pode armazenar seu CodeCatalyst PAT em `gradle.properties` um arquivo separado de sua escolha.
### Método 1: colocar o PAT em `gradle.properties`
Use esse método se você não estiver usando o arquivo `gradle.properties` e puder substituir o conteúdo pelo PAT. Se você estiver usando `gradle.properties`, poderá modificar esse método para adicionar o PAT em vez de substituir o conteúdo do arquivo.
**nota**
O exemplo mostra o arquivo `gradle.properties` localizado em `GRADLE_USER_HOME`.
Primeiro, crie um PAT se você não tiver um.
**Para criar um token de acesso pessoal (PAT)**
1. Na barra de menu superior, escolha seu selo de perfil e escolha **Minhas configurações**.
**dica**
Você também pode encontrar seu perfil de usuário acessando a página de membros de um projeto ou espaço e escolhendo seu nome na lista de membros.
1. Em **Nome do PAT**, insira um nome descritivo para o seu PAT.
1. Em **Data de expiração**, mantenha a data padrão ou escolha o ícone do calendário para selecionar uma data personalizada. A data de vencimento é padronizada para um ano a contar da data atual.
1. Escolha **Criar**.
Você também pode criar esse token ao escolher **Clonar repositório** para um repositório de origem.
1. Salve o segredo do PAT em um local seguro.
**Importante**
O segredo do PAT só é exibido uma vez. Não é possível recuperá-lo depois de fechar a janela.
Depois, atualize o arquivo `build.gradle` com o seguinte trecho:
```
repositories {
maven {
name = '{{spaceName}}'
url = uri('https://packages.{{region}}.codecatalyst.aws/maven/{{space_name}}/{{proj_name}}/{{repo_name}}/')
credentials(PasswordCredentials)
}
}
```
### Método 2: colocar o PAT em um arquivo separado
Use esse método se você não quiser modificar o arquivo `gradle.properties`.
Primeiro, crie um PAT se você não tiver um.
**Para criar um token de acesso pessoal (PAT)**
1. Na barra de menu superior, escolha seu selo de perfil e escolha **Minhas configurações**.
**dica**
Você também pode encontrar seu perfil de usuário acessando a página de membros de um projeto ou espaço e escolhendo seu nome na lista de membros.
1. Em **Nome do PAT**, insira um nome descritivo para o seu PAT.
1. Em **Data de expiração**, mantenha a data padrão ou escolha o ícone do calendário para selecionar uma data personalizada. A data de vencimento é padronizada para um ano a contar da data atual.
1. Escolha **Criar**.
Você também pode criar esse token ao escolher **Clonar repositório** para um repositório de origem.
1. Salve o segredo do PAT em um local seguro.
**Importante**
O segredo do PAT só é exibido uma vez. Não é possível recuperá-lo depois de fechar a janela.
**Para colocar seu PAT em um arquivo separado**
1. Atualize o arquivo `build.gradle` com o seguinte trecho. Substitua {{space\_name}}{{proj\_name}}, e {{repo\_name}} por seu nome de CodeCatalyst usuário, nome do espaço, nome do projeto e nome do repositório do pacote.
```
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. Grave o PAT no arquivo que foi especificado em seu arquivo `build.gradle`:
```
echo "codecatalystArtifactsToken={{PAT}}" > {{fileName}}
```