Mengkonfigurasi dan menggunakan Gradle Groovy - Amazon 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 CodeCatalyst, Anda harus menghubungkan Gradle Groovy ke repositori paket Anda dan menyediakan token akses pribadi () untuk otentikasi. PAT Anda dapat melihat petunjuk untuk menghubungkan Gradle Groovy ke repositori paket Anda di konsol. CodeCatalyst

Mengambil dependensi dari CodeCatalyst

Petunjuk berikut menjelaskan cara mengonfigurasi 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 Connect to repository.

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

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

    1. Pilih Buat token.

    2. Pilih Salin untuk menyalinPAT.

      Awas

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

  8. Perbarui file properti gradle Anda dengan kredensyal 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 and spacePassword selama Anda menggunakan nilai yang sama dalam langkah-langkah berikut.

    spaceUsername=username spacePassword=PAT
  9. 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 untuk 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) }
  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 mengonfigurasi proyek 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 Connect to repository.

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

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

    2. Pilih Salin untuk menyalinPAT.

      Awas

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

  8. Perbarui file properti gradle Anda dengan kredensyal 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 and 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 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.

Mengambil paket dari repositori paket eksternal melalui CodeCatalyst

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 Mengambil 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 Menambahkan repositori upstream 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

Menerbitkan paket ke CodeCatalyst

Bagian ini menjelaskan cara menerbitkan 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/.

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

  3. Pilih repositori paket Anda dari daftar repositori paket.

  4. Pilih Connect to repository.

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

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

    2. Pilih Salin untuk menyalinPAT.

      Awas

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

  7. Perbarui file properti gradle Anda dengan kredensyal 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 and 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 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) } } }

    maven-publishPlugin menghasilkan POM file berdasarkangroupId,artifactId, dan version ditentukan di publishing bagian.

  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 diterbitkan. Anda akan 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 IDEA IntelliJ yang menarik dependensi dari. CodeCatalyst Untuk mengautentikasi Gradle dengan CodeCatalyst, Anda harus menggunakan token akses pribadi ()PAT. Anda dapat menyimpan CodeCatalyst PAT di dalam gradle.properties atau file terpisah pilihan Anda.

Metode 1: PAT Masukkan gradle.properties

Gunakan metode ini jika Anda tidak menggunakan gradle.properties file dan dapat menimpa isinya dengan file AndaPAT. Jika Anda menggunakangradle.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 a 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.

  2. Dalam PATnama, masukkan nama deskriptif untuk AndaPAT.

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

  4. Pilih Buat.

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

  5. Simpan PAT rahasia di lokasi yang aman.

    penting

    PATRahasianya 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: PAT Masukkan file terpisah

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

Pertama, buat a 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.

  2. Dalam PATnama, masukkan nama deskriptif untuk AndaPAT.

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

  4. Pilih Buat.

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

  5. Simpan PAT rahasia di lokasi yang aman.

    penting

    PATRahasianya hanya ditampilkan sekali. Anda tidak dapat mengambilnya setelah Anda menutup jendela.

Untuk menempatkan Anda PAT 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) } } }
  2. Tulis Anda PAT ke dalam file yang ditentukan dalam build.gradle file Anda:

    echo "codecatalystArtifactsToken=PAT" > fileName