הוראות לביצוע הגדרות

אם אתם לא משתמשים בספרייה שנוצרה, תוכלו להוריד את ספריית הלקוח של Google API ל-Java ואת יחסי התלות שלה בקובץ ZIP, או להשתמש ב-Maven.

קרא גם את הוראות ההגדרה של ProGuard שהן חלק מספריית הלקוח של Google HTTP לתיעוד של Java.

הורדת הספרייה עם יחסי תלות

מורידים את קובץ ה-ZIP העדכני ביותר, שאותו ניתן למצוא בדף ההורדות, ומחלצים אותו במחשב. קובץ ה-ZIP מכיל את קובצי ה-מאגר של המחלקה של ספריית הלקוח ואת קובצי ה-מאגר המשויכים לכל פריט מידע שנוצר בתהליך הפיתוח (Artifact) ויחסי התלות שלו. אפשר למצוא תרשימי תלות ורישיונות לספריות השונות בתיקייה של יחסי התלות. לפרטים נוספים על התוכן של ההורדה, עיין בקובץ Readme.html.

Android

אם אתם מפתחים ל-Android, ו-Google API שבו אתם רוצים להשתמש כלול בספריית Google Play Services, כדאי להשתמש בספריית Google Play Services כדי ליהנות מרמת הביצועים הגבוהה ביותר ומהביצועים הטובים ביותר.

אם אתם משתמשים בספריית הלקוח של Google API ל-Java ב-Android, חשוב לדעת אילו יחסי תלות תואמים ל-Android, ובפרט רמת ה-SDK של Android. אפליקציות ל-Android מצריכות את קובצי ה-מאגר הבאים, או את הגרסאות התואמות החדשות יותר, מתיקיית 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

Google App Engine

יישומי Google App Engine דורשים את קובצי הצנצנות הבאים, או גרסאות תואמות חדשות יותר, מתיקיית 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

Servlet

אפליקציות Servlet דורשות את קובצי הצנצנות הבאים, או את הגרסאות התואמות החדשות יותר, מתיקיית 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

Java גנרי

אפליקציות Java לשימוש כללי דורשות את קובצי ה-Jar הבאים, או גרסאות תואמות חדשות יותר, מתיקיית 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

ספריות שנוצרו עבור Google APIs

במאגר של הספריות שנוצרות יש הוראות איך להשתמש בכל אחת מהגרסאות של ממשקי ה-API.

Maven

ספריית הלקוח של Google API עבור Java נמצאת במאגר המרכזי של Maven. groupId של Maven לכל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) של הספרייה הזו הוא com.google.api-client. הוראות ספציפיות ל-Maven לכל מודול (בהמשך).

מודולים

הספרייה הזו מורכבת מתשעה מודולים:

google-api-client

ספריית הלקוח של Google API עבור Java (google-api-client) תוכננה כך שתהיה תואמת לכל פלטפורמות Java הנתמכות, כולל Android.

שימוש ב-Maven:

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

ב-Android, צריך להחריג באופן מפורש יחסי תלות שלא בשימוש:

<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

תוספים לספריית הלקוח של Google API ל-Java (google-api-client-android) תומכים ב-Java Google Android (רק ל-SDK >= 2.1). המודול הזה תלוי ב-google-api-client וב-google-http-client-android.

שימוש ב-Maven:

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

google-api-client-servlet

תוספי Servlet ו-JDO לספריית הלקוח של Google API עבור Java (google-api-client-servlet) תומכים ביישומי אינטרנט של Java servlet. המודול הזה תלוי ב-google-api-client וב-google-oauth-client-servlet.

שימוש ב-Maven:

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

google-api-client-appengine

תוספים של Google App Engine לספריית הלקוח של Google API עבור Java (google-api-client-appengine) תומכים ביישומי Java של Google App Engine. המודול הזה תלוי ב-google-api-client, ב-google-api-client-servlet, ב-google-oauth-client-appengine וב-google-http-client-appengine.

שימוש ב-Maven:

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

google-api-client-gson

תוספי GSON לספריית הלקוח של Google API עבור Java (google-api-client-gson). המודול הזה תלוי ב-google-api-client וב-google-http-client-gson.

שימוש ב-Maven:

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

google-api-client-jackson2

תוספי Jackson2 לספריית הלקוח של Google API עבור Java (google-api-client-jackson2). המודול הזה תלוי ב-google-api-client וב-google-http-client-jackson2.

שימוש ב-Maven:

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

google-api-client-protobuf

מאגר נתונים זמני של פרוטוקולים תוספים לספריית הלקוח של Google API עבור Java (google-api-client-protobuf). המודול הזה תלוי ב-google-http-client-protobuf וב-google-api-client.

שימוש ב-Maven:

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

google-api-client-xml

תוספי XML לספריית הלקוח של Google API עבור Java (google-api-client-xml). המודול הזה תלוי ב-google-api-client וב-google-http-client-xml.

שימוש ב-Maven:

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