Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Siapkan proyek Apache Maven yang menggunakan AWS SDK for Java 2.x
<a name="setup-project-maven"></a>

Anda dapat menggunakan [Apache Maven](https://maven.apache.org/) untuk menyiapkan dan membangun AWS SDK for Java 2.x proyek, atau untuk [membangun SDK itu sendiri](https://github.com/aws/aws-sdk-java-v2/tree/master#building-from-source).

## Prasyarat
<a name="prerequisitesmaven"></a>

Untuk menggunakan SDK for Java 2.x dengan Maven, Anda memerlukan yang berikut ini:
+ Java *8.0 atau yang lebih baru*. Anda dapat mengunduh perangkat lunak Java SE Development Kit terbaru dari [http://www.oracle. com/technetwork/java/javase/downloads](https://www.oracle.com/java/technologies/downloads/)/. SDK for Java 2.x juga bekerja dengan [OpenJDK Amazon Corretto dan, distribusi Open](https://openjdk.org/) Java Development Kit (OpenJDK). Unduh versi OpenJDK terbaru dari. [https://openjdk.java.net/install/index.html](https://openjdk.org/install/index.html) Unduh versi Amazon Corretto 8 atau Amazon Corretto 11 terbaru [dari Corretto halaman](https://aws.amazon.com/corretto/).
+  *Apache Maven*. Jika Anda perlu menginstal Maven, buka [http://maven.apache.org/](https://maven.apache.org/) untuk mengunduh dan menginstalnya.

## Buat proyek Maven
<a name="create-maven-project"></a>

Untuk membuat proyek Maven dari baris perintah, jalankan perintah berikut dari terminal atau jendela prompt perintah. `` ``

```
mvn -B archetype:generate \
 -DarchetypeGroupId=software.amazon.awssdk \
 -DarchetypeArtifactId=archetype-lambda -Dservice=s3 -Dregion=US_WEST_2 \
 -DarchetypeVersion=2.X.X \
 -DgroupId=com.example.myapp \
 -DartifactId=myapp
```

**catatan**  
Ganti *com.example.myapp* dengan namespace paket lengkap aplikasi Anda. Juga ganti *myapp* dengan nama proyek Anda. Ini menjadi nama direktori untuk proyek Anda.  
Untuk menggunakan arketipe versi terbaru, ganti *2.X.X* dengan yang [terbaru dari](https://central.sonatype.com/artifact/software.amazon.awssdk/archetype-lambda) Maven central.

Perintah ini membuat proyek Maven menggunakan toolkit templating arketipe. Pola dasar menghasilkan perancah untuk proyek penangan fungsi. AWS Lambda Arketipe proyek ini telah dikonfigurasi sebelumnya untuk dikompilasi dengan Java SE 8 dan menyertakan ketergantungan ke versi SDK for Java 2.x yang ditentukan dengan. `-DarchetypeVersion`

Untuk informasi selengkapnya tentang membuat dan mengonfigurasi proyek Maven, lihat Panduan Memulai [Maven](https://maven.apache.org/guides/getting-started/).

## Konfigurasikan compiler Java untuk Maven
<a name="configure-maven-compiler"></a>

Jika Anda membuat proyek menggunakan pola dasar AWS Lambda proyek seperti yang dijelaskan sebelumnya, konfigurasi kompiler Java sudah dilakukan untuk Anda.

Untuk memverifikasi bahwa konfigurasi ini ada, mulailah dengan membuka `pom.xml` file dari folder proyek yang Anda buat (misalnya,`myapp`) ketika Anda menjalankan perintah sebelumnya. Lihat pada baris 11 dan 12 untuk melihat pengaturan versi kompiler Java untuk proyek Maven ini, dan penyertaan yang diperlukan dari plugin kompiler Maven pada baris 71-75.

```
<project>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>${maven.compiler.plugin.version}</version>
      </plugin>
    </plugins>
  </build>
</project>
```

**Jika Anda membuat proyek dengan pola dasar yang berbeda atau dengan menggunakan metode lain, Anda harus memastikan bahwa plugin kompiler Maven adalah bagian dari build dan properti sumber dan targetnya disetel ke 1.8 dalam file.** `pom.xml`

Lihat cuplikan sebelumnya untuk satu cara mengonfigurasi pengaturan yang diperlukan ini.

Atau, Anda dapat mengkonfigurasi konfigurasi kompiler sebaris dengan deklarasi plugin, sebagai berikut.

```
<project>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>
```

## Mendeklarasikan SDK sebagai dependensi
<a name="sdk-as-dependency"></a>

Untuk menggunakan AWS SDK untuk Java dalam proyek Anda, Anda perlu mendeklarasikannya sebagai dependensi dalam file proyek Anda. `pom.xml`

Jika Anda membuat proyek menggunakan pola dasar proyek seperti yang dijelaskan sebelumnya, versi terbaru SDK sudah dikonfigurasi sebagai dependensi dalam proyek Anda. 

Pola dasar menghasilkan ketergantungan artefak BOM (bill of material) untuk id grup. `software.amazon.awssdk` Dengan BOM, Anda tidak perlu menentukan versi maven untuk dependensi artefak individual yang berbagi id grup yang sama.

Jika Anda membuat proyek Maven dengan cara yang berbeda, konfigurasikan versi terbaru SDK untuk proyek Anda dengan memastikan bahwa `pom.xml` file tersebut berisi yang berikut ini.

```
<project>
  <properties>
    <aws.java.sdk.version>2.X.X</aws.java.sdk.version>
  </properties>
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>bom</artifactId>
        <version>${aws.java.sdk.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
</project>
```

**catatan**  
Ganti *2.X.X* dalam `pom.xml` file dengan [versi terbaru dari](https://central.sonatype.com/artifact/software.amazon.awssdk/bom) file AWS SDK for Java 2.x.

## Tetapkan dependensi untuk modul SDK
<a name="modules-dependencies"></a>

Sekarang setelah Anda mengonfigurasi SDK, Anda dapat menambahkan dependensi untuk satu atau beberapa AWS SDK untuk Java modul yang akan digunakan dalam proyek Anda.

Meskipun Anda dapat menentukan nomor versi untuk setiap komponen, Anda tidak perlu melakukannya karena Anda sudah mendeklarasikan versi SDK di `dependencyManagement` bagian menggunakan artefak tagihan bahan. Untuk memuat versi berbeda dari modul yang diberikan, tentukan nomor versi untuk ketergantungannya.

Jika Anda membuat proyek menggunakan pola dasar proyek seperti yang dijelaskan sebelumnya, proyek Anda sudah dikonfigurasi dengan beberapa dependensi. Ini termasuk dependensi untuk penangan AWS Lambda fungsi dan Amazon S3, sebagai berikut.

```
<project>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>s3</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>software.amazon.awssdk</groupId>
                    <artifactId>netty-nio-client</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>software.amazon.awssdk</groupId>
                    <artifactId>apache-client</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>url-connection-client</artifactId>
        </dependency>

        <dependency>
            <groupId>com.amazonaws</groupId>
            <artifactId>aws-lambda-java-core</artifactId>
            <version>${aws.lambda.java.version}</version>
        </dependency>
    </dependencies>
</project>
```

**catatan**  
Pada `pom.xml` contoh di atas, dependensi berasal dari s yang berbeda`groupId`. `s3`Ketergantungan berasal dari`software.amazon.awssdk`, sedangkan `aws-lambda-java-core` dependensi berasal dari. `com.amazonaws` Konfigurasi manajemen ketergantungan BOM memengaruhi artefak untuk`software.amazon.awssdk`, sehingga diperlukan versi untuk artefak. `aws-lambda-java-core`  
Untuk pengembangan *penangan fungsi Lambda* menggunakan SDK for Java 2.x`aws-lambda-java-core`, adalah dependensi yang benar. Namun, jika aplikasi Anda perlu mengelola sumber daya Lambda, menggunakan operasi seperti`listFunctions`,,, dan `deleteFunction` `invokeFunction``createFunction`, aplikasi Anda memerlukan dependensi berikut.   

```
<groupId>software.amazon.awssdk</groupId>
<artifactId>lambda</artifactId>
```

**catatan**  
`s3`Ketergantungan mengecualikan dependensi `netty-nio-client` dan `apache-client` transitif. Sebagai pengganti salah satu klien HTTP tersebut, arketipe mencakup `url-connection-client` ketergantungan, yang membantu [mengurangi latensi startup untuk fungsi](lambda-optimize-starttime.md#lambda-quick-url). AWS Lambda 

Tambahkan modul ke proyek Anda untuk Layanan AWS dan fitur yang Anda butuhkan untuk proyek Anda. Modul (dependensi) yang dikelola oleh AWS SDK untuk Java BOM terdaftar di repositori pusat [Maven](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).

**catatan**  
Anda dapat melihat `pom.xml` file dari contoh kode untuk menentukan dependensi mana yang Anda butuhkan untuk proyek Anda. [Misalnya, jika Anda tertarik dengan dependensi untuk layanan DynamoDB, lihat [contoh ini dari Repositori Contoh Kode](https://github.com/awsdocs/aws-doc-sdk-examples/blob/da520cb4436f8567a90b6f73f77232fd590a50bf/javav2/example_code/dynamodb/pom.xml) di.AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2) GitHub (Cari `pom.xml` file di bawah [/javav2/example\$1code/dynamodb](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/dynamodb).)

### Membangun seluruh SDK ke dalam proyek Anda
<a name="build-the-entire-sdk-into-your-project"></a>

Untuk mengoptimalkan aplikasi Anda, kami sangat menyarankan agar Anda hanya menarik komponen yang Anda butuhkan, bukan seluruh SDK. Namun, untuk membangun keseluruhan AWS SDK untuk Java ke dalam proyek Anda, nyatakan dalam `pom.xml` file Anda, sebagai berikut.

```
<project>
  <dependencies>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>aws-sdk-java</artifactId>
      <version>2.X.X</version>
    </dependency>
  </dependencies>
</project>
```

## Bangun proyek Anda
<a name="build-project"></a>

Setelah Anda mengkonfigurasi `pom.xml` file, Anda dapat menggunakan Maven untuk membangun proyek Anda.

Untuk membangun proyek Maven Anda dari baris perintah, buka jendela terminal atau command prompt, arahkan ke direktori proyek Anda (misalnya,`myapp`), masukkan atau tempel perintah berikut, lalu tekan Enter atau Return.

```
mvn package
```

Ini menciptakan satu `.jar` file (JAR) di `target` direktori (misalnya,`myapp/target`). JAR ini berisi semua modul SDK yang Anda tentukan sebagai dependensi dalam file Anda. `pom.xml`