Konfigurowanie projektu w Android Studio

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Aby skonfigurować aplikację pod kątem korzystania z pakietu SDK Miejsc na Androida, wykonaj te czynności. Są one wymagane w przypadku wszystkich aplikacji używających pakietu SDK Miejsc na Androida.

Krok 1. Skonfiguruj Android Studio

  1. Wymagany jest Android Studio Arctic Fox lub nowszy. Pobierz i zainstaluj, jeśli jeszcze jej nie masz.
  2. Upewnij się, że używasz wtyczki Android Gradle w wersji 7.0 lub nowszej w Android Studio.

Krok 2. Skonfiguruj pakiet SDK

Biblioteka SDK Miejsc na Androida jest dostępna wrepozytorium Google Maven. Aby dodać pakiet SDK do aplikacji, wykonaj te czynności:

  1. W pliku settings.gradle najwyższego poziomu uwzględnij portal wtyczki Gradle, repozytorium Google Maven i centralne repozytorium Maven w bloku pluginManagement. Blok pluginManagement musi być widoczny przed innymi wypowiedziami w skrypcie.
    pluginManagement {
        repositories {
            gradlePluginPortal()
            google()
            mavenCentral()
        }
    } 
  2. W pliku settings.gradle najwyższego poziomu umieść w repozytorium dependencyResolutionManagement repozytorium Google Maven i centralne repozytorium Maven:
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
        }
    } 
  3. W sekcji dependencies pliku build.gradle modułu na poziomie modułu dodaj zależność od pakietu SDK Miejsc na Androida:

    dependencies {
        implementation 'com.google.android.libraries.places:places:3.0.0'
    }
    
  4. W pliku build.gradle na poziomie modułu ustaw compileSdk i minSdk na te wartości:
    android {
        compileSdk 31
    
        defaultConfig {
            minSdk 21
            // ...
        }

Krok 3. Dodaj klucz interfejsu API do projektu

W tej sekcji dowiesz się, jak przechowywać klucz interfejsu API, aby można było bezpiecznie odwoływać się do niego przez aplikację. Zalecamy niesprawdzanie klucza interfejsu API w systemie kontroli wersji, dlatego zalecamy przechowywanie go w pliku local.properties, który znajduje się w katalogu głównym projektu. Więcej informacji o pliku local.properties znajdziesz w artykule Pliki właściwości Gradle.

Aby uprościć to zadanie, zalecamy użycie wtyczki Gradle obiektów tajnych na Androida. Aby zainstalować wtyczkę i zapisać klucz interfejsu API:

  1. W Android Studio otwórz plik build.gradle na poziomie projektu i dodaj ten kod do elementu dependencies w sekcji buildscript.
    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
    }
  2. Następnie otwórz plik build.gradle na poziomie modułu i dodaj ten kod do elementu plugins.
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
        
  3. Zapisz plik i zsynchronizuj projekt z Gradle.
  4. Otwórz local.properties w katalogu na poziomie projektu i dodaj ten kod. Zastąp YOUR_API_KEY kluczem interfejsu API.
    MAPS_API_KEY=YOUR_API_KEY
        
  5. Zapisz plik.
  6. W pliku AndroidManifest.xml otwórz stronę com.google.android.geo.API_KEY i zaktualizuj android:value attribute w ten sposób:
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />
        

Uwaga: jak pokazano powyżej, com.google.android.geo.API_KEY to zalecana nazwa metadanych klucza interfejsu API. Klucz o tej nazwie może być używany do uwierzytelniania na wielu interfejsach API opartych na Mapach Google na platformie Android, w tym w pakiecie Places SDK dla Androida. Aby zapewnić zgodność wsteczną, interfejs API obsługuje też nazwę com.google.android.maps.v2.API_KEY. Ta nazwa starszego typu umożliwia uwierzytelnianie tylko dla interfejsu Android Maps API v2. Aplikacja może określać tylko jedną z nazw metadanych klucza interfejsu API. Jeśli podasz obie opcje, interfejs API zwróci wyjątek.

Krok 4. Inicjowanie klienta interfejsu Places API

Zainicjuj pakiet SDK Miejsc na Androida w ramach aktywności lub fragmentu, jak pokazano w przykładzie poniżej (pamiętaj, że podczas wywoływania Places.initialize() przekazujesz klucz interfejsu API):

Java


    // Initialize the SDK
    Places.initialize(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

      

Kotlin


    // Initialize the SDK
    Places.initialize(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

      

Teraz możesz już zacząć korzystać z pakietu SDK Miejsc na Androida.

Krok 5. Skonfiguruj urządzenie z Androidem

Aby uruchomić aplikację, która korzysta z pakietu SDK Miejsc na Androida, musisz ją wdrożyć na urządzeniu z Androidem lub w emulatorze Androida opartym na Androidzie 4.0 lub nowszym i interfejsach API Google.

  • Aby korzystać z urządzenia z Androidem, wykonaj czynności opisane w artykule Uruchamianie aplikacji na urządzeniu.
  • Aby użyć emulatora Androida, możesz utworzyć urządzenie wirtualne i zainstalować emulator za pomocą Menedżera urządzeń wirtualnych Android dostępnego w Android Studio.

Dalsze kroki

Po skonfigurowaniu projektu możesz zapoznać się z przykładowymi aplikacjami.