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