Hướng dẫn thiết lập

Bạn có thể tải Thư viện ứng dụng Google OAuth cho Java và các phần phụ thuộc của thư viện này xuống dưới dạng tệp zip hoặc sử dụng Maven.

Ngoài ra, hãy xem hướng dẫn thiết lập ProGuard trong tài liệu về Thư viện ứng dụng HTTP của Google cho Java.

Tải thư viện xuống cùng với các phần phụ thuộc

Tải tệp zip mới nhất xuống (bạn có thể tìm thấy tệp này trên trang tải xuống) rồi giải nén tệp đó trên máy tính. Tệp zip này chứa các tệp jar của lớp thư viện ứng dụng và các tệp jar nguồn được liên kết cho từng cấu phần phần mềm và các phần phụ thuộc của chúng. Bạn có thể tìm thấy biểu đồ phần phụ thuộc và giấy phép cho các thư viện khác nhau trong thư mục phần phụ thuộc. Để biết thêm thông tin chi tiết về nội dung của tệp tải xuống, hãy xem tệp readme.html.

Android

Nếu bạn đang phát triển cho Android và API Google mà bạn muốn sử dụng có trong thư viện Dịch vụ Google Play, hãy sử dụng thư viện Dịch vụ Google Play để có hiệu suất và trải nghiệm tốt nhất.

Nếu bạn đang sử dụng Thư viện ứng dụng OAuth của Google cho Java với Android, điều quan trọng là bạn phải biết những phần phụ thuộc nào tương thích với Android, cụ thể là cấp độ SDK Android nào. Các ứng dụng Android yêu cầu các tệp jar sau đây hoặc các phiên bản tương thích mới hơn trong thư mục 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

Các ứng dụng Google App Engine yêu cầu các tệp jar sau đây hoặc các phiên bản tương thích mới hơn trong thư mục 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

Ứng dụng Servlet yêu cầu các tệp jar sau hoặc các phiên bản tương thích mới hơn, từ thư mục 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 chung

Các ứng dụng Java dùng cho nhiều mục đích yêu cầu các tệp jar sau đây hoặc các phiên bản tương thích mới hơn từ thư mục 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

Thư viện ứng dụng Google OAuth cho Java nằm trong kho lưu trữ Maven trung tâm. groupId Maven cho tất cả cấu phần phần mềm của thư viện này là com.google.oauth-client. Chúng tôi cung cấp hướng dẫn cụ thể về Maven cho từng mô-đun (dưới đây).

Mô-đun

Thư viện này gồm năm mô-đun:

google-oauth-client

Thư viện ứng dụng OAuth của Google cho Java (google-oauth-client) được thiết kế để tương thích với tất cả các nền tảng Java được hỗ trợ, bao gồm cả Android.

Cách sử dụng Maven:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client</artifactId>
  <version>1.30.4</version>
</dependency>

Trên Android, bạn cần loại trừ rõ ràng các phần phụ thuộc không dùng đến:

<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

Các tiện ích Servlet và JDO cho Thư viện ứng dụng OAuth của Google dành cho Java (google-oauth-client-servlet) hỗ trợ các ứng dụng web servlet Java. Mô-đun này phụ thuộc vào google-oauth-client.

Cách sử dụng Maven:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-servlet</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-appengine

Các tiện ích Google App Engine đối với Thư viện ứng dụng OAuth của Google cho Java (google-oauth-client-appengine) hỗ trợ các ứng dụng Java Google App Engine. Mô-đun này phụ thuộc vào google-oauth-client và google-oauth-client-servlet.

Cách sử dụng Maven:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-appengine</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-java6

Các tiện ích Java 6 (trở lên) cho Thư viện ứng dụng OAuth của Google dành cho Java (google-oauth-client-java6) hỗ trợ các ứng dụng Java6 trở lên. Mô-đun này phụ thuộc vào google-oauth-client.

Cách sử dụng Maven:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-java6</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-jetty

Các tiện ích cầu tàu cho Thư viện ứng dụng OAuth của Google dành cho Java (google-oauth-client-jetty) hỗ trợ luồng mã uỷ quyền cho các ứng dụng đã cài đặt. Mô-đun này phụ thuộc vào google-oauth-client-java6.

Cách sử dụng Maven:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-jetty</artifactId>
  <version>1.30.4</version>
</dependency>