Menyiapkan proyek Gradle

Anda dapat menggunakan Gradle untuk menyiapkan dan membangun AWS SDK for Java proyek.

Langkah awal dalam contoh berikut berasal dari panduan Memulai Gradle untuk versi 8.4. Jika Anda menggunakan versi yang berbeda, hasil Anda mungkin sedikit berbeda.

Untuk membuat aplikasi Java dengan Gradle (baris perintah)

Buat direktori untuk menampung proyek Anda. Dalam contoh ini, demo adalah nama direktori.

Di dalam demo direktori, jalankan gradle init perintah dan berikan nilai yang disorot dengan warna merah seperti yang ditunjukkan pada output baris perintah berikut. Untuk berjalan-jalan, kita memilih Kotlin sebagai DSL bahasa skrip build, tetapi contoh lengkap untuk Groovy juga ditampilkan di akhir topik ini.


> gradle init
Starting a Gradle Daemon (subsequent builds will be faster)

Select type of project to generate:
1: basic
2: application
3: library
4: Gradle plugin
Enter selection (default: basic) [1..4] 2

Select implementation language:
1: C++
2: Groovy
3: Java
4: Kotlin
5: Scala
6: Swift
Enter selection (default: Java) [1..6] 3

Generate multiple subprojects for application? (default: no) [yes, no] no
Select build script DSL:
1: Kotlin
2: Groovy
Enter selection (default: Kotlin) [1..2] <Enter>

Select test framework:
1: JUnit 4
2: TestNG
3: Spock
4: JUnit Jupiter
Enter selection (default: JUnit Jupiter) [1..4] 4

Project name (default: demo): <Enter>
Source package (default: demo): <Enter>
Enter target version of Java (min. 7) (default: 11): <Enter>
Generate build using new APIs and behavior (some features may change in the next minor release)? (default: no) [yes, no] <Enter>

> Task :init
To learn more about Gradle by exploring our Samples at https://docs.gradle.org/8.4/samples/sample_building_java_applications.html

BUILD SUCCESSFUL in 3m 43s
2 actionable tasks: 2 executed

Setelah init tugas selesai, demo direktori berisi struktur pohon berikut. Kami melihat lebih dekat pada file build utama, build.gradle.kts (disorot dengan warna merah), di bagian selanjutnya.


├── app
│   ├── build.gradle.kts
│   └── src
│       ├── main
│       │   ├── java
│       │   │   └── demo
│       │   │       └── App.java
│       │   └── resources
│       └── test
│           ├── java
│           │   └── demo
│           │       └── AppTest.java
│           └── resources
├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
└── settings.gradle.kts

build.gradle.ktsFile berisi konten perancah berikut.


/*
 * This file was generated by the Gradle 'init' task.
 *
 * This generated file contains a sample Java application project to get you started.
 * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.4/userguide/building_java_projects.html in the Gradle documentation.
 */

plugins {
    // Apply the application plugin to add support for building a CLI application in Java.
    application
}

repositories {
    // Use Maven Central for resolving dependencies.
    mavenCentral()
}

dependencies {
    // Use JUnit Jupiter for testing.
    testImplementation("org.junit.jupiter:junit-jupiter:5.9.3")

    testRuntimeOnly("org.junit.platform:junit-platform-launcher")

    // This dependency is used by the application.
    implementation("com.google.guava:guava:33.3.0-jre")
}

// Apply a specific Java toolchain to ease working on different environments.
java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(11))
    }
}

application {
    // Define the main class for the application.
    mainClass.set("demo.App")
}

tasks.named<Test>("test") {
    // Use JUnit Platform for unit tests.
    useJUnitPlatform()
}

Gunakan file build Gradle scaffolded sebagai dasar untuk proyek Anda. AWS
1. Untuk mengelola SDK dependensi proyek Gradle Anda, tambahkan tagihan material (BOM) Maven AWS SDK for Java 2.x untuk bagian dependencies file. build.gradle.kts
```
...
dependencies {
    implementation(platform("software.amazon.awssdk:bom:2.27.21"))
    // With the bom declared, you specify individual SDK dependencies without a version.
 ...
}
...
```
  catatan
  Dalam contoh file build ini, ganti 2.27.21 dengan versi terbaru SDK untuk Java 2.x. Temukan versi terbaru yang tersedia di repositori pusat Maven.
2. Tentukan SDK modul yang dibutuhkan aplikasi Anda di dependencies bagian ini. Sebagai contoh, berikut ini menambahkan ketergantungan pada Amazon Simple Storage Service.
```
...
dependencies {    
    implementation(platform("software.amazon.awssdk:bom:2.27.21"))
    implementation("software.amazon.awssdk:s3")
 ...
}
...
```
  Gradle secara otomatis menyelesaikan versi dependensi yang dideklarasikan dengan menggunakan informasi dari. BOM

Contoh berikut menunjukkan file build Gradle lengkap di Kotlin dan Groovy. DSLs File build berisi dependensi untuk Amazon S3, otentikasi, logging, dan pengujian. Versi sumber dan target Java adalah versi 11.

Kotlin DSL (build.gradle.kts)


/*
 * This file was generated by the Gradle 'init' task.
 *
 * This generated file contains a sample Java application project to get you started.
 * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.4/userguide/building_java_projects.html in the Gradle documentation.
 */

plugins {
    // Apply the application plugin to add support for building a CLI application in Java.
    application
}

repositories {
    // Use Maven Central for resolving dependencies.
    mavenCentral()
}

dependencies {
    implementation(platform("software.amazon.awssdk:bom:2.20.56"))
    implementation("software.amazon.awssdk:s3")
    implementation("software.amazon.awssdk:sso")
    implementation("software.amazon.awssdk:ssooidc")
    implementation(platform("org.apache.logging.log4j:log4j-bom:2.20.0"))
    implementation("org.apache.logging.log4j:log4j-slf4j2-impl")
    implementation("org.apache.logging.log4j:log4j-1.2-api")
    testImplementation(platform("org.junit:junit-bom:5.10.0"))
    testImplementation("org.junit.jupiter:junit-jupiter")
}

// Apply a specific Java toolchain to ease working on different environments.
java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(11))
    }
}

application {
    // Define the main class for the application.
    mainClass.set("demo.App")
}

tasks.named<Test>("test") {
    // Use JUnit Platform for unit tests.
    useJUnitPlatform()
}

Groovy DSL (build.gradle)


/*
 * This file was generated by the Gradle 'init' task.
 *
 * This generated file contains a sample Java application project to get you started.
 * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.4/userguide/building_java_projects.html in the Gradle documentation.
 */

plugins {
    // Apply the application plugin to add support for building a CLI application in Java.
    id 'application'
}

repositories {
    // Use Maven Central for resolving dependencies.
    mavenCentral()
}

dependencies {
    implementation platform('software.amazon.awssdk:bom:2.27.21')
    implementation 'software.amazon.awssdk:s3'
    implementation 'software.amazon.awssdk:sso'
    implementation 'software.amazon.awssdk:ssooidc'
    implementation platform('org.apache.logging.log4j:log4j-bom:2.20.0')
    implementation 'org.apache.logging.log4j:log4j-slf4j2-impl'
    implementation 'org.apache.logging.log4j:log4j-1.2-api'
    testImplementation platform('org.junit:junit-bom:5.10.0')
    testImplementation 'org.junit.jupiter:junit-jupiter'
}

// Apply a specific Java toolchain to ease working on different environments.
java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(11)
    }
}

application {
    // Define the main class for the application.
    mainClass = 'demo_groovy.App'
}

tasks.named('test') {
    // Use JUnit Platform for unit tests.
    useJUnitPlatform()
}

Untuk langkah selanjutnya, lihat panduan Memulai di situs web Gradle untuk petunjuk tentang cara membuat dan menjalankan aplikasi Gradle.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Siapkan proyek Apache Maven

Siapkan proyek Gambar Asli GraalVM

Menyiapkan proyek Gradle

Untuk membuat aplikasi Java dengan Gradle (baris perintah)

catatan