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

אפשר להוריד את ספריית הלקוח של OAuth של Google ל-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, בפרט רמת ה-SDK של Android. אפליקציות ל-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 מחייבות את קובצי ה-jar הבא, או גרסאות תואמות חדשות יותר גרסאות libs, מתיקיית 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 כלליות נדרשים קובצי ה-jar הבאים, או גרסאות תואמות חדשות יותר, מהתיקייה 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 לכל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) לספרייה הזו הוא 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) תמיכה ב-Java servlet אינטרנט. המודול הזה תלוי ב-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-hardware6) תמיכה ביישומי Java6 ואילך. מודול זה תלוי ב- 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>