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

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

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

تنزيل المكتبة باستخدام المهام التابعة

نزِّل أحدث ملف ZIP، والذي يمكنك العثور عليه في صفحة عمليات التنزيل، واستخراجه على جهاز الكمبيوتر. يحتوي ملف ZIP هذا على ملفات Jarض حسب فئة مكتبة العميل وملفات Jar المصدر المرتبطة لكل عنصر ومعالِفاته. يمكنك العثور على الرسوم البيانية للتراخيص والتراخيص للمكتبات المختلفة في مجلد الارتباطات. لمزيد من التفاصيل حول محتوى الملف الذي تم تنزيله، يمكنك الاطّلاع على ملف Readme.html.

Android

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

إذا كنت تستخدم مكتبة برامج Google OAuth لـ Java مع Android، من المهم معرفة الارتباطات المتوافقة مع Android، وتحديدًا مستوى Android SDK. تتطلب تطبيقات 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
• jason-core-2.9.5.jar
• jsr305-3.0.2.jar
• Protobuf-java-3.6.1.jar

تحذير: بالنسبة إلى نظام التشغيل Android، يجب وضع ملفات Jar في دليل باسم "libs&quot، حتى تتمكّن حزمة حزمة APK من العثور عليها. وبخلاف ذلك، ستظهر لك رسالة خطأ NoClassDefFoundError في وقت التشغيل.

Google App Engine

تتطلب تطبيقات Google App Engine ملفات jar التالية أو الإصدارات الأحدث المتوافقة من مجلد libs:

• google-oauth-client-1.30.4.jar
• google-oauth-client-app Engine-1.30.4.jar
• google-oauth-client-servlet-1.30.4.jar
• google-http-client-1.32.1.jar
• google-http-client-app Engine-1.32.1.jar
• gson-2.8.5.jar
• jason-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
• Common-logging-1.2.0.jar
• gson-2.8.5.jar
• jason-core-2.9.5.jar
• http:// .4.5.9.jar
• http://-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
• Common-logging-1.2.0.jar
• gson-2.8.5.jar
• jason-core-2.9.5.jar
• http:// .4.5.9.jar
• http://-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 لكل العناصر لهذه المكتبة هي com.google.oauth-client. يتم تقديم تعليمات Maven محدّدة لكل وحدة (أدناه).

الوحدات

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

• google-oauth-client
• google-oauth-client-servlet
• google-oauth-client-app Engine
• google-oauth-client-java6
• google-oauth-client-jetty

برنامج OAuth للمستخدم

تم تصميم مكتبة عميل 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-app Engine

تتوافق إضافات Google App Engine إلى مكتبة عميل Google OAuth في Java (google-oauth-client-app Engine) مع تطبيقات 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>