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.
- Thiết lập dự án ứng dụng dành cho thiết bị di động.
- Thêm SDK Trình điều khiển vào ứng dụng.
- Thêm khoá API vào ứng dụng của bạn.
- 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 dành cho thiết bị di động của bạn cho Trình điều khiển SDK.
Để định cấu hình dự án ứng dụng dành cho thiết bị di động, hãy làm theo các bước sau:
- 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 hỗ trợ 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.
- 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.
- 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. Cho để 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:
Mở tệp
build.gradle
ở cấp cơ sở rồi thêm mã sau vào tệp Phần tửdependencies
trongbuildscript
.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") } }
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")
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.
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
Trong tệp
AndroidManifest.xml
, hãy chuyển đếncom.google.android.geo.API_KEY
rồi cập nhật thuộc tínhandroid: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ở.