View a markdown version of this page

Mengkonfigurasi dan menggunakan Gradle Groovy - Amazon CodeCatalyst

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.

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

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

Mengambil dependensi dari CodeCatalyst

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

Untuk menggunakan Gradle Groovy untuk mengambil dependensi dari repositori paket Anda CodeCatalyst
  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Arahkan ke proyek Anda.

  3. Di panel navigasi, pilih Paket.

  4. Pilih repositori paket Anda dari daftar repositori paket.

  5. Pilih Hu bungkan ke repositori.

  6. Di kotak dialog Hubun gkan ke repositori, pilih Gradle Groovy dari daftar klien manajer paket.

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

    1. Pilih Buat token.

    2. Pilih Salin untuk menyalin PAT Anda.

      Awas

      Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

  8. Perbarui file properti gradle Anda dengan kredenSIAL 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
  9. Untuk mengambil dependensi dari build Gradle, sal CodeCatalyst in cuplikan maven kode dan tambahkan ke repositories bagian dalam file proyek 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-nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.

    • Ganti space_name dengan nama CodeCatalyst ruang 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) }
  10. (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

Secara default Gradle akan menyelesaikan plugin dari Portal Plugin Gradle publik. Langkah-langkah berikut mengkonfigurasi project Gradle Anda untuk menyelesaikan plugin dari repositori CodeCatalyst paket Anda.

Untuk menggunakan Gradle untuk mengambil plugin dari repositori paket Anda CodeCatalyst
  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Arahkan ke proyek Anda.

  3. Di panel navigasi, pilih Paket.

  4. Pilih repositori paket Anda dari daftar repositori paket.

  5. Pilih Hu bungkan ke repositori.

  6. Di kotak dialog Hubun gkan ke repositori, pilih Gradle dari daftar klien manajer paket.

  7. Anda memerlukan token akses pribadi (PAT) untuk mengotentikasi Gradle. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.

    1. Pilih Buat token.

    2. Pilih Salin untuk menyalin PAT Anda.

      Awas

      Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

  8. Perbarui file properti gradle Anda dengan kredenSIAL 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
  9. Tambahkan pluginManagement blok ke settings.gradle file Anda. pluginManagementBlok harus muncul sebelum pernyataan lain disettings.gradle. Ganti nilai-nilai berikut.

    catatan

    Jika menyalin dari instruksi konsol, nilai-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 ruang 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.

Mengambil paket dari repositori paket eksternal melalui CodeCatalyst

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

CodeCatalyst mendukung repositori paket Maven publik berikut.

  • gerbang pusat maven-

  • gerbang google-android

  • 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 Mengambil dependensi dari CodeCatalyst atauMengambil plugin dari CodeCatalyst.

  2. Pastikan repositori Anda telah menambahkan repositori gateway yang ingin Anda instal sebagai koneksi hulu. Anda dapat melakukan ini dengan mengikuti petunjuk di Menambahkan repositori hulu dan memilih repositori paket publik yang ingin Anda tambahkan sebagai hulu.

Untuk informasi selengkapnya tentang meminta paket dari repositori hulu, lihat. Meminta versi paket dengan repositori hulu

Menerbitkan paket ke CodeCatalyst

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

Untuk menggunakan Gradle Groovy untuk menerbitkan paket ke repositori CodeCatalyst paket
  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Pada halaman ikhtisar untuk proyek Anda, pilih Paket.

  3. Pilih repositori paket Anda dari daftar repositori paket.

  4. Pilih Hu bungkan ke repositori.

  5. Di kotak dialog Hubun gkan ke repositori, pilih Gradle Groovy dari daftar klien manajer paket.

  6. Anda memerlukan token akses pribadi (PAT) untuk mengotentikasi Gradle. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.

    1. Pilih Buat token.

    2. Pilih Salin untuk menyalin PAT Anda.

      Awas

      Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

  7. Perbarui file properti gradle Anda dengan kredenSIAL 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
  8. Tambahkan maven-publish plugin ke plugins bagian build.gradle file proyek.

    plugins { id 'java-library' id 'maven-publish' }
  9. Selanjutnya, tambahkan bagian publishing ke file build.gradle proyek. Ganti nilai-nilai berikut.

    catatan

    Jika menyalin dari instruksi konsol, nilai-nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.

    • Ganti space_name dengan nama CodeCatalyst ruang 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.

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

    ./gradlew publish
  11. Arahkan ke repositori paket Anda di CodeCatalyst konsol untuk memeriksa apakah paket berhasil dipublikasikan. Anda harus melihat paket dalam daftar Paket repositori paket Anda.

Untuk informasi selengkapnya, lihat topik berikut di situs web Gradle:

Menjalankan build Gradle di IntelliJ IDEA

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

Metode 1: Masukkan PAT di gradle.properties

Gunakan metode ini jika Anda tidak menggunakan gradle.properties file dan dapat mengganti isinya dengan PAT Anda. Jika Anda menggunakangradle.properties, Anda dapat memodifikasi metode ini untuk menambahkan PAT alih-alih mengganti 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 Peng aturan saya.

    Tip

    Anda juga dapat menemukan profil pengguna Anda dengan membuka halaman anggota untuk proyek atau ruang dan memilih nama Anda dari daftar anggota.

  2. Di nama PAT, masukkan nama deskriptif untuk PAT Anda.

  3. Di Tanggal ked aluwarsa, tinggalkan tanggal default atau pilih ikon kalender untuk memilih tanggal khusus. Tanggal kedaluwarsa default adalah satu tahun dari tanggal saat ini.

  4. Pilih Buat.

    Anda juga dapat membuat token ini ketika Anda memilih repositori Clone untuk repositori sumber.

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

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 Peng aturan saya.

    Tip

    Anda juga dapat menemukan profil pengguna Anda dengan membuka halaman anggota untuk proyek atau ruang dan memilih nama Anda dari daftar anggota.

  2. Di nama PAT, masukkan nama deskriptif untuk PAT Anda.

  3. Di Tanggal ked aluwarsa, tinggalkan tanggal default atau pilih ikon kalender untuk memilih tanggal khusus. Tanggal kedaluwarsa default adalah satu tahun dari tanggal saat ini.

  4. Pilih Buat.

    Anda juga dapat membuat token ini ketika Anda memilih repositori Clone untuk repositori sumber.

  5. 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. G space_name antiproj_name,, dan repo_name dengan nama CodeCatalyst pengguna, nama ruang, 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) } } }
  2. Tulis PAT Anda ke dalam file yang ditentukan dalam build.gradle file Anda:

    echo "codecatalystArtifactsToken=PAT" > fileName