Aby skonfigurować projekt konsoli Google Cloud do korzystania z Driver SDK na Androida, wykonaj te czynności.
- Skonfiguruj projekt aplikacji mobilnej.
- Dodaj do aplikacji pakiet Driver SDK do aplikacji.
- 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.
Konfigurowanie projektu 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 deweloperskiego w Google Cloud Console ani klucza interfejsu API dla projektu mobilności, musisz je skonfigurować. Więcej informacji znajdziesz w artykule Tworzenie projektu Fleet Engine.
- W konsoli Google Cloud wybierz ten sam projekt konsoli Google Cloud i klucz API, którego używasz w przypadku Fleet Engine.
- Wybierz Interfejsy API i , a potem wyszukaj i włącz Maps SDK na Androida.
Dodawanie do aplikacji pakietu Driver SDK
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 do konfiguracji Gradle lub Maven zależności pakietu Driver SDK i Navigation SDK.
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 pliku pom.xml
te informacje:
<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ć klucza interfejsu API projektu uzyskanego podczas konfigurowania projektu programistycznego. Więcej informacji znajdziesz w artykule Konfigurowanie projektu aplikacji mobilnej.
W tej sekcji opisano, jak przechowywać klucz interfejsu API, aby aplikacja mogła się do niego bezpieczniej odwoływać. Więcej informacji o sprawdzonych metodach zabezpieczania kluczy interfejsu API znajdziesz w artykule o sprawdzonych metodach zabezpieczania kluczy interfejsu API na temat Google Maps Platform.
Aby usprawnić to zadanie, możesz użyć dokumentacji GitHub 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 podany niżej kod do elementuplugins
.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 folder
local.properties
w katalogu na poziomie projektu, a potem dodaj ten 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}" />
Poniżej znajdziesz przykład pełnego pliku 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 atrybucji i licencji open source. Najlepiej jest uwzględnić atrybuty jako niezależną pozycję menu lub jako część pozycji menu Informacje.
Informacje o licencjach znajdziesz w pliku „third_party_licenses.txt” w niezaarchiwizowanym pliku AAR.
Informacje o tym, jak uwzględniać informacje o oprogramowaniu open source, znajdziesz w artykule Uwzględnianie informacji o oprogramowaniu open source.