Instrukcje konfiguracji

Jeśli nie używasz biblioteki wygenerowanej, możesz pobrać bibliotekę klienta Google API dla Javy i jej zależności w pliku ZIP lub użyć Maven.

Zapoznaj się też z instrukcjami konfigurowania ProGuard, które są częścią dokumentacji klienta Google HTTP dla języka Java.

Pobieranie biblioteki z zależnościami

Pobierz najnowszy plik ZIP, który możesz znaleźć na stronie pobranych plików i rozpakować na komputerze. Ten plik ZIP zawiera pliki jar klasy biblioteki klienta oraz powiązane pliki jar dla każdego artefaktu i jego zależności. W folderze zależności znajdziesz wykresy i licencje dotyczące różnych bibliotek. Aby uzyskać więcej informacji o zawartości pobranego pliku, przeczytaj plik Readme.html.

Android

Gdy programujesz aplikację na Androida, a interfejs Google API, którego chcesz użyć, jest uwzględniony w bibliotece Usług Google Play, zalecamy korzystanie z biblioteki Google Play.

Jeśli używasz biblioteki klienta interfejsu API Google dla języka Java z Androidem, musisz wiedzieć, które zależności są zgodne z Androidem, a zwłaszcza na którym poziomie pakietu SDK Androida. Aplikacje na Androida wymagają tych plików jar lub nowszych zgodnych wersji z folderu libs:

  • google-api-client-2.0.0.jar
  • google-api-client-android-2.0.0.jar,
  • google-oauth-client-1.34.1.jar
  • google-http-client-1.42.2.jar
  • google-http-client-android-1.42.2.jar
  • gson-2.9.0.jar
  • jackson-core-2.13.3.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.21.4.jar

Google App Engine

Aplikacje Google App Engine wymagają następujących plików jar lub nowszych wersji z folderu libs:

  • google-api-client-2.0.0.jar
  • google-api-client-appengine-2.0.0.jar
  • google-api-client-servicelet-2.0.0.jar,
  • google-oauth-client-1.34.1.jar
  • google-oauth-client-appengine-1.34.1.jar
  • google-oauth-client-servicelet-1.34.1.jar,
  • google-http-client-1.42.2.jar
  • google-http-client-appengine-1.39.2.jar
  • gson-2.9.0.jar
  • jackson-core-2.13.3.jar
  • jdo2-api-2.3-eb.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.21.4.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

Serwlet

Aplikacje Servlet wymagają tego folderu jar lub nowszych zgodnych wersji z folderu libs:

  • google-api-client-2.0.0.jar
  • google-api-client-servicelet-2.0.0.jar,
  • google-oauth-client-1.34.1.jar
  • google-oauth-client-servicelet-1.34.1.jar,
  • google-http-client-1.42.2.jar
  • common-logging-1.2.jar
  • gson-2.9.0.jar
  • http://client.4.5.13.jar
  • httpcore-4.4.12.jar
  • jackson-core-2.13.3.jar
  • jdo2-api-2.3-eb.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.21.4.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

Ogólna wersja Java

Aplikacje Javy do ogólnego zastosowania wymagają tych plików jar lub nowszych zgodnych wersji z folderu libs:

  • google-api-client-2.0.0.jar
  • google-oauth-client-1.34.1.jar
  • google-http-client-1.42.2.jar
  • google-http-client-jackson2-1.39.2.jar
  • common-logging-1.2.jar
  • gson-2.9.0.jar
  • http://client.4.5.13.jar
  • httpcore-4.4.12.jar
  • jackson-core-2.13.3.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.21.4.jar
  • xpp3-1.1.4c.jar

Biblioteki utworzone dla interfejsów API Google

Repozytorium wygenerowanych bibliotek zawiera instrukcje korzystania z każdej wersji interfejsów API.

Maven

Biblioteka klienta interfejsu API Google dla języka Java znajduje się w centralnym repozytorium Maven. Wartość Maven groupId dla wszystkich artefaktów tej biblioteki to com.google.api-client. Szczegółowe instrukcje dotyczące Maven znajdziesz w każdym module (poniżej).

Moduły

Ta biblioteka składa się z 9 modułów:

klient-google-api

Biblioteka klienta interfejsu API Google dla języka Java (google-api-client) jest zgodna ze wszystkimi obsługiwanymi platformami Java, w tym z Androidem.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.0.0</version>
</dependency>

Na Androidzie musisz wyraźnie wykluczyć nieużywane zależności:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.0.0</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-api-client-android,

Rozszerzenia biblioteki klienta interfejsu API Google dla języka Java (google-api-client-android) obsługują aplikacje Java Google Android (tylko w przypadku pakietów SDK >= 2.1). Ten moduł zależy od adresów google-api-client i google-http-client-android.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-android</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-serlet

Rozszerzenia Servlet i JDO do biblioteki klienta interfejsu API Google dla języka Java (google-api-client-servlet) obsługują serwletowe Javy. Ten moduł zależy od klienta google-api-client i google-oauth-client-servlet.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-servlet</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-appengine,

Rozszerzenia Google App Engine do biblioteki klienta interfejsu API Google dla języka Java (google-api-client-appengine) obsługują aplikacje Google Google App Engine. Ten moduł zależy od serwerów google-api-client, google-api-client-servlet, google-oauth-client-appengine i google-http-client-appengine.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-appengine</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-gson

Rozszerzenia GSON do biblioteki klienta interfejsu API Google dla języka Java (google-api-client-gson). Ten moduł zależy od klienta google-api-client i google-http-client-gson.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-gson</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-jackson2

rozszerzenia Jackson2 do biblioteki klienta interfejsu API Google dla języka Java (google-api-client-jackson2). Ten moduł zależy od klienta google-api-client i google-http-client-jackson2.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-jackson2</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-java6,

Rozszerzenia języka Java 6 (i nowsze) do biblioteki klienta interfejsu API Google dla języka Java (google-api-client-java6). Ten moduł zależy od klienta google-api-client i google-oauth-client-java6.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-java6</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-protobuf,

Rozbudowa bufora protokołu w bibliotece klienta interfejsu API Google dla języka Java (google-api-client-protobuf). Ten moduł zależy od adresów google-http-client-protobuf i google-api-client.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-protobuf</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-xml,

Rozszerzenia XML biblioteki klienta interfejsu API Google dla języka Java (google-api-client-xml). Ten moduł zależy od adresów google-api-client i google-http-client-xml.

Wykorzystanie Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-xml</artifactId>
  <version>2.0.0</version>
</dependency>