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

尽可能通过 Maven 或 Gradle 使用客户端库。二进制分发版可通过 Maven Central 制品库获取(如需了解详情,请参阅快速入门指南)。不过,您可以使用本页中介绍的 build 流程自行构建该库。

客户端库是使用 Gradle 构建的。依赖项从 Maven Central 制品库下载。

安装 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
    
  4. 将客户端库导出到本地 Maven 制品库:

    ./gradlew publishToMavenLocal
    

使用本地 Maven 制品库中的客户端库

成功构建并导出后,客户端库的制品将可供 Maven 和 Gradle 从本地代码库(通常为 ~/.m2/repository/com/google/api-ads/google-ads/)获取。查看 gradle.properties 以获取当前的 SNAPSHOT 版本字符串,然后将对该 SNAPSHOT 版本的依赖项添加到项目 build 文件中。

在 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'