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

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

  1. Thiết lập dự án ứng dụng dành cho thiết bị di động.
  2. Thêm SDK Trình điều khiển 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 các thuộc tính bắt buộc vào ứng dụng của bạn.

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

Thiết lập dự án ứng dụng dành cho thiết bị di động

Phần này mô tả cách định cấu hình dự án ứng dụng di động của bạn cho Trình điều khiển SDK.

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

  1. Trường hợp bạn không có dự án phát triển trên Google Cloud Console và không có khoá API cho dự án di chuyển 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 Tạo dự án Fleet Engine.
  2. Trong Google Cloud Console, hãy chọn cùng một dự án Google Cloud Console và Khoá API mà bạn đang dùng cho Fleet Engine.
  3. Chọn API & Services, sau đó tìm kiếm và bật SDK Bản đồ dành cho Android.

Thêm SDK Trình điều khiển vào ứng dụng của bạn

SDK Trình điều khiển có sẵn trong kho lưu trữ Google Maven. Kho lưu trữ bao gồm các tệp Mô hình đối tượng dự án của SDK (.pom) và Javadocs.

Để thêm SDK trình điều khiển vào ứng dụng của bạn, hãy thêm SDK trình điều khiển và SDK điều hướng các phần phụ thuộc vào cấu hình Gradle hoặc Maven của bạn.

Trong ví dụ sau, hãy thay thế VERSION_NUMBER bằng phiên bản đã chọn của SDK trình điều khiển.

Gradle

Thêm phần 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 phần 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 của bạn

Sau khi bạn thêm SDK Trình điều khiển 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, hãy xem bài viết Thiết lập dự án ứng dụng di động.

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

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

Để 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 cơ sở rồi thêm mã sau vào tệp 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 mã sau vào tệp 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 Đồng bộ hoá dự án với Gradle.

  4. Mở local.properties trong thư mục cấp dự án rồi thêm mã sau. Thay thế YOUR_API_KEY bằng khoá API.

    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 trình bà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>

Đưa các thuộc tính bắt buộc vào ứng dụng của bạn

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

Bạn có thể tìm thấy thông tin giấy phép trong tệp "third_party_permissions.txt" tệp trong tệp AAR đã huỷ lưu trữ.

Hãy tham khảo bài viết Bao gồm thông báo nguồn mở để biết cách bao gồm các thông báo nguồn mở.

Các bước tiếp theo

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