Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Gradle Groovy を設定して使用する
<a name="packages-maven-gradle"></a>

CodeCatalyst で Gradle Groovy を使用するには、Gradle Groovy をパッケージリポジトリに接続し、認証用の個人用アクセストークン (PAT) を提供する必要があります。Gradle Groovy をパッケージリポジトリに接続する手順については、CodeCatalyst コンソールで確認できます。

**Contents**
+ [CodeCatalyst から依存関係を取得する](#gradle-fetch-dependencies)
+ [CodeCatalyst からプラグインを取得する](#gradle-fetch-plugins)
+ [CodeCatalyst を使用して外部パッケージリポジトリからパッケージを取得する](#gradle-install-public)
+ [CodeCatalyst にパッケージを公開する](#gradle-publish-packages)
+ [IntelliJ IDEA で Gradle ビルドを実行する](#gradle-intellij)
  + [方法 1: PAT を `gradle.properties` に入れる](#gradle-intellij-gradle-properties)
  + [方法 2: PAT を別のファイルに入れる](#gradle-intellij-file)

## CodeCatalyst から依存関係を取得する
<a name="gradle-fetch-dependencies"></a>

次の手順では、CodeCatalyst パッケージリポジトリの依存関係を取得するように Gradle Groovy を設定する方法を説明します。

**Gradle Groovy を使用して CodeCatalyst パッケージリポジトリから依存関係を取得するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. プロジェクトに移動します。

1. ナビゲーションペインで、[**Packages (パッケージ)**] を選択します。

1. パッケージリポジトリのリストからパッケージリポジトリを選択します。

1. **[リポジトリに接続]** を選択します。

1. **[リポジトリに接続]** ダイアログボックスで、パッケージマネージャークライアントのリストから **[Gradle Groovy]** を選択します。

1. CodeCatalyst で Gradle Groovy を認証するには、個人用アクセストークン (PAT) が必要です。トークンが既にある場合はそれを使用できます。そうでない場合は、ここで作成できます。

   1. **[トークンを作成]** をクリックします。

   1. **[コピー]** をクリックして PAT をコピーします。
**警告**  
ダイアログボックスを閉じると、PAT を再度表示またはコピーできなくなります。

1. アクセス認証情報を使用して、gradle プロパティファイルを更新します。{{username}} を CodeCatalyst のユーザー名に置き換え、{{PAT}} を CodeCatalyst の個人用アクセストークンに置き換えます。{{spaceUsername}} と {{spacePassword}} には任意の値を使用できます。ただし、以下のステップで同じ値を使用してください。

   ```
   {{spaceUsername}}={{username}}
   {{spacePassword}}={{PAT}}
   ```

1. Gradle ビルドで CodeCatalyst から依存関係を取得するには、`maven` コードスニペットをコピーしてプロジェクトの `build.gradle` ファイル内の `repositories` セクションに追加します。次の値を置き換えます。{{spaceName}} には任意の値を使用できます。ただし、以下のステップで同じ値を使用してください。
**注記**  
コンソールの手順からコピーする場合は、以下の値は自動的に更新されるため、変更する必要はありません。
   + {{space\_name}} を CodeCatalyst のスペース名に置き換えます。
   + {{proj\_name}} を CodeCatalyst のプロジェクト名に置き換えます。
   + {{repo\_name}} を CodeCatalyst のパッケージリポジトリ名に置き換えます。

   ```
   maven {
     name = '{{spaceName}}'
     url = uri('https://packages.{{region}}.codecatalyst.aws/maven/{{space_name}}/{{proj_name}}/{{repo_name}}/')
     credentials(PasswordCredentials)
   }
   ```

1. (オプション) CodeCatalyst パッケージリポジトリをプロジェクトの依存関係の唯一のソースとして使用するには、リポジトリの他のセクションを `build.gradle` ファイルから削除します。複数のリポジトリがある場合、Gradle はリストされている順序で各リポジトリの依存関係を検索します。

## CodeCatalyst からプラグインを取得する
<a name="gradle-fetch-plugins"></a>

デフォルトでは、Gradle はパブリック [Gradle Plugin Portal](https://plugins.gradle.org/) からプラグインを解決します。次のステップでは、CodeCatalyst パッケージリポジトリからプラグインを解決するように Gradle プロジェクトを設定します。

**Gradle を使用して CodeCatalyst パッケージリポジトリからプラグインを取得するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. プロジェクトに移動します。

1. ナビゲーションペインで、[**Packages (パッケージ)**] を選択します。

1. パッケージリポジトリのリストからパッケージリポジトリを選択します。

1. **[リポジトリに接続]** を選択します。

1. **[リポジトリに接続]** ダイアログボックスで、パッケージマネージャークライアントのリストから **[Gradle]** を選択します。

1. CodeCatalyst で Gradle を認証するには、個人用アクセストークン (PAT) が必要です。トークンが既にある場合はそれを使用できます。そうでない場合は、ここで作成できます。

   1. **[トークンを作成]** をクリックします。

   1. **[コピー]** をクリックして PAT をコピーします。
**警告**  
ダイアログボックスを閉じると、PAT を再度表示またはコピーできなくなります。

1. アクセス認証情報を使用して、gradle プロパティファイルを更新します。{{username}} を CodeCatalyst のユーザー名に置き換え、{{PAT}} を CodeCatalyst の個人用アクセストークンに置き換えます。{{spaceUsername}} と {{spacePassword}} には任意の値を使用できます。ただし、以下のステップで同じ値を使用してください。

   ```
   {{spaceUsername}}={{username}}
   {{spacePassword}}={{PAT}}
   ```

1. `pluginManagement` ブロックを `settings.gradle` ファイルに追加します。`pluginManagement` ブロックは、`settings.gradle` の他のステートメントの前に置く必要があります。次の値を置き換えます。
**注記**  
コンソールの手順からコピーする場合は、以下の値は自動的に更新されるため、変更する必要はありません。
   + {{spaceName}} を前のステップで使用した名前値に置き換えます。
   + {{space\_name}} を CodeCatalyst のスペース名に置き換えます。
   + {{proj\_name}} を CodeCatalyst のプロジェクト名に置き換えます。
   + {{repo\_name}} を CodeCatalyst のパッケージリポジトリ名に置き換えます。

   ```
   pluginManagement {
       repositories {
           maven {
               name = '{{spaceName}}'
               url = uri('https://packages.{{region}}.codecatalyst.aws/maven/{{space_name}}/{{proj_name}}/{{repo_name}}/')
               credentials(PasswordCredentials)
           }
       }
   }
   ```

   これにより、Gradle は指定したリポジトリからプラグインを解決します。一般的に必要な Gradle プラグインをビルドで使用できるように、リポジトリには Gradle Plugin Portal(`gradle-plugins-store`) への接続が設定されたアップストリームリポジトリが必要です。詳細については、[Gradle ドキュメント](https://docs.gradle.org/current/userguide/plugins.html#sec:custom_plugin_repositories) を参照してください。

## CodeCatalyst を使用して外部パッケージリポジトリからパッケージを取得する
<a name="gradle-install-public"></a>

Maven パッケージは、CodeCatalyst リポジトリを介してパブリックリポジトリからインストールできます。これを行うには、ゲートウェイリポジトリを表すゲートウェイへのアップストリーム接続を使用してリポジトリを設定します。ゲートウェイリポジトリからインストールされたパッケージは、CodeCatalyst リポジトリに取り込まれて保存されます。

CodeCatalyst は、以下の Maven パッケージリポジトリをサポートしています。
+ maven-central-gateway
+ google-android-gateway
+ gradle-plugins-gateway
+ commonsware-gateway

**パブリック Maven パッケージリポジトリからパッケージをインストールするには**

1. まだ設定していない場合は、「[CodeCatalyst から依存関係を取得する](#gradle-fetch-dependencies)」または「[CodeCatalyst からプラグインを取得する](#gradle-fetch-plugins)」の手順に従って CodeCatalyst パッケージリポジトリで Gradle を設定します。

1. リポジトリに、インストール元のゲートウェイリポジトリがアップストリーム接続として追加されていることを確認します。これを行うには、「[アップストリームリポジトリを追加する](packages-upstream-repositories-add.md)」の手順に従い、アップストリームとして追加するパブリックパッケージリポジトリを選択します。

アップストリームリポジトリからのパッケージのリクエストの詳細については、「[アップストリームリポジトリを持つパッケージバージョンのリクエスト](packages-upstream-repositories-request.md)」を参照してください。

## CodeCatalyst にパッケージを公開する
<a name="gradle-publish-packages"></a>

このセクションでは、Gradle でビルドされた Java ライブラリを CodeCatalyst リポジトリに公開する方法を説明します。

**Gradle Groovy を使用して CodeCatalyst パッケージリポジトリにパッケージを公開するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. プロジェクトの概要ページで、**[パッケージ]** を選択します。

1. パッケージリポジトリのリストからパッケージリポジトリを選択します。

1. **[リポジトリに接続]** を選択します。

1. **[リポジトリに接続]** ダイアログボックスで、パッケージマネージャークライアントのリストから **[Gradle Groovy]** を選択します。

1. CodeCatalyst で Gradle を認証するには、個人用アクセストークン (PAT) が必要です。トークンが既にある場合はそれを使用できます。そうでない場合は、ここで作成できます。

   1. **[トークンを作成]** をクリックします。

   1. **[コピー]** をクリックして PAT をコピーします。
**警告**  
ダイアログボックスを閉じると、PAT を再度表示またはコピーできなくなります。

1. アクセス認証情報を使用して、gradle プロパティファイルを更新します。{{username}} を CodeCatalyst のユーザー名に置き換え、{{PAT}} を CodeCatalyst の個人用アクセストークンに置き換えます。{{spaceUsername}} と {{spacePassword}} には任意の値を使用できます。ただし、以下のステップで同じ値を使用してください。

   ```
   {{spaceUsername}}={{username}}
   {{spacePassword}}={{PAT}}
   ```

1. `maven-publish` プラグインをプロジェクトの `build.gradle` ファイルの `plugins` セクションに追加します。

   ```
   plugins {
       id 'java-library'
       id 'maven-publish'
   }
   ```

1. 次に、`publishing` セクションをプロジェクト `build.gradle` ファイルに追加します。次の値を置き換えます。
**注記**  
コンソールの手順からコピーする場合は、以下の値は自動的に更新されるため、変更する必要はありません。
   + {{space\_name}} を CodeCatalyst のスペース名に置き換えます。
   + {{proj\_name}} を CodeCatalyst のプロジェクト名に置き換えます。
   + {{repo\_name}} を 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)
           }
       }
   }
   ```

   `maven-publish` プラグインは、`publishing` セクションで指定された `groupId`、`artifactId` および `version` に基づいて POM ファイルを生成します。

1. これらの `build.gradle` への変更が完了したら、次のコマンドを実行してプロジェクトをビルドし、それをリポジトリにアップロードします。

   ```
   ./gradlew publish
   ```

1. CodeCatalyst コンソールでパッケージリポジトリに移動し、パッケージが正常に公開されたことを確認します。パッケージは、パッケージリポジトリの **[パッケージ]** リストに表示されます。

詳細については、Gradle ウェブサイトで以下のトピックを参照してください。
+  [Java ライブラリの構築](https://guides.gradle.org/building-java-libraries/) 
+  [プロジェクトをモジュールとして公開する](https://docs.gradle.org/current/userguide/publishing_setup.html) 

## IntelliJ IDEA で Gradle ビルドを実行する
<a name="gradle-intellij"></a>

IntelliJ IDEAで、CodeCatalyst から依存関係をプルする Gradle ビルドを実行できます。CodeCatalyst で Gradle を認証するには、個人用アクセストークン (PAT) を使用する必要があります。CodeCatalyst PAT は、`gradle.properties` または別の任意のファイルに保存できます。

### 方法 1: PAT を `gradle.properties` に入れる
<a name="gradle-intellij-gradle-properties"></a>

`gradle.properties` ファイルを使用しておらず、その内容を PAT で上書きできる場合は、この方法を使用します。`gradle.properties` を使用している場合は、この方法を変更して、ファイルの内容を上書きするのではなく、PAT を追加します。

**注記**  
この例は `GRADLE_USER_HOME` にある `gradle.properties` ファイルを示します。

まず、PAT がない場合は作成します。

**個人アクセストークン (PAT) を作成するには**

1. 上部のメニューバーでプロファイルバッジを選択し、**[My 設定]** を選択します。
**ヒント**  
ユーザープロファイルは、プロジェクトまたはスペースのメンバーページに移動し、メンバーリストから名前を選択することで見つけることができます。

1. **[PAT 名]** に、チームのわかりやすい名前を入力します。

1. **[有効期限]** では、デフォルトの日付のままにしておくか、カレンダーアイコンを選択して、カスタムの日付を選択します。有効期限のデフォルトは、現在の日付から 1 年です。

1. **[作成]** を選択します。

   このトークンは、ソースリポジトリの **[クローンリポジトリC]** を選択したときにも作成できます。

1. PAT シークレットを安全な場所に保存します。
**重要**  
PAT シークレットは 1 回だけ表示されます。ウィンドウを閉じると、再表示できなくなります。

続いて、次のスニペットを使用して `build.gradle` ファイルを更新します。

```
repositories {
    maven {
        name = '{{spaceName}}'
        url = uri('https://packages.{{region}}.codecatalyst.aws/maven/{{space_name}}/{{proj_name}}/{{repo_name}}/')
        credentials(PasswordCredentials)
    }
}
```

### 方法 2: PAT を別のファイルに入れる
<a name="gradle-intellij-file"></a>

この方法は、`gradle.properties` ファイルを修正したくない場合に使用します。

まず、PAT がない場合は作成します。

**個人アクセストークン (PAT) を作成するには**

1. 上部のメニューバーでプロファイルバッジを選択し、**[My 設定]** を選択します。
**ヒント**  
ユーザープロファイルは、プロジェクトまたはスペースのメンバーページに移動し、メンバーリストから名前を選択することで見つけることができます。

1. **[PAT 名]** に、チームのわかりやすい名前を入力します。

1. **[有効期限]** では、デフォルトの日付のままにしておくか、カレンダーアイコンを選択して、カスタムの日付を選択します。有効期限のデフォルトは、現在の日付から 1 年です。

1. **[作成]** を選択します。

   このトークンは、ソースリポジトリの **[クローンリポジトリC]** を選択したときにも作成できます。

1. PAT シークレットを安全な場所に保存します。
**重要**  
PAT シークレットは 1 回だけ表示されます。ウィンドウを閉じると、再表示できなくなります。

**PAT を別のファイルに入れるには**

1. 次のスニペットを使用して `build.gradle` ファイルを更新します。{{space\_name}}、{{proj\_name}}、{{repo\_name}} を 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)
           }
       }
   }
   ```

1. `build.gradle` ファイルで指定したファイルに PAT を書き込みます。

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