Instrukcje konfiguracji

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

Zobacz też instrukcje konfigurowania ProGuarda, które są częścią dokumentacji biblioteki klienta HTTP Google dla języka Java.

Pobieranie biblioteki z zależnymi komponentami

Pobierz najnowszy plik ZIP, który znajdziesz na stronie pobierania, i rozpakuj go na komputerze. Ten plik ZIP zawiera pliki jar klas biblioteki klienta oraz powiązane źródłowe pliki jar, w których występują poszczególne artefakty i ich zależności. Wykresy zależności i licencje dla różnych bibliotek znajdziesz w folderze zależności. Szczegółowe informacje o treści pobieranego pliku znajdziesz w pliku readme.html.

Android

Jeśli tworzysz aplikację na Androida, a interfejs API Google, którego chcesz użyć, jest zawarty w bibliotece Usług Google Play, użyj tej biblioteki, aby uzyskać najlepszą wydajność i wrażenia.

Jeśli używasz biblioteki klienta Google API dla Javy na Androidzie, musisz wiedzieć, które zależności są zgodne z Androidem, a w szczególności na jakim poziomie interfejsu API Androida. Aplikacje na Androida wymagają tych plików JAR lub nowszych kompatybilnych wersji z folderu libs:

• google-api-client-2.4.0.jar
• google-api-client-android-2.4.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

Ostrzeżenie: w przypadku Androida MUSISZ umieścić pliki .jar w katalogu „libs”, aby program pakujący pliki APK mógł je znaleźć. W przeciwnym razie podczas działania wystąpi błąd NoClassDefFoundError.

Google App Engine

Aplikacje Google App Engine wymagają tych plików JAR lub nowszych kompatybilnych wersji z folderu libs:

• google-api-client-2.4.0.jar
• google-api-client-appengine-2.4.0.jar
• google-api-client-servlet-2.4.0.jar
• google-oauth-client-1.34.1.jar
• google-oauth-client-appengine-1.34.1.jar
• google-oauth-client-servlet-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 serwletowe wymagają następujących plików jar lub nowszych zgodnych wersji z folderu libs:

• google-api-client-2.4.0.jar
• google-api-client-servlet-2.4.0.jar
• google-oauth-client-1.34.1.jar
• google-oauth-client-servlet-1.34.1.jar
• google-http-client-1.42.2.jar
• commons-logging-1.2.jar
• gson-2.9.0.jar
• httpclient-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 ogólnego przeznaczenia w Javie wymagają tych plików JAR lub nowszych kompatybilnych wersji z folderu libs:

• google-api-client-2.4.0.jar
• google-oauth-client-1.34.1.jar
• google-http-client-1.42.2.jar
• google-http-client-jackson2-1.39.2.jar
• commons-logging-1.2.jar
• gson-2.9.0.jar
• httpclient-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

wygenerowane biblioteki dla interfejsów Google API;

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

Maven

Biblioteka klienta interfejsów API Google do języka Java znajduje się w centralnym repozytorium Maven. Wartość groupId w Mavenie dla wszystkich artefaktów w tej bibliotece to com.google.api-client. Szczegółowe instrukcje dotyczące Mavena znajdziesz w przypadku każdego modułu (poniżej).

Moduły

Biblioteka składa się z 9 modułów:

• google-api-client
• google-api-client-android
• google-api-client-appengine
• google-api-client-servlet
• google-api-client-gson
• google-api-client-jackson2
• google-api-client-protobuf
• google-api-client-xml

klient google-api-client

Biblioteka klienta interfejsu API Google dla języka Java (google-api-client) została zaprojektowana tak, aby była zgodna ze wszystkimi obsługiwanymi platformami Java, w tym Androidem.

Korzystanie z Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.4.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.4.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 na platformę Google Android w języku Java (tylko w przypadku pakietu SDK w wersji co najmniej 2.1). Ten moduł zależy od pakietów google-api-client i google-http-client-android.

Korzystanie z Maven:

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

google-api-client-servlet

Rozszerzenia servleta i JDO do biblioteki klienta interfejsu API Google dla języka Java (google-api-client-servlet) obsługują aplikacje internetowe servletów w języku Java. Ten moduł korzysta z interfejsów google-api-client i google-oauth-client-servlet.

Korzystanie z Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-servlet</artifactId>
  <version>2.4.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 App Engine w języku Java. Ten moduł korzysta z interfejsów google-api-client, google-api-client-servlet, google-oauth-client-appengine i google-http-client-appengine.

Korzystanie z Maven:

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

google-api-client-gson

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

Korzystanie z Maven:

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

google-api-client-jackson2

rozszerzenie Jackson2 do biblioteki klienta interfejsu API Google dla języka Java (google-api-client-jackson2). Ten moduł korzysta z interfejsów google-api-client i google-http-client-jackson2.

Korzystanie z Maven:

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

google-api-client-protobuf

rozszerzenia Protocol Buffer do biblioteki klienta interfejsu API Google dla języka Java (google-api-client-protobuf); Ten moduł korzysta z protokołów google-http-client-protobuf i google-api-client.

Korzystanie z Maven:

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

google-api-client-xml

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

Korzystanie z Maven:

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