AWS SDK untuk Java 1.x mencapai end-of-support pada 31 Desember 2025. Kami menyarankan Anda bermigrasi ke [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)untuk terus menerima fitur baru, peningkatan ketersediaan, dan pembaruan keamanan.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Gunakan alat build
Penggunaan alat build membantu mengelola pengembangan proyek Java. Beberapa alat build tersedia, tetapi kami menunjukkan cara memulai dan menjalankan dengan dua alat build populer - Maven dan Gradle. Topik ini menunjukkan cara menggunakan alat build ini untuk mengelola dependensi SDK for Java yang Anda perlukan untuk proyek Anda.
**Topics**
+ [Gunakan SDK dengan Apache Maven](setup-project-maven.md)
+ [Menggunakan SDK dengan Gradle](setup-project-gradle.md)
# Gunakan SDK dengan Apache Maven
Anda dapat menggunakan [Apache Maven](https://maven.apache.org/) untuk mengkonfigurasi dan membangun AWS SDK untuk Java proyek, atau untuk membangun SDK itu sendiri.
**catatan**
Anda harus menginstal Maven untuk menggunakan panduan dalam topik ini. Jika belum diinstal, kunjungi [http://maven.apache.org/](http://maven.apache.org/) untuk mengunduh dan menginstalnya.
## Buat paket Maven baru
Untuk membuat paket Maven dasar, buka jendela terminal (baris perintah) dan jalankan:
```
mvn -B archetype:generate \
-DarchetypeGroupId=org.apache.maven.archetypes \
-DgroupId=org.example.basicapp \
-DartifactId=myapp
```
Ganti *org.example.basicapp* dengan namespace paket lengkap aplikasi Anda, dan *myapp* dengan nama proyek Anda (ini akan menjadi nama direktori untuk proyek Anda).
Secara default, buat template proyek untuk Anda menggunakan pola dasar [quickstart](http://maven.apache.org/archetypes/maven-archetype-quickstart/), yang merupakan tempat awal yang baik untuk banyak proyek. Ada lebih banyak arketipe yang tersedia; kunjungi halaman arketipe [Maven untuk daftar arketipe](https://maven.apache.org/archetypes/index.html) yang dikemas. Anda dapat memilih pola dasar tertentu untuk digunakan dengan menambahkan `-DarchetypeArtifactId` argumen ke perintah. `archetype:generate` Sebagai contoh:
```
mvn archetype:generate \
-DarchetypeGroupId=org.apache.maven.archetypes \
-DarchetypeArtifactId=maven-archetype-webapp \
-DgroupId=org.example.webapp \
-DartifactId=mywebapp
```
**catatan**
Lebih banyak informasi tentang membuat dan mengonfigurasi proyek disediakan di Panduan [Memulai Maven](https://maven.apache.org/guides/getting-started/).
## Konfigurasikan SDK sebagai dependensi Maven
Untuk menggunakan AWS SDK untuk Java dalam proyek Anda, Anda harus mendeklarasikannya sebagai dependensi dalam file proyek Anda. `pom.xml` Dimulai dengan versi 1.9.0, Anda dapat mengimpor [komponen individual](#configuring-maven-individual-components) atau [seluruh](#configuring-maven-entire-sdk) SDK.
### Menentukan modul SDK individu
Untuk memilih modul SDK individual, gunakan AWS SDK untuk Java bill of materials (BOM) untuk Maven, yang akan memastikan bahwa modul yang Anda tentukan menggunakan versi SDK yang sama dan kompatibel satu sama lain.
Untuk menggunakan BOM, tambahkan `` bagian ke `pom.xml` file aplikasi Anda, tambahkan `aws-java-sdk-bom` sebagai dependensi dan tentukan versi SDK yang ingin Anda gunakan:
```
com.amazonaws
aws-java-sdk-bom
1.11.1000
pom
import
```
[Untuk melihat AWS SDK untuk Java BOM versi terbaru yang tersedia di Maven Central, kunjungi: https://mvnrepository.com/artifact/ com.amazonaws/. aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom) Anda juga dapat menggunakan halaman ini untuk melihat modul (dependensi) mana yang dikelola oleh BOM yang dapat Anda sertakan dalam `` bagian file proyek Anda. `pom.xml`
Anda sekarang dapat memilih modul individual dari SDK yang Anda gunakan dalam aplikasi Anda. Karena Anda sudah mendeklarasikan versi SDK di BOM, Anda tidak perlu menentukan nomor versi untuk setiap komponen.
```
com.amazonaws
aws-java-sdk-s3
com.amazonaws
aws-java-sdk-dynamodb
```
Anda juga dapat merujuk ke * Katalog Kode Sampel AWS *untuk mempelajari dependensi apa yang akan digunakan untuk diberikan. Layanan AWS Lihat file POM di bawah contoh layanan tertentu. Misalnya, jika Anda tertarik dengan dependensi untuk layanan AWS S3, lihat contoh [lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) di. GitHub (Lihat pom under /java/example\$1code/s 3).
### Mengimpor semua modul SDK
Jika Anda ingin menarik *seluruh* SDK sebagai dependensi, jangan gunakan metode BOM, tetapi cukup deklarasikan seperti ini: `pom.xml`
```
com.amazonaws
aws-java-sdk
1.11.1000
```
## Bangun proyek Anda
Setelah Anda menyiapkan proyek, Anda dapat membangunnya menggunakan perintah Maven: `package`
```
mvn package
```
Ini akan membuat `0jar` file Anda di `target` direktori.
## Membangun SDK dengan Maven
Anda dapat menggunakan Apache Maven untuk membangun SDK dari sumber. Untuk melakukannya, [unduh kode SDK dari GitHub](https://github.com/aws/aws-sdk-java), buka kemasannya secara lokal, lalu jalankan perintah Maven berikut:
```
mvn clean install
```
# Menggunakan SDK dengan Gradle
Untuk mengelola dependensi SDK untuk proyek [Gradle](https://gradle.com/) Anda, impor BOM Maven ke dalam AWS SDK untuk Java file aplikasi. `build.gradle`
**catatan**
Dalam contoh berikut, ganti *1.12.529* dalam file build dengan versi yang valid dari file AWS SDK untuk Java. Temukan versi terbaru di repositori [pusat Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).
## Penyiapan proyek untuk Gradle 4.6 atau lebih tinggi
[Sejak Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), Anda dapat menggunakan fitur dukungan POM Gradle yang ditingkatkan untuk mengimpor file bill of materials (BOM) dengan mendeklarasikan dependensi pada BOM.
1. Jika Anda menggunakan Gradle 5.0 atau yang lebih baru, lewati ke langkah 2. Jika tidak, aktifkan fitur *IMPROVED\$1POM\$1SUPPORT* dalam file. `settings.gradle`
```
enableFeaturePreview('IMPROVED_POM_SUPPORT')
```
1. Tambahkan BOM ke bagian *dependensi* dari file aplikasi. `build.gradle`
```
...
dependencies {
implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')
// Declare individual SDK dependencies without version
...
}
```
1. Tentukan modul SDK yang akan digunakan di bagian *dependensi*. Misalnya, berikut ini mencakup ketergantungan untuk Amazon Simple Storage Service (Amazon S3).
```
...
dependencies {
implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')
implementation 'com.amazonaws:aws-java-sdk-s3'
...
}
```
Gradle secara otomatis menyelesaikan versi dependensi SDK yang benar dengan menggunakan informasi dari BOM.
Berikut ini adalah contoh `build.gradle` file lengkap yang menyertakan ketergantungan untuk Amazon S3.
```
group 'aws.test'
version '1.0-SNAPSHOT'
apply plugin: 'java'
sourceCompatibility = 1.8
repositories {
mavenCentral()
}
dependencies {
implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')
implementation 'com.amazonaws:aws-java-sdk-s3'
}
```
**catatan**
Pada contoh sebelumnya, ganti dependensi Amazon S3 dengan dependensi AWS layanan yang akan Anda gunakan dalam proyek Anda. Modul (dependensi) yang dikelola oleh AWS SDK untuk Java BOM terdaftar di repositori pusat [Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).
## Penyiapan proyek untuk versi Gradle lebih awal dari 4.6
Versi Gradle lebih awal dari 4.6 tidak memiliki dukungan BOM asli. Untuk mengelola AWS SDK untuk Java dependensi proyek Anda, gunakan [plugin manajemen dependensi](https://github.com/spring-gradle-plugins/dependency-management-plugin) Spring untuk Gradle untuk mengimpor Maven BOM untuk SDK.
1. Tambahkan plugin manajemen ketergantungan ke `build.gradle` file aplikasi Anda.
```
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE"
}
}
apply plugin: "io.spring.dependency-management"
```
1. Tambahkan BOM ke bagian *DependencyManagement* dari file.
```
dependencyManagement {
imports {
mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529'
}
}
```
1. Tentukan modul SDK yang akan Anda gunakan di bagian *dependensi*. Misalnya, berikut ini mencakup ketergantungan untuk Amazon S3.
```
dependencies {
compile 'com.amazonaws:aws-java-sdk-s3'
}
```
Gradle secara otomatis menyelesaikan versi dependensi SDK yang benar dengan menggunakan informasi dari BOM.
Berikut ini adalah contoh `build.gradle` file lengkap yang menyertakan ketergantungan untuk Amazon S3.
```
group 'aws.test'
version '1.0'
apply plugin: 'java'
sourceCompatibility = 1.8
repositories {
mavenCentral()
}
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE"
}
}
apply plugin: "io.spring.dependency-management"
dependencyManagement {
imports {
mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529'
}
}
dependencies {
compile 'com.amazonaws:aws-java-sdk-s3'
testCompile group: 'junit', name: 'junit', version: '4.11'
}
```
**catatan**
Pada contoh sebelumnya, ganti dependensi Amazon S3 dengan dependensi AWS layanan yang akan Anda gunakan dalam proyek Anda. Modul (dependensi) yang dikelola oleh AWS SDK untuk Java BOM terdaftar di repositori pusat [Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).
Untuk informasi selengkapnya tentang menentukan dependensi SDK dengan menggunakan BOM, lihat [Menggunakan SDK dengan Apache Maven](setup-project-maven.md).