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

תוכלו להוריד את ספריית הלקוח של Google OAuth ל-Java ואת יחסי התלות שלה בקובץ ZIP, או להשתמש ב-Maven.

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

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

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

Android

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

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

מייבן

ספריית הלקוח של Google OAuth ל-Java נמצאת במאגר המרכזי של Maven. groupId של Maven לכל פריטי המידע שנוצרו בתהליך הפיתוח (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-java6) תומכים באפליקציות 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>