Wypróbuj wersję demonstracyjną

Dzięki zintegrowaniu pakietu SDK do nawigacji na Androida Twoja aplikacja może nie tylko łączyć się z zewnętrznym widokiem mapy. Dzięki nawigacji w Mapach Google Twoja aplikacja może oferować dynamiczne pobieranie i raportowanie danych o trasie użytkownika w jednym widoku. Z tego przewodnika dowiesz się, jak uruchamiać aplikacje demonstracyjne pakietu SDK nawigacji, które są dostępne na GitHub.

Przygotuj się

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

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

Ta dokumentacja jest przeznaczona dla osób, które znają programowanie na Androida i koncepcje programowania obiektowego. 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 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 dopiero zaczynają pracę nad tymi projektami, znajdą w obu aplikacjach wiele przydatnych funkcji.

W wersji 4.1 pakietu SDK do nawigacji na Androida dostępne są do pobrania na GitHub 2 aplikacje demonstracyjne.

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

Demonstracja GoogleNavigation

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

Budynek

  1. W Android Studio zaimportuj aplikację demonstracyjną 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 Java zwróć uwagę na kod implementacji.

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

    • 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 – wykonaj te instrukcje, 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, wybierz obraz, który zawiera 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ą opcji.

Osoby, które dopiero zaczynają korzystać z NavSDK, prawdopodobnie uznają te 2 opcje za najbardziej przydatne.

Opcja 1.: NavViewActivity przedstawia zachowania za pomocą NavigationVieww połączeniu z Navigator.

Opcja 2. Druga opcja, zatytułowana NavFragmentActivity, przedstawia zachowania przy użyciu SupportNavigationFragment obok Navigator.

Gdy klikniesz jedną z tych opcji, zobaczysz:

  • interfejs nawigacji.
  • przycisk „Ustaw miejsce docelowe” w menu aplikacji;
  • nakładka, z którą możesz wchodzić w interakcje, aby dynamicznie wywoływać metody interfejsu 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. Użyj paneli sterowania, aby zobaczyć, co się dzieje, gdy wywołujesz interfejs 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:

Prezentacja Map Google

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

Budynek

  1. W Android Studio zaimportuj aplikację demonstracyjną 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 Java zwróć uwagę na kod implementacji.

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

    • 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 pluginie Gradle do obsługi 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 tak, aby wykrywał to urządzenie.
    • Emulator – do konfigurowania urządzenia wirtualnego użyj Menedżera urządzenia wirtualnego z Androidem (AVD). Wybierając emulator, wybierz obraz, który zawiera 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ą demonstracji.

Ten schemat prezentacji i odpowiednia struktura kodu źródłowego powinny być znane użytkownikom wersji demonstracyjnych pakietu SDK Map Google. Dzieje się tak, ponieważ wersja demonstracyjna pakietu Navigation SDK 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 wybranie klasy widoku, w której chce przetestować wersję demonstracyjną: NavigationView lub MapView (w stosownych przypadkach).

Google zachęca użytkowników do korzystania z NavigationView. W tym pokazie możesz wypróbować te zachowania w obu wersjach naszej aplikacji demonstracyjnej i wybrać tę, która Ci odpowiada. Na przykład MapView może być nadal potrzebna w sytuacjach, gdy używasz biblioteki zewnętrznej, która oczekuje interakcji z tą klasą.