Wypróbuj wersję demonstracyjną

Dzięki zintegrowaniu pakietu SDK 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. Ten przewodnik zawiera informacje o uruchamianiu aplikacji demonstracyjnych Navigation SDK, które są dostępne na GitHub.

Przygotuj się

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

  • Klucz API udostępniony do użycia z pakietem SDK do nawigacji. Więcej informacji o tworzeniu i ograniczaniu kluczy znajdziesz w artykule Korzystanie z kluczy API.
  • Element pakietu SDK. Upewnij się, że Twój projekt jest skonfigurowany do korzystania z Mavena w przypadku pakietu SDK nawigacji.
  • Co najmniej 1 aplikacja demonstracyjna.
  • 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 obiektowego. Musisz też znać Mapy Google z perspektywy użytkownika.

Pobieranie aplikacji demonstracyjnych

Google udostępnia 2 aplikacje, które pomogą Ci zrozumieć, co oferuje pakiet Navigation SDK 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 wersji demonstracyjnej GoogleNavigation. Deweloperzy, którzy dopiero zaczynają korzystać z tych projektów, znajdą w obu aplikacjach wiele przydatnych funkcji.

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

  • Demonstracja GoogleNavigation: pokazuje integrację zachowań i widoków interfejsu API w odniesieniu do wrażeń użytkownika podczas sesji z prowadzeniem.

  • Demo GoogleMap: pokazuje poszczególne zachowania interfejsu GoogleMap, aby umożliwić dostosowywanie wyglądu i prezentacji map.

Prezentacja GoogleNavigation

Najnowsze demo GoogleNavigation jest dostępne 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 Kompiluj 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 sprawdź, czy pakiet SDK znajduje się w sekcji zależności.

Więcej informacji o dodawaniu klucza interfejsu API do pliku manifestu znajdziesz w dokumentacji dotyczącej pliku dodatku Gradle z tajną zawartością.

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ł urządzenie.
    • Emulator – użyj Menedżera urządzeń wirtualnych 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) i wybierz miejsce wdrożenia.

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

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

Opcja 1. NavViewActivity przedstawia zachowania przy użyciu NavigationView w połączeniu z Navigator.

Opcja 2: druga opcja o nazwie NavFragmentActivity przedstawia zachowania z wykorzystaniem 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 przejazd z Twojej bieżącej lokalizacji do tego adresu. Użyj nakładki paneli sterowania, aby zobaczyć, co się dzieje, gdy wywołujesz interfejs API. Możesz na przykład kliknąć Wyświetl metody, aby wymusić tryb nocny pakietu SDK i sprawdzić, jak on wygląda.

Opcja SwappingMapAndNavActivity

SwappingMapAndNavActivity przedstawia te typowe wzorce:

Prezentacja Map Google

Najnowsze demo GoogleNavigation jest dostępne 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 Kompiluj 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 sprawdź, czy w sekcji zależności występuje pakiet SDK.

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

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 programistyczne 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ądzeń wirtualnych Androida (AVD). Wybierając emulator, wybierz obraz, który zawiera interfejsy API Google.

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

Po utworzeniu i uruchomieniu aplikacja wyświetla użytkownikowi stronę docelowa 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 Map Google została zaprojektowana tak, aby była podobna do aplikacji demonstracyjnej interfejsu Map API. Główna różnica polega na tym, że wersja demonstracyjna pakietu SDK nawigacji 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 samouczku możesz wypróbować te zachowania w obu wersjach naszej aplikacji demonstracyjnej i wybrać tę, która Ci odpowiada. Na przykład może być konieczne użycie MapView w sytuacjach, gdy używasz biblioteki zewnętrznej, która ma współpracować z tą klasą.