Configurando e usando o Gradle Groovy - Amazon CodeCatalyst

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

Configurando e usando o 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

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

  2. Navegue até o projeto.

  3. No painel de navegação, selecione Packages (pacotes).

  4. Escolha seu repositório de pacotes na lista de repositórios de pacotes.

  5. Escolha Conectar ao repositório.

  6. Na caixa de diálogo Connect to repository, escolha Gradle Groovy na lista de clientes do gerenciador de pacotes.

  7. Você precisará de um token de acesso pessoal (PAT) para autenticar o Gradle Groovy. CodeCatalyst Se você já tem um, você pode usá-lo. Caso contrário, você pode criar um aqui.

    1. Escolha Criar token.

    2. Escolha Copiar para copiar seu PAT.

      Atenção

      Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.

  8. Atualize seu arquivo de propriedades do gradle com suas credenciais de acesso. Substitua o nome de CodeCatalyst usuário pelo seu nome de usuário e substitua o PAT pelo seu token de acesso CodeCatalyst pessoal. Você pode usar qualquer valor para spaceUsername e spacePassword, desde que use os mesmos valores nas etapas a seguir.

    spaceUsername=username spacePassword=PAT
  9. 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 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 seu CodeCatalyst espaço.

    • Substitua proj_name pelo nome do seu CodeCatalyst projeto.

    • Substitua repo_name pelo nome do repositório do CodeCatalyst pacote.

    maven { name = 'spaceName' url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/') credentials(PasswordCredentials) }
  10. (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 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/.

  2. Navegue até o projeto.

  3. No painel de navegação, selecione Packages (pacotes).

  4. Escolha seu repositório de pacotes na lista de repositórios de pacotes.

  5. Escolha Conectar ao repositório.

  6. Na caixa de diálogo Connect to repository, escolha Gradle na lista de clientes do gerenciador de pacotes.

  7. Você precisará de um token de acesso pessoal (PAT) para autenticar o Gradle. CodeCatalyst Se você já tem um, você pode usá-lo. Caso contrário, você pode criar um aqui.

    1. Escolha Criar token.

    2. Escolha Copiar para copiar seu PAT.

      Atenção

      Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.

  8. Atualize seu arquivo de propriedades do gradle com suas credenciais de acesso. Substitua o nome de CodeCatalyst usuário pelo seu nome de usuário e substitua o PAT pelo seu token de acesso CodeCatalyst pessoal. Você pode usar qualquer valor para spaceUsername e spacePassword, desde que use os mesmos valores nas etapas a seguir.

    spaceUsername=username spacePassword=PAT
  9. 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 seu CodeCatalyst espaço.

    • Substitua proj_name pelo nome do seu CodeCatalyst projeto.

    • Substitua repo_name pelo nome do repositório do CodeCatalyst 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 (gradle-plugins-store) para que os plug-ins do Gradle normalmente necessários estejam disponíveis para a compilação. Para obter mais informações, consulte a documentação do Gradle.

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

  • gateway de software comum

Para instalar pacotes de repositórios públicos de pacotes 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 ou. Buscando plug-ins de CodeCatalyst

  2. 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 Adicionar um repositório upstream e escolhendo o repositório público de pacotes que você deseja adicionar como upstream.

Para obter mais informações sobre a solicitação de pacotes de repositórios upstream, consulte. Solicitar uma versão do pacote com repositórios upstream

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

  2. Na página de visão geral do seu projeto, escolha Pacotes.

  3. Escolha seu repositório de pacotes na lista de repositórios de pacotes.

  4. Escolha Conectar ao repositório.

  5. Na caixa de diálogo Connect to repository, escolha Gradle Groovy na lista de clientes do gerenciador de pacotes.

  6. Você precisará de um token de acesso pessoal (PAT) para autenticar o Gradle. CodeCatalyst Se você já tem um, você pode usá-lo. Caso contrário, você pode criar um aqui.

    1. Escolha Criar token.

    2. Escolha Copiar para copiar seu PAT.

      Atenção

      Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.

  7. Atualize seu arquivo de propriedades do gradle com suas credenciais de acesso. Substitua o nome de CodeCatalyst usuário pelo seu nome de usuário e substitua o PAT pelo seu token de acesso CodeCatalyst pessoal. Você pode usar qualquer valor para spaceUsername e spacePassword, desde que use os mesmos valores nas etapas a seguir.

    spaceUsername=username spacePassword=PAT
  8. Adicione o maven-publish plug-in à plugins seção do build.gradle arquivo do projeto.

    plugins { id 'java-library' id 'maven-publish' }
  9. 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 seu CodeCatalyst espaço.

    • Substitua proj_name pelo nome do seu CodeCatalyst projeto.

    • Substitua repo_name pelo nome do repositório do CodeCatalyst 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.

  10. 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
  11. 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 de pacotes do seu repositório de pacotes.

Para obter mais informações, consulte os tópicos a seguir no site do Gradle:

Executando 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: Coloque o PAT gradle.properties

Use esse método se você não estiver usando o gradle.properties arquivo e puder sobrescrever seu conteúdo com seu PAT. Se você estiver usandogradle.properties, poderá modificar esse método para adicionar o PAT em vez de sobrescrever 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.

  2. Em Nome do PAT, insira um nome descritivo para o seu PAT.

  3. Em Data de expiração, deixe a data padrão ou escolha o ícone do calendário para selecionar uma data personalizada. A data de expiração é padronizada para um ano a partir da data atual.

  4. Escolha Criar.

    Você também pode criar esse token ao escolher Clonar repositório para um repositório de origem.

  5. Salve o segredo do PAT em um local seguro.

    Importante

    O segredo do PAT só é exibido uma vez. Você não pode recuperá-lo depois de fechar a janela.

Em seguida, atualize seu build.gradle arquivo 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.

  2. Em Nome do PAT, insira um nome descritivo para o seu PAT.

  3. Em Data de expiração, deixe a data padrão ou escolha o ícone do calendário para selecionar uma data personalizada. A data de expiração é padronizada para um ano a partir da data atual.

  4. Escolha Criar.

    Você também pode criar esse token ao escolher Clonar repositório para um repositório de origem.

  5. Salve o segredo do PAT em um local seguro.

    Importante

    O segredo do PAT só é exibido uma vez. Você não pode recuperá-lo depois de fechar a janela.

Para colocar seu PAT em um arquivo separado
  1. Atualize seu build.gradle arquivo 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) } } }
  2. Grave seu PAT no arquivo que foi especificado em seu build.gradle arquivo:

    echo "codecatalystArtifactsToken=PAT" > fileName