Auto-App

Auto-App

Nutzerhandbuch  Codebeispiel  Codelab

API-Referenz
androidx.car.app
androidx.car.app.model
androidx.car.app.navigation
androidx.car.app.notification
androidx.car.app.serialization
androidx.car.app.validation
androidx.car.app.versioning

Entwickeln Sie Vorlagen-Apps für Android Auto und Android Automotive OS.

Letzte Aktualisierung	Stabile Version	Releasekandidat	Betarelease	Alpha-Release
19. November 2025	1.7.0	-	-	1.8.0-alpha03

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von der Car App Library hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:

Cool

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

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

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

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

Kotlin

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

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

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

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

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Lassen Sie es uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können für ein vorhandenes Problem stimmen, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.8

Version 1.8.0-alpha03

19. November 2025

androidx.car.app:app-*:1.8.0-alpha03 ist veröffentlicht. Version 1.8.0-alpha03 enthält diese Commits.

Neue Funktionen

• Mit „Bild in Zeilen“ sind jetzt neue Anwendungsfälle für Listen möglich.
• Fügen Sie SectionedItemTemplate#alphabeticalIndexingStrategy hinzu, um eine unterschiedliche alphabetische Indexierung für Listenbeschleuniger zu ermöglichen.

API-Änderungen

• endImageType für endImages in Rows hinzugefügt (I8865b)
• Fügen Sie SectionedItemTemplate#alphabeticalIndexingStrategy hinzu. Dies ist ein Ersatz für #isAlphabeticalIndexingAllowed und bietet Entwicklern mehr Optionen für die alphabetische Indexierung. (Ia164d, b/410092683)
• Unterstützung für ein Endbild für eine Zeile in einer Auto-App hinzugefügt. (If93f0)
• CarIcon MediaPlayback wurde hinzugefügt, um die Verwendung der Standardaktion MediaPlayback zu vereinfachen. (Ib6cb7)

Fehlerkorrekturen

• Verschieben des Standard-minSdk von API 21 zu API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)

Version 1.8.0-alpha02

18. Juni 2025

androidx.car.app:app-*:1.8.0-alpha02 ist veröffentlicht. Version 1.8.0-alpha02 enthält diese Commits.

Neue Funktionen

• Unterstützung für Action.MEDIA_PLAYBACK wurde hinzugefügt. Damit wird ein Hinweis basierend auf dem Status der Medienwiedergabe angezeigt.
• Es wurde Unterstützung für das Steuern der Scrollposition eines Nutzers beim Aktualisieren von SectionedItemTemplate hinzugefügt.

API-Änderungen

• Unterstützung für das Speichern der Scrollposition eines Nutzers in SectionedItemTemplate zwischen Aktualisierungen hinzugefügt. (Ia4c51)
• Die MEDIA_PLAYBACK-Aktion wurde aktualisiert, um sie für die Aktion zum Zeilenende zu aktivieren (I05cc4).
• Neuen Aktionstyp hinzufügen (I6cc5a)
• Fügen Sie CarAppExtender#addAction(Action) hinzu, damit dem CarAppExtender beliebige Aktionen hinzugefügt werden können. (Idc4d7)
• SectionedItemTemplate ist jetzt ab API 8 verfügbar. (I9a079)

Version 1.8.0-alpha01

20. Mai 2025

androidx.car.app:app-*:1.8.0-alpha01 ist veröffentlicht. Version 1.8.0-alpha01 enthält diese Commits.

Neue Funktionen

Alle Funktionen sind vorübergehend nur in Android Auto verfügbar. In AAOS werden dieselben APIs verwendet.

• Die Kategorie „Media“ wurde hinzugefügt, um benutzerdefinierte Anwendungen als Alternative zu MediaBrowse-basierten Anwendungen zu erstellen.
• Es wurde eine Wiedergabevorlage hinzugefügt, mit der die wichtigsten Aktionen in der Medienwiedergabeansicht gesteuert werden können (nur für Medien-Apps verfügbar).
• Vollständige Unterstützung für die Vorlage für Abschnittelemente in Android Auto hinzugefügt, die Kombinationen von Unterabschnitten aus Listen/Rastern ermöglicht.
• „Extragroß“ als zusätzliche Größe für Rasterelemente hinzugefügt.

API-Änderungen

• Zusätzliche Größenoption für Rasterelemente hinzufügen (I35b58)
• Kategorie und Berechtigung für Media-Apps in der Auto-App-Bibliothek hinzugefügt (I8e100)
• Es wurde eine neue API für Apps hinzugefügt, mit der erkannt werden kann, ob die Medienkategorie CarAppLibrary unterstützt wird (Ic4b08).
• OnItemVisibilityChangeListener wurde dem Abschnitt hinzugefügt. (I2c2fd)
• Mileage#getOdometerKilometers wurde hinzugefügt und Mileage#getOdometerMeters wird nicht mehr unterstützt. (Ic91af)

Fehlerkorrekturen

• Tippfehler in Javadoc von CarIcon.setTint korrigieren (Iabd72)
• Die Row.Builder#setNumericDecoration-Dokumentation wurde aktualisiert, um zu verdeutlichen, dass 1 Vorgang + numerische Dekoration nicht unterstützt werden, 0 oder 2 Vorgänge + numerische Dekoration jedoch schon. (Ic0b08)
• Für Rasterelemente wurde ein Feld für die Hintergrundfarbe des Logos hinzugefügt. (I2b6ae)

Version 1.7

Version 1.7.0

16. Juli 2025

androidx.car.app:app-*:1.7.0 ist veröffentlicht. Version 1.7.0 enthält diese Commits.

• Dies ist die erste stabile Version, die die in beta03 gepatchte Korrektur für CVE-2024-10382 enthält. Wenn Sie eine niedrigere Version als 1.7-beta03 verwenden, aktualisieren Sie bitte auf diese Version.

Version 1.7.0-rc01

15. Januar 2025

androidx.car.app:app-*:1.7.0-rc01 wurde ohne nennenswerte Änderungen gegenüber Beta 03 veröffentlicht. Version 1.7.0-rc01 enthält diese Commits.

• Dies ist der erste RC, der die Fehlerbehebung für CVE-2024-10382 enthält, die in Beta 03 gepatcht wurde. Wenn Sie eine niedrigere Version als 1.7-beta03 verwenden, aktualisieren Sie bitte auf diese Version.

Version 1.7.0-beta03

13. November 2024

Eine Sicherheitslücke wurde geschlossen und es wurden allgemeine Fehler behoben. Wenn Sie eine niedrigere Version verwenden, aktualisieren Sie bitte auf diese Version.

androidx.car.app:app-*:1.7.0-beta03 ist veröffentlicht. Version 1.7.0-beta03 enthält diese Commits.

API-Änderungen

• Aktualisieren Sie den Code für die CAL-Serialisierung/-Deserialisierung so, dass nur Objekte verarbeitet werden, für die die Annotation @CarProtocol deklariert ist. (Ic730e)
• CarAppExtender kann jetzt verwendet werden, um das Framework Notification.Builder anstelle von NotificationCompat.Builder zu erweitern. (Id3ad7)
• Fügen Sie KEY_EXCLUDE_MEDIA_ITEM_FROM_MIXED_APP_LIST hinzu. (I201f9)
• Der leere Builder-Konstruktor für ConversationItem wird eingestellt und durch einen Konstruktor ersetzt, der erforderliche Parameter akzeptiert. Außerdem wird eine Prüfung hinzugefügt, um Null-Nachrichten zu vermeiden. (Ic8221)

Fehlerkorrekturen

• Achten Sie darauf, dass für die PlaceList-Karte ein Header-Titel mit einem String (nur Text) verwendet wird. (Ic992f)
• In dieser Bibliothek werden jetzt JSpecify-Annotationen für Nullsicherheit verwendet, die typbezogen sind. Kotlin-Entwickler sollten das folgende Compiler-Argument verwenden, um die korrekte Verwendung zu erzwingen: -Xjspecify-annotations=strict (dies ist die Standardeinstellung ab Version 2.1.0 des Kotlin-Compilers). (Ib5367, b/326456246)

Version 1.7.0-beta02

18. September 2024

androidx.car.app:app-*:1.7.0-beta02 ist veröffentlicht. Version 1.7.0-beta02 enthält diese Commits.

API-Änderungen

• KEY_ROOT_HINT_MEDIA_HOST_VERSION zusätzlich hinzufügen (I8796b)
• Ersetzen Sie die Klasse TabContents.Api8Builder durch den Konstruktor @ExperimentalCarApi in der Klasse TabContents.Builder (I26fbe).
• Intent-Aktion und Extras für CarMediaApp hinzufügen (I50782)
• Messaging-APIs als nicht experimentell kennzeichnen (I0b070)
• Das Laden von Remote-Elementen wurde zu SectionedItemTemplate hinzugefügt. Dadurch können lange Listen geladen werden, ohne dass die App abstürzt. (I0d122)
• SectionedItemTemplate wurde in API 8 der Liste der unterstützten Vorlagen in TabTemplate hinzugefügt. (Idc5d6)

Fehlerkorrekturen

• Die manuelle Beschreibung des Zugriffs auf neue Plattform-APIs wurde entfernt, da dies automatisch über die API-Modellierung erfolgt, wenn R8 mit AGP 7.3 oder höher verwendet wird (z. B. R8-Version 3.3), und für alle Builds, wenn AGP 8.1 oder höher verwendet wird (z. B. D8-Version 8.1). Clients, die AGP nicht verwenden, wird empfohlen, auf D8-Version 8.1 oder höher zu aktualisieren. Weitere Details findest du in diesem Artikel. (I9496c, b/345472586)

Version 1.7.0-beta01

26. Juni 2024

androidx.car.app:app-*:1.7.0-beta01 ist veröffentlicht. Version 1.7.0-beta01 enthält diese Commits. Die Funktionen sind dieselben wie in Alpha01. Sie sind unten noch einmal aufgeführt:

Neue Funktionen

• Karte mit Inhalt:Diese neue Vorlage enthält einen Kartenbereich und eine Inhaltvorlage, die derzeit als Liste, Raster, Bereich oder Nachricht verwendet werden kann.
  • RoutePreview, PlaceListNavigation und MapTemplate sind jetzt veraltet. Vorlagen funktionieren weiterhin wie bisher.
  • Beispiel-Apps wurden aktualisiert, um die Verwendung von MapWithContent anstelle von eingestellten Vorlagen zu zeigen.
• Konversationselement:Neue APIs zum Anzeigen von Konversationen (IM, SMS) und zum Vorlesen von Assistant im Auto.
• Fahrzeugabmessungen:Neue API zum Abrufen von Fahrzeugabmessungen (derzeit nur für AAOS).

API-Änderungen

• Fügen Sie @ExperimentalCarApi-Tag zu MediaPlaybackTemplate.Builder hinzu. (Ic1957)
• Fügt eine neue SectionedItemTemplate in „Experimentell“ hinzu. (I5958a)
• Einführung von CarAppApiLevel 8 (I3fa22)
• Fügt MediaPlaybackTemplate hinzu, um Inhalte während der Medienwiedergabe in der Car App Library anzuzeigen. (I3c10d)
• Eine neue API wurde hinzugefügt, mit der Apps erkennen können, ob das System Hintergrundaudio während der Fahrt unterstützt (I0f868).

Fehlerkorrekturen

• Behebt bestimmte Fälle von Speicherlecks und Abstürzen im CAL-Clientcode und in der CAL Navigation Sample App. (I55e04)
• Ersetzen Sie requireNotNull instances in der Methode onDestroy von BaseCarAppActivity durch if-null-Prüfungen, um Abstürze zu vermeiden. (Iec676)

Version 1.7.0-alpha02

17. April 2024

androidx.car.app:app-*:1.7.0-alpha02 ist veröffentlicht. Version 1.7.0-alpha02 enthält diese Commits.

Neue Funktionen

• Es wurden eingestellte Flags für kartenbasierte Vorlagen hinzugefügt, die in Zukunft von der MapWithContent-Vorlage unterstützt werden.

API-Änderungen

• Alte MapTemplate-, RoutePreviewNavigationTemplate- und PlaceListNavigationTemplate-Funktionen einstellen und die Verwendung der neuen MapWithContentTemplate fördern (Ib0a08)

Version 1.7.0-alpha01

3. April 2024

androidx.car.app:app-*:1.7.0-alpha01 ist veröffentlicht. Wir haben unser Versionsschema für Bibliotheken an die aktive CarApi-Version angepasst. So soll die Verwirrung über das Namensschema aufgrund von Entwicklerfeedback verringert werden. Daher überspringen wir die Versionen 1.5 und 1.6 und gehen direkt zu Version 1.7 über. Version 1.7.0-alpha01 enthält diese Commits.

Neue Funktionen

• Karte mit Inhalt: Die neue Vorlage MapWithContent unterstützt Liste / Raster / Bereich / Nachricht als Inhalt in einer Karte.
  • RoutePreview- und PlaceListNavigation-Kartenvorlagen werden nicht mehr unterstützt.
  • Beispiel-Apps wurden aktualisiert, um die Funktionen eingestellter Vorlagen mit MapWithContent zu demonstrieren.
• Conversation Item: Neue APIs zum Anzeigen von Unterhaltungen (IM, SMS) und zum Vorlesen von Assistant-Informationen im Auto.
• Fahrzeugabmessungen: Neue API zum Abrufen von Fahrzeugabmessungen (derzeit nur für AAOS).

API-Änderungen

• Markierung des Bildtyps „Extrakleine Zeile“ als experimentell (I5184b)
• Die CarInfo#fetchExteriorDimensions API wurde hinzugefügt, die den Zugriff auf Informationen zu den Außenabmessungen des Fahrzeugs wie Höhe, Breite usw. ermöglicht (Ia40c5).
• Tag „ExperimentalAPI“ aus MapWithContentTemplate entfernt (I66db8)
• Aktualisieren Sie den Parameter GridItem#setTitle, sodass er Nullwerte zulässt. (I3d610)
• Für die GetHeader API ist kein API 7 erforderlich, da sie abwärtskompatibel ist (I8c812).
• Unterstützung für Header in ListTemplate hinzufügen, headerAction, headerTitle, actionStrip einstellen (I7ae01)
• title, headerAction und actionStrip in GridTemplate einstellen und Unterstützung für Header hinzufügen (I41a9c)
• Anforderung für Stufe 7 für experimentelle APIs entfernt: Getter/Setter für Badge, GridTemplate-Elementgröße und Bildform sowie GridItem-Methoden zum Abrufen/Festlegen von Badge. (Id71eb)
• title, headerAction und actionStrip in PaneTemplate einstellen, neue Header-Unterstützung hinzufügen (I23154)
• Die Media Center-Telemetrie wurde von BroadcastReceiver in „Browse Custom Action“ geändert. (I4185f)
• Unterstützung für das Attribut Header in MessageTemplate hinzugefügt. Die Unterstützung für ActionStrip, headerAction und title wurde eingestellt. (Ie2de8)
• Sichtbarkeit von Benachrichtigungskonstanten ändern (Icf8a8)
• Entfernen Sie das Attribut isLoading aus der übergeordneten Vorlage (I651e6).
• Extras hinzufügen, um Media-Apps über die wichtigsten UI-Parameter zu informieren (I85ca2)
• Funktion für Media Center-Analysen zu MediaExtensions hinzufügen (I7ce28)
• Es wurde eine Option für ein sehr kleines Bild in Zeilen hinzugefügt. (I72c03)

Fehlerkorrekturen

• Aktualisiere die Javadoc-Dokumentation für ConversationItem, um anzugeben, dass Nachrichten vom ältesten zum neuesten sortiert werden sollen. (I77a2a)
• Aktualisiere die Kürzungslogik für ListTemplate, um die ältesten Nachrichten aus ConversationItem zu entfernen (Ie0a61)

Version 1.4

Version 1.4.0

29. Mai 2024

androidx.car.app:app-*:1.4.0 ist veröffentlicht. Version 1.4.0 ist eine Promotion von Version 1.4.0-rc02.

Wichtige Änderungen seit Version 1.3.0

• Karten-Rendering für Kombi-Instrumente für Navigations-Apps
• Neue Tab-Vorlage für ein besseres App-Layout / eine bessere App-Nutzerfreundlichkeit
• Unterstützung für adaptive Aufgabenlimits
• Sekundäre Aktionen für Listenelemente

Version 1.4.0-rc02

13. Dezember 2023

androidx.car.app:app-*:1.4.0-rc02 ist veröffentlicht. Version 1.4.0-rc02 enthält diese Commits.. Nur kleinere Korrekturen

Fehlerkorrekturen

• Aktualisiere die Javadoc-Dokumentation für ConversationItem, um anzugeben, dass Nachrichten in der Reihenfolge vom ältesten zum neuesten sortiert werden sollen (I77a2a).
• Aktualisiere die Kürzungslogik für ListTemplate, um die ältesten Nachrichten aus ConversationItem zu entfernen (Ie0a61)

Version 1.4.0-rc01

1. November 2023

androidx.car.app:app-*:1.4.0-rc01 wird ohne nennenswerte Änderungen veröffentlicht. Version 1.4.0-rc01 enthält diese Commits.

Version 1.4.0-beta02

20. September 2023

androidx.car.app:app-*:1.4.0-beta02 ist veröffentlicht. Version 1.4.0-beta02 enthält diese Commits. Diese Version ist fast identisch mit Beta 01, senkt aber die compileSdk-Anforderung auf 33.

Fehlerkorrekturen

• Ein Fehler wurde behoben, durch den Ladebildschirme auf Tabs nicht richtig angezeigt wurden. (cae860)

Version 1.4.0-beta01

9. August 2023

androidx.car.app:app-*:1.4.0-beta01 ist veröffentlicht. Version 1.4.0-beta01 enthält diese Commits..

Hinweis:Für 1.4-beta01 ist compileSdk34 erforderlich, das sich noch in der Entwicklungsphase befindet. Dieses Problem wird in Version 1.4-beta02 behoben. Alternativ können Sie android.suppressUnsupportedCompileSdk=34 in die settings.gradle-Datei Ihres Projekts einfügen, um die Warnung vorübergehend zu unterdrücken.

Neue Funktionen

• Kartenrendering für das Kombi-Instrument für Navigations-Apps
• Neue Tab-Vorlage für ein besseres App-Layout und eine bessere Nutzerfreundlichkeit
• Unterstützung für adaptive Aufgabenlimits
• Sekundäre Aktionen für Listenelemente

API-Änderungen

• Siehe alpha02

Version 1.4.0-alpha02

26. Juli 2023

androidx.car.app:app-*:1.4.0-alpha02 ist veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.

• Die Veröffentlichung von Alpha02 soll eine Vorbereitung auf die bevorstehende Veröffentlichung von Beta01 sein.

Neue Funktionen

• Kartenrendering auf dem Kombiinstrument für Navigations-Apps
• Tabs für Apps hinzugefügt, um das Layout zu verbessern
• Optionen zum Rendern von Listen- und Rastervorlagen hinzugefügt
• Neue Kategorien für Wetter und Kommunikation hinzugefügt
• Mehrere APIs in die nächste CarApi 7-Version verschieben

API-Änderungen

• Multimedia-Felder zu CarMessage hinzufügen (I5aaf6)
• Benutzerdefinierte Aktionen für ConversationItem in der Car App Library hinzufügen (Ie5ed6)
• Füge Extras hinzu, um anzugeben, dass ein Media-Element in einem immersiven Audioformat wiedergegeben wird, und um das Logo des Inhaltsformats (Icb5bb) zu präsentieren.
• Es wurde ein neuer Aktionstyp, die ActionsConstraints API, hinzugefügt, um die Schaltfläche „Verfassen“ zu unterstützen. (I31661)
• set/getTemplate als set/get ContentTemplate erstellt (Ica036)
• Der Vorlagenparameter wäre jetzt @NonNull. Aktualisierte MapWithContentTemplate API-Dokumentation (I0f8ed)
• Entfernt das @ExperimentalCarApi-Tag für Aktionen in ListTemplate für den Start in CAL 1.4 (I2cfcb)
• Entfernt das @ExperimentalCarApi-Tag für TabTemplate (Ifcb82)
• Entfernen Sie die @ExperimentalCarApi-Annotationen aus den sekundären Aktionen und Dekorationen der Zeile (I8487e).
• Fügt die ID des aktiven Tabinhalts zu TabTemplate hinzu und stellt den aktiven Status auf Tabs ein (I96932)
• ItemImageShape-Property zu GridTemplate hinzufügen (Ibf431)
• Fügen Sie GridTemplate die Eigenschaft ItemSize hinzu, mit der die Größe von Rasterelementen anhand von relativen kleinen, mittleren und großen Buckets gesteuert wird. (Icdb3b)
• Öffnen Sie den API-Zugriff für Entwickler, damit sie eine Kopie des aktuellen Screen-Stacks erhalten. (I48107)
• Kategorie für Wetter-Apps in der Auto-App-Bibliothek hinzugefügt (I2be44)
• Kategorie für Anruf-Apps wird der Car App Library hinzugefügt (Icab33)
• GridItem.Builder#setBadge() durch überlastete setImage()-Methoden ersetzt (Id2000)
• Eigenschaft „Symbol“ für Badge hinzufügen (I629b2)
• Methode zum Festlegen der Hintergrundfarbe des Punkt-Badges hinzugefügt (I6411c)
• Fügen Sie GridItem das Attribut „Badge“ hinzu, damit ein Badge über einem GridItem-Bild angezeigt werden kann. (I95de7)
• Es wurde ein experimentelles Badge-Objekt hinzugefügt, das ein Badge darstellt, das über einem Bild angezeigt werden soll. (I9878d)

Version 1.4.0-alpha01

22. Februar 2023

androidx.car.app:app-*:1.4.0-alpha01 ist veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.

API-Änderungen

• Fügt GridTemplate Aktionen der obersten Ebene in der Car App Library hinzu (Id0191)
• Fügt Aktionen der obersten Ebene zu ListTemplate in der Car App Library hinzu (I9efab)
• Extras hinzufügen, um den Untertitel oder die Beschreibung eines Medienelements mit anderen Medienelementen zu verknüpfen (Ic84bf)
• Aktualisieren Sie die API-Ebene für Zeilenaktionen auf Ebene 6. (Ie0a69)
• Messaging-Callbacks zu A4C hinzufügen (Ie3986)

Fehlerkorrekturen

• Es wurden fehlende Java-Dokumentverweise für CarMessage hinzugefügt. (I5db1c)
• equals() und hashCode() für ConversationItem und CarMessage überschreiben (I6fd10)
• ConversationItem.mMessages-Validierung verbessern (nicht null, nicht leer (Iafc51) erforderlich)
• @Keep-Annotationen zu ConversationItem-Feldern hinzufügen (I5d250)
• Java-Dokumente für die Zeilengestaltung und sekundäre Aktionen wurden aktualisiert. (I000b6)

Version 1.3

Version 1.3.0-rc01

7. Dezember 2022

androidx.car.app:app-*:1.3.0-rc01 ist veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.

• Kleinere Fehlerkorrekturen aus Beta 01. Keine wesentlichen Änderungen.

Version 1.3.0-beta01

7. September 2022

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 und androidx.car.app:app-testing:1.3.0-beta01 wurden veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.

• Mit dieser Bibliothek entwickelte Auto-Apps können jetzt mit API-Level 5 im Play Store veröffentlicht werden (siehe Entwicklerleitfaden). Funktionen, die mit API-Level 5 und niedriger gekennzeichnet sind, sind sowohl mit Android Auto 8.1+ als auch mit Google Automotive App Host 1.4+ kompatibel.

Neue Funktionen

Zusätzlich zu den Funktionen, die in der Car App Library 1.3.0-alpha01 hinzugefügt wurden, wurden im Rahmen von beta01 die folgenden Funktionen hinzugefügt. Alle Funktionen hier beziehen sich nur auf Änderungen auf Hostseite ohne API-Änderungen:

• Die schwebende Navigationsleiste wird weiterhin angezeigt, auch wenn sich ein Nutzer in PlaceListNavigationTemplate, RoutePreviewNavigationTemplate und MapTemplate auf einem kartenbasierten Auswahlbildschirm befindet. Dazu müssen Sie die Navigationsinformationen über NavigationManager.updateTrip() aktualisieren.
• Aktivieren Sie die Aktionsschaltfläche mit FLAG_DEFAULT, um eine Timeout-Animation zu verwenden. Nach dem Zeitlimit wird standardmäßig auf diese Schaltfläche geklickt. ([API 5 - All Templates])
• Der Untertitel eines Rows wird nicht abgeschnitten, wenn das Auto geparkt ist, aber auf zwei Zeilen gekürzt, wenn das Auto fährt. ([API 5 - All Templates])
• Unterstützung für den deaktivierten Status für Action, Toggle, Row ([API 5 - All Templates])

API-Änderungen

• Einschränkungen in der Liste MapTemplate lockern, um auswählbare Listen zu unterstützen (I961ed)
• Entfernen Sie die Einschränkung für Header-Aktionen, um benutzerdefinierte Symbole zu ermöglichen. (Iad28f)
• Fügen Sie ActionsConstraints die Einschränkung setOnClickListenerAllowed() hinzu. Where it allowed Action to set OnClickDelegate() to actions except the standard icon types. (TYPE_APP_ICON, TYPE_BACK und TYPE_PAN) (I3c745)

Fehlerkorrekturen

• Kompatibilität von Android Automotive Template Host 1.4+ mit gekrümmten Displays ([Host change]) hinzugefügt

Version 1.3.0-alpha01

27. Juli 2022

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 und androidx.car.app:app-testing:1.3.0-alpha01 wurden veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.

Funktionen, die mit API-Ebene 5 gekennzeichnet sind, sind mit Android Auto 7.9 und höher kompatibel.

Neue Funktionen

• API-Level 5: Neue MapTemplate, die von Navigations-Apps verwendet werden können, um Bereichs- oder Listeninhalte neben einer Karte anzuzeigen (If5826, If44b8)
• API-Level 5: Neue CarAudioRecord API zum Aufzeichnen von Audioeingaben über das Mikrofon des Hostfahrzeugs (I5e71a)
• API-Level 5: Neue SuggestionManager-API, mit der Apps Vorschläge für den Host bereitstellen können (I5c103)
• API-Level 5: Neue Alert API zum Anzeigen von Kontextbenachrichtigungen auf dem NavigationTemplate (I163a7, I5ad70)
• API-Level 5: Neue Header- und MapController-Komponenten zur Erleichterung der Wiederverwendung in Vorlagen (If5826)
• androidx.car.app.category.POI als Kategorie zum Aktivieren von POI-Apps hinzugefügt (androidx.car.app.category.PARKING und androidx.car.app.category.CHARGING wurden eingestellt) (I59da1)

API-Änderungen

• API-Level 5: Neue onClick-Methode in der SurfaceCallback-Schnittstelle für die Interaktion durch Tippen auf die Karte (Ia9777)
• API-Level 5: Neue Flags Action.FLAG_IS_PERSISTENT und Action.FLAG_DEFAULT zur Beschreibung von Actions (I96318, I5ad70)
• API‑Level 5: Neuer aktivierter/deaktivierter Status für die Komponenten Action, Row und Toggle (Hostunterstützung ab Version 1.3.0-beta01 der Bibliothek) (Id8a09)
• API-Ebene 5: Die neue Header-Komponente wird über setHeader auf PlaceListNavigationTemplate.Builder und RoutePreviewNavigationTemplate.Builder bevorzugt. Die vorhandenen Methoden setTitle und setHeaderAction werden eingestellt (I30e6a).
• API-Level 5: Neue setOnContentRefreshListner-Methode für PlaceListMapTemplate.Builder und PlaceListNavigationTemplate.Builder zur Verwendung mit Implementierungen der neuen OnContentRefreshListner-Schnittstelle.
• API-Ebene 5: Neue setTripText und setTripIcon auf der TravelEstimate.Builder zum Anpassen der Karte mit der geschätzten Reisezeit (Idcc6d, Ic620d)
• Unterstützung für CarIconSpan im Titel von PaneTemplate hinzufügen (Ia1ee0)
• Unterstützung für CarIconSpan im Titel und Text von Row hinzufügen (Ic1e3c)
• Karten ActionStrip können jetzt bis zu vier Aktionen haben (If3522)
• Car App API-Level auf 5 aktualisieren (I26b8e)
• Header/Titel sind jetzt für die folgenden Felder optional: PlaceListMapTemplate, PlaceListNavigationTemplate, RoutePreviewNavigationTemplate, GridTemplate, ListTemplate, LongMessageTemplate, MessageTemplate, PaneTemplate und SignInTemplate (I2078d, Icadde)

Fehlerkorrekturen

• Die Regeln für die Bildgröße für PaneTemplate wurden aktualisiert und verwenden jetzt einen quadratischen Begrenzungsrahmen (Idd72e).
• Eine Ausnahme wurde behoben, die auftritt, wenn der Bildschirmstapel nach State.DESTROYED geändert wird. (I3c8eb)
• Es wurde eine Nullprüfung für das Abrufen des App-Symbols hinzugefügt (I3f710).
• Car Hardware API so aktualisieren, dass standardmäßig STATUS_UNKNOWN anstelle von STATUS_UNAVAILABLE verwendet wird (Ic9444)
• Prüfen, ob ein Display vorhanden ist, bevor eine Oberfläche erstellt wird (Ice027a)
• Behebe den CarValue.equals()-Fehler im Zusammenhang mit STATUS_UNIMPLEMENTED (I24451)

Version 1.2

Version 1.2.0

9. November 2022

androidx.car.app:app-*:1.2.0 ist veröffentlicht. Version 1.2.0 enthält diese Commits.

• Dies ist eine Stabilisierungsversion. Es gibt keine Änderungen im Vergleich zu v1.2.0-rc01.

Version 1.2.0-rc01

23. März 2022

androidx.car.app:app-*:1.2.0-rc01 ist veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.

• Dies ist ein Stabilisierungsrelease. Im Vergleich zu v1.2.0-beta02 gibt es keine API-Änderungen. Es wurden neue experimentelle Funktionen (API‑Level 5) hinzugefügt, die für zukünftige Android Auto- und Android Automotive-Versionen vorgesehen sind.

Fehlerkorrekturen

• Eine Ausnahme wurde behoben, die auftritt, wenn der Bildschirmstapel nach State.DESTROYED geändert wird. (I3c8eb)
• Die CarSensors-API wurde aktualisiert, um anzugeben, dass sie nicht für AAOS implementiert ist (Idd57b).
• PlaceListMapTempalte.Builder#setCurrentLocationEnabled wurde aktualisiert, um darauf hinzuweisen, dass ACCESS_COARSE_LOCATION für die Funktion ausreicht (I510c2).
• Die Ausfahrtsnummer ist jetzt optional für Manövertypen vom Typ „Kreisverkehr mit Winkel“ (Ife7d1).

Version 1.2.0-beta02

26. Januar 2022

androidx.car.app:app-*:1.2.0-beta02 ist veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.

Mit dieser Bibliotheksversion erstellte Auto-Apps, die auf die Android Automotive OS-Plattform ausgerichtet sind, können jetzt im Play Store im offenen Testkanal veröffentlicht werden. Weitere Informationen finden Sie im Entwicklerleitfaden.

Funktionen, die mit API-Level 4 und niedriger gekennzeichnet sind, sind sowohl mit Android Auto 7.2+ als auch mit der neuen Android Automotive OS-Plattform kompatibel. Einschränkungen finden Sie im Abschnitt Known Issues unten.

API-Änderungen

• Die experimentelle setOnContentRefreshListener API wurde zu POI-Vorlagen hinzugefügt (I6bf22).

Fehlerkorrekturen

• Ein Speicherleck in CarAppService wurde behoben, das auftrat, wenn die Bindung des Car-Hosts aufgehoben wurde. (I5c9ca, b/203594731)
• Die Javadocs für CarAppActivity wurden aktualisiert, um Anforderungen für den Launchmode „singleTask“ aufzunehmen (Id2f95).
• Reduziert den visuellen Fehler beim Fortsetzen. (Iff7e0)

Bekannte Probleme

• Die Karten ActionStrip in PlaceListNavigationTemplate und RoutePreviewNavigateTemplate werden in den nächsten Versionen von Android Auto und Android Automotive OS verfügbar sein.

Version 1.2.0-alpha02

15. Dezember 2021

androidx.car.app:app-*:1.2.0-alpha02 ist veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.

Funktionen, die mit API-Level 4 gekennzeichnet sind, wurden von experimentell auf stabil umgestellt. Dazu gehören die Karten-ActionStrip in PlaceListNavigationTemplate und RoutePreviewNavigateTemplate, das CarIcon-Bild in Pane, QRCodeSignInMethod und die Möglichkeit, Rendering-Hinweise (z. B. Flags) in Action festzulegen.

Neue Funktionen

• In Android Auto 7.1 und höher wurde das Elementlimit für Pane von 2 auf 4 erhöht.

API-Änderungen

• Der Klasse CarUnit wurde eine experimentelle toString()-Methode hinzugefügt. (I36a3b)

Fehlerkorrekturen

• Ein Absturz in CarAppPermissionActivity wurde behoben, der auftrat, wenn der Callback nicht mehr aktiv war (If9823).
• Das Standardlimit für die Liste Pane wurde auf 4 geändert (I0068b)

Version 1.2.0-alpha01

3. November 2021

androidx.car.app:app-*:1.2.0-alpha01 ist veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.

Alle neuen v1.2.0-Funktionen (API 4+) sind derzeit experimentell und zielen auf zukünftige Android Auto- und Android Automotive OS-Releases ab. Weitere Informationen finden Sie im Entwicklerleitfaden.

API-Änderungen

• Die AutomotiveCarInfo-API ist jetzt experimentell. (Ia13e5)
• Car App Library API-Level 4 hinzugefügt (I2a2e7)
• API-Level 4: Unterstützung für das Festlegen von CarIcon in Pane wurde hinzugefügt (Ifcc12).
• API-Level 4: Die Anmeldung per QR‑Code wurde hinzugefügt (Ib623e).
• API-Level 4: set/getFlags wurde zu Action hinzugefügt (Ic03ab)
• API-Level 4: Unterstützung für Schwenken und Zoomen in PlaceListNavigationTemplate und RoutePreviewNavigationTemplate hinzugefügt (I9d8a3)

Fehlerkorrekturen

• API-Level 4: Mechanismus hinzufügen, damit Apps Standortupdates an den Car Host senden können (I3bad3)
• Ein Problem wurde behoben, bei dem die Hostvalidierungslogik die Berechtigung TEMPLATE_RENDERER nicht richtig gefunden hat (I62618).

Version 1.1.0

Version 1.1.0

15. Dezember 2021

androidx.car.app:app-*:1.1.0 ist veröffentlicht. Version 1.1.0 enthält diese Commits.

Dies ist eine Stabilisierungsversion. Es gibt keine Änderungen im Vergleich zu v1.1.0-rc01. Weitere Informationen zu neuen Funktionen für die Car App Library finden Sie in den Versionshinweisen für v1.2.0-alpha02.

Wichtige Änderungen seit Version 1.0.0

• API-Ebene 2: SignInTemplate und LongMessageTemplate, die für Anmeldevorgänge verwendet werden können, wenn das Fahrzeug geparkt ist
• API-Level 2: Unterstützung für Karteninteraktivität innerhalb von NavigationTemplate
• API-Level 2: Unterstützung von Texten unterschiedlicher Länge, damit Apps je nach Größe des Autodisplays mehrere Versionen von Strings für die Anzeige bereitstellen können.
• API-Ebene 3: CarHardwareManager, mit der Hardware-Daten des Fahrzeugs wie Modell und Marke, Tankfüllstände und andere Sensoren abgefragt werden können.

Version 1.1.0-rc01

3. November 2021

androidx.car.app:app-*:1.1.0-rc01 ist veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Dies ist ein Stabilisierungsrelease. Im Vergleich zu v1.1.0-beta01 gibt es keine API-Änderungen. Es wurden neue experimentelle Funktionen (API-Level 4) hinzugefügt, die für zukünftige Android Auto-Releases vorgesehen sind. Weitere Informationen zu den experimentellen APIs finden Sie in den Versionshinweisen für v1.2.0-alpha01.

Version 1.1.0-beta01

1. September 2021

androidx.car.app:app-*:1.1.0-beta01 ist veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

Alle v1.1.0-Funktionen (API 2+) sind vollständig mit Android Auto 6.7 und höher kompatibel. Weitere Informationen finden Sie im Entwicklerleitfaden.

API-Änderungen

• Manager wurde als öffentliche Schnittstelle entfernt (Ie381b)
• Es wurde die Möglichkeit hinzugefügt, einen benutzerdefinierten Hintergrund mit Branding für Berechtigungsanfragen festzulegen (I74b76).
• ScreenManager.getStackSize wurde hinzugefügt. (I0b16a)
• Der ScreenController-Konstruktor, der TestCarContext (Iefebc) explizit verwendet, wurde entfernt.

Fehlerkorrekturen

• Beim Erstellen von CarHardwareManager wurde eine API-Level-Prüfung hinzugefügt (I48f9b).
• Es wurden Prüfungen auf ungültige CarSpan-Nutzung in der gesamten API hinzugefügt (I65ae6).
• Ein Problem wurde behoben, bei dem der Stack in einem fehlerhaften Zustand (I81b13) verblieb, wenn ein Screen während der Erstellung als abgeschlossen markiert wurde.
• Ein Problem wurde behoben, bei dem CarNotificationManager.notify einen Fehler für AutomotiveOS protokolliert hat, wenn in der CarAppExtender Aktionen mit Symbolen vorhanden waren (I3633d).
• Es wurde eine Handshake-Methode für die App und den Host hinzugefügt, um eine API-Version festzulegen (I7d6f8).

Version 1.1.0-alpha02

21. Juli 2021

androidx.car.app:app-*:1.1.0-alpha02 ist veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.

Neue Funktionen

• API-Level 3: Es wurde ein CarHardwareManager hinzugefügt, mit dem Hardware-Daten des Fahrzeugs wie Modell und Marke, Tankfüllstände und andere Sensoren abgefragt werden können. Derzeit ist diese Funktion nur für Android Auto 6.7 und höher im Open-Testing-Kanal verfügbar. Wenn Sie dies in einer Desktopumgebung testen möchten, benötigen Sie eine neue Version von Desktop Head Unit, die separat veröffentlicht wird. Auf der Seite Android-Apps für Autos testen finden Sie Informationen dazu, wann die neue Version verfügbar ist.
• Weitere Informationen und Designrichtlinien zur Verwendung dieser Funktionen in Auto-Hosts, die mit API-Level 3 kompatibel sind, finden Sie im Entwicklerleitfaden und in der Bibliotheksreferenz.

API-Änderungen

• Die Lebenszyklusmethoden SessionController und ScreenController wurden in einer einzigen moveToState-Methode zusammengefasst (I1ed00).
• CarContext#getHostInfo() hinzugefügt (I8977e)
• Nicht mehr weitergeführte Felder wurden entfernt. (I67168)
• SessionController und ScreenController wurden aktualisiert, um Konstruktoren direkt verfügbar zu machen (Iabf22).
• PinSignInMethod.Builder und ProviderSignInMethod.Builder entfernt (I9f0cb)
• „setCarAppResult()“ wurde hinzugefügt, um die Verwendung von Vorlagen-Apps „for result“ in AAOS zu ermöglichen (I37741).
• CarHardware-Schnittstellen mit Anmerkungen mit @MainThread. (Ib2f85)
• OnCarDataListener wurde in OnCarDataAvailableListener umbenannt (I518ca)
• Die Methodennamen und Javadocs für CarInfo, Speed und Mileage wurden aktualisiert. (I86672)
• Toll wurde in TollCard umbenannt. (I3e7c8)
• Die verworfene PinSignInMethod.getPin wurde entfernt und durch PinSignInMethod.getPinCode ersetzt (I996ce).
• OnInputCompletedListener wurde entfernt und durch InputCallback ersetzt. (Ib5be1)
• PinSignInMethod wurde geändert, sodass CharSequence anstelle von String verwendet wird (I275d5)

Fehlerkorrekturen

• Javadoc-Korrekturen für Autohardware. (I2abbc)

Externer Beitrag

Bekannte Probleme

• In der SignInTemplate kann die Verwendung von InputSignInMethod zu einem NullPointerException im Car-Host führen. Dieses Problem wird in der nächsten Version der Bibliothek behoben. Um das Problem zu umgehen, fügen Sie der ProGuard-Konfiguration Ihrer App die folgende Zeile hinzu: -keep class androidx.car.app.model.signin.InputSignInMethod { *; }

Version 1.1.0-alpha01

16. Juni 2021

androidx.car.app:app:1.1.0-alpha01, androidx.car.app:app-automotive:1.1.0-alpha01 und androidx.car.app:app-testing:1.1.0-alpha01 sind veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

Neue Funktionen

• API-Level 2: Neue SignInTemplate- und LongMessageTemplate-Ressourcen, die für Anmeldevorgänge verwendet werden können, wenn das Fahrzeug geparkt ist.
• API-Level 2: Unterstützung für neue Karteninteraktivität innerhalb des NavigationTemplate
• API-Level 2: Unterstützung von Text mit mehreren Längen, damit Apps je nach Größe des Autodisplays mehrere Versionen von Strings für die Anzeige bereitstellen können.
• Weitere Informationen und Designrichtlinien zur Verwendung dieser Funktionen in mit API-Level 2 kompatiblen Car-Hosts finden Sie im Entwicklerleitfaden und in der Bibliotheks-Javadoc.

API-Änderungen

• Alle *Callback-Schnittstellenmethoden wurden auf „default“ gesetzt und OnRequestPermissionsCallback wurde in OnRequestPermissionsListener umbenannt (Ib3ec9).
• Die androidx.car.app.hardware-Klassen wurden aktualisiert, um unnötige Builder- und Parameterklassen zu entfernen. (I67beb)
• Es wurden androidx.car.app.hardware-Klassen für den Zugriff auf fahrzeugspezifische Daten wie Kraftstoff, Akku und Geschwindigkeit hinzugefügt. (Iff3c9)
• Unterstützung für ActionStrip auf MessageTemplate hinzugefügt (Ida657)
• setLoading wurde zu MessageTemplate hinzugefügt. (I2a4b5)
• ConnectionToCar wurde in CarConnection umbenannt (Ife9bd)
• NavigationTemplate wurde geändert, sodass ein expliziter PanModeDelegate zurückgegeben wird. (I13877)
• Aktualisierte Parameterreihenfolge für CarContext.requestPermissions (Ib890a)
• Der Metadatenschlüssel zum Definieren des minimalen API-Levels für Autos wurde auf androidx.car.api.minCarApiLevel aktualisiert (Ib0d41).
• Es wurde eine API erstellt, mit der der Verbindungsstatus des Autos beobachtet werden kann (Ifc935).
• Unterstützung für das Festlegen eines Schalters für ein Action hinzugefügt und den Schwenkmodus Action-Typ hinzugefügt (Ica6af)
• CarNotificationManager wurde erstellt, um das Senden von Benachrichtigungen im Auto zu unterstützen (I10d7a)
• ConstraintManager hinzugefügt, um Listenlimits vom Host bereitzustellen (I8690e)
• Die API für den Schwenkmodus und den Kartenaktionsstreifen wurde in NavigationTemplate hinzugefügt (I77aa6).
• Die API zum Schwenken und Zoomen wurde in SurfaceCallback für Navigations-Apps hinzugefügt (Id5e9d).
• CarAppApiLevel auf 2 aktualisiert (Ic1540)
• Es wurde die Möglichkeit hinzugefügt, Berechtigungen von einem CarAppService anzufordern (I5421e).
• Der Multi-Text-API wurde die Annotation RequiresCarApi(2) hinzugefügt. (Iacb62)
• Mehrere Textvarianten im Titel der Halblistenvorlage (Ib8df7) zulässig
• Neue LongMessageTemplate hinzugefügt (erfordert Car API-Level 2) (Ic5cee)

Fehlerkorrekturen

• Aktualisierte Anforderungen an die Bildgröße für größere Autodisplays (I116dc)
• Es war nicht möglich, mehr als zwei Aktionen in Vorlagentexten hinzuzufügen (I32157)
• Achten Sie darauf, dass beim Erstellen aller PendingIntents in der Car App Library Flags gesetzt werden. (If84fe, b/186394900)
• Javadoc wurde aktualisiert, um Textänderungen von Row als Aktualisierungen zuzulassen (If3f9c)
• androidx.activity:activity:1.2.0 ist jetzt eine API-Abhängigkeit (Id1cb9)
• SignInTemplate und LongMessageTemplate erfordern jetzt Aktionen, die nur im geparkten Zustand ausgeführt werden können. Die Dokumentation wurde aktualisiert, um darauf hinzuweisen, dass sie nur angezeigt werden, wenn das Auto geparkt ist (Iddaa9).
• Es wurde eine Ausnahme behoben, die beim Einblenden eines Screen beim Start auftritt (Ifcf40, b/184664896).
• Zulässige benutzerdefinierte Textfarbe in ForegroundCarColorSpan (I69e59)
• Ein Problem wurde behoben, bei dem ON_DESTROY auf einem Session nach dem ON_DESTROY eines Screen (I52e01, b/183696617) beobachtet wurde.
• Die Javadoc-Dokumentation wurde aktualisiert und enthält nun Informationen dazu, wann die verbleibende Zeit eines TravelEstimate auf eine unbekannte Zeit gesetzt werden darf. (I99610, b/183632456)
• Action wurde aktualisiert, um ForegroundColorSpan im Titel und eine beliebige benutzerdefinierte Hintergrundfarbe (I578e4) zu unterstützen.
• NavigationManagerCallback#onStopNavigation darf nicht ausgeführt werden, wenn der Callback gelöscht wird, bevor er ausgeführt wird (I7fc5e, b/181143772).
• Ein Problem wurde behoben, bei dem die App explizit eine Abhängigkeit von lifecycle-common-java8 (I8b8c8) aufweisen musste.

Bekannte Probleme

• In der SignInTemplate wird auf der Bildschirmtastatur ein „Suchen“-Symbol anstelle eines „Eingabe“-Symbols angezeigt, wenn der Nutzer die Eingabe bestätigen möchte. Als Workaround können Nutzer auf die Smartphone-Tastatur zugreifen, die aktiviert wird, wenn das Eingabefeld fokussiert ist.
• In Android Auto 6.5 werden die Pan- und Zoom-Callbacks in SurfaceCallback möglicherweise für einige Touch-Gesten fälschlicherweise aufgerufen.

Car App Testing Version 1.0.0

Version 1.0.0-alpha01

24. März 2021

androidx.car.app:app-testing:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Dies ist die erste Jetpack-Version der zuvor proprietären Testbibliothek. Beispiele für die Verwendung dieser Bibliothek in Ihren Tests

Neue Funktionen

• Die Controller für die Modellklassen wurden entfernt. Modell-Getter sind jetzt Teil der öffentlichen API-Oberfläche, sodass Werte, die in den Buildern festgelegt wurden, validiert werden können.
• Der vorherige CarAppServiceController wurde durch den neuen SessionController ersetzt, um die Logik im Zusammenhang mit der Lebensdauer der Verbindung zum Host zu testen.

Version 1.0.0

Version 1.0.0

21. April 2021

androidx.car.app:app:1.0.0 ist veröffentlicht. Version 1.0.0 enthält diese Commits.

Wichtige Funktionen von Version 1.0.0

• Anfang April haben wir angekündigt, dass Apps mit androidx.car.app:app:1.0.0-rc01 im Produktionschannel veröffentlicht werden können. Die Car App Library v1.0.0 ist jetzt stabil und vollständig mit Android Auto 6.1 und höher kompatibel.
• In der Entwickleranleitung finden Sie Informationen zum Erstellen von Navigations-, Park- und Lade-Apps für Android Auto mit der Bibliothek.

Fehlerkorrekturen

• Es wurde eine Ausnahme behoben, die beim Einblenden eines Screen beim Start auftritt (70aae1, b/184664896).
• Ein Problem wurde behoben, bei dem ON_DESTROY auf einem Session nach dem ON_DESTROY eines Screen (0ceecb, b/183696617) beobachtet wurde.

Version 1.0.0-rc01

24. März 2021

androidx.car.app:app:1.0.0-rc01 ist veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

Fehlerkorrekturen

• Ein Race-Bedingungsfehler wurde behoben, bei dem NavigationManagerCallback#onStopNavigation aufgerufen wurde, nachdem der Callback gelöscht wurde. Dies geschah, wenn der Callback gelöscht wurde, bevor der Callback-Executor tatsächlich ausgeführt wurde (I7fc5e, b/181143772).
• Ein Problem wurde behoben, bei dem die App explizit eine Abhängigkeit von lifecycle-common-java8 (I8b8c8) aufweisen musste.
• Es wurde ein NullPointerException behoben, das ausgelöst wurde, wenn die App einen stopNavigation-Aufruf empfängt, nachdem sie bereits einen Callback entfernt hat (Ib8b89, b/181143772).
• Verbesserungen, damit keine Anrufe an die App gesendet werden, wenn ihr Lebenszyklus nicht mindestens den Status CREATED hat (I86965, b/179800224, b/177921120)
• Ein Problem wurde behoben, bei dem eine ungültige Mindest-API, die im Manifest der App angegeben war, einen Fehler ausgelöst und einen ANR auf dem Host verursacht hat. (Iffedd, b/174231592)

Version 1.0.0-beta01

24. Februar 2021

androidx.car.app:app:1.0.0-beta01 ist veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

Dies ist das erste Jetpack-Release der bisher nicht öffentlich zugänglichen Bibliothek. Es ist mit Android Auto 6.1 oder höher kompatibel. Eine detaillierte Anleitung zum Erstellen von Auto-Apps mit der Bibliothek finden Sie im Entwicklerleitfaden.

Neue Funktionen

• Es wurde ein GridTemplate eingeführt, mit dem Ihre App eine Liste von UI-Elementen in einem Rasterlayout anzeigen kann.
• Die Methode CarAppService.createHostValidator wurde eingeführt, um zu prüfen, ob eine Hostverbindung von einer vertrauenswürdigen Quelle stammt (z. B. Android Auto).
• Die CarAppExtender.Builder.setColor API wurde hinzugefügt. (b/174231592)

Fehlerkorrekturen

• Ein Problem wurde behoben, durch das beim sequenziellen Schließen von Bildschirmen der falsche Screen fortgesetzt wurde. (b/177590791)