Configuração e uso do 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á.

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

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. Selecione Conectar ao repositório.

  6. Na caixa de diálogo Conectar ao repositório, selecione 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á 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.

  8. Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. usernameSubstitua 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
  9. Para buscar dependências CodeCatalyst em uma versã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 valorspaceName, 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_nameSubstitua pelo nome do seu CodeCatalyst espaço.

    • proj_nameSubstitua pelo nome CodeCatalyst do seu projeto.

    • repo_nameSubstitua 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) }
  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. Selecione Conectar ao repositório.

  6. Na caixa de diálogo Conectar ao repositório, selecione 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á 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.

  8. Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. usernameSubstitua 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
  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.

    • spaceNameSubstitua pelo valor do nome usado na etapa anterior.

    • space_nameSubstitua pelo nome do seu CodeCatalyst espaço.

    • proj_nameSubstitua pelo nome CodeCatalyst do seu projeto.

    • repo_nameSubstitua 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.

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

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 projeto, selecione Pacotes.

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

  4. Selecione Conectar ao repositório.

  5. Na caixa de diálogo Conectar ao repositório, selecione 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á 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.

  7. Atualize o arquivo de propriedades do gradle com suas credenciais de acesso. usernameSubstitua 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
  8. Adicione o plug-in maven-publish à seção plugins do arquivo build.gradle 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.

    • space_nameSubstitua pelo nome do seu CodeCatalyst espaço.

    • proj_nameSubstitua pelo nome CodeCatalyst do seu projeto.

    • repo_nameSubstitua 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.

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

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

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

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

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

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

  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. 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_nameproj_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 o PAT no arquivo que foi especificado em seu arquivo build.gradle:

    echo "codecatalystArtifactsToken=PAT" > fileName