Định cấu hình dự án trên Google Cloud Console

Để thiết lập và định cấu hình một bảng điều khiển Google Cloud để sử dụng Consumer SDK cho Android, hãy làm theo các bước sau.

  1. Thiết lập dự án phát triển.
  2. Thêm Consumer SDK vào ứng dụng của bạn.
  3. Thêm khoá API vào ứng dụng của bạn.
  4. Thêm thông tin bắt buộc về quyền tác giả vào ứng dụng.

Để biết thêm thông tin chi tiết về từng bước, hãy xem các phần sau.

Thiết lập dự án phát triển

Nếu không có dự án phát triển trên Google Cloud Console và khoá API cho dự án di động của mình, bạn cần thiết lập một dự án. Để biết thông tin chi tiết, hãy xem phần Tạo dự án trong hướng dẫn về Fleet Engine.

Khi bạn chọn dự án phát triển cho Consumer SDK, hãy chọn cùng một dự án trên Google Cloud Console và khoá API mà bạn đang dùng cho Fleet Engine.

Thêm Consumer SDK vào ứng dụng của bạn

Consumer SDK có trong kho lưu trữ Google Maven. Kho lưu trữ này bao gồm các tệp Mô hình đối tượng dự án (.pom) và Javadoc của SDK. Để thêm Consumer SDK vào ứng dụng, hãy thêm các phần phụ thuộc Consumer SDK và Maps SDK vào cấu hình Gradle hoặc Maven.

Trong các ví dụ sau, hãy thay thế VERSION_NUMBER bằng phiên bản bắt buộc của Consumer SDK:

Gradle

Thêm nội dung sau vào build.gradle:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

Thêm nội dung sau vào pom.xml:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

Thêm khoá API vào ứng dụng

Sau khi thêm Consumer SDK vào ứng dụng, hãy thêm khoá API. Bạn phải sử dụng khoá API dự án mà bạn nhận được khi thiết lập dự án phát triển. Để biết thêm thông tin chi tiết, hãy xem phần Thiết lập dự án phát triển ở Bước 3 của hướng dẫn này.

Phần này mô tả cách lưu trữ khoá API để ứng dụng của bạn có thể tham chiếu khoá này một cách an toàn hơn. Để biết thêm thông tin về các phương pháp bảo mật tốt nhất cho khoá API, hãy xem bài viết trên Nền tảng Google Maps về các phương pháp bảo mật tốt nhất cho API.

Để đơn giản hoá tác vụ này, bạn có thể sử dụng tài liệu Trình bổ trợ Secrets Gradle cho Android trên GitHub.

Cách cài đặt trình bổ trợ và lưu trữ khoá API:

  1. Mở tệp build.gradle ở cấp gốc rồi thêm đoạn mã sau vào phần tử dependencies trong buildscript.

    Groovy

    buildscript {
      dependencies {
          // ...
          classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
      }
}

    Kotlin

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
    }
}

  2. Mở tệp build.gradle ở cấp ứng dụng rồi thêm đoạn mã sau vào phần tử plugins.

    Groovy

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    Kotlin

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. Nếu bạn sử dụng Android Studio, hãy đồng bộ hoá dự án với Gradle. Để biết thông tin chi tiết, hãy xem phần Đồng bộ hoá dự án với Gradle trong tài liệu về Android.

  4. Mở local.properties trong thư mục cấp dự án, sau đó thêm đoạn mã sau. Thay thế YOUR_API_KEY bằng khoá API của bạn.

    MAPS_API_KEY=YOUR_API_KEY

  5. Trong tệp AndroidManifest.xml, hãy chuyển đến com.google.android.geo.API_KEY rồi cập nhật thuộc tính android:value như sau:

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="${M>APS_API_KEY}" /

Ví dụ sau đây cho thấy một tệp kê khai hoàn chỉnh cho một ứng dụng mẫu:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.c>onsumerap<idemo"
        uses-permission android:name="android.permissio>n.ACCESS_<FINE_LOCATION" /
        application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:sup>portsRtl="<;true"
            android:theme="@style/_AppTheme"

            meta-data
                android:name=&q>uot;com.google<.android.geo.API_KEY"
          >      android:val<ue="${MA>PS_API_KEY}" /

<            activity android:name=".MainActiv>ity"
           <     intent-filter
                    action android:name>="android.in<tent.action.MA>IN" /
  <         >         <category and>roid:<name=&quo>t;android.intent.category.LAUNCHER" /
                /intent-filter
            /activity
        /application
    /manifest

Thêm thông tin ghi nhận quyền tác giả bắt buộc vào ứng dụng của bạn

Nếu sử dụng Consumer SDK trong ứng dụng của mình, bạn phải thêm văn bản ghi nhận quyền sở hữu và giấy phép nguồn mở vào phần thông báo pháp lý của ứng dụng. Bạn nên đưa thông tin ghi nhận quyền tác giả vào một mục riêng trong trình đơn hoặc trong mục Giới thiệu.

Bạn có thể tìm thấy thông tin về giấy phép trong tệp "third_party_licenses.txt" trong tệp AAR chưa lưu trữ.

Tham khảo https://developers.google.com/android/guides/opensource để biết cách đưa thông báo về nguồn mở.

Bước tiếp theo

Lấy mã thông báo xác thực