Aby skonfigurować projekt konsoli Google Cloud do używania pakietu Driver SDK Android, wykonaj te czynności.
- Skonfiguruj projekt aplikacji mobilnej.
- Dodaj do aplikacji pakiet Driver SDK.
- Dodaj klucz interfejsu API do aplikacji.
- Dodaj wymagane informacje o źródłach w swojej aplikacji.
Więcej informacji o poszczególnych krokach znajdziesz w kolejnych sekcjach.
Skonfiguruj projekt aplikacji mobilnej
W tej sekcji dowiesz się, jak skonfigurować projekt aplikacji mobilnej pod kątem sterownika. SDK.
Aby skonfigurować projekt aplikacji mobilnej:
- Jeśli nie masz projektu programistycznego konsoli Google Cloud ani klucza interfejsu API do projektu mobilnego, musisz go skonfigurować. Więcej informacji: Utwórz projekt Fleet Engine.
- W konsoli Google Cloud wybierz ten sam projekt konsoli Google Cloud Klucz interfejsu API, którego używasz we Fleet Engine.
- Wybierz Interfejsy API i usługi, a potem wyszukaj i włącz Maps SDK na Androida.
Dodaj pakiet Driver SDK do aplikacji
Pakiet Driver SDK jest dostępny w repozytorium Google Maven. Repozytorium zawiera pliki .pom (Project Object Model) pakietu SDK i dokumenty Javadocs.
Aby dodać pakiet Driver SDK do aplikacji, dodaj SDK Driver SDK i pakiet Navigation SDK do konfiguracji Gradle lub Maven.
W tym przykładzie zastąp VERSION_NUMBER
wybraną wersją
pakietu Driver SDK.
Gradle
Dodaj do 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
Dodaj do 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>
Dodawanie klucza interfejsu API do aplikacji
Po dodaniu pakietu Driver SDK do aplikacji dodaj klucz interfejsu API. Musisz użyć klucz interfejsu API projektu uzyskany podczas konfigurowania projektu programistycznego. Dla: Więcej informacji znajdziesz w artykule Konfigurowanie projektu aplikacji mobilnej.
W tej sekcji opisano, jak przechowywać klucz interfejsu API w celu zwiększenia jego bezpieczeństwa przywoływanych przez aplikację. Aby dowiedzieć się więcej o sprawdzonych metodach zapewniania bezpieczeństwa klucza interfejsu API, przeczytaj artykuł Google Maps Platform dotyczący sprawdzonych metod zapewniania bezpieczeństwa interfejsów API.
Aby usprawnić to zadanie, możesz skorzystać z dokumentacji GitHuba Wtyczka Gradle obiektów tajnych na Androida.
Aby zainstalować wtyczkę i zapisać klucz interfejsu API, wykonaj te czynności:
Otwórz plik
build.gradle
na poziomie głównym i dodaj ten kod do sekcjidependencies
w kolumniebuildscript
.Zakręcony
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") } }
Otwórz plik
build.gradle
na poziomie aplikacji i dodaj ten kod do sekcjiplugins
.Zakręcony
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Jeśli używasz Androida Studio, zsynchronizuj swój projekt z Gradle. Więcej informacji: Zsynchronizuj projekt z Gradle.
Otwórz plik
local.properties
w katalogu na poziomie projektu i dodaj następujący kod. ZastąpYOUR_API_KEY
swoim kluczem interfejsu API.MAPS_API_KEY=YOUR_API_KEY
W pliku
AndroidManifest.xml
przejdź do sekcjicom.google.android.geo.API_KEY
i zaktualizuj atrybutandroid:value
w następujący sposób:
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
Ten przykład zawiera pełny plik manifestu przykładowej aplikacji:
<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>
Umieść w aplikacji wymagane informacje o źródłach
Jeśli w swojej aplikacji używasz pakietu Driver SDK, musisz dodać tekst źródła i licencji open source. Najlepiej umieścić informacje o źródłach jako niezależne pozycje menu lub w sekcji Informacje. .
Informacje o licencji znajdziesz w pliku „third_party_licenses.txt” zapisz w niezarchiwizowanego pliku AAR.
Zapoznaj się z artykułem Uwzględnianie powiadomień open source, aby dowiedzieć się, jak zawierać powiadomienia o otwartym kodzie źródłowym.