从源代码构建 Java 版客户端库

请尽可能通过 Maven 或 Gradle 使用客户端库。二进制分发可通过 Maven 中央存储库获取（如需了解详情，请参阅快速入门指南）。不过，您可以使用本页所述的构建流程自行构建该库。

客户端库是使用 Gradle 构建的。依赖项是从 Maven 中央存储库下载的。

注意： 如果您从源代码构建库，请确保在 IDE 中启用注解处理。

安装 Java 开发套件

需要 JDK 8 或更高版本才能构建库。本指南假定您的机器上已安装 Java。

使用 Gradle 进行构建

使用随附的 Gradle 封装容器。如需了解已配置的 Gradle 封装容器版本，请参阅 gradle-wrapper.properties。您无需单独安装 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 版本字符串，然后向项目 build 文件添加对该 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'