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

אפשר להוריד את ספריית הלקוח של 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 ל-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>