Инструкции по настройке

Вы можете скачать клиентскую библиотеку Google OAuth для Java и ее зависимости в виде ZIP-файла или использовать Maven.

Также ознакомьтесь с инструкциями по настройке ProGuard в документации по клиентской библиотеке Google HTTP-клиента для Java.

Скачайте библиотеку с зависимостями

Скачайте последнюю версию ZIP-файла со страницы загрузок и распакуйте его на компьютере. В этом ZIP-файле содержатся JAR-файлы классов клиентской библиотеки и связанные с ними JAR-файлы исходного кода для каждого артефакта и их зависимостей. Графики зависимостей и лицензии для разных библиотек можно найти в папке dependencies. Подробную информацию о содержимом скачанного файла можно найти в файле readme.html.

Android

Если вы разрабатываете приложение для Android и нужный вам API Google включен в библиотеку сервисов Google Play, используйте эту библиотеку, чтобы обеспечить максимальную производительность и удобство.

Если вы используете клиентскую библиотеку Google OAuth для Java с Android, важно знать, какие зависимости совместимы с Android, в частности с каким уровнем Android SDK. Для приложений Android требуются следующие JAR-файлы или более новые совместимые версии из папки libs:

  • 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 требуются следующие JAR-файлы (или более новые совместимые версии) из папки libs:

  • 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

Сервлет

Для приложений сервлетов требуются следующие JAR-файлы (или более новые совместимые версии) из папки libs:

  • 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 общего назначения требуются следующие JAR-файлы (или более новые совместимые версии) из папки libs:

  • 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

Клиентская библиотека Google OAuth для Java находится в центральном репозитории Maven. groupId Maven для всех артефактов этой библиотеки – com.google.oauth-client. Инструкции по работе с Maven приведены ниже для каждого модуля.

Модули

Эта библиотека состоит из пяти модулей:

google-oauth-client

Клиентская библиотека Google OAuth для Java (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

Расширения Servlet и JDO для клиентской библиотеки Google OAuth для Java (google-oauth-client-servlet) поддерживают веб-приложения Java Servlet. Этот модуль зависит от 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

Расширения Google App Engine для клиентской библиотеки Google OAuth для Java (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 6 (и более поздних версий) для клиентской библиотеки Google OAuth для Java (google-oauth-client-java6) поддерживают приложения Java 6 и более поздних версий. Этот модуль зависит от 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

Расширения Jetty для клиентской библиотеки Google OAuth для Java (google-oauth-client-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>