设置说明

您可以下载 Java 版 Google OAuth 客户端库及其依赖项的 ZIP 文件，也可以使用 Maven。

另请参阅 Google HTTP 客户端库（适用于 Java）文档中的 ProGuard 设置说明。

下载包含依赖项的库

下载最新的 zip 文件（可在下载页面上找到），并将其解压缩到计算机上。此 ZIP 文件包含每个工件及其依赖项的客户端库类 jar 文件和关联的源 jar 文件。您可以在依赖项文件夹中找到不同库的依赖关系图和许可。如需详细了解下载内容，请参阅 readme.html 文件。

Android

如果您正在为 Android 开发应用，并且您要使用的 Google API 包含在 Google Play 服务库中，请使用 Google Play 服务库以获得最佳性能和体验。

如果您将 Java 版 Google OAuth 客户端库与 Android 搭配使用，请务必了解哪些依赖项与 Android 兼容，尤其是哪个 Android SDK 级别。Android 应用需要 libs 文件夹中的以下 jar 文件或更新版本的兼容版本：

  • google-oauth-client-1.30.4.jar
  • google-http-client-1.32.1.jar
  • google-http-client-android-1.32.1jar
  • gson-2.8.5.jar
  • jackson-core-2.9.5.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.6.1.jar

Google App Engine

Google App Engine 应用需要 libs 文件夹中的以下 jar 文件或更高兼容版本：

  • google-oauth-client-1.30.4.jar
  • google-oauth-client-appengine-1.30.4.jar
  • google-oauth-client-servlet-1.30.4.jar
  • google-http-client-1.32.1.jar
  • google-http-client-appengine-1.32.1.jar
  • gson-2.8.5.jar
  • jackson-core-2.9.5.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.6.1.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

Servlet

Servlet 应用需要 libs 文件夹中的以下 jar 文件或更高兼容版本：

  • google-oauth-client-1.30.4.jar
  • google-oauth-client-servlet-1.32.1.jar
  • google-http-client-1.32.1.jar
  • 通用日志记录-1.2.0.jar
  • Gson-2.8.5.jar
  • jackson-core-2.9.5.jar
  • httpclient-4.5.9.jar
  • httpcore-4.4.11.jar
  • jackson-core-2.1.3.jar
  • jdo2-api-2.3-eb.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.6.1.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

通用 Java

通用 Java 应用需要 libs 文件夹中的以下 jar 文件或更高兼容版本：

  • google-oauth-client-1.30.4.jar
  • google-http-client-1.32.1.jar
  • 通用日志记录-1.2.0.jar
  • Gson-2.8.5.jar
  • jackson-core-2.9.5.jar
  • httpclient-4.5.9.jar
  • httpcore-4.4.11.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.6.1.jar
  • xpp3-1.1.4c.jar

Maven

Java 版 Google OAuth 客户端库位于 Maven 中央代码库中。此库的所有工件的 Maven groupId 均为 com.google.oauth-client。下面针对每个模块提供了具体的 Maven 说明。

模块

此库由五个模块组成：

google-oauth-client

Java 版 Google OAuth 客户端库 (google-oauth-client) 旨在与所有受支持的 Java 平台（包括 Android）兼容。

Maven 用法：

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client</artifactId>
  <version>1.30.4</version>
</dependency>

在 Android 上，您需要明确排除未使用的依赖项：

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client</artifactId>
  <version>1.30.4</version>
  <exclusions>
    <exclusion>
      <artifactId>xpp3</artifactId>
      <groupId>xpp3</groupId>
    </exclusion>
    <exclusion>
      <artifactId>httpclient</artifactId>
      <groupId>org.apache.httpcomponents</groupId>
    </exclusion>
    <exclusion>
      <artifactId>junit</artifactId>
      <groupId>junit</groupId>
    </exclusion>
    <exclusion>
      <artifactId>android</artifactId>
      <groupId>com.google.android</groupId>
    </exclusion>
  </exclusions>
</dependency>

google-oauth-client-servlet

适用于 Java 的 Google OAuth 客户端库 (google-oauth-client-servlet) 的 Servlet 和 JDO 扩展支持 Java Servlet Web 应用。此模块依赖于 google-oauth-client。

Maven 用法：

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-servlet</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-appengine

Java 版 Google OAuth 客户端库的 Google App Engine 扩展程序 (google-oauth-client-appengine) 支持 Java Google App Engine 应用。此模块依赖于 google-oauth-client 和 google-oauth-client-servlet。

Maven 用法：

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-appengine</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-java6

Java 版 Google OAuth 客户端库 (google-oauth-client-java6) 的 Java 6（及更高版本）扩展支持 Java6+ 应用。此模块依赖于 google-oauth-client。

Maven 用法：

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-java6</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-jetty

Java 版 Google OAuth 客户端库 (google-oauth-client-jetty) 的 Jetty 扩展支持已安装应用的授权代码流程。此模块依赖于 google-oauth-client-java6。

Maven 的用法：

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-jetty</artifactId>
  <version>1.30.4</version>
</dependency>