אפשר להוריד את ספריית הלקוח של Google OAuth ל-Java ואת יחסי התלות שלה בקובץ zip, או להשתמש ב-Maven.
כדאי לעיין גם בהוראות ההגדרה של ProGuard שמופיעות במסמכי התיעוד של ספריית הלקוח של Google ל-HTTP עבור Java.
הורדת הספרייה עם פריטים תלויים
מורידים את קובץ ה-zip העדכני ביותר, שזמין בדף ההורדות, ומחלצים אותו במחשב. קובץ ה-zip הזה מכיל את קובצי ה-jar של הכיתות בספריית הלקוח ואת קובצי ה-jar של המקור המשויכים לכל ארטיפקט ואת יחסי התלות שלהם. תרשימי התלות והרישיונות של הספריות השונות נמצאים בתיקיית dependencies. פרטים נוספים על תוכן ההורדה מופיעים בקובץ readme.html.
Android
אם אתם מפתחים ל-Android, וממשק Google API שבו אתם רוצים להשתמש נכלל בספריית Google Play Services, כדאי להשתמש בספריית Google Play Services כדי ליהנות מהביצועים ומהחוויה הטובים ביותר.
אם אתם משתמשים בספריית הלקוח של Google OAuth עבור Java עם Android, חשוב לדעת אילו יחסי תלות תואמים ל-Android, ובמיוחד באיזו רמה של Android SDK. אפליקציות ל-Android זקוקות לקובצי ה-jar הבאים, או לגרסאות תואמות חדשות יותר, מהתיקייה libs:
- google-oauth-client-1.30.4.jar
- google-http-client-1.32.1.jar
- google-http-client-android-1.32.1jar
- gson-2.8.5.jar
- jackson-core-2.9.5.jar
- jsr305-3.0.2.jar
- protobuf-java-3.6.1.jar
Google App Engine
אפליקציות Google App Engine דורשות את קובצי ה-jar הבאים, או גרסאות תואמות חדשות יותר, מהתיקייה libs:
- google-oauth-client-1.30.4.jar
- google-oauth-client-appengine-1.30.4.jar
- google-oauth-client-servlet-1.30.4.jar
- google-http-client-1.32.1.jar
- google-http-client-appengine-1.32.1.jar
- gson-2.8.5.jar
- jackson-core-2.9.5.jar
- jsr305-3.0.2.jar
- protobuf-java-3.6.1.jar
- transaction-api-1.1.jar
- xpp3-1.1.4c.jar
Servlet
כדי להריץ אפליקציות Servlet, צריך את קובצי ה-jar הבאים מהתיקייה libs, או גרסאות תואמות חדשות יותר:
- google-oauth-client-1.30.4.jar
- google-oauth-client-servlet-1.32.1.jar
- google-http-client-1.32.1.jar
- Commons-logging-1.2.0.jar
- gson-2.8.5.jar
- jackson-core-2.9.5.jar
- httpclient-4.5.9.jar
- httpcore-4.4.11.jar
- jackson-core-2.1.3.jar
- jdo2-api-2.3-eb.jar
- jsr305-3.0.2.jar
- protobuf-java-3.6.1.jar
- transaction-api-1.1.jar
- xpp3-1.1.4c.jar
Java גנרית
לשימוש כללי ב-Java, נדרשים קובצי ה-Jam הבאים או גרסאות תואמות חדשות יותר, מתיקיית libs:
- google-oauth-client-1.30.4.jar
- google-http-client-1.32.1.jar
- Commons-logging-1.2.0.jar
- gson-2.8.5.jar
- jackson-core-2.9.5.jar
- httpclient-4.5.9.jar
- httpcore-4.4.11.jar
- jsr305-3.0.2.jar
- protobuf-java-3.6.1.jar
- xpp3-1.1.4c.jar
Maven
ספריית הלקוח של Google OAuth ל-Java נמצאת במאגר המרכזי של Maven. הערך של Maven groupId
לכל הארטיפקטים של הספרייה הזו הוא com.google.oauth-client
. הוראות ספציפיות ל-Maven מפורטות לכל מודול (בהמשך).
מודולים
הספרייה הזו מורכבת מחמישה מודולים:
- google-oauth-client
- google-oauth-client-servlet
- google-oauth-client-appengine
- google-oauth-client-java6
- google-oauth-client-jetty
google-oauth-client
ספריית הלקוח של Google OAuth ל-Java (google-oauth-client) תוכננה להיות תואמת לכל הפלטפורמות הנתמכות של Java, כולל Android.
שימוש ב-Maven:
<dependency> <groupId>com.google.oauth-client</groupId> <artifactId>google-oauth-client</artifactId> <version>1.30.4</version> </dependency>
ב-Android, צריך להחריג באופן מפורש יחסי תלות שלא נמצאים בשימוש:
<dependency> <groupId>com.google.oauth-client</groupId> <artifactId>google-oauth-client</artifactId> <version>1.30.4</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-oauth-client-servlet
התוספים Servlet ו-JDO לספריית הלקוח של Google OAuth ל-Java (google-oauth-client-servlet) תומכים באפליקציות אינטרנט מסוג servlet ב-Java. המודול הזה תלוי ב-google-oauth-client.
שימוש ב-Maven:
<dependency> <groupId>com.google.oauth-client</groupId> <artifactId>google-oauth-client-servlet</artifactId> <version>1.30.4</version> </dependency>
google-oauth-client-appengine
התוספים של Google App Engine לספריית הלקוח של Google OAuth ל-Java (google-oauth-client-appengine) תומכים באפליקציות Java ב-Google App Engine. המודול הזה תלוי ב-google-oauth-client וב-google-oauth-client-servlet.
שימוש ב-Maven:
<dependency> <groupId>com.google.oauth-client</groupId> <artifactId>google-oauth-client-appengine</artifactId> <version>1.30.4</version> </dependency>
google-oauth-client-java6
התוספים ל-Java 6 ואילך לספריית הלקוח של Google OAuth ל-Java (google-oauth-client-java6) תומכים באפליקציות מ-Java 6 ואילך. המודול הזה תלוי ב-google-oauth-client.
שימוש ב-Maven:
<dependency> <groupId>com.google.oauth-client</groupId> <artifactId>google-oauth-client-java6</artifactId> <version>1.30.4</version> </dependency>
google-oauth-client-jetty
התוספים של Jetty לספריית הלקוח של Google OAuth ל-Java (google-oauth-client-jetty) תומכים בתהליך של קוד הרשאה לאפליקציות מותקנות. המודול הזה תלוי ב-google-oauth-client-java6.
שימוש ב-Maven:
<dependency> <groupId>com.google.oauth-client</groupId> <artifactId>google-oauth-client-jetty</artifactId> <version>1.30.4</version> </dependency>