Wypróbuj wersję demonstracyjną

Dzięki integracji pakietu Navigation SDK na Androida aplikacja może mieć nie tylko połączenie z zewnętrznym widokiem mapy. Dzięki Nawigacji w Mapach Google Twoja aplikacja może umożliwiać dynamiczne pobieranie i raportowanie danych o ścieżce użytkownika. W tym przewodniku wyjaśniamy, jak uruchamiać aplikacje demonstracyjne pakietu Navigation SDK, które są dostępne na GitHubie.

Przygotuj się

Aby zacząć korzystać z Navigation SDK, musisz mieć:

  • Klucz interfejsu API skonfigurowany do użycia z pakietem SDK nawigacji. Więcej informacji o tworzeniu i ograniczaniu kluczy znajdziesz w artykule Korzystanie z kluczy API.
  • Artefakt pakietu SDK. Upewnij się, że Twój projekt jest skonfigurowany do korzystania z Mavena w przypadku pakietu SDK Navigation.
  • co najmniej jedną z aplikacji w wersji demonstracyjnej.
  • Android Studio – zalecane środowisko programistyczne do tworzenia aplikacji za pomocą pakietu SDK nawigacji.

Ta dokumentacja jest przeznaczona dla osób znających programowanie na Androida i koncepcje programowania zorientowane na obiekty. Musisz też znać Mapy Google z perspektywy użytkownika.

Pobierz aplikacje w wersji demonstracyjnej

Google udostępnia 2 aplikacje, które pomogą Ci zrozumieć, co pakiet SDK nawigacji oferuje oprócz interfejsów API Map Google. Wybór aplikacji zależy od Twojego poziomu doświadczenia. Programiści, którzy znają interfejsy API Map Google, mogą skupić się na demonstracji GoogleNavigation. Deweloperzy, którzy nie mają doświadczenia z obydwoma projektami, mogą okazać się przydatne.

Od pakietu Navigation SDK na Androida w wersji 4.1 te aplikacje demonstracyjne są dostępne do pobrania z GitHub.

  • Demonstracja GoogleNavigation: pokazuje integrację zachowań i widoków interfejsu API w kontekście wrażeń użytkownika podczas sesji z przewodnikowaną nawigacją.

  • Demo GoogleMap: pokazuje poszczególne zachowania interfejsu GoogleMap, aby dostosować wygląd i prezentację map.

Demo Nawigacji Google

Najnowsza wersja demonstracyjna usługi GoogleNavigation jest dostępna na GitHubie.

Budynek

  1. W Android Studio zaimportuj aplikację w wersji demonstracyjnej i zezwól na uruchomienie Gradle.

  2. Otwórz local.defaults.properties i zaktualizuj wartość właściwości MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Kliknij kompilacja i sprawdź szczegóły implementacji pakietu SDK.

    • W klasie Javy zwróć uwagę na kod implementacji.

    • Zwróć uwagę na projekt i tekst w szablonie XML.

    • W pliku build.gradle zwróć uwagę na pakiet SDK w sekcji zależności.

Więcej informacji o dodawaniu klucza interfejsu API do pliku manifestu znajdziesz w dokumentacji wtyczki Gradle obiektów tajnych.

Uruchomiono

  1. Podłącz urządzenie z Androidem do komputera lub użyj emulatora.

    • Urządzenie z Androidem – zapoznaj się z instrukcjami, aby włączyć opcje programisty na urządzeniu z Androidem i skonfigurować system w taki sposób, aby wykrywał urządzenie.
    • Emulator – użyj Menedżera urządzenia wirtualnego z Androidem (AVD), aby skonfigurować urządzenie wirtualne. Przy wyborze emulatora wybierz obraz zawierający interfejsy API Google.

  2. W Android Studio kliknij opcję menu Uruchom (lub ikonę odtwarzania), a następnie wybierz miejsce docelowe wdrożenia.

Po utworzeniu i uruchomieniu aplikacja wyświetla użytkownikowi stronę docelową z listą opcji.

Nowi użytkownicy NavSDK prawdopodobnie uznają te 2 opcje za najbardziej przydatne.

Opcja 1: NavViewActivity pokazuje zachowania, używając NavigationView w połączeniu z Navigator.

Opcja 2. Druga opcja o nazwie NavFragmentActivity pozwala zaprezentować zachowania przy użyciu ikony SupportNavigationFragment obok Navigator.

Gdy klikniesz jedną z tych opcji, zobaczysz:

  • interfejs nawigacji
  • przycisk „Ustaw miejsce docelowe” w menu aplikacji;
  • z nakładką umożliwiającą dynamiczne wywoływanie metod w interfejsie API
  • menu z większą liczbą opcji

Aby rozpocząć, kliknij Ustaw miejsce docelowe i wybierz adres. Następnie aplikacja symuluje podróż z Twojej bieżącej lokalizacji do tego adresu. Skorzystaj z nakładki paneli sterowania, aby sprawdzić, co się dzieje po wywołaniu interfejsu API. Możesz np. kliknąć Wyświetl metody, aby wymusić tryb nocny w pakiecie SDK i sprawdzić, jak on wygląda.

Opcja SwappingMapAndNavActivity

SwappingMapAndNavActivity przedstawia te typowe wzorce:

Demonstracja Map Google

Najnowsze demo Google Navigation jest dostępne na GitHubie.

Budynek

  1. W Android Studio zaimportuj aplikację w wersji demonstracyjnej i zezwól na uruchomienie Gradle.

  2. Otwórz plik local.defaults.properties i zaktualizuj wartość właściwości MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Kliknij kompilacja i sprawdź szczegóły implementacji pakietu SDK.

    • W klasie Javy zwróć uwagę na kod implementacji.

    • Zwróć uwagę na projekt i tekst w szablonie XML.

    • W pliku build.gradle zwróć uwagę na pakiet SDK w zależnościach.

Więcej informacji o dodawaniu klucza interfejsu API do pliku manifestu znajdziesz w artykule secrets gradle plugin.

Uruchomiono

  1. Podłącz urządzenie z Androidem do komputera lub użyj emulatora.

    • Urządzenie z Androidem: zapoznaj się z instrukcjami, aby włączyć opcje programisty na urządzeniu z Androidem i skonfigurować system w taki sposób, aby wykrywał urządzenie.
    • Emulator – do konfigurowania urządzenia wirtualnego użyj Menedżera urządzenia wirtualnego z Androidem (AVD). Przy wyborze emulatora wybierz obraz zawierający interfejsy API Google.

  2. W Android Studio kliknij opcję menu Uruchom (lub ikonę odtwarzania), a potem wybierz miejsce docelowe wdrożenia.

Po utworzeniu i uruchomieniu aplikacja wyświetla użytkownikowi stronę docelową z listą wersji demonstracyjnych.

Ten schemat prezentacji i odpowiednia struktura kodu źródłowego powinny być znane użytkownikom wersji demonstracyjnych pakietu SDK Map Google. Wynika to z tego, że wersja demonstracyjna GoogleMap została zaprojektowana tak, by przypominała aplikację demonstracyjną interfejsu Maps API. Główna różnica polega na tym, że wersja demonstracyjna pakietu Navigation SDK umożliwia użytkownikowi wybranie klasy widoku, którą chce przetestować i uruchomienia w przypadku: NavigationView lub MapView (w stosownych przypadkach).

Google zwykle zachęca użytkowników do korzystania z narzędzia NavigationView. Dzięki tej wersji demonstracyjnej możesz wypróbować te funkcje w obu wersjach aplikacji i wybrać opcję, która najbardziej Ci odpowiada. Na przykład użycie MapView może być nadal konieczne w sytuacjach, gdy korzystasz z biblioteki innej firmy, która oczekuje interakcji z tą klasą.