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

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

1. Thiết lập dự án ứng dụng di động.
2. Thêm Driver 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.

Lưu ý: Ứng dụng của bạn phải nhắm đến minSdkVersion 23 trở lên.

Thiết lập dự án ứng dụng di động

Phần này mô tả cách định cấu hình dự án ứng dụng di động cho Driver SDK.

Để định cấu hình dự án ứng dụng di động, hãy làm theo các bước sau:

1. 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êm thông tin, hãy xem bài viết Tạo dự án Fleet Engine.
2. Trong Google Cloud Console, 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.
3. Chọn APIs & Services (API và dịch vụ), sau đó tìm và bật Maps SDK cho Android.

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

Driver SDK có trong kho lưu trữ Maven của Google. 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 Driver SDK vào ứng dụng, hãy thêm các phần phụ thuộc Driver SDK và Navigation SDK vào cấu hình Gradle hoặc Maven.

Lưu ý: Driver SDK phụ thuộc vào Navigation SDK. Đặt phần phụ thuộc của bạn thành một phiên bản được xác định rõ ràng của Navigation SDK, như trong ví dụ này. Nếu không, hãy bỏ qua khối mã ví dụ để cho phép dự án luôn tải phiên bản mới nhất của Navigation SDK xuống trong phiên bản phát hành chính. Hành vi kết hợp của các phiên bản mới nhất của Driver SDK và Navigation SDK đã trải qua quá trình kiểm thử nghiêm ngặt trước khi phát hành.

Trong ví dụ sau, hãy thay thế VERSION_NUMBER bằng phiên bản đã chọn của Driver SDK.

Gradle

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

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

Maven

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

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

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

Sau khi thêm Driver 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 ứng dụng di động.

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.

Lưu ý quan trọng: Đừng kiểm tra khoá API trong hệ thống kiểm soát phiên bản. Thay vào đó, hãy lưu trữ trong tệp local.properties nằm trong thư mục gốc của dự án. Để biết thêm thông tin về tệp local.properties, hãy xem phần Tệp thuộc tính Gradle.

Để đơ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 của GitHub.

Để cài đặt trình bổ trợ và lưu trữ khoá API, hãy làm theo các bước sau:

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.

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="${MAPS_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.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme" >

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

            <activity android:name=".MainActivity" >
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

Lưu ý: Để có trải nghiệm điều hướng tốt nhất, người lái xe nên cấp các quyền sau: android.permission.ACCESS_COARSE_LOCATION và android.permission.ACCESS_FINE_LOCATION. Đảm bảo yêu cầu cả hai quyền đó tại thời gian chạy trong ứng dụng.

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 Driver SDK trong ứng dụng, bạn phải đưa văn bản ghi nhận quyền tác giả 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 phần Đưa thông báo về nguồn mở để biết cách đưa thông báo về nguồn mở.

Bước tiếp theo

Khai báo phần phụ thuộc