دستورالعمل‌های راه‌اندازی

می‌توانید «کتابخانه کارخواه Google OAuth» برای Java و وابستگی‌های آن را در یک فایل zip بارگیری کنید، یا می‌توانید از Maven استفاده کنید.

همچنین دستورالعمل‌های راه‌اندازی ProGuard را که بخشی از اسناد «کتابخانه کارخواه HTTP»‏ Google برای Java است ببینید.

بارگیری کتابخانه با وابستگی‌ها

جدیدترین فایل zip را که می‌توانید در صفحه بارگیری‌ها پیدا کنید، بارگیری و در رایانه‌تان استخراج کنید. این فایل zip حاوی فایل‌های jar کلاس کتابخانه کارخواه و فایل‌های jar منبع مرتبط برای هر آرتیفکت و وابستگی‌های آن‌ها است. می‌توانید نمودارهای وابستگی و پروانه‌های کتابخانه‌های مختلف را در پوشه وابستگی‌ها پیدا کنید. برای جزئیات بیشتر درباره محتوای بارگیری، فایل readme.html را ببینید.

Android

اگر برای Android توسعه می‌دهید و Google API که می‌خواهید استفاده کنید در کتابخانه «خدمات Google Play» گنجانده شده است، برای بهترین عملکرد و تجربه از کتابخانه «خدمات Google Play» استفاده کنید.

اگر از «کتابخانه کارخواه Google OAuth» برای Java با Android استفاده می‌کنید، مهم است بدانید کدام وابستگی‌ها با Android سازگار هستند، به‌ویژه کدام سطح کیت توسعه نرم‌افزار 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

برنامه‌های 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

Generic 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 برای جاوا (google-oauth-client) به‌گونه‌ای طراحی شده است که با همه پلاتفرم‌های جاوا که پشتیبانی می‌شوند، ازجمله 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 for 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 Client Library for 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 Client Library for 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>