從來源建構 Java 適用的用戶端程式庫

請盡可能透過 Maven 或 Gradle 使用用戶端程式庫。二進位檔發行版本可透過 Maven Central 存放區取得 (詳情請參閱快速入門指南)。不過，您可以使用本頁所述的建構程序自行建構程式庫。

用戶端程式庫是使用 Gradle 建構而成。依附元件是從 Maven Central 中央存放區下載。

注意： 如果您從來源建構程式庫，請務必在 IDE 中啟用註解處理功能。

安裝 Java Development Kit

您必須使用 JDK 8 以上版本，才能建構程式庫。本指南假設您的電腦已安裝 Java。

使用 Gradle 建構

使用隨附的 Gradle 包裝函式。請參閱 gradle-wrapper.properties，瞭解已設定的 Gradle 包裝函式版本。您不需要另外安裝 Gradle。

建構程式庫

1. 將專案複製到本機 google-ads-java 目錄：

   git clone https://github.com/googleads/google-ads-java.git google-ads-java
   

2. 請前往 google-ads-java 目錄：

   cd google-ads-java
   

3. 執行下列指令，建構程式庫和範例專案的快照版本：

   ./gradlew build
   

   注意： 在 Windows 上，請使用 gradlew，而非 ./gradlew。

4. 將用戶端程式庫匯出至本機 Maven 存放區：

   ./gradlew publishToMavenLocal
   

   注意： 即使您先前未使用或安裝 Maven，也可以將程式庫匯出至本機存放區。系統會視需要建立目錄。

在本機 Maven 存放區中使用用戶端程式庫

成功建構及匯出後，Maven 和 Gradle 就能從本機存放區 (通常是 ~/.m2/repository/com/google/api-ads/google-ads/) 取得用戶端程式庫的構件。請查看 gradle.properties，瞭解目前的 SNAPSHOT 版本字串，然後在專案建構檔案中新增該 SNAPSHOT 版本的依附元件。

在 Maven (pom.xml) 中：

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>VERSION-SNAPSHOT</version>
</dependency>

在 Gradle (build.gradle) 中：

implementation 'com.google.api-ads:google-ads:VERSION-SNAPSHOT'