Wypróbuj wersję demonstracyjną

Dzięki integracji pakietu Navigation SDK na Androida Twoja aplikacja może wykraczać poza linkowanie do zewnętrznego widoku mapy. Dzięki nawigacji w Mapach Google Twoja aplikacja może dynamicznie pobierać dane o podróży użytkownika i generować raporty na ich podstawie. Z tego przewodnika dowiesz się, jak uruchamiać aplikacje demonstracyjne pakietu Navigation SDK, które są dostępne na GitHubie.

Przygotuj się

Aby rozpocząć korzystanie z pakietu Navigation SDK, musisz mieć:

Ta dokumentacja jest przeznaczona dla osób, które znają się na tworzeniu aplikacji na Androida i mają pojęcie o programowaniu obiektowym. Musisz też znać Mapy Google z perspektywy użytkownika.

Pobieranie aplikacji demonstracyjnych

Google udostępnia 2 aplikacje, które pomogą Ci zrozumieć, co pakiet SDK do nawigacji oferuje w porównaniu z interfejsami API Map Google, w zależności od Twojego poziomu doświadczenia. Programiści znający interfejsy API Map Google mogą skupić się na wersji demonstracyjnej GoogleNavigation. Deweloperzy, którzy dopiero zaczynają pracę nad tymi projektami, uznają obie aplikacje za przydatne.

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

  • GoogleNavigation demo: prezentuje integrację zachowań i widoków interfejsu API w kontekście wrażeń użytkownika podczas sesji nawigacji z instrukcjami.

  • Wersja demonstracyjna GoogleMap: prezentuje poszczególne zachowania interfejsu GoogleMap, aby dostosować wygląd i sposób prezentacji map.

Wersja demonstracyjna GoogleNavigation

Najnowsza wersja demonstracyjna GoogleNavigation jest dostępna na GitHub.

Kompilacja

  1. W Android Studio zaimportuj aplikację demonstracyjną i pozwó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 build i sprawdź szczegóły implementacji pakietu SDK.

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

    • W pliku XML układu zwróć uwagę na projekt układu i tekst.

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

Więcej informacji o tym, jak klucz interfejsu API jest dodawany do pliku manifestu, znajdziesz w dokumentacji wtyczki Gradle obiektów tajnych.

Uruchom

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

    • Urządzenie z Androidem – zapoznaj się z instrukcjami, aby włączyć na urządzeniu z Androidem opcje programisty i skonfigurować system tak, aby wykrywał urządzenie.
    • Emulator – użyj menedżera urządzenia wirtualnego z Androidem (AVD), aby skonfigurować urządzenie wirtualne. Wybierając emulator, pamiętaj, aby wybrać obraz, który zawiera interfejsy API Google.

  2. W Android Studio kliknij opcję menu Uruchom (lub ikonę przycisku odtwarzania), a następnie wybierz miejsce 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 za pomocą NavigationView w połączeniu z Navigator.

Opcja 2: druga opcja, zatytułowana NavFragmentActivity, przedstawia zachowania przy użyciu SupportNavigationFragment i Navigator.

Gdy klikniesz jedną z tych opcji, zobaczysz:

  • interfejs nawigacji,
  • przycisk „Ustaw miejsce docelowe” w menu aplikacji;
  • nakładkę, z którą możesz wchodzić w interakcje, aby dynamicznie wywoływać metody w interfejsie API;
  • rozszerzone menu z większą liczbą opcji,

Aby rozpocząć, kliknij Ustaw miejsce docelowe i wybierz adres. Aplikacja symuluje wtedy podróż z Twojej obecnej lokalizacji pod ten adres. Użyj nakładki paneli sterowania, aby zobaczyć, co się stanie, gdy wywołasz interfejs API. Na przykład kliknij Wyświetl metody, aby wymusić w pakiecie SDK tryb nocny i sprawdzić, jak wygląda.

Opcja SwappingMapAndNavActivity

SwappingMapAndNavActivity przedstawia te typowe wzorce:

Wersja demonstracyjna GoogleMap

Najnowsza wersja demonstracyjna GoogleNavigation jest dostępna na GitHub.

Kompilacja

  1. W Android Studio zaimportuj aplikację demonstracyjną i pozwó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 build i sprawdź szczegóły implementacji pakietu SDK.

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

    • W pliku XML układu zwróć uwagę na projekt układu i tekst.

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

Więcej informacji o tym, jak klucz interfejsu API jest dodawany do pliku manifestu, znajdziesz w sekcji secrets gradle plugin.

Uruchom

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

    • Urządzenie z Androidem: postępuj zgodnie z instrukcjami, aby włączyć opcje programisty na urządzeniu z Androidem i skonfigurować system tak, aby wykrywał urządzenie.
    • Emulator: użyj menedżera urządzenia wirtualnego z Androidem (AVD), aby skonfigurować urządzenie wirtualne. Wybierając emulator, pamiętaj, aby wybrać obraz, który zawiera interfejsy API Google.

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

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

Ten wzorzec prezentacji i odpowiadająca mu struktura kodu źródłowego powinny być znane użytkownikom wersji demonstracyjnych pakietu SDK Map Google. Dzieje się tak, ponieważ wersja demonstracyjna GoogleMap jest podobna do aplikacji demonstracyjnej interfejsu Maps API. Główna różnica polega na tym, że wersja demonstracyjna pakietu Navigation SDK umożliwia użytkownikowi wybór klasy widoku, w której chce przetestować wersję demonstracyjną: NavigationView lub MapView (w odpowiednich przypadkach).

Google zwykle zachęca do korzystania z NavigationView. W aplikacji demonstracyjnej możesz wypróbować te zachowania w obu wersjach i wybrać tę, która Ci odpowiada. Na przykład może być nadal konieczne użycie MapView w sytuacjach, w których korzystasz z biblioteki innej firmy, która oczekuje interakcji z tą klasą.