Konfigurowanie projektu w Google Cloud Console

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

  1. Skonfiguruj projekt aplikacji mobilnej.
  2. Dodaj do aplikacji pakiet Driver SDK.
  3. Dodaj do aplikacji klucz interfejsu API.
  4. Dodaj do aplikacji wymagane informacje o autorze.

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

Skonfiguruj projekt aplikacji mobilnej

W tej sekcji opisujemy, jak skonfigurować projekt aplikacji mobilnej pod kątem pakietu Driver SDK.

Aby skonfigurować projekt aplikacji mobilnej:

  1. Jeśli nie masz projektu deweloperskiego w konsoli Google Cloud i klucza interfejsu API dla projektu mobilności, musisz je skonfigurować. Więcej informacji znajdziesz w artykule Tworzenie projektu Fleet Engine.
  2. W konsoli Google Cloud wybierz ten sam projekt i klucz interfejsu API, których używasz w Fleet Engine.
  3. Wybierz Interfejsy API i usługi , wyszukaj i włącz Maps SDK na Androida.

Dodaj do aplikacji pakiet Driver SDK

Pakiet Driver SDK jest dostępny w repozytorium Google Maven. Repozytorium zawiera pliki Project Object Model (.pom) pakietu SDK i Javadocs.

Aby dodać pakiet Driver SDK do aplikacji, dodaj zależności pakietu Driver SDK i Navigation SDK do konfiguracji Gradle lub Maven.

W poniższym przykładzie zastąp VERSION_NUMBER wybraną wersją pakietu Driver SDK.

Gradle

Dodaj do pliku 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:

<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>

Dodaj do aplikacji klucz interfejsu API

Gdy dodasz do aplikacji pakiet Driver SDK, dodaj klucz interfejsu API. Musisz użyć klucza interfejsu API projektu, który został uzyskany podczas konfigurowania projektu deweloperskiego. Więcej informacji znajdziesz w artykule Konfigurowanie projektu aplikacji mobilnej.

W tej sekcji opisujemy, jak przechowywać klucz interfejsu API, aby aplikacja mogła się do niego odwoływać w bezpieczniejszy sposób. Więcej informacji o sprawdzonych metodach zabezpieczania kluczy interfejsu API znajdziesz w artykule Platformy Google Maps o sprawdzonych metodach zabezpieczania interfejsów API.

Aby uprościć to zadanie, możesz skorzystać z dokumentacji GitHub Wtyczka Gradle obiektów tajnych na Androida.

Aby zainstalować wtyczkę i zapisać klucz interfejsu API:

  1. Otwórz plik build.gradle na poziomie głównym i dodaj ten kod do elementu dependencies w sekcji 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. Otwórz plik build.gradle na poziomie aplikacji i dodaj ten kod do elementu plugins.

    Groovy

    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 projekt z Gradle. Więcej informacji znajdziesz w artykule Synchronizowanie projektu z Gradle.

  4. Otwórz plik local.properties w katalogu na poziomie projektu, a następnie dodaj ten kod. Zastąp YOUR_API_KEY swoim kluczem interfejsu API.

    MAPS_API_KEY=YOUR_API_KEY

  5. W pliku AndroidManifest.xml przejdź do com.google.android.geo.API_KEY i zaktualizuj atrybut android:value w ten sposób:

       <meta-data
           android:name="com.google.android.geo.API_KEY"
           android:value="${MAPS_API_KEY}" />

Poniższy przykład przedstawia kompletny manifest 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>

Dodaj do aplikacji wymagane informacje o autorze

Jeśli używasz w aplikacji pakietu Driver SDK, musisz dodać informację o pochodzeniu danych i licencje open source w sekcji informacji prawnych aplikacji. Najlepiej jest dodać informacje o autorze jako niezależną pozycję menu lub jako część pozycji menu Informacje.

Informacje o licencji znajdziesz w pliku „third_party_licenses.txt” w rozpakowanym pliku AAR.

Informacje o tym, jak dodać informacje o oprogramowaniu open source, znajdziesz w artykule Dodawanie informacji o oprogramowaniu open source.

Co dalej?

Deklarowanie zależności