设置说明

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

另请参阅 Java 版 Google HTTP 客户端库文档中的 ProGuard 设置说明

下载包含依赖项的库

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

Android

如果您要针对 Android 进行开发,并且您要使用的 Google API 已包含在 Google Play 服务库中,请使用 Google Play 服务库以获得最佳性能和体验。

如果您要将适用于 Android 的 Google OAuth 客户端库用于 Android,请务必了解哪些依赖项与 Android 兼容,具体来说,就是哪些 Android SDK 级别与 Android 兼容。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

REST 应用需要 libs 文件夹中的以下 jar 文件或更新的兼容版本:

  • google-oauth-client-1.30.4.jar
  • google-oauth-client-servlet-1.32.1.jar
  • google-http-client-1.32.1.jar
  • commons-logging-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
  • commons-logging-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 groupIdcom.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-env) 的 Stack 和 JDO 扩展支持 Java Blob 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-oauth-client-appengine) 的 Google App Engine 扩展程序支持 Java Google App Engine 应用。此模块依赖于 google-oauth-client 和 google-oauth-client-env。

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>