使用軟體開發套件搭配 Apache Maven - AWS SDK for Java 1.x
建立新 Maven 軟體開發套件將軟體開發套件作為 Maven 依存項目建立專案使用 Maven 軟體開發套件

截至 2024 年 7 月 31 日， AWS SDK for Java 1.x 已進入維護模式，並將end-of-support在 2025 年 12 月 31 日送達。我們建議您遷移至 AWS SDK for Java 2.x，以繼續接收新功能、可用性改進和安全性更新。

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

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

您可以使用 Apache Maven 設定及建立AWS SDK for Java的專案或建立開發套件本身。

注意

您必須已安裝 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 替換為項目名稱（這將成為項目的目錄名稱）。

根據預設，會使用快速入門原型為您建立專案範本，這對於許多專案來說都是一個很好的起點。還有更多可用的原型；請訪問 Maven 原型頁面以獲取打包的原型列表。您可以將 -DarchetypeArtifactId 引數新增到 archetype:generate 命令，選擇使用特定原型。例如：

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

有關創建和配置項目的更多信息在 Maven 入門指南中提供。

將軟體開發套件作為 Maven 依存項目

要在項目AWS SDK for Java中使用，您需要將其聲明為項目pom.xml文件中的依賴項。從版本 1.9.0 開始，您可以導入單個組件或整個 SDK。

指定個別的 SDK 模組

要選擇AWS SDK for Java單獨的 SDK 模塊，請使用 Maven 的材料清單（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 中央提供的最新AWS SDK for Java BOM 版本，請造訪：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/例子代碼/s3 下的 POM）。

匯入所有 SDK 模組

如果您想將整個 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 軟體開發套件

您可以使用 Apache Maven 從來源建置軟體開發套件從來源。為此，請從下載 SDK 代碼 GitHub，在本地解壓縮，然後執行以下 Maven 命令：

mvn clean install