翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# を使用する Gradle プロジェクトを設定する AWS SDK for Java 2.x
[Gradle](https://gradle.org/) を使用して、 AWS SDK for Java 2.x プロジェクトを設定および構築できます。
次の例での最初のステップは、「[Gradle's Getting Started guide](https://docs.gradle.org/current/samples/sample_building_java_applications.html)」バージョン 8.4 用からのものです。別のバージョンを使用すると、結果が多少異なる場合があります。
**Gradle で Java アプリケーションを作成する方法 (コマンドライン)**
1. プロジェクトを格納するディレクトリを作成します。この例では、`demo` がディレクトリ名です。
1. `demo` ディレクトリ内で `gradle init` コマンドを実行し、次のコマンドライン出力に示すように、赤で強調表示されている値を指定します。ここでは、ビルドスクリプト DSL 言語として「Kotlin」を選択しますが、このトピックの最後には「Groovy」の完全な例も示されています。
```
> 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]
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):
Source package (default: demo):
Enter target version of Java (min. 7) (default: 11):
Generate build using new APIs and behavior (some features may change in the next minor release)? (default: no) [yes, no]
> 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
```
1. `init` タスクが完了すると、`demo` ディレクトリには次のツリー構造を含みます。次のセクションでは、メインのビルドファイル、`build.gradle.kts` (赤でハイライト) を詳しく見ていきます。
```
├── 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.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 {
// 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") {
// Use JUnit Platform for unit tests.
useJUnitPlatform()
}
```
1. スキャフォールドされた Gradle ビルドファイルを AWS プロジェクトの基礎として使用します。
1. Gradle プロジェクトの SDK 依存関係を管理するには、 の Maven 部品表 (BOM) AWS SDK for Java 2.x を `build.gradle.kts`ファイルの `dependencies`セクションに追加します。
```
...
dependencies {
implementation(platform("software.amazon.awssdk:bom:2.27.21"))
// With the bom declared, you specify individual SDK dependencies without a version.
...
}
...
```
**注記**
この例では、 *2.27.21*を SDK for Java 2.x の最新バージョンに置き換えます。[Maven 中央リポジトリ](https://central.sonatype.com/artifact/software.amazon.awssdk/bom/versions)で入手可能な最新バージョンを確認してください。
1. アプリケーションが必要とする SDK モジュールを `dependencies` セクションで指定してください。例として、以下では Amazon Simple Storage Service への依存関係を追加します。
```
...
dependencies {
implementation(platform("software.amazon.awssdk:bom:2.27.21"))
implementation("software.amazon.awssdk:s3")
...
}
...
```
Gradle は BOM の情報を使用して、正しいバージョンの宣言された依存関係を自動的に解決します。
以下の例は、Kotlin と Groovy DSL の両方における完全な Gradle ビルドファイルを示しています。ビルドファイルには、Amazon S3、認証、ログ記録、テストの依存関係が含まれています。Java のソースおよびターゲットバージョンはバージョン 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") {
// 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()
}
```
------
次のステップについては、Gradle ウェブサイトの「入門ガイド」で、[Gradle アプリケーションをビルドして実行する](https://docs.gradle.org/current/samples/sample_building_java_applications.html#run_the_application)方法を確認してください。