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

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

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

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

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

Android

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

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