Konfigurowanie projektu w Google Cloud Console

Aby skonfigurować projekt konsoli Google Cloud do korzystania z Driver SDK na Androida, wykonaj te czynności.

  1. Skonfiguruj projekt aplikacji mobilnej.
  2. Dodaj do aplikacji pakiet SDK Driver.
  3. Dodaj klucz interfejsu API do aplikacji.
  4. Dodaj wymagane informacje o źródłach do swojej aplikacji.

Więcej informacji o każdym kroku znajdziesz w następnych sekcjach.

Skonfiguruj projekt aplikacji mobilnej

Z tej sekcji dowiesz się, jak skonfigurować projekt aplikacji mobilnej pod kątem pakietu SDK Driver.

Aby skonfigurować projekt aplikacji mobilnej:

  1. Jeśli nie masz projektu programistycznego konsoli Google Cloud ani klucza interfejsu API do projektu mobilnego, musisz go skonfigurować. Więcej informacji znajdziesz w artykule Tworzenie projektu Fleet Engine.
  2. W konsoli Google Cloud wybierz ten sam projekt konsoli Google Cloud Klucz interfejsu API, którego używasz we Fleet Engine.
  3. Kliknij Interfejsy API i usługi, a następnie wyszukaj i włącz pakiet SDK Maps na Androida.

Dodawanie do aplikacji pakietu Driver SDK

Pakiet Driver SDK jest dostępny w repozytorium Google Maven. Repozytorium zawiera pliki modelu obiektu projektu (.pom) i dokumentację Javadoc pakietu SDK.

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 pliku build.gradle te informacje:

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ć klucz interfejsu API projektu uzyskany podczas konfigurowania projektu programistycznego. 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 użyć dokumentacji GitHub Wtyczka Gradle obiektów tajnych na Androida.

Aby zainstalować wtyczkę i zapisać klucz interfejsu API, wykonaj te czynności:

  1. Otwórz plik build.gradle najwyższego poziomu i dodaj poniższy kod do sekcji dependencies w kolumnie buildscript.

    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")
    }
}

  2. Otwórz plik build.gradle na poziomie aplikacji i dodaj ten kod do sekcji plugins.

    Zakręcony

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    Kotlin

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. Jeśli używasz Androida Studio, zsynchronizuj swój projekt z Gradle. Więcej informacji: Zsynchronizuj projekt z Gradle.

  4. Otwórz plik local.properties w katalogu na poziomie projektu i dodaj następujący kod. Zastąp YOUR_API_KEY swoim kluczem API.

    MAPS_API_KEY=YOUR_API_KEY

  5. W pliku AndroidManifest.xml przejdź do sekcji com.google.android.geo.API_KEY i zaktualizuj atrybut android: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 dla 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.

Co dalej?

Deklarowanie zależności