Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengkonfigurasi dan menggunakan Gradle Groovy
<a name="packages-maven-gradle"></a>

Untuk menggunakan Gradle Groovy CodeCatalyst, Anda harus menghubungkan Gradle Groovy ke repositori paket Anda dan menyediakan token akses pribadi (PAT) untuk otentikasi. Anda dapat melihat petunjuk untuk menghubungkan Gradle Groovy ke repositori paket Anda di konsol. CodeCatalyst 

**Contents**
+ [Mengambil dependensi dari CodeCatalyst](#gradle-fetch-dependencies)
+ [Mengambil plugin dari CodeCatalyst](#gradle-fetch-plugins)
+ [Mengambil paket dari repositori paket eksternal melalui CodeCatalyst](#gradle-install-public)
+ [Menerbitkan paket ke CodeCatalyst](#gradle-publish-packages)
+ [Menjalankan build Gradle di IntelliJ IDEA](#gradle-intellij)
  + [Metode 1: Masukkan PAT ke dalam `gradle.properties`](#gradle-intellij-gradle-properties)
  + [Metode 2: Letakkan PAT dalam file terpisah](#gradle-intellij-file)

## Mengambil dependensi dari CodeCatalyst
<a name="gradle-fetch-dependencies"></a>

Petunjuk berikut menjelaskan cara mengonfigurasi Gradle Groovy untuk mengambil dependensi repositori paket Anda. CodeCatalyst 

**Untuk menggunakan Gradle Groovy untuk mengambil dependensi dari repositori paket CodeCatalyst**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Arahkan ke proyek Anda.

1. Di panel navigasi, pilih **Paket**.

1. Pilih repositori paket Anda dari daftar repositori paket.

1. Pilih **Connect to repository**.

1. Di kotak dialog **Connect to repository**, pilih **Gradle Groovy** dari daftar klien manajer paket.

1. Anda akan memerlukan token akses pribadi (PAT) untuk mengautentikasi Gradle Groovy. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.

   1. Pilih **Buat token**.

   1. Pilih **Salin** untuk menyalin PAT Anda.
**Awas**  
Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

1. Perbarui file properti gradle Anda dengan kredensi akses Anda. Ganti {{username}} dengan CodeCatalyst nama pengguna Anda dan ganti {{PAT}} dengan token akses CodeCatalyst pribadi Anda. Anda dapat menggunakan nilai apa pun untuk {{spaceUsername}} dan {{spacePassword}} selama Anda menggunakan nilai yang sama dalam langkah-langkah berikut.

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

1. Untuk mengambil dependensi dari CodeCatalyst dalam build Gradle, salin cuplikan `maven` kode dan tambahkan ke `repositories` bagian dalam file project Anda. `build.gradle` Ganti nilai-nilai berikut. Anda dapat menggunakan nilai apa pun {{spaceName}} selama Anda menggunakan nilai yang sama dalam langkah-langkah berikut.
**catatan**  
Jika menyalin dari instruksi konsol, nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.
   + Ganti {{space\_name}} dengan nama CodeCatalyst spasi Anda.
   + Ganti {{proj\_name}} dengan nama CodeCatalyst proyek Anda.
   + Ganti {{repo\_name}} dengan nama repositori CodeCatalyst paket Anda.

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

1. (Opsional) Untuk menggunakan repositori CodeCatalyst paket sebagai satu-satunya sumber untuk dependensi proyek Anda, hapus bagian lain dalam repositori dari file. `build.gradle` Jika Anda memiliki lebih dari satu repositori, Gradle menelusuri setiap repositori untuk dependensi sesuai urutan pencantumannya.

## Mengambil plugin dari CodeCatalyst
<a name="gradle-fetch-plugins"></a>

Secara default Gradle akan menyelesaikan plugin dari [Portal Plugin Gradle](https://plugins.gradle.org/) publik. Langkah-langkah berikut mengonfigurasi proyek Gradle Anda untuk menyelesaikan plugin dari repositori CodeCatalyst paket Anda.

**Untuk menggunakan Gradle untuk mengambil plugin dari repositori paket CodeCatalyst**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Arahkan ke proyek Anda.

1. Di panel navigasi, pilih **Paket**.

1. Pilih repositori paket Anda dari daftar repositori paket.

1. Pilih **Connect to repository**.

1. Di kotak dialog **Connect to repository**, pilih **Gradle** dari daftar klien manajer paket.

1. Anda akan memerlukan token akses pribadi (PAT) untuk mengautentikasi Gradle dengan. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.

   1. Pilih **Buat token**.

   1. Pilih **Salin** untuk menyalin PAT Anda.
**Awas**  
Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

1. Perbarui file properti gradle Anda dengan kredensi akses Anda. Ganti {{username}} dengan CodeCatalyst nama pengguna Anda dan ganti {{PAT}} dengan token akses CodeCatalyst pribadi Anda. Anda dapat menggunakan nilai apa pun untuk {{spaceUsername}} dan {{spacePassword}} selama Anda menggunakan nilai yang sama dalam langkah-langkah berikut.

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

1. Tambahkan `pluginManagement` blok ke `settings.gradle` file Anda. `pluginManagement`Blok harus muncul sebelum pernyataan lain di`settings.gradle`. Ganti nilai-nilai berikut.
**catatan**  
Jika menyalin dari instruksi konsol, nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.
   + Ganti {{spaceName}} dengan nilai nama yang digunakan pada langkah sebelumnya.
   + Ganti {{space\_name}} dengan nama CodeCatalyst spasi Anda.
   + Ganti {{proj\_name}} dengan nama CodeCatalyst proyek Anda.
   + Ganti {{repo\_name}} dengan nama repositori CodeCatalyst paket Anda.

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

   Hal ini akan memastikan bahwa Gradle menyelesaikan plugin dari repositori yang ditentukan. Repositori harus memiliki koneksi upstream yang dikonfigurasi ke Gradle Plugin Portal (`gradle-plugins-store`) sehingga plugin Gradle yang umum diperlukan tersedia untuk build. Untuk informasi selengkapnya, lihat [Dokumentasi Gradle](https://docs.gradle.org/current/userguide/plugins.html#sec:custom_plugin_repositories).

## Mengambil paket dari repositori paket eksternal melalui CodeCatalyst
<a name="gradle-install-public"></a>

Anda dapat menginstal paket Maven dari repositori publik melalui repositori dengan mengonfigurasinya dengan koneksi upstream ke gateway yang mewakili CodeCatalyst repositori gateway. Paket yang diinstal dari repositori gateway dicerna dan disimpan di repositori Anda. CodeCatalyst

CodeCatalyst mendukung repositori paket Maven publik berikut.
+ maven-central-gateway
+ google-android-gateway
+ gradle-plugins-gateway
+ gerbang commonsware-

**Untuk menginstal paket dari repositori paket Maven publik**

1. Jika Anda belum melakukannya, konfigurasikan Gradle dengan repositori CodeCatalyst paket Anda dengan mengikuti langkah-langkah di atau. [Mengambil dependensi dari CodeCatalyst](#gradle-fetch-dependencies) [Mengambil plugin dari CodeCatalyst](#gradle-fetch-plugins) 

1. Pastikan repositori Anda telah menambahkan repositori gateway yang ingin Anda instal sebagai koneksi hulu. Anda dapat melakukan ini dengan mengikuti petunjuk [Menambahkan repositori hulu](packages-upstream-repositories-add.md) dan memilih repositori paket publik yang ingin Anda tambahkan sebagai upstream.

Untuk informasi selengkapnya tentang meminta paket dari repositori upstream, lihat. [Meminta versi paket dengan repositori hulu](packages-upstream-repositories-request.md)

## Menerbitkan paket ke CodeCatalyst
<a name="gradle-publish-packages"></a>

Bagian ini menjelaskan cara mempublikasikan pustaka Java yang dibangun dengan Gradle Groovy ke repositori. CodeCatalyst

**Untuk menggunakan Gradle Groovy untuk memublikasikan paket ke repositori paket CodeCatalyst**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pada halaman ikhtisar untuk proyek Anda, pilih **Paket**.

1. Pilih repositori paket Anda dari daftar repositori paket.

1. Pilih **Connect to repository**.

1. Di kotak dialog **Connect to repository**, pilih **Gradle Groovy** dari daftar klien manajer paket.

1. Anda akan memerlukan token akses pribadi (PAT) untuk mengautentikasi Gradle dengan. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.

   1. Pilih **Buat token**.

   1. Pilih **Salin** untuk menyalin PAT Anda.
**Awas**  
Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

1. Perbarui file properti gradle Anda dengan kredensi akses Anda. Ganti {{username}} dengan CodeCatalyst nama pengguna Anda dan ganti {{PAT}} dengan token akses CodeCatalyst pribadi Anda. Anda dapat menggunakan nilai apa pun untuk {{spaceUsername}} dan {{spacePassword}} selama Anda menggunakan nilai yang sama dalam langkah-langkah berikut.

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

1. Tambahkan `maven-publish` plugin ke `plugins` bagian `build.gradle` file proyek.

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

1. Selanjutnya, tambahkan bagian `publishing` ke file `build.gradle` proyek. Ganti nilai-nilai berikut.
**catatan**  
Jika menyalin dari instruksi konsol, nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.
   + Ganti {{space\_name}} dengan nama CodeCatalyst spasi Anda.
   + Ganti {{proj\_name}} dengan nama CodeCatalyst proyek Anda.
   + Ganti {{repo\_name}} dengan nama repositori CodeCatalyst paket Anda.

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

   Plugin `maven-publish` menghasilkan file POM berdasarkan `groupId`, `artifactId`, dan `version` yang ditentukan dalam bagian `publishing`.

1. Setelah perubahan ke `build.gradle` selesai, jalankan perintah berikut untuk membangun proyek dan mengunggah ke repositori.

   ```
   ./gradlew publish
   ```

1. Arahkan ke repositori paket Anda di CodeCatalyst konsol untuk memeriksa apakah paket berhasil diterbitkan. Anda akan melihat paket dalam daftar **Paket** repositori paket Anda.

Untuk informasi selengkapnya, lihat topik berikut di situs web Gradle:
+  [Membangun Perpustakaan Java](https://guides.gradle.org/building-java-libraries/) 
+  [Menerbitkan proyek sebagai modul](https://docs.gradle.org/current/userguide/publishing_setup.html) 

## Menjalankan build Gradle di IntelliJ IDEA
<a name="gradle-intellij"></a>

Anda dapat menjalankan build Gradle di IntelliJ IDEA yang menarik dependensi dari. CodeCatalyst Untuk mengautentikasi Gradle dengan CodeCatalyst, Anda harus menggunakan token akses pribadi (PAT). Anda dapat menyimpan CodeCatalyst PAT Anda di `gradle.properties` atau file terpisah pilihan Anda.

### Metode 1: Masukkan PAT ke dalam `gradle.properties`
<a name="gradle-intellij-gradle-properties"></a>

Gunakan metode ini jika Anda tidak menggunakan `gradle.properties` file dan dapat menimpa isinya dengan PAT Anda. Jika Anda menggunakan`gradle.properties`, Anda dapat memodifikasi metode ini untuk menambahkan PAT alih-alih menimpa konten file.

**catatan**  
Contoh menunjukkan file `gradle.properties` yang berada di `GRADLE_USER_HOME`.

Pertama, buat PAT jika Anda tidak memilikinya.

**Untuk membuat token akses pribadi (PAT)**

1. Di bilah menu atas, pilih lencana profil Anda, lalu pilih **Pengaturan saya**. 
**Tip**  
Anda juga dapat menemukan profil pengguna Anda dengan membuka halaman anggota untuk proyek atau ruang dan memilih nama Anda dari daftar anggota.

1. Dalam **nama PAT**, masukkan nama deskriptif untuk PAT Anda.

1. Di **Tanggal kedaluwarsa**, tinggalkan tanggal default atau pilih ikon kalender untuk memilih tanggal kustom. Tanggal kedaluwarsa default menjadi satu tahun dari tanggal saat ini.

1. Pilih **Buat**.

   Anda juga dapat membuat token ini ketika Anda memilih Repositori **klon untuk repositori** sumber.

1. Simpan rahasia PAT di lokasi yang aman. 
**penting**  
Rahasia PAT hanya ditampilkan sekali. Anda tidak dapat mengambilnya setelah Anda menutup jendela. 

Selanjutnya, perbarui `build.gradle` file Anda dengan cuplikan berikut:

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

### Metode 2: Letakkan PAT dalam file terpisah
<a name="gradle-intellij-file"></a>

Gunakan metode ini jika Anda tidak ingin memodifikasi file `gradle.properties`.

Pertama, buat PAT jika Anda tidak memilikinya.

**Untuk membuat token akses pribadi (PAT)**

1. Di bilah menu atas, pilih lencana profil Anda, lalu pilih **Pengaturan saya**. 
**Tip**  
Anda juga dapat menemukan profil pengguna Anda dengan membuka halaman anggota untuk proyek atau ruang dan memilih nama Anda dari daftar anggota.

1. Dalam **nama PAT**, masukkan nama deskriptif untuk PAT Anda.

1. Di **Tanggal kedaluwarsa**, tinggalkan tanggal default atau pilih ikon kalender untuk memilih tanggal kustom. Tanggal kedaluwarsa default menjadi satu tahun dari tanggal saat ini.

1. Pilih **Buat**.

   Anda juga dapat membuat token ini ketika Anda memilih Repositori **klon untuk repositori** sumber.

1. Simpan rahasia PAT di lokasi yang aman. 
**penting**  
Rahasia PAT hanya ditampilkan sekali. Anda tidak dapat mengambilnya setelah Anda menutup jendela. 

**Untuk menempatkan PAT Anda dalam file terpisah**

1. Perbarui `build.gradle` file Anda dengan cuplikan berikut. Ganti{{space\_name}},{{proj\_name}}, dan {{repo\_name}} dengan nama CodeCatalyst pengguna, nama spasi, nama proyek, dan nama repositori paket Anda.

   ```
   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. Tulis PAT Anda ke dalam file yang ditentukan dalam `build.gradle` file Anda:

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