Busca de dependências do CodeCatalyst Busca de plug-ins do CodeCatalyst Busca de pacotes de repositórios de pacotes externos por meio do CodeCatalyst Publicar pacotes no CodeCatalyst Execução de uma compilação do Gradle no IntelliJ IDEA

Configuração e uso do Gradle Groovy

Para usar o Gradle Groovy com o CodeCatalyst, você deve conectar o Gradle Groovy ao 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 repositório de pacotes no console do CodeCatalyst.

Sumário

Busca de dependências do CodeCatalyst

As instruções a seguir explicam como configurar o Gradle Groovy para buscar dependências no repositório de pacotes do CodeCatalyst.

Para usar o Gradle Groovy para buscar dependências no repositório de pacotes do CodeCatalyst

Abra o console do CodeCatalyst em https://codecatalyst.aws/.
Navegue até o projeto.
No painel de navegação, selecione Packages (pacotes).
Escolha seu repositório de pacotes na lista de repositórios de pacotes.
Selecione Conectar ao repositório.
Na caixa de diálogo Conectar ao repositório, selecione Gradle Groovy na lista de clientes do gerenciador de pacotes.
Você precisará de um token de acesso pessoal (PAT) para a autenticação do Gradle Groovy com o CodeCatalyst. Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Selecione Criar token.
2. 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.
Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. Substitua o nome de usuário pelo nome de usuário do CodeCatalyst e substitua o PAT pelo token de acesso pessoal do CodeCatalyst. Você pode usar qualquer valor para spaceUsername e spacePassword, desde que use os mesmos valores nas etapas a seguir.
```
spaceUsername=username
spacePassword=PAT
```
Para buscar dependências do CodeCatalyst em uma compilação do Gradle, copie o snippet de código maven e adicione-o à seção repositories no arquivo build.gradle do seu projeto. Substitua os valores a seguir. Você pode usar qualquer valor para 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.
- Substitua space_name pelo nome do espaço do CodeCatalyst.
- Substitua proj_name pelo nome do projeto do CodeCatalyst.
- Substitua repo_name pelo nome do seu repositório de pacotes do CodeCatalyst.
```
maven {
  name = 'spaceName'
  url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
  credentials(PasswordCredentials)
}
```
(Opcional) Para usar o repositório de pacotes do CodeCatalyst 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.

Busca de plug-ins do CodeCatalyst

Por padrão, o Gradle resolverá plug-ins do Portal de plug-ins do Gradle público. As etapas a seguir configuram o projeto do Gradle para resolver plug-ins do repositório de pacotes do CodeCatalyst.

Para usar o Gradle para buscar plug-ins do seu repositório de pacotes do CodeCatalyst

Abra o console do CodeCatalyst em https://codecatalyst.aws/.
Navegue até o projeto.
No painel de navegação, selecione Packages (pacotes).
Escolha seu repositório de pacotes na lista de repositórios de pacotes.
Selecione Conectar ao repositório.
Na caixa de diálogo Conectar ao repositório, selecione Gradle na lista de clientes do gerenciador de pacotes.
Você precisará de um token de acesso pessoal (PAT) para a autenticação do Gradle com o CodeCatalyst. Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Selecione Criar token.
2. 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.
Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. Substitua o nome de usuário pelo nome de usuário do CodeCatalyst e substitua o PAT pelo token de acesso pessoal do CodeCatalyst. Você pode usar qualquer valor para spaceUsername e spacePassword, desde que use os mesmos valores nas etapas a seguir.
```
spaceUsername=username
spacePassword=PAT
```
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.
- Substitua spaceName pelo valor do nome usado na etapa anterior.
- Substitua space_name pelo nome do espaço do CodeCatalyst.
- Substitua proj_name pelo nome do projeto do CodeCatalyst.
- Substitua repo_name pelo nome do seu repositório de pacotes do CodeCatalyst.
```
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.

Busca de pacotes de repositórios de pacotes externos por meio do CodeCatalyst

Você pode instalar pacotes do Maven de repositórios públicos por meio de um repositório do CodeCatalyst configurando-o com uma conexão upstream com o gateway que representa o repositório do gateway. Os pacotes instalados no repositório de gateway são ingeridos e armazenados no repositório do CodeCatalyst.

O CodeCatalyst suporta os seguintes repositórios de pacotes públicos do Maven.

maven-central-gateway
google-android-gateway
gradle-plugins-gateway
commonsware-gateway

Para instalar pacotes de repositórios de pacotes públicos do Maven

Se você ainda não tiver feito isso, configure o Gradle com seu repositório de pacotes do CodeCatalyst seguindo as etapas em Busca de dependências do CodeCatalyst ou Busca de plug-ins do CodeCatalyst.
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 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.

Publicar pacotes no CodeCatalyst

Esta seção descreve como publicar uma biblioteca Java criada com o Gradle Groovy em um repositório do CodeCatalyst.

Para usar o Gradle Groovy para publicar pacotes em um repositório de pacotes do CodeCatalyst

Abra o console do CodeCatalyst em https://codecatalyst.aws/.
Na página de visão geral do projeto, selecione Pacotes.
Escolha seu repositório de pacotes na lista de repositórios de pacotes.
Selecione Conectar ao repositório.
Na caixa de diálogo Conectar ao repositório, selecione Gradle Groovy na lista de clientes do gerenciador de pacotes.
Você precisará de um token de acesso pessoal (PAT) para a autenticação do Gradle com o CodeCatalyst. Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Selecione Criar token.
2. 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.
Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. Substitua o nome de usuário pelo nome de usuário do CodeCatalyst e substitua o PAT pelo token de acesso pessoal do CodeCatalyst. Você pode usar qualquer valor para spaceUsername e spacePassword, desde que use os mesmos valores nas etapas a seguir.
```
spaceUsername=username
spacePassword=PAT
```
Adicione o plug-in maven-publish à seção plugins do arquivo build.gradle do projeto.
```
plugins {
    id 'java-library'
    id 'maven-publish'
}
```
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.
- Substitua space_name pelo nome do espaço do CodeCatalyst.
- Substitua proj_name pelo nome do projeto do CodeCatalyst.
- Substitua repo_name pelo nome do seu repositório de pacotes do CodeCatalyst.
```
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.
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
```
Navegue até o repositório do pacote no console do CodeCatalyst para verificar se o pacote foi publicado. 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:

Execução de uma compilação do Gradle no IntelliJ IDEA

Você pode executar uma compilação do Gradle no IntelliJ IDEA que extraia dependências do CodeCatalyst. Para a autenticação do Gradle com o CodeCatalyst, você deve usar um token de acesso pessoal (PAT). Você pode armazenar o PAT do CodeCatalyst em gradle.properties ou em 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)

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.
Em Nome do PAT, insira um nome descritivo para o seu PAT.
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.
Escolha Criar.

Você também pode criar esse token ao escolher Clonar repositório para um repositório de origem.
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)

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.
Em Nome do PAT, insira um nome descritivo para o seu PAT.
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.
Escolha Criar.

Você também pode criar esse token ao escolher Clonar repositório para um repositório de origem.
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

Atualize o arquivo build.gradle com o seguinte trecho. Substitua space_name, proj_name e repo_name pelo nome de usuário, nome do espaço, nome do projeto e nome do repositório de pacotes do CodeCatalyst.


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)
        }
    }
}

Grave o PAT no arquivo que foi especificado em seu arquivo build.gradle:
```
echo "codecatalystArtifactsToken=PAT" > fileName
```

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Usando o Maven

Configuração e uso de mvn

Configuração e uso do Gradle Groovy

Sumário

Busca de dependências do CodeCatalyst

Para usar o Gradle Groovy para buscar dependências no repositório de pacotes do CodeCatalyst

Atenção

nota

Busca de plug-ins do CodeCatalyst

Para usar o Gradle para buscar plug-ins do seu repositório de pacotes do CodeCatalyst

Atenção

nota

Busca de pacotes de repositórios de pacotes externos por meio do CodeCatalyst

Para instalar pacotes de repositórios de pacotes públicos do Maven

Publicar pacotes no CodeCatalyst

Para usar o Gradle Groovy para publicar pacotes em um repositório de pacotes do CodeCatalyst

Atenção

nota

Execução de uma compilação do Gradle no IntelliJ IDEA

Método 1: colocar o PAT em gradle.properties

nota

Para criar um token de acesso pessoal (PAT)

dica

Importante

Método 2: colocar o PAT em um arquivo separado

Para criar um token de acesso pessoal (PAT)

dica

Importante

Para colocar seu PAT em um arquivo separado

Método 1: colocar o PAT em `gradle.properties`