Deklarowanie zależności

Aby dodać zależność od biblioteki Car App Library, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Maven firmy Google.

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

dependencies {
    implementation "androidx.car.app:app:1.4.0"

    // For Android Auto specific functionality
    implementation "androidx.car.app:app-projected:1.4.0"

    // For Android Automotive specific functionality
    implementation "androidx.car.app:app-automotive:1.4.0"

    // For testing
    testImplementation "androidx.car.app:app-testing:1.4.0"
}

dependencies {
    implementation("androidx.car.app:app:1.4.0")

    // For Android Auto specific functionality
    implementation("androidx.car.app:app-projected:1.4.0")

    // For Android Automotive specific functionality
    implementation("androidx.car.app:app-automotive:1.4.0")

    // For testing
    testImplementation("androidx.car.app:app-testing:1.4.0")
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli zauważysz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk z gwiazdką.

Tworzenie nowego numeru

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.7

Wersja 1.7.0-beta02

18 września 2024 r.

androidx.car.app:app-*:1.7.0-beta02 został zwolniony. Wersja 1.7.0-beta02 zawiera te komity.

Zmiany w interfejsie API

• Dodaj KEY_ROOT_HINT_MEDIA_HOST_VERSION dodatkowe (I8796b)
• Zastąp klasę TabContents.Api8Builder konstruktorem @ExperimentalCarApi w klasie TabContents.Builder (I26fbe)
• Dodaj działanie intencji i dodatkowe informacje dla CarMediaApp (I50782)
• Oznacz interfejsy API do przesyłania wiadomości jako nieeksperymentalne (I0b070)
• Dodaj wczytywanie obiektów zdalnych do SectionedItemTemplate (umożliwia wczytywanie długich list bez zawieszania się) (I0d122)
• Dodaliśmy SectionedItemTemplate do listy obsługiwanych szablonów w TabTemplate w interfejsie API 8. (Idc5d6)

Poprawki błędów

• Usunięto ręczne określanie dostępu do nowych interfejsów API platformy, ponieważ odbywa się to automatycznie za pomocą modelowania interfejsu API podczas korzystania z R8 z AGP 7.3 lub nowszym (np. R8 w wersji 3.3) oraz dla wszystkich kompilacji podczas korzystania z AGP 8.1 lub nowszego (np. D8 w wersji 8.1). Klientom, którzy nie korzystają z pakietu AGP, zalecamy zaktualizowanie go do wersji D8 w wersji 8.1 lub nowszej. Więcej szczegółów znajdziesz w tym artykule. (I9496c, b/345472586)

Wersja 1.7.0-beta01

26 czerwca 2024 r.

androidx.car.app:app-*:1.7.0-beta01 został zwolniony. Wersja 1.7.0-beta01 zawiera te komity. Funkcje są takie same jak w wersji alfa01. Poniżej znajdują się powtórzenia:

Nowe funkcje

• Mapa z treściami: nowy szablon Map Canvas oraz szablon treści, który może być obecnie listą, siatką, panelem lub wiadomością.
  • Wycofano reguły RoutePreview, PlaceListNavigation i MapTemplate. Szablony będą działać tak jak dotąd.
  • Przykładowe aplikacje zostały zaktualizowane, aby zamiast wycofanych szablonów pokazywać użycie MapWithContent
• Element rozmowy:nowe interfejsy API do wyświetlania rozmów (czat, SMS) i czytania przez Asystenta w samochodzie.
• Wymiary pojazdu: nowy interfejs API do pobierania danych o pomiarach pojazdów (obecnie dane z AAOS).

Zmiany w interfejsie API

• Dodaj tag @ExperimentalCarApi do MediaPlaybackTemplate.Builder. (IC1957).
• Dodaje nową opcję SectionedItemTemplate w wersji eksperymentalnej. (I5958a)
• Przedstawianie CarAppApiLevel 8 (I3fa22)
• Dodaje MediaPlaybackTemplate do wyświetlania treści podczas odtwarzania multimediów w Bibliotece aplikacji samochodowych. (I3c10d)
• Dodano nowy interfejs API dla aplikacji wykrywający, czy system obsługuje dźwięk w tle podczas jazdy (I0f868).

Poprawki błędów

• Naprawia niektóre wystąpienia wycieków i awarii pamięci w kodzie klienta CAL oraz w przykładowej aplikacji CAL Navigation Sample (I55e04).
• Aby uniknąć awarii, w metodzie onDestroy klasy BaseCarAppActivity zastąp instrukcję requireNotNull instances instrukcją if-null. (Iec676)

Wersja 1.7.0-alpha02

17 kwietnia 2024 r.

androidx.car.app:app-*:1.7.0-alpha02 został zwolniony. Wersja 1.7.0-alpha02 zawiera te komisy.

Nowe funkcje

• Dodaliśmy oznaczenia przestarzałych szablonów opartych na mapach, które będą używane przez szablon MapWithContent.

Zmiany w interfejsie API

• Wycofanie starszych wersji usług MapTemplate, RoutePreviewNavigationTemplate, PlaceListNavigationTemplate i zachęcenie do korzystania z nowych MapWithContentTemplate (Ib0a08)

Wersja 1.7.0-alpha01

3 kwietnia 2024 r.

Usługa androidx.car.app:app-*:1.7.0-alpha01 została zwolniona. Zmieniliśmy schemat wersji biblioteki, aby był zgodny z aktywowaną wersją CarApi. Zrobiliśmy to, aby zmniejszyć dezorientację związaną ze schematem nazewnictwa. Uwzględniliśmy opinie deweloperów. Z tego powodu pominiemy wersje 1.5 / 1.6, które są bezpośrednio przenoszone do wersji 1.7 1.7.0-alfa01, która zawiera te zatwierdzenia.

Nowe funkcje

• Mapa z zawartością: nowy szablon o nazwie MapWithContent, który obsługuje listy, siatkę, panele i wiadomości jako zawartość w mapie.
  • RoutePreview, PlaceListNavigation, szablony map zostały wycofane.
  • Przykładowe aplikacje zostały zaktualizowane, aby wyświetlały funkcje wycofanych szablonów za pomocą MapWithContent.
• Element rozmowy: nowe interfejsy API do wyświetlania rozmów (czat, SMS) i odczytywania przez Asystenta w samochodzie.
• Vehicle Dimensions (Wymiary pojazdu): nowy interfejs API do pobierania danych o pomiarach dotyczących pojazdów (obecnie dane z AAOS).

Zmiany w interfejsie API

• Oznaczenie typu obrazu w wierszu bardzo małym jako eksperymentalnego (I5184b)
• Dodano interfejs API CarInfo#fetchExteriorDimensions, który umożliwia dostęp do informacji o zewnętrznych wymiarach pojazdu, takich jak wysokość, szerokość itp. (Ia40c5)
• Usunięto tag ExperimentalAPI z MapWithContentTemplate (I66db8)
• Zmień parametr GridItem#setTitle, aby mógł być pusty. (I3d610)
• Interfejs API GetHeader nie wymaga interfejsu API 7, ponieważ jest wstecznie zgodny (I8c812)
• Dodanie obsługi Header w ListTemplate, wycofanie headerAction, headerTitle i actionStrip (I7ae01)
• Wycofanie funkcji title, headerAction i actionStrip w wersji GridTemplate oraz dodanie obsługi funkcji Header (I41a9c)
• Usuń wymóg poziomu 7 w przypadku interfejsów API w wersji eksperymentalnej: Badge, GridTemplate metody pobierania i ustawiania rozmiaru elementu oraz kształtu obrazu, GridItem metody pobierania i ustawiania plakietki. (Id71eb)
• Wycofanie funkcji title, headerAction i actionStrip w PaneTemplate oraz dodanie obsługi nowej funkcji Header (I23154)
• Zmieniono telemetrię Media Center z BroadcastReceiver na przeglądanie działania niestandardowego. (I4185f)
• Dodano obsługę atrybutu Header w MessageTemplate. Wycofana obsługa ActionStrip, headerAction i title. (Ie2de8)
• Zmiana widoczności stałych alertów (Icf8a8)
• Usuń atrybut isLoading ze szablonu nadrzędnego (I651e6).
• Dodaj dodatkowe informacje, aby poinformować aplikacje multimedialne o głównych parametrach interfejsu (I85ca2)
• Dodawanie funkcji analitycznej centrum mediów do MediaExtensions (I7ce28)
• Dodano opcję bardzo małego obrazu w wierszach. (I72c03)

Poprawki błędów

• Zaktualizuj javadoc w ConversationItem, aby wskazać, że wiadomości powinny być sortowane od najstarszej do najnowszej. (I77a2a)
• Zaktualizuj logikę skracania ListTemplate, aby usunąć najstarsze wiadomości z ConversationItem (Ie0a61)

Wersja 1.4

Wersja 1.4.0

29 maja 2024 r.

androidx.car.app:app-*:1.4.0 został zwolniony. Wersja 1.4.0 promuje wersję 1.4.0-rc02.

Ważne zmiany od wersji 1.3.0

• Renderowanie mapy klastra w przypadku aplikacji do nawigacji
• Szablon nowej karty na potrzeby ulepszonego układu i użyteczności aplikacji
• Obsługa limitów zadań adaptacyjnych
• Czynności dodatkowe dotyczące elementów listy

Wersja 1.4.0-rc02

13 grudnia 2023 r.

Usługa androidx.car.app:app-*:1.4.0-rc02 została zwolniona. Wersja 1.4.0-rc02 zawiera te zatwierdzenia. tylko drobne poprawki.

Poprawki błędów

• Zaktualizowano javadoc w ConversationItem, aby wskazać, że wiadomości powinny być sortowane od najstarszej do najnowszej (I77a2a)
• Zaktualizowano logikę skracania ListTemplate, aby usuwać najstarsze wiadomości z ConversationItem (Ie0a61)

Wersja 1.4.0-rc01

1 listopada 2023 roku

androidx.car.app:app-*:1.4.0-rc01 jest publikowana bez istotnych zmian. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

Wersja 1.4.0-beta02

20 września 2023 r.

androidx.car.app:app-*:1.4.0-beta02 został zwolniony. Wersja 1.4.0-beta02 zawiera te commity. Jest to wersja prawie identyczna jak beta01, ale z wymaganym compileSdk 33.

Poprawki błędów

• Naprawiono błąd polegający na tym, że ekrany wczytywania na kartach nie były prawidłowo wyświetlane. (CAE860).

Wersja 1.4.0-beta01

9 sierpnia 2023 r.

androidx.car.app:app-*:1.4.0-beta01 został zwolniony. Wersja 1.4.0-beta01 zawiera te commity.

Uwaga: wersja 1.4-beta01 wymaga kompilacji Sdk34, która jest nadal w etapie rozwoju. Wersja 1.4-beta02 rozwiąże ten problem. Możesz też dodać android.suppressUnsupportedCompileSdk=34 do pliku settings.gradle projektu, aby bezpiecznie tymczasowo wyłączyć ostrzeżenie.

Nowe funkcje

• Renderowanie mapy w klastrze przyrządów na potrzeby aplikacji do nawigacji
• Nowy szablon karty zapewniający lepszy układ i użyteczność aplikacji
• obsługę adaptacyjnych limitów zadań,
• Czynności dodatkowe dotyczące elementów listy

Zmiany w interfejsie API

• Zobacz alpha02

Wersja 1.4.0-alpha02

26 lipca 2023 r.

androidx.car.app:app-*:1.4.0-alpha02 został zwolniony. Wersja 1.4.0-alpha02 zawiera te commity.

• Wersja Alpha02 ma być przygotowaniem do nadchodzącej wersji beta01.

Nowe funkcje

• Renderowanie mapy w klastrze przyrządów w przypadku aplikacji do nawigacji
• Dodano karty dla aplikacji, aby ulepszyć układ
• Dodano opcje renderowania szablonów listy i siatka
• Dodano nowe kategorie dotyczące pogody i komunikacji
• Przeniesienie kilku interfejsów API do następnej wersji CarApi 7

Zmiany w interfejsie API

• Dodawanie pól multimedialnych do aplikacji CarMessage (I5aaf6)
• Dodaje niestandardowe działania do aplikacji ConversationItem w bibliotece aplikacji samochodowych (Ie5ed6)
• Dodaj dodatkowe informacje, aby wskazać, że element multimedialny jest odtwarzany w formacie dźwięku przestrzennego, i wyświetlić logo formatu treści (Icb5bb).
• Dodaj nowy typ działania, ActionsConstraints, aby obsługiwać przycisk tworzenia. (I31661)
• Ustawiono set/getTemplate jako set/get ContentTemplate (Ica036)
• Parametr szablonu będzie teraz @NonNull. Zaktualizowano dokumentację interfejsu API MapWithContentTemplate (I0f8ed)
• Usunięcie tagu @ExperimentalCarApi dla działań w sekcji ListTemplate w celu uruchomienia w CAL 1.4 (I2cfcb)
• Usuwa tag @ExperimentalCarApi dla TabTemplate (Ifcb82)
• Usuń adnotacje @ExperimentalCarApi z działań alternatywnych i dekoracji wiersza (I8487e)
• Dodanie identyfikatora treści aktywnej karty do TabTemplate i wycofanie stanu aktywnego na kartach (I96932)
• Dodawanie właściwości ItemImageShape do właściwości GridTemplate (Ibf431)
• Dodaj właściwość ItemSize do GridTemplate, która kontroluje rozmiar elementów siatki zgodnie z względnymi zbiornikami małych, średnich i dużych. (Icdb3b).
• Otwórz dostęp do interfejsu API, aby umożliwić deweloperom uzyskanie kopii bieżącego zestawu ekranów. (I48107)
• Dodaje kategorię aplikacji pogodowych do biblioteki aplikacji w samochodzie (I2be44)
• Dodanie kategorii aplikacji do dzwonienia do Biblioteki aplikacji samochodowych (Icab33)
• Metody GridItem.Builder#setBadge() zostały zastąpione przeciążonymi metodami setImage() (Id2000).
• Dodawanie właściwości ikony do plakietki (I629b2)
• Dodaj metodę ustawiania koloru tła plakietki z kropką (I6411c)
• Dodaj do GridItem właściwość Plakietka, aby wyświetlać plakietkę na obrazie GridItem. (I95de7)
• Dodano eksperymentalny obiekt Odznaka, który będzie reprezentować odznakę wyświetlaną na obrazie. (I9878D)

Wersja 1.4.0-alpha01

22 lutego 2023 roku

Usługa androidx.car.app:app-*:1.4.0-alpha01 została zwolniona. Wersja 1.4.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• Dodanie działań najwyższego poziomu do GridTemplate w Bibliotece aplikacji samochodowych (Id0191)
• Dodaje działania najwyższego poziomu do aplikacji ListTemplate w bibliotece aplikacji samochodowych (I9efab)
• Dodawanie dodatkowych informacji, aby połączyć napisy lub opis elementu multimedialnego z innymi elementami multimedialnymi (Ic84bf)
• Zaktualizuj poziom interfejsu API działań dotyczących wierszy do poziomu 6. (IE0A69)
• Dodawanie wywołań zwrotnych wiadomości do A4C (Ie3986)

Poprawki błędów

• Dodaj brakujące odwołania do dokumentacji Java dla CarMessage. (I5db1c)
• Zastąp equals() i hashCode() wartościami ConversationItem i CarMessage (I6fd10)
• Ulepszona weryfikacja ConversationItem.mMessages (wymaganie, aby nie był null i nie był pusty (Iafc51))
• Dodawanie adnotacji @Keep do pól ConversationItem (I5d250)
• Zaktualizowano dokumenty Java dotyczące dekoracji wiersza i dodatkowych działań. (I000b6)

Wersja 1.3

Wersja 1.3.0-rc01

7 grudnia 2022 r.

androidx.car.app:app-*:1.3.0-rc01 został zwolniony. Wersja 1.3.0-rc01 zawiera te commity.

• Drobne poprawki błędów z wersji beta01. Bez istotnych zmian.

Wersja 1.3.0-beta01

7 września 2022 roku

androidx.car.app:app:1.3.0-beta01, androidx.car.app:app-projected:1.3.0-beta01, androidx.car.app:app-automotive:1.3.0-beta01 i androidx.car.app:app-testing:1.3.0-beta01 są odblokowane. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

• Aplikacje samochodowe utworzone za pomocą tej biblioteki mogą teraz trafić do Sklepu Play przy użyciu poziomu interfejsu API 5 (zobacz nasz przewodnik dla programistów). Funkcje opisane w interfejsie API na poziomie 5 lub niższym są zgodne zarówno z Androidem Auto 8.1 lub nowszym, jak i z Google Automotive App Host w wersji 1.4 lub nowszej.

Nowe funkcje

Oprócz możliwości dodanych do Biblioteki aplikacji samochodowych w wersji 1.3.0-alfa01 dodaliśmy te funkcje w ramach wersji beta 01 (wszystkie funkcje są tu wprowadzane tylko ze zmianami po stronie hosta bez żadnych zmian w interfejsie API):

• Pływający pasek nawigacyjny będzie widoczny nawet wtedy, gdy użytkownik będzie na ekranie wyboru na mapie w aplikacjach PlaceListNavigationTemplate, RoutePreviewNavigationTemplate i MapTemplate. Możesz to zrobić, aktualizując informacje nawigacyjne za pomocą NavigationManager.updateTrip().
• Aby włączyć animację limitu czasu, zaznacz pole FLAG_DEFAULT obok przycisku działania. Po upływie limitu czasu ten przycisk będzie klikany domyślnie. ([API 5 - All Templates])
• Tekst podrzędny Row nie jest skracany, gdy samochód jest zaparkowany, ale podczas jazdy jest skracany do 2 wierszy. ([API 5 - All Templates])
• Obsługa stanu wyłączonego w przypadku Action, Toggle, Row ([API 5 - All Templates])

Zmiany w interfejsie API

• Zmniejsz ograniczenia na liście MapTemplate, aby umożliwić wybór list (I961ed)
• Usuń ograniczenie dotyczące działań związanych z nagłówkiem, aby umożliwić stosowanie ikon niestandardowych. (Iad28f).
• Dodaj ograniczenie setOnClickListenerAllowed() do ActionsConstraints. Umożliwiało to Action ustawienie OnClickDelegate() dla działań z wyjątkiem standardowych typów ikon. (TYPE_APP_ICON, TYPE_BACK i TYPE_PAN) (I3c745)

Poprawki błędów

• Dodano zgodność składnika Android Automotive Templates Host w wersji 1.4 lub nowszej z wyświetlaczami zakrzywionymi ([Host change]).

Wersja 1.3.0-alpha01

27 lipca 2022 roku

androidx.car.app:app:1.3.0-alpha01, androidx.car.app:app-projected:1.3.0-alpha01, androidx.car.app:app-automotive:1.3.0-alpha01 i androidx.car.app:app-testing:1.3.0-alpha01 są odblokowane. Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Funkcje opisane jako zgodne z poziomem interfejsu API 5 są zgodne z Androidem Auto 7.9 lub nowszym.

Nowe funkcje

• Poziom API 5: nowa wartość MapTemplate, której aplikacje nawigacyjne mogą używać do wyświetlania panelu lub listy treści obok mapy (If5826, If44b8).
• Poziom interfejsu API 5: nowy interfejs API CarAudioRecord umożliwiający nagrywanie sygnału audio za pomocą mikrofonu pojazdu gospodarza (I5e71a)
• Poziom interfejsu API 5: nowy interfejs API SuggestionManager, który umożliwia aplikacjom przesyłanie sugestii do hosta (I5c103)
• Poziom API 5: nowy interfejs API Alert do wyświetlania powiadomień kontekstowych na stronie NavigationTemplate (I163a7, I5ad70)
• Poziom API 5: nowe komponenty Header i MapController ułatwiające ponowne używanie w różnych szablonach (If5826)
• Dodano kategorię androidx.car.app.category.POI, aby umożliwić stosowanie aplikacji z miejscami docelowymi (wycofano kategorie androidx.car.app.category.PARKING i androidx.car.app.category.CHARGING) (I59da1)

Zmiany w interfejsie API

• Poziom API 5: nowa metoda onClick w interfejsie SurfaceCallback umożliwiająca interaktywność na mapie (Ia9777)
• Poziom API 5: nowe flagi Action.FLAG_IS_PERSISTENT i Action.FLAG_DEFAULT do opisywania Action (I96318, I5ad70)
• Poziom API 5: nowy stan włączenia/wyłączenia komponentów Action, Row i Toggle (obsługa hosta wkrótce w wersji 1.3.0-beta01 biblioteki) (Id8a09)
• Poziom interfejsu API 5: preferuj nowy komponent Header za pomocą komponentu setHeader w plikach PlaceListNavigationTemplate.Builder i RoutePreviewNavigationTemplate.Builder, wycofując obecne metody setTitle i setHeaderAction (I30e6a)
• Poziom interfejsu API 5: nowa metoda setOnContentRefreshListner na platformach PlaceListMapTemplate.Builder i PlaceListNavigationTemplate.Builder do użytku z implementacjami nowego interfejsu OnContentRefreshListner.
• Poziom interfejsu API 5: nowe setTripText i setTripIcon w systemie TravelEstimate.Builder, aby dostosować kartę prognozy dotyczącej podróży (Idcc6d, Ic620d)
• Dodaj obsługę CarIconSpan w tytule PaneTemplate (Ia1ee0)
• Dodawanie obsługi CarIconSpan w tytule i tekście Row (Ic1e3c)
• Mapy ActionStrip mogą teraz zawierać maksymalnie 4 działania (If3522)
• Zaktualizuj interfejs Car App API na poziomie 5 (I26b8e)
• Nagłówki/tytuły są teraz opcjonalne w przypadku dokumentów PlaceListMapTemplate, PlaceListNavigationTemplate, RoutePreviewNavigationTemplate, GridTemplate, ListTemplate, LongMessageTemplate, MessageTemplate, PaneTemplate i SignInTemplate (I2078d, Icadde)

Poprawki błędów

• Zaktualizowano reguły rozmiaru obrazu PaneTemplate, aby zawierały kwadratowy prostokąt ograniczający (Idd72e).
• Rozwiązaliśmy problem z wyjątkiem, który występuje, gdy po State.DESTROYED modyfikowany jest stos ekranów. (I3c8eb).
• Dodano zerową kontrolę pobierania ikony aplikacji (I3f710).
• Aktualizacja interfejsu Car Hardware API, aby domyślnie używać interfejsu STATUS_UNKNOWN zamiast STATUS_UNAVAILABLE (Ic9444)
• Sprawdzanie, czy wyświetlacz istnieje, przed utworzeniem powierzchni (Ice027a)
• Naprawiono błąd CarValue.equals() dotyczący STATUS_UNIMPLEMENTED (I24451)

Wersja 1.2

Wersja 1.2.0

9 listopada 2022 r.

androidx.car.app:app-*:1.2.0 został zwolniony. Wersja 1.2.0 zawiera te zatwierdzenia.

• Jest to stabilna wersja, która nie zawiera żadnych zmian w stosunku do wersji 1.2.0-rc01.

Wersja 1.2.0-rc01

23 marca 2022 r.

androidx.car.app:app-*:1.2.0-rc01 został zwolniony. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

• Jest to wersja stabilizacyjna. W porównaniu z wersją v1.2.0-beta02 nie wprowadzono żadnych zmian w interfejsie API. Dodano nowe funkcje eksperymentalne (poziom interfejsu API 5) przeznaczone do przyszłych wersji Androida Auto i Androida Automotive.

Poprawki błędów

• Rozwiązaliśmy problem z wyjątkiem, który występuje, gdy po State.DESTROYED modyfikowany jest stos ekranów. (I3c8eb)
• Zaktualizowano interfejs API CarSensors, aby wskazać, że nie jest on implementowany w przypadku AAOS (Idd57b).
• Zaktualizowano PlaceListMapTempalte.Builder#setCurrentLocationEnabled, by wskazać, że parametr ACCESS_COARSE_LOCATION jest wystarczający do działania tej funkcji (I510c2).
• Uczyniliśmy numer zjazdu opcjonalnym w przypadku typów manewrów na rondzie z zakrętem (Ife7d1).

Wersja 1.2.0-beta02

26 stycznia 2022 r.

Usługa androidx.car.app:app-*:1.2.0-beta02 została zwolniona. Wersja 1.2.0-beta02 zawiera te commity.

Aplikacje samochodowe utworzone z użyciem tej wersji biblioteki na platformę Android Automotive OS można teraz publikować w otwartym kanale testowania w Sklepie Play. Więcej informacji znajdziesz w przewodniku dla programistów.

Funkcje oznaczone jako API na poziomie 4 lub niższym są zgodne zarówno z Android Auto w wersji 7.2 lub nowszej, jak i z nową platformą Android Automotive OS. Zastrzeżenia znajdziesz w sekcji Known Issues poniżej.

Zmiany w interfejsie API

• Do szablonów ciekawych miejsc dodano eksperymentalny interfejs API setOnContentRefreshListener (I6bf22)

Poprawki błędów

• Naprawiliśmy wyciek pamięci w CarAppService, gdy gospodarz samochodu odłączył się od usługi. (I5c9ca, b/203594731)
• Zaktualizowano CarAppActivity javadoc, aby uwzględnić wymagania dotyczące trybu uruchamiania singleTask (Id2f95)
• Eliminuje problemy wizualne przy wznawianiu. (Iff7e0).

Znane problemy

• Mapy ActionStrip w wersjach PlaceListNavigationTemplate i RoutePreviewNavigateTemplate staną się dostępne w kolejnych wersjach Android Auto i Android Automotive OS.

Wersja 1.2.0-alfa02

15 grudnia 2021 roku

androidx.car.app:app-*:1.2.0-alpha02 został zwolniony. Wersja 1.2.0-alpha02 zawiera te commity.

Funkcje opisane w interfejsie API poziomu 4 zostały przekształcone z wersji eksperymentalnej w stabilną. Dotyczy to m.in. map ActionStrip w PlaceListNavigationTemplate i RoutePreviewNavigateTemplate, obrazu CarIcon w systemach Pane i QRCodeSignInMethod oraz możliwości ustawiania wskazówek dotyczących renderowania (np. flag) w jednostkach Action.

Nowe funkcje

• Na Androidzie Auto w wersji 7.1 i nowszych limit produktów Pane został zwiększony z 2 do 4.

Zmiany w interfejsie API

• Dodano eksperymentalną metodę toString() do CarUnit(I36a3b).

Poprawki błędów

• Naprawiono błąd powodujący awarię w CarAppPermissionActivity, jeśli wywołanie zwrotne nie działa (If9823)
• Zmieniono domyślny limit listy Pane na 4 (I0068b)

Wersja 1.2.0-alpha01

3 listopada 2021 r.

androidx.car.app:app-*:1.2.0-alpha01 został zwolniony. Wersja 1.2.0-alpha01 zawiera te commity.

Wszystkie nowe funkcje v1.2.0 (API 4+) są obecnie funkcjami eksperymentalnymi kierowanymi na przyszłe wersje Androida Auto i Androida Automotive. Więcej informacji znajdziesz w przewodniku dla programistów.

Zmiany w interfejsie API

• Interfejs API AutomotiveCarInfo jest teraz eksperymentalny. (Ia13e5).
• Dodano poziom API 4 biblioteki Car App Library (I2a2e7).
• Poziom API 4: dodano obsługę ustawienia CarIcon w Pane (Ifcc12).
• Poziom interfejsu API 4: dodano metodę logowania za pomocą kodu QR (Ib623e).
• Poziom API 4: dodano flagę set/getFlags do interfejsu Action (Ic03ab)
• Poziom API 4: dodano obsługę przesuwania i powiększania w funkcjach PlaceListNavigationTemplate i RoutePreviewNavigationTemplate (I9d8a3).

Poprawki błędów

• Poziom interfejsu API 4: dodaj mechanizm umożliwiający aplikacjom wysyłanie aktualizacji lokalizacji do hosta samochodu (I3bad3)
• Rozwiązanie problemu, który powodował, że logika weryfikacji hosta nie znajdowała prawidłowo uprawnienia TEMPLATE_RENDERER (I62618)

Wersja 1.1.0

Wersja 1.1.0

15 grudnia 2021 roku

androidx.car.app:app-*:1.1.0 został zwolniony. Wersja 1.1.0 zawiera te zatwierdzenia.

Jest to wersja stabilna, która nie zawiera żadnych zmian w porównaniu z wersją v1.1.0-rc01. Więcej informacji o nowych funkcjach biblioteki aplikacji samochodowych znajdziesz w informacjach o wersji v1.2.0-alpha02.

Ważne zmiany od wersji 1.0.0

• Poziom 2 interfejsu API: SignInTemplate i LongMessageTemplate, które można używać do logowania się, gdy pojazd jest zaparkowany.
• Poziom interfejsu API 2: obsługa interakcji z mapą w ramach NavigationTemplate
• Poziom 2 interfejsu API: obsługa tekstu o różnej długości, która umożliwia aplikacjom wyświetlanie wielu wersji ciągu znaków w zależności od rozmiaru ekranu samochodu.
• Poziom interfejsu API 3: CarHardwareManager, który może służyć do wysyłania zapytań o dane sprzętowe pojazdu, takie jak model i marka, poziom paliwa i inne czujniki.

Wersja 1.1.0-rc01

3 listopada 2021 r.

androidx.car.app:app-*:1.1.0-rc01 został zwolniony. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

Jest to stabilna wersja, w której nie ma żadnych zmian w interfejsie API w porównaniu z wersją v1.1.0-beta01. Dodaliśmy nowe funkcje eksperymentalne (poziom API 4), które są przeznaczone dla przyszłych wersji Androida Auto. Więcej informacji o interfejsach API w wersji eksperymentalnej znajdziesz w informacjach o wersji v1.2.0-alpha01.

Wersja 1.1.0-beta01

1 września 2021 roku

Usługa androidx.car.app:app-*:1.1.0-beta01 została zwolniona. Wersja 1.1.0-beta01 zawiera te commity.

Wszystkie funkcje v1.1.0 (interfejs API 2+) są w pełni zgodne z Androidem Auto w wersji 6.7 lub nowszej. Więcej informacji znajdziesz w przewodniku dla programistów.

Zmiany w interfejsie API

• Usunięto Manager jako interfejs publiczny (Ie381b).
• Dodano możliwość ustawienia niestandardowego tła z logo marki dla prośby o uprawnienia (I74b76)
• Dodano ScreenManager.getStackSize (I0b16a)
• Usunięto konstruktor ScreenController, który przyjmuje argument TestCarContext (Iefebc).

Poprawki błędów

• Dodano sprawdzanie poziomu interfejsu API podczas tworzenia CarHardwareManager (I48f9b)
• Dodano mechanizmy kontroli nieprawidłowego użycia interfejsu API CarSpan (I65ae6).
• Rozwiązanie problemu polegającego na tym, że jeśli podczas tworzenia Screen zostanie oznaczony jako zakończony, pozostawia stos w nieprawidłowym stanie (I81b13)
• Naprawiono problem, który powodował, że CarNotificationManager.notify rejestrował błąd w AutomotiveOS, jeśli w CarAppExtender były działania z ikonami (I3633d).
• Dodano metodę uścisku dłoni dla aplikacji i hosta, aby ustalić wersję interfejsu API (I7d6f8).

Wersja 1.1.0-alpha02

21 lipca 2021 r.

Usługa androidx.car.app:app-*:1.1.0-alpha02 została zwolniona. Wersja 1.1.0-alpha02 zawiera te commity.

Nowe funkcje

• Interfejs API 3: dodano CarHardwareManager, który umożliwia wysyłanie zapytań o dane sprzętowe pojazdu, takie jak model i marka, poziom paliwa i inne czujniki. Obecnie ta funkcja jest dostępna tylko na Androidzie Auto 6.7 lub nowszym w kanale testów otwartych. Aby przetestować to w środowisku komputerowym, wymagana jest nowa wersja Desktop Head Unit, która zostanie opublikowana oddzielnie. Zaglądaj na stronę testowania aplikacji na Androida w samochodach, aby dowiedzieć się, kiedy będzie dostępna nowa wersja.
• Aby uzyskać więcej informacji i wytycznych dotyczących projektowania, jak korzystać z tych funkcji w urządzeniach samochodowych zgodnych z interfejsem API w poziomie 3, zapoznaj się z przewodnikiem dla programistów i dokumentacją biblioteki.

Zmiany w interfejsie API

• Skonsolidowano metody cyklu życia SessionController i ScreenController w jedną metodę moveToState (I1ed00)
• Dodano CarContext#getHostInfo() (I8977e)
• Usunięto wycofane pola. (I67168)
• Zmieniono klasy SessionController i ScreenController, aby konstruktory były widoczne bezpośrednio (Iabf22).
• Usunięto PinSignInMethod.Builder i ProviderSignInMethod.Builder (I9f0cb)
• Dodano funkcję „setCarAppResult()”, aby umożliwić korzystanie z aplikacji szablonowych „dla wyniku” w AAOS (I37741).
• Oznaczyłeś interfejsy CarHardware w dokumentacji @MainThread. (Ib2f85)
• Nazwa OnCarDataListener została zmieniona na OnCarDataAvailableListener (I518ca)
• Zaktualizowano nazwy metod CarInfo, Speed, Mileage oraz javadoc. (I86672)
• Nazwa Toll została zmieniona na TollCard. (I3e7c8).
• Usunięto wycofane pole PinSignInMethod.getPin, które zostało zastąpione przez pole PinSignInMethod.getPinCode (I996ce)
• Usunięto OnInputCompletedListener (zastąpiono go elementem InputCallback). (Ib5be1)
• Zmieniono PinSignInMethod na CharSequence zamiast String (I275d5)

Poprawki błędów

• poprawki Javadoc dla sprzętu samochodowego; (I2abbc)

Darowizna zewnętrzna

Znane problemy

• W SignInTemplate użycie funkcji InputSignInMethod może spowodować wyświetlenie komunikatu NullPointerException na hoście samochodu. Ten problem zostanie rozwiązany w kolejne wydanie biblioteki. Aby obejść ten problem, dodaj ten wiersz do konfiguracji Proguarda aplikacji: -keep class androidx.car.app.model.signin.InputSignInMethod { *; }

Wersja 1.1.0-alpha01

16 czerwca 2021 r.

Funkcje androidx.car.app:app:1.1.0-alpha01, androidx.car.app:app-automotive:1.1.0-alpha01 i androidx.car.app:app-testing:1.1.0-alpha01 są dostępne. Wersja 1.1.0-alpha01 zawiera te commity.

Nowe funkcje

• Poziom interfejsu API 2: nowe parametry SignInTemplate i LongMessageTemplate, które można używać do logowania się, gdy pojazd jest zaparkowany.
• Poziom interfejsu API 2: obsługa nowych interakcji z mapą w ramach NavigationTemplate
• Poziom 2 interfejsu API: nowa obsługa tekstu o różnej długości, która umożliwia aplikacjom wyświetlanie wielu wersji ciągu znaków w zależności od rozmiaru ekranu samochodu.
• Aby uzyskać więcej informacji i poznać wytyczne dotyczące korzystania z tych funkcji w urządzeniach samochodowych zgodnych z interfejsem API w wersji 2, zapoznaj się z przewodnikiem dla programistów i dokumentacją Javadoc biblioteki.

Zmiany interfejsu API

• Ustawienie wszystkich metod interfejsu *Callback jako domyślne i nazwy OnRequestPermissionsCallback -> OnRequestPermissionsListener (Ib3ec9)
• Zaktualizowano klasy androidx.car.app.hardware, aby usunąć zbędne klasy konstruktorów i parametrów. (I67beb)
• Dodaliśmy klasy androidx.car.app.hardware, które umożliwiają dostęp do danych dotyczących samochodu, takich jak paliwo, bateria i prędkość. (Iff3c9)
• Dodano obsługę ActionStrip w MessageTemplate (Ida657)
• Dodano setLoading do MessageTemplate. (I2a4b5)
• Nazwa „ConnectionToCar” została zmieniona na „CarConnection” (Ife9bd)
• Zmieniono funkcję NavigationTemplate, aby zwracała jawną wartość PanModeDelegate (I13877).
• Zaktualizowano kolejność parametrów w przypadku zdarzenia CarContext.requestPermissions (Ib890a)
• Zaktualizowano klucz metadanych, aby określić min. poziom interfejsu API samochodu na androidx.car.api.minCarApiLevel (Ib0d41)
• Utworzono interfejs API, który umożliwia obserwowanie stanu połączenia samochodu (Ifc935)
• Dodaliśmy obsługę ustawiania przełącznika Action i typ trybu przesuwania Action (Ica6af).
• Utworzono CarNotificationManager, aby obsługiwać wysyłanie powiadomień w samochodzie (I10d7a).
• Dodano ConstraintManager do określania limitów list przez hosta (I8690e).
• Dodano interfejs API trybu przesuwania i paska działań mapy w wersji NavigationTemplate (I77aa6).
• Dodano interfejs API do przesuwania i powiększania SurfaceCallback w przypadku aplikacji do nawigacji (Id5e9d).
• Zmiana wartości CarAppApiLevel na 2 (Ic1540)
• Dodano możliwość wysyłania próśb o uprawnienia do urządzenia CarAppService (I5421e)
• Dodano adnotację RequiresCarApi(2) do interfejsu multi-text API (Iacb62).
• Dozwolono na kilka wariantów tekstu w tytule szablonu połowy listy (Ib8df7)
• Dodano nowe LongMessageTemplate (wymaga interfejsu Car API na poziomie 2) (Ic5cee)

Poprawki błędów

• Zaktualizowaliśmy wymagania dotyczące rozmiaru obrazu, aby uwzględnić większe ekrany samochodowe (I116dc).
• Dodanie więcej niż 2 działań w tekstach szablonów jest niedozwolone (I32157)
• Upewnij się, że wszystkie flagi PendingIntent zostały utworzone w bibliotece aplikacji samochodowych. (If84fe, b/186394900)
• Zaktualizowano dokument javadoc, aby zezwalał na zmiany tekstu elementu Row w ramach odświeżania (If3f9c)
• androidx.activity:activity:1.2.0 jest teraz zależnością interfejsu API (Id1cb9)
• SignInTemplate i LongMessageTemplate zostały ustawione tak, aby wymagały działań tylko zaparkowanych pojazdów, i zaktualizuj dokumentację, żeby wskazać, że będą wyświetlane tylko po zaparkowaniu samochodu (Iddaa9).
• Usunięto wyjątek, który występuje podczas wywoływania Screen na początku (Ifcf40, b/184664896)
• Dozwolony niestandardowy kolor tekstu w ForegroundCarColorSpan (I69e59)
• Rozwiązanie problemu polegającego na tym, że po ON_DESTROY Session w Session jest obserwowany jako ON_DESTROY (I52e01, b/183696617)Screen
• Zaktualizowano javadoc, aby umożliwić ustawienie nieznanego czasu pozostałego dla TravelEstimate. (I99610, b/183632456)
• Zaktualizowano Action, aby obsługiwał ForegroundColorSpan w tytule i dowolny niestandardowy kolor tła (I578e4).
• Nie wykonuj NavigationManagerCallback#onStopNavigation, jeśli wywołanie zwrotne zostanie wyczyszczone przed wykonaniem wykonawcy (I7fc5e, b/181143772)
• Naprawiliśmy błąd, który wymagał od aplikacji jawnej zależności od pakietu lifecycle-common-java8 (I8b8c8).

Znane problemy

• W SignInTemplate, gdy użytkownik chce potwierdzić dane, klawiatura ekranowa wyświetla ikonę „wyszukiwania” zamiast ikony „Enter”. Jako obejście tego problemu użytkownicy mogą korzystać z klawiatury telefonu, która aktywuje się, gdy pole wprowadzania jest aktywne.
• W wersji 6.5 aplikacji Android Auto wywołania zwrotne przesuwania i powiększania w funkcji SurfaceCallback mogą być nieprawidłowo wywoływane w przypadku niektórych gestów dotykowych.

Testowanie aplikacji samochodowej w wersji 1.0.0

Wersja 1.0.0-alpha01

24 marca 2021 r.

androidx.car.app:app-testing:1.0.0-alpha01 został zwolniony. Wersja 1.0.0-alfa01 zawiera te zatwierdzenia.

To pierwsza wersja Jetpacka z biblioteki testów o źródle zamkniętym. Aby dowiedzieć się, jak używać tej biblioteki w testach, zapoznaj się z naszą biblioteką przykładów.

Nowe funkcje

• Kontrolery klas modeli zostały usunięte. Moduły pobierania modeli są teraz częścią publicznej platformy interfejsu API, która umożliwia weryfikowanie wartości ustawionych w konstruktorach.
• Poprzednia wartość CarAppServiceController została zastąpiona nową wartością SessionController, aby umożliwić testowanie logiki związanej z czasem trwania połączenia z hots.

Wersja 1.0.0

Wersja 1.0.0

21 kwietnia 2021 r.

androidx.car.app:app:1.0.0 został zwolniony. Wersja 1.0.0 zawiera te zatwierdzenia.

Najważniejsze funkcje wersji 1.0.0

• Na początku kwietnia ogłosiliśmy, że aplikacje mogą być publikowane w wersji produkcyjnej za pomocą androidx.car.app:app:1.0.0-rc01. Biblioteka aplikacji samochodowych w wersji 1.0.0 jest teraz stabilna i w pełni zgodna z Androidem Auto w wersji 6.1 lub nowszej.
• Więcej informacji o tworzeniu aplikacji do nawigacji, parkowania i ładowania na Androidzie Auto za pomocą biblioteki znajdziesz w przewodniku dla programistów.

Poprawki błędów

• Naprawiono wyjątek, który występował, gdy podczas uruchamiania był wyskakiwany element Screen (70aae1, b/184664896).
• Rozwiązanie problemu polegającego na tym, że ON_DESTROY w Session jest obserwowany po ON_DESTROY ON_DESTROY (0ceecb, b/183696617)Screen

Wersja 1.0.0-rc01

24 marca 2021 r.

Usługa androidx.car.app:app:1.0.0-rc01 została zwolniona. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy błąd związany z warunkiem wyścigu, w którym funkcja NavigationManagerCallback#onStopNavigation była wywoływana po wyczyszczeniu funkcji wywołania zwrotnego. Wystąpiło to, gdy wywołanie zwrotne zostało usunięte, zanim wykonawca wywołania zwrotnego został faktycznie uruchomiony (I7fc5e, b/181143772).
• Rozwiązaliśmy problem, który wymagał, aby aplikacja jawnie wiązała się z zależnością od interfejsu lifecycle-common-java8 (I8b8c8)
• Rozwiązanie problemu z NullPointerException, który występował, gdy aplikacja otrzymywała wywołanie stopNavigation, mimo że wywołanie zwrotne zostało już usunięte (Ib8b89, b/181143772)
• Ulepszenia, które zapobiegają wysyłaniu wywołań do aplikacji, jeśli jej cykl życia nie jest co najmniej w stanie CREATED (I86965, b/179800224, b/177921120)
• Rozwiązaliśmy problem, który polegał na tym, że nieprawidłowy interfejs API określony w pliku manifestu aplikacji powodował błąd ANR w hoście. (Iffedd, b/174231592)

Wersja 1.0.0-beta01

24 lutego 2021 r.

androidx.car.app:app:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

To pierwsza wersja Jetpacka biblioteki z zamkniętym kodem źródłowym. Jest zgodna z Androidem Auto w wersji 6.1 lub nowszej. Szczegółowe informacje o tworzeniu aplikacji samochodowych przy użyciu biblioteki znajdziesz w przewodniku dla programistów.

Nowe funkcje

• Wprowadziliśmy GridTemplate, którego Twoja aplikacja może używać do wyświetlania listy elementów UI w układzie siatki.
• Wprowadziliśmy metodę CarAppService.createHostValidator, która pozwala sprawdzić, czy połączenie hosta pochodzi z zaufanego źródła (np. Androida Auto).
• Dodano interfejs API CarAppExtender.Builder.setColor. (b/174231592)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że po wyświetleniu kolejnych ekranów niewłaściwie wznawiana była praca Screen. (B/177590791)