使用軟體開發套件搭配 Apache Maven - AWS SDK for Java 1.x
建立新的 Maven 套件將 SDK 設定為 Maven 相依性建立專案使用 Maven 建置 SDK

AWS SDK for Java 1.x 已於 2025 年 12 月 31 日end-of-support。我們建議您遷移至 AWS SDK for Java 2.x，以繼續接收新功能、可用性改善和安全性更新。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用軟體開發套件搭配 Apache Maven

您可以使用 Apache Maven 來設定和建置 AWS SDK for Java 專案，或建置 SDK 本身。

注意

您必須已安裝 Maven 才能使用本主題中的指導方針。如果尚未安裝，請造訪 http://maven.apache.org/ 進行下載和安裝。

建立新的 Maven 套件

若要建立基本 Maven 套件，請開啟終端機 （命令列） 視窗並執行：

mvn -B archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DgroupId=org.example.basicapp \
  -DartifactId=myapp

將 org.example.basicapp 取代為應用程式的完整套件命名空間，並將 myapp 取代為專案的名稱 （這會成為專案的目錄名稱）。

根據預設， 會使用 quickstart 原型為您建立專案範本，這是許多專案的理想起點。有更多可用的原型；請造訪 Maven 原型頁面以取得 封裝的原型清單。您可以將 -DarchetypeArtifactId 引數新增到 archetype:generate 命令，選擇使用特定原型。例如：

mvn archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DarchetypeArtifactId=maven-archetype-webapp \
  -DgroupId=org.example.webapp \
  -DartifactId=mywebapp
注意

Maven 入門指南提供建立和設定專案的更多相關資訊。

將 SDK 設定為 Maven 相依性

若要在專案 AWS SDK for Java 中使用 ，您需要在專案的 pom.xml 檔案中將其宣告為相依性。從 1.9.0 版開始，您可以匯入個別元件或整個 SDK。

指定個別 SDK 模組

若要選取個別 SDK 模組，請使用 Maven 的物料 AWS SDK for Java 清單 (BOM)，這將確保您指定的模組使用相同版本的 SDK，且彼此相容。

若要使用 BOM，請將 <dependencyManagement>區段新增至應用程式的 pom.xml 檔案，新增 aws-java-sdk-bom做為相依性，並指定您要使用的 SDK 版本：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.11.1000</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

若要檢視 Maven Central 上提供的 AWS SDK for Java BOM 最新版本，請造訪：https：//https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom。您也可以使用此頁面來查看哪些模組 （相依性） 是由 BOM 管理，您可以包含在專案pom.xml檔案的 <dependencies>區段中。

您現在可以從應用程式中使用的 SDK 中選取個別模組。由於您已經在 BOM 中宣告開發套件版本，所以不需要指定每個元件的版本編號。

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>

您也可以參閱 AWS 程式碼範例目錄 ，以了解要用於指定 的相依性 AWS 服務。請參閱特定服務範例下的 POM 檔案。例如，如果您對 AWS S3 服務的相依性感興趣，請參閱 GitHub 上的完整範例。（查看 /java/example_code/s3 下的 pom)。

匯入所有 SDK 模組

如果您想要提取整個開發套件做為相依性，請不要使用 BOM 方法，只需pom.xml像這樣在 中宣告：

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk</artifactId>
    <version>1.11.1000</version>
  </dependency>
</dependencies>

建立專案

設定專案後，您可以使用 Maven 的package命令建置專案：

mvn package

這將在 target目錄中建立您的 –0—jar 檔案。

使用 Maven 建置 SDK

您可以使用 Apache Maven 從來源建置 SDK。若要這樣做，請從 GitHub 下載 SDK 程式碼，在本機解壓縮，然後執行下列 Maven 命令：

mvn clean install