تعليمات الإعداد

يمكنك تنزيل مكتبة Google OAuth Client Library للغة Java والملفات التي تعتمد عليها في ملف zip، أو يمكنك استخدام Maven.

راجِع أيضًا تعليمات إعداد ProGuard التي تشكّل جزءًا من مكتبة برامج Google HTTP لمستندات Java.

تنزيل المكتبة التي تتضمن عناصر تابعة

نزِّل أحدث ملف ZIP، الذي يمكنك العثور عليه في صفحة عمليات التنزيل، واستخرجه من جهاز الكمبيوتر. يحتوي ملف zip هذا على ملفات jar الخاصة بصفوف مكتبة العميل وملفات jar المصدر المرتبطة بكل عنصر وملفاته الملحقة. يمكنك العثور على الرسوم البيانية للتبعية والتراخيص للمكتبات المختلفة في مجلد "التبعيات". لمزيد من التفاصيل حول محتوى عملية التحميل، يُرجى الاطّلاع على ملف readme.html.

Android

إذا كنت تُطوّر تطبيقات لنظام التشغيل Android وكانت واجهة برمجة التطبيقات من Google التي تريد استخدامها مضمّنة في مكتبة "خدمات Google Play"، استخدِم مكتبة "خدمات Google Play" للحصول على أفضل أداء وتجربة.

إذا كنت تستخدم "مكتبة عميل 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

تتطلب تطبيقات serlet ملفات الوعاء التالية، أو الإصدارات المتوافقة الأحدث، من مجلد 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 المركزي. قيمة groupId Maven لكل العناصر في هذه المكتبة هي com.google.oauth-client. يتم تقديم تعليمات Maven محددة لكل وحدة (أدناه).

الوحدات

تتألف هذه المكتبة من خمس وحدات:

google-oauth-client

تم تصميم مكتبة Google OAuth Client Library للغة 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 Client Library للغة 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 Client Library للغة 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 Client Library للغة 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>