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

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

اطلع أيضًا على تعليمات إعداد ProGuard التي تكون جزءًا من مكتبة برامج Google HTTP لوثائق Java.

تنزيل المكتبة التي تحتوي على التبعيات

عليك تنزيل أحدث ملف ZIP، الذي يمكنك العثور عليه في صفحة التنزيلات، واستخراجه على جهاز الكمبيوتر. يحتوي ملف ZIP هذا على ملفات فئة مكتبة العميل وملفات برطمان المصدر المرتبطة لكل أداة وتبعياتها. يمكنك العثور على الرسوم البيانية والتراخيص للتبعية للمكتبات المختلفة في مجلد التبعيات. لمزيد من التفاصيل حول محتويات التنزيل، راجع ملف 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 ملفات 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 للأغراض العامة ملفات 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 للغة Java (google-oauth-client) بحيث تكون متوافقة مع جميع أنظمة JavaScript الأساسية المتوافقة، بما في ذلك 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.

استخدام 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 في "مكتبة برامج OAuth على Google" بلغة 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>