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

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

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

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

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

Android

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

إذا كنت تستخدم "مكتبة عميل 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 ملفات 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 للأغراض العامة ملفات 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 لكل العناصر لهذه المكتبة هو 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 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 للغة 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>