Instructions de configuration

Vous pouvez télécharger la bibliothèque cliente Google OAuth pour Java et ses dépendances dans un fichier ZIP, ou utiliser Maven.

Consultez également les instructions de configuration de ProGuard qui font partie de la documentation de la bibliothèque cliente HTTP Google pour Java.

Télécharger la bibliothèque avec les dépendances

Téléchargez le dernier fichier ZIP, disponible sur la page de téléchargements, puis extrayez-le sur votre ordinateur. Ce fichier ZIP contient la classe de la bibliothèque cliente jar et les fichiers JAR sources associés pour chaque artefact, ainsi que leurs les dépendances. Vous trouverez des graphiques de dépendances et des licences pour les différents bibliothèques dans le dossier des dépendances. Pour en savoir plus sur le contenu de la consultez le fichier readme.html.

Android

Si vous développez pour Android et que l'API Google que vous souhaitez utiliser est incluse dans la bibliothèque Google Play Services, utilisez la bibliothèque Google Play Services pour obtenir les meilleures performances et l'expérience optimale.

Si vous utilisez la bibliothèque cliente Google OAuth pour Java avec Android, elle est il est important de connaître les dépendances compatibles avec Android, en particulier à quel niveau de SDK Android. Les applications Android nécessitent les fichiers JAR suivants, ou des versions compatibles plus récentes, à partir du dossier 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

Les applications Google App Engine nécessitent les fichiers JAR suivants (ou versions ultérieures) versions compatibles, à partir du dossier "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

Servlet

Les applications servlet nécessitent les fichiers JAR suivants, ou des versions compatibles plus récentes, du dossier 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 générique

Les applications Java à usage général nécessitent les fichiers JAR suivants (ou versions ultérieures). versions compatibles, à partir du dossier "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

La bibliothèque cliente Google OAuth pour Java se trouve Maven. Le groupId Maven pour tous les artefacts de cette bibliothèque est com.google.oauth-client. Des instructions Maven spécifiques sont fournies pour chaque module (ci-dessous).

Modules

Cette bibliothèque se compose de cinq modules :

google-oauth-client

La bibliothèque cliente Google OAuth pour Java (google-oauth-client) a été conçue compatible avec toutes les plates-formes Java compatibles, y compris Android.

Utilisation de Maven:

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

Sur Android, vous devez exclure explicitement les dépendances inutilisées :

<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

Extensions servlet et JPO vers la bibliothèque cliente Google OAuth pour Java (google-oauth-client-servlet) sont compatibles avec les applications Web servlet Java. Ce module dépend de google-oauth-client.

Utilisation de Maven:

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

google-oauth-client-appengine

Extensions Google App Engine pour la bibliothèque cliente Google OAuth pour Java (google-oauth-client-appengine) sont compatibles avec les applications Java Google App Engine. Ce module dépend de google-oauth-client et de google-oauth-client-servlet.

Utilisation de Maven:

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

google-oauth-client-java6

Extensions Java 6 (ou version ultérieure) vers la bibliothèque cliente Google OAuth pour Java (google-oauth-client-java6) prend en charge les applications Java6+. Ce module dépend de google-oauth-client.

Utilisation de Maven:

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

google-oauth-client-jetty

Les extensions Jetty de la bibliothèque cliente Google OAuth pour Java (google-oauth-client-jetty) prennent en charge le flux de code d'autorisation pour les applications installées. Ce module dépend de google-oauth-client-java6.

Utilisation de Maven :

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