Auto-App

Vorlagenbasierte Apps für Android Auto und Android Automotive OS erstellen
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alpha-Release
26. Juni 2024 1.4.0 - 1.7.0-beta01 -

Abhängigkeiten deklarieren

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

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

Cool

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"
}

Kotlin

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")
}

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

Feedback

Dein Feedback hilft uns, Jetpack zu verbessern. Teilen Sie uns mit, wenn Sie neue Ausgaben entdecken oder Verbesserungsvorschläge für diese Bibliothek haben. Bitte sieh dir die vorhandenen Probleme in dieser Bibliothek an, bevor du eine neue erstellst. Sie können einem vorhandenen Problem Ihre Stimme hinzufügen, indem Sie auf die Sternschaltfläche klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung.

Version 1.7

Version 1.7.0-beta01

26. Juni 2024

androidx.car.app:app-*:1.7.0-beta01 wurde veröffentlicht. Version 1.7.0-beta01 enthält diese Commits. Die Funktionen sind mit den in Alpha01 veröffentlichten Funktionen identisch, die im Folgenden wiederholt werden:

Neue Funktionen

  • Karte mit Inhalt:Neue Vorlage enthält einen Karten-Canvas und eine Inhaltsvorlage, die vorerst Liste / Raster / Fenster / Nachricht sein kann.
    • RoutePreview, PlaceListNavigation und MapTemplate wurden verworfen. Vorlagen funktionieren weiterhin unverändert.
    • Beispiel-Apps wurden aktualisiert. Sie sehen jetzt die Nutzung MapWithContentanstelle von verworfenen Vorlagen.
  • Konversationselement:Neue APIs für die Anzeige von Unterhaltungen (IM, SMS) und Vorlesen von Assistant im Auto.
  • Vehicle Dimensions (Fahrzeugabmessungen): Neue API zum Abrufen von Fahrzeugmesswerten (derzeit Daten in AAOS).

API-Änderungen

  • @ExperimentalCarApi-Tag zu MediaPlaybackTemplate.Builder hinzufügen. (IC1957)
  • Fügt in der Testphase eine neue SectionedItemTemplate hinzu. (I5958a)
  • CarAppApiLevel 8 vorstellen (I3fa22)
  • Fügt MediaPlaybackTemplate für die Anzeige von Inhalten während der Medienwiedergabe in der Auto-App-Bibliothek hinzu. (I3c10d)
  • Neue API für Apps hinzugefügt, um zu erkennen, ob das System während der Fahrt Hintergrundgeräusche unterstützt (I0f868)

Fehlerkorrekturen

  • Behebt bestimmte Instanzen 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 wurde 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 durch MapWithContent-Vorlage unterstützt werden.

API-Änderungen

  • Alte MapTemplate, RoutePreviewNavigationTemplate und PlaceListNavigationTemplate einstellen und zur Verwendung der neuen MapWithContentTemplate (Ib0a08) ermutigen

Version 1.7.0-alpha01

3. April 2024

androidx.car.app:app-*:1.7.0-alpha01 wurde veröffentlicht. Wir haben das Versionsverwaltungsschema unserer Bibliothek so verschoben, dass es der aktiven CarApi-Version entspricht. So soll das Namensschema aufgrund des Feedbacks von Entwicklern leichter nachvollziehbar sein. Daher überspringen wir die Versionen 1.5 / 1.6 direkt beim Wechsel zu 1.7 Version 1.7.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Karte mit Inhalt: Neue Vorlage mit dem Namen MapWithContent, die die Listen-/Raster-/Fenster-/Nachricht als Inhalt in einer Karte unterstützt.
    • RoutePreview, PlaceListNavigation und Kartenvorlagen wurden eingestellt.
    • Beispiel-Apps wurden mit MapWithContent aktualisiert und zeigen nun die Funktionen eingestellter Vorlagen.
  • Konversationselement: Neue APIs zum Anzeigen von Unterhaltungen (IM, SMS) und Vorlesen von Assistant im Auto.
  • Vehicle Dimensions: Neue API zum Abrufen von Fahrzeugmesswerten (derzeit Daten in AAOS).

API-Änderungen

  • Bildtyp der sehr kleinen Zeile als experimentell markieren (I5184b)
  • Die CarInfo#fetchExteriorDimensions API für den Zugriff auf Informationen zu Fahrzeugaußenabmessungen wie Höhe, Breite usw. wurde hinzugefügt (Ia40c5).
  • ExperimentalAPI-Tag aus MapWithContentTemplate entfernt (I66db8)
  • Aktualisieren Sie den Parameter GridItem#setTitle so, dass er Nullwerte zulässt. (I3d610)
  • Für die GetHeader API ist API 7 nicht erforderlich, da sie abwärtskompatibel ist (I8c812).
  • Unterstützung für Header in ListTemplate hinzufügen, headerAction, headerTitle, actionStrip (I7ae01) verwerfen
  • title, headerAction und actionStrip in GridTemplate einstellen und Unterstützung für Header hinzufügen (I41a9c)
  • Anforderung der Stufe 7 für experimentelle APIs aufheben: Logo, GridTemplate-Gerätegröße und -Bildformer/-set, GridItem-Methoden zum Abrufen/Festlegen des Logos. (Id71eb)
  • title, headerAction und actionStrip in PaneTemplate einstellen, neue Unterstützung für Header hinzufügen (I23154)
  • Media Center-Telemetrie wurde von „BroadcastReceiver“ in „Benutzerdefinierte Aktion durchsuchen“ geändert. (I4185f)
  • Unterstützung für Header-Attribute in MessageTemplate hinzugefügt. Die Unterstützung für ActionStrip, headerAction und title wurde eingestellt. (Beispiel 8)
  • Konstante Sichtbarkeit von Benachrichtigungen ändern (Icf8a8)
  • Attribut isLoading aus der übergeordneten Vorlage entfernen (I651e6)
  • Fügen Sie Extras hinzu, um Medien-Apps die wichtigsten Parameter der Benutzeroberfläche mitzuteilen (I85ca2).
  • Mediacenter-Analysefunktion zu MediaExtensions hinzufügen (I7ce28)
  • Es wurde eine Option für ein besonders kleines Bild auf Zeilen hinzugefügt. (I72c03)

Fehlerkorrekturen

  • Aktualisieren Sie die Javadoc auf ConversationItem, um anzugeben, dass Nachrichten von der ältesten bis zur neuesten Nachricht geordnet werden sollen. (I77a2a)
  • Die Kürzungslogik von ListTemplate aktualisieren, 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 wurde veröffentlicht. Version 1.4.0 ist eine Promotion von 1.4.0-rc02.

Wichtige Änderungen seit Version 1.3.0

  • Kartenrendering für Kombi-Instrument für Navigations-Apps
  • Vorlage „Neuer Tab“ für ein verbessertes App-Layout / eine verbesserte 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 wurde veröffentlicht. Version 1.4.0-rc02 enthält diese Commits. Nur kleinere Korrekturen

Fehlerkorrekturen

  • Javadoc für ConversationItem aktualisieren, um anzugeben, dass Nachrichten von der ältesten zur neuesten Nachricht geordnet werden sollen (I77a2a)
  • Die Kürzungslogik von ListTemplate aktualisieren, 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 wurde veröffentlicht. Version 1.4.0-beta02 enthält diese Commits. Das ist fast identisch mit Beta01, aber die compileSdk-Anforderung wird auf 33 gesenkt.

Fehlerkorrekturen

  • Ein Fehler wurde behoben, bei dem Ladebildschirme auf Tabs nicht korrekt angezeigt wurden. (cae860)

Version 1.4.0-beta01

9. August 2023

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

Hinweis:1.4-beta01 erfordert CompileSdk34, der sich noch im Entwicklerstatus befindet. 1.4-beta02 behebt dieses Problem. Alternativ können Sie der Datei settings.gradle Ihres Projekts android.suppressUnsupportedCompileSdk=34 hinzufügen, um die Warnung vorübergehend zu unterdrücken.

Neue Funktionen

API-Änderungen

  • Siehe alpha02

Version 1.4.0-alpha02

26. Juli 2023

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

  • Die Veröffentlichung von Alpha02 ist als Vorbereitung auf eine bevorstehende Veröffentlichung von beta01 vorgesehen.

Neue Funktionen

  • Unterstützung für das Kartenrendering im Kombi-Instrument für Navigations-Apps
  • Es wurden Tabs für Apps hinzugefügt, um das Layout zu verbessern.
  • Optionen für das Rendern von Listen-/Rastervorlagen hinzugefügt
  • Neue Kategorien für Wetter und Kommunikation hinzugefügt
  • Mehrere APIs auf die nächste CarApi 7-Version umstellen

API-Änderungen

  • Multimediafelder zu CarMessage hinzufügen (I5aaf6)
  • Fügt benutzerdefinierte Aktionen zu ConversationItem in der Auto-App-Bibliothek (Ie5ed6) hinzu
  • Fügen Sie Extras hinzu, um darauf hinzuweisen, dass ein Medienelement mit einem immersiven Audioformat wiedergegeben wird, und präsentieren Sie sein Inhaltsformat-Logo (Icb5bb)
  • Neuer Aktionstyp, ActionsConstraints API, um die Schaltfläche „Schreiben“ zu unterstützen. (I31661)
  • set/getTemplate als set/get ContentTemplate (Ica036) erstellt
  • Der Vorlagenparameter wäre jetzt @NonNull. Aktualisierte MapWithContentTemplate API-Dokumentation (I0f8ed)
  • Entfernt das Tag @ExperimentalCarApi für Aktionen in ListTemplate für den Start in CAL 1.4 (I2cfcb)
  • Entfernt das @ExperimentalCarApi-Tag für TabTemplate (Ifcb82)
  • Anmerkungen @ExperimentalCarApi aus sekundären Aktionen und Dekorationen für Zeile entfernen (I8487e)
  • Fügt die Content-ID eines aktiven Tabs zu TabTemplate hinzu und stellt den aktiven Status auf Tabs ein (I96932)
  • Property ItemImageShape zu GridTemplate hinzufügen (Ibf431)
  • Fügen Sie die Eigenschaft ItemSize zu GridTemplate hinzu, die die Größe der Rasterelemente nach relativ kleinen, mittleren und großen Buckets steuert. (Icdb3b)
  • Geben Sie den API-Zugriff für Entwickler frei, um eine Kopie des aktuellen Screen Stacks zu erhalten. (I48107)
  • Fügt der Auto-App-Bibliothek eine Kategorie für Wetter-Apps hinzu (I2be44)
  • Fügt eine Kategorie für Anrufe von Apps zur Auto-App-Bibliothek (Icab33) hinzu
  • GridItem.Builder#setBadge() wurde durch überlastete setImage()-Methoden ersetzt (Id2000)
  • Symboleigenschaft zum Logo hinzufügen (I629b2)
  • Methode zum Festlegen der Hintergrundfarbe des Punktlogos hinzufügen (I6411c)
  • Wenn du GridItem eine Badge-Eigenschaft hinzufügst, kann ein Badge über einem GridItem-Bild angezeigt werden. (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 wurde veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.

API-Änderungen

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

Fehlerkorrekturen

  • Fügen Sie fehlende Java Doc-Referenzen für CarMessage hinzu. (I5db1c)
  • equals() und hashCode() für ConversationItem und CarMessage überschreiben (I6fd10)
  • ConversationItem.mMessages-Validierung verbessern (muss nicht null, nicht leer sein (Iafc51)
  • @Keep-Annotationen zu ConversationItem-Feldern hinzufügen (I5d250)
  • Java-Dokumente für die Zeilengestaltung und sekundäre Aktionen aktualisieren. (I000b6)

Version 1.3

Version 1.3.0-rc01

7. Dezember 2022

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

  • Kleinere Fehlerkorrekturen von Beta01. Keine größeren Ä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.

Neue Funktionen

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

  • Die unverankerte Navigationsleiste wird auch dann angezeigt, wenn sich der Nutzer auf einem kartenbasierten Auswahlbildschirm in PlaceListNavigationTemplate, RoutePreviewNavigationTemplate und MapTemplate befindet. Dazu können Sie die Navigationsinformationen über NavigationManager.updateTrip() aktualisieren.
  • Wenn Sie die Aktionsschaltfläche mit FLAG_DEFAULT aktivieren, wird eine Zeitüberschreitungsanimation angezeigt. Nach Ablauf des Zeitlimits wird diese Schaltfläche standardmäßig angeklickt. ([API 5 - All Templates])
  • Ein Rows-Untertext wird nicht gekürzt, wenn das Auto geparkt ist, sondern während der Fahrt auf 2 Zeilen gekürzt. ([API 5 - All Templates])
  • Support deaktiviert 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 Actions, um benutzerdefinierte Symbole zuzulassen. (Iad28f)
  • Fügen Sie die Einschränkung setOnClickListenerAllowed() zu ActionsConstraints hinzu. Womit erlaubte Action, OnClickDelegate() auf Aktionen außer den Standardsymboltypen festzulegen. (TYPE_APP_ICON, TYPE_BACK und TYPE_PAN) (I3c745)

Fehlerkorrekturen

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.

Mit API-Level 5 gekennzeichnete Funktionen sind mit Android Auto 7.9 und höher kompatibel.

Neue Funktionen

  • API-Ebene 5: Neues MapTemplate, das von Navigations-Apps verwendet werden kann, um Fenster- oder Listeninhalte neben einer Karte anzuzeigen (If5826, If44b8)
  • API-Level 5: Neue CarAudioRecord API, um die Aufnahme von Audioeingaben über das Mikrofon des Hostfahrzeugs zu ermöglichen (I5e71a)
  • API-Level 5: neue SuggestionManager API, damit Apps dem Host Vorschläge machen können (I5c103)
  • API-Ebene 5: Neue Alert API, die in Kontextbenachrichtigungen auf dem NavigationTemplate angezeigt wird (I163a7, I5ad70)
  • API-Level 5: Neue Header- und MapController-Komponenten, um die Wiederverwendung in Vorlagen zu vereinfachen (If5826)
  • androidx.car.app.category.POI“ wurde als Kategorie zum Aktivieren von POI-Apps hinzugefügt (und androidx.car.app.category.PARKING und androidx.car.app.category.CHARGING wurden eingestellt) (I59da1)

API-Änderungen

  • API-Ebene 5: Neue Methode onClick in der SurfaceCallback-Oberfläche, um Interaktivität durch Antippen auf der Karte zu ermöglichen (Ia9777)
  • API-Ebene 5: neue Flags Action.FLAG_IS_PERSISTENT und Action.FLAG_DEFAULT zur Beschreibung von Actions (I96318, I5ad70)
  • API-Ebene 5: Neuer aktivierter/deaktivierter Status für die Komponenten Action, Row und Toggle (Host-Unterstützung im Rahmen des Release 1.3.0-beta01 der Bibliothek) (Id8a09)
  • API-Ebene 5: Die neue Header-Komponente wird über setHeader für PlaceListNavigationTemplate.Builder und RoutePreviewNavigationTemplate.Builder bevorzugt. Die vorhandenen Methoden setTitle und setHeaderAction werden eingestellt (I30e6a).
  • API-Ebene 5: neue Methode setOnContentRefreshListner 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, um die Karte für Reiseschätzungen anzupassen (Idcc6d, Ic620d)
  • Unterstützung für CarIconSpans im Titel der PaneTemplate hinzufügen (Ia1ee0)
  • Unterstützung für CarIconSpans im Titel und Text einer Row hinzufügen (Ic1e3c)
  • Karten-ActionStrips können jetzt bis zu vier Aktionen haben (If3522)
  • Aktualisieren Sie das API-Level der Car App auf 5 (I26b8e).
  • Überschriften/Titel sind jetzt für PlaceListMapTemplate, PlaceListNavigationTemplate, RoutePreviewNavigationTemplate, GridTemplate, ListTemplate, LongMessageTemplate, MessageTemplate, PaneTemplate und SignInTemplate (I2078d, Icadde) optional.

Fehlerkorrekturen

  • PaneTemplate Regeln für die Bildgröße wurden auf einen quadratischen Begrenzungsrahmen aktualisiert (Idd72e).
  • Eine Ausnahme, die auftrat, wenn der Bildschirmstapel nach State.DESTROYED geändert wurde, wurde behoben. (I3c8eb)
  • Nullprüfung zum Abrufen des App-Symbols hinzugefügt (I3f710)
  • Aktualisieren Sie die Car Hardware API, sodass standardmäßig STATUS_UNKNOWN statt STATUS_UNAVAILABLE verwendet wird (Ic9444).
  • Prüfen Sie, ob das Display vorhanden ist, bevor Sie eine Oberfläche erstellen (Ice027a).
  • CarValue.equals()-Fehler im Zusammenhang mit STATUS_UNIMPLEMENTED beheben (I24451)

Version 1.2

Version 1.2.0

9. November 2022

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

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

Version 1.2.0-rc01

23. März 2022

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

  • Dies ist eine Stabilisierungsversion. 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-Releases vorgesehen sind.

Fehlerkorrekturen

  • Eine Ausnahme, die auftrat, wenn der Bildschirmstapel nach State.DESTROYED geändert wurde, wurde behoben. (I3c8eb)
  • CarSensors API wurde aktualisiert, um anzuzeigen, dass sie nicht für AAOS implementiert sind (Idd57b).
  • PlaceListMapTempalte.Builder#setCurrentLocationEnabled wurde aktualisiert, um anzugeben, dass ACCESS_COARSE_LOCATION für das Feature (I510c2) ausreicht.
  • Die Ausfahrtnummer für Fahrgemeinschaftstypen im Kreisverkehr mit Winkel ist optional (Ife7d1)

Version 1.2.0-beta02

26. Januar 2022

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

Auto-Apps, die mit dieser Bibliotheksversion erstellt wurden und auf die Android Automotive OS-Plattform ausgerichtet sind, können jetzt im Play Store-Kanal für offene Tests veröffentlicht werden. Weitere Informationen finden Sie im Entwicklungsleitfaden.

Mit API-Level 4 und niedriger gekennzeichnete Funktionen sind sowohl mit Android Auto 7.2 oder höher als auch mit der neuen Android Automotive OS-Plattform kompatibel. Im Abschnitt Known Issues weiter unten finden Sie Vorbehalte.

API-Änderungen

  • Experimentelle setOnContentRefreshListener API zu POI-Vorlagen hinzugefügt (I6bf22)

Fehlerkorrekturen

  • Ein Speicherleck in CarAppService, das beim Aufheben der Bindungen des Autohosts aufgetreten ist, wurde behoben. (I5c9ca, b/203594731)
  • Javadoc für CarAppActivity wurde aktualisiert, um Anforderungen für den SingleTask-Launchmodus (Id2f95) einzuschließen
  • Reduziert visuelle Störungen im Lebenslauf. (Iff7e0)

Bekannte Probleme

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

Version 1.2.0-alpha02

15. Dezember 2021

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

Mit API-Level 4 gekennzeichnete Funktionen wurden von experimenteller auf stabil aktualisiert, darunter die ActionStrips der Karte in PlaceListNavigationTemplate und RoutePreviewNavigateTemplate, das CarIcon-Bild in Panes, die QRCodeSignInMethod und die Möglichkeit, Rendering-Hinweise (z.B. Flags) in Actions festzulegen.

Neue Funktionen

  • In Android Auto 7.1 und höher wurde die maximal zulässige Anzahl an Artikeln für Pane von 2 auf 4 erhöht.

API-Änderungen

  • Experimentelle toString()-Methode zu CarUnit hinzugefügt(I36a3b)

Fehlerkorrekturen

  • Ein Absturz wurde behoben, der in CarAppPermissionActivity auftrat, wenn der Callback inaktiv war (If9823)
  • Standardlistenlimit für Pane wurde in 4 geändert (I0068b)

Version 1.2.0-alpha01

3. November 2021

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

Alle neuen v1.2.0-Funktionen (API 4 oder höher) befinden sich in der Testphase und sind auf zukünftige Android Auto- und Android Automotive OS-Releases ausgerichtet. Weitere Informationen finden Sie im Entwicklungsleitfaden.

API-Änderungen

  • AutomotiveCarInfo API wurde experimentell ausgeführt. (Ia13e5)
  • Car App Library API-Level 4 hinzugefügt (I2a2e7)
  • API-Ebene 4: Unterstützung für das Festlegen von CarIcon in Pane hinzugefügt (Ifcc12)
  • API-Level 4: Anmeldemethode mit QR-Code hinzugefügt (Ib623e)
  • API-Ebene 4: „set/getFlags“ zu Action hinzugefügt (Ic03ab)
  • API-Ebene 4: Unterstützung für Schwenken und Zoomen in PlaceListNavigationTemplate und RoutePreviewNavigationTemplate hinzugefügt (I9d8a3)

Fehlerkorrekturen

  • API-Level 4: Mechanismus hinzugefügt, der es Apps ermöglicht, Standortupdates an den Autohost zu senden (I3bad3)
  • Problem behoben, bei dem die Hostvalidierungslogik die Berechtigung TEMPLATE_RENDERER nicht richtig fand (I62618)

Version 1.1.0

Version 1.1.0

15. Dezember 2021

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

Dies ist eine Stabilisierungsversion. Im Vergleich zu v1.1.0-rc01 gibt es keine Änderungen. Weitere Informationen zu den neuen Funktionen der Auto-App-Mediathek findest du in den Versionshinweisen zu 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-Ebene 2: Unterstützung von Karteninteraktivität innerhalb der NavigationTemplate
  • API-Ebene 2: Textunterstützung in mehreren Längen, damit Apps je nach Bildschirmgröße des Autos mehrere Versionen eines Strings zur Anzeige bereitstellen können.
  • API-Level 3: CarHardwareManagerKann verwendet werden, um die Hardwaredaten des Fahrzeugs abzufragen, z. B. Modell und Marke, Kraftstoffstände und andere Sensoren.

Version 1.1.0-rc01

3. November 2021

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

Dies ist eine Stabilisierungsversion. 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 zu v1.2.0-alpha01.

Version 1.1.0-beta01

1. September 2021

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

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

API-Änderungen

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

Fehlerkorrekturen

  • API-Level-Prüfung beim Erstellen von CarHardwareManager hinzugefügt (I48f9b)
  • Es wurde eine Prüfung auf ungültige CarSpan-Nutzung in der API hinzugefügt (I65ae6).
  • Ein Problem wurde behoben, durch das Screen während der Erstellung als abgeschlossen markiert wurde, den Stack in einem fehlerhaften Zustand belassen (I81b13).
  • Ein Problem wurde behoben, bei dem CarNotificationManager.notify einen Fehler für AutomotiveOS protokolliert, wenn in CarAppExtender Aktionen mit Symbolen vorhanden waren (I3633d).
  • Es wurde eine Handshakemethode für die Anwendung und den Host hinzugefügt, um eine API-Version zu erstellen (I7d6f8).

Version 1.1.0-alpha02

21. Juli 2021

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

Neue Funktionen

  • API-Level 3: Ein CarHardwareManager wurde hinzugefügt, mit dem Hardwaredaten des Fahrzeugs abgefragt werden können, z. B. Modell und Marke, Kraftstoffstand und andere Sensoren. Diese Funktion ist derzeit nur im offenen Testkanal für Android Auto 6.7 oder höher verfügbar. Zum Testen in einer Desktopumgebung ist eine neue Version von Desktop Head Unit erforderlich, die separat veröffentlicht wird. Auf der Seite Android-Apps für Autos testen erfahren Sie, wann die neue Version verfügbar ist.
  • Im Entwicklungsleitfaden und in der Bibliotheksreferenz finden Sie weitere Details und Designrichtlinien zur Verwendung dieser Funktionen in Autohosts, die mit API-Level 3 kompatibel sind.

API-Änderungen

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

Fehlerkorrekturen

  • Javadoc-Fehlerbehebungen für Autohardware (I2abbc)

Externer Beitrag

Bekannte Probleme

  • In SignInTemplate kann die Verwendung von InputSignInMethod zu einem NullPointerException im Autohost führen. Dies wird in der nächsten Version der Bibliothek behandelt. Fügen Sie die folgende Zeile in die Proguard-Konfiguration Ihrer App ein, um das Problem zu umgehen: -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 wurden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

Neue Funktionen

  • API-Ebene 2: neue SignInTemplate und LongMessageTemplate, die für Anmeldevorgänge verwendet werden können, wenn das Fahrzeug geparkt ist.
  • API-Ebene 2: Neue Unterstützung für Interaktivität von Karten innerhalb von NavigationTemplate
  • API-Ebene 2: Neue Textunterstützung in mehreren Längen, damit Apps je nach Bildschirmgröße des Autos mehrere Versionen eines Strings zur Anzeige bereitstellen können.
  • Weitere Informationen und Designrichtlinien zur Verwendung dieser Funktionen in Autohosts, die mit API-Level 2 kompatibel sind, finden Sie im Entwicklungsleitfaden und in der Javadoc-Bibliothek.

API-Änderungen

  • Alle *Callback-Schnittstellenmethoden wurden als Standard festgelegt und in OnRequestPermissionsCallback -> OnRequestPermissionsListener (Ib3ec9) umbenannt.
  • androidx.car.app.hardware-Klassen wurden aktualisiert, um unnötige Builder und Parameterklassen zu entfernen. (I67beb)
  • androidx.car.app.hardware-Klassen für den Zugriff auf fahrzeugspezifische Daten wie Kraftstoff, Akku und Geschwindigkeit hinzugefügt. (Iff3c9)
  • ActionStrip-Unterstützung auf MessageTemplate hinzugefügt (Ida657)
  • setLoading“ wurde zu „MessageTemplate“ hinzugefügt. (I2a4b5)
  • ConnectionToCar wurde in CarConnection umbenannt (Ife9bd)
  • NavigationTemplate wurde so geändert, dass ein explizites PanModeDelegate-Objekt zurückgegeben wird (I13877)
  • Parameterreihenfolge für CarContext.requestPermissions (Ib890a) aktualisiert
  • Metadatenschlüssel aktualisiert, um die API-Ebene für min. Car auf androidx.car.api.minCarApiLevel zu definieren (Ib0d41)
  • Es wurde eine API erstellt, die die Beobachtung des Status der Autoverbindung ermöglicht (Ifc935)
  • Unterstützung für die Einstellung einer Ein/Aus-Schaltfläche für Action wurde hinzugefügt und der Schwenkmodus-Action-Typ (Ica6af) wurde hinzugefügt.
  • CarNotificationManager wurde erstellt, um das Senden von Benachrichtigungen im Auto zu unterstützen (I10d7a)
  • ConstraintManager zur Angabe von Listenlimits des Hosts hinzugefügt (I8690e)
  • Schwenkmodus und API für Karten-Aktionsleisten in NavigationTemplate (I77aa6) hinzugefügt
  • Schwenk- und Zoom-API in SurfaceCallback für Navigations-Apps hinzugefügt (Id5e9d)
  • CarAppApiLevel auf 2 aktualisiert (Ic1540)
  • Berechtigung zum Anfordern von Berechtigungen von einem CarAppService hinzugefügt (I5421e)
  • Der Multi-Text-API (Iacb62) wurde die Anmerkung RequiresCarApi(2) hinzugefügt
  • Mehrere Textvarianten im Titel der Halbliste sind zulässig (Ib8df7)
  • Neue LongMessageTemplate hinzugefügt (Car API-Level 2 erforderlich) (Ic5cee)

Fehlerkorrekturen

  • Die Anforderungen an die Bildgröße wurden aktualisiert, um größere Displays im Auto zu berücksichtigen (I116dc).
  • Hinzufügen von mehr als zwei Aktionen in Vorlagentexten nicht zulässig (I32157)
  • Für das Erstellen von PendingIntents in der Auto-App-Bibliothek wurden Flags festgelegt. (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 wurden dazu aufgefordert, nur geparkte Aktionen im Gehäuse zu verlangen und die Dokumentation zu aktualisieren, um anzugeben, dass sie nur angezeigt werden, wenn das Auto geparkt ist (Iddaa9).
  • Eine Ausnahme wurde behoben, die auftrat, wenn ein Screen während des Starts per Pop-up aufgerufen wurde (Ifcf40, b/184664896).
  • Zulässige benutzerdefinierte Textfarbe in ForegroundCarColorSpan (I69e59)
  • Es wurde ein Problem behoben, bei dem ON_DESTROY auf einer Session nach ON_DESTROY einer Screen beobachtet wurde (I52e01, b/183696617).
  • Javadoc wurde aktualisiert, wenn die verbleibende Zeit einer TravelEstimate auf eine unbekannte Zeit festgelegt ist. (I99610, b/183632456)
  • Action wurde aktualisiert, um ForegroundColorSpan im Titel und jeder benutzerdefinierten Hintergrundfarbe zu unterstützen (I578e4)
  • Führen Sie NavigationManagerCallback#onStopNavigation nicht aus, wenn der Callback vor Ausführung des Executors gelöscht wird (I7fc5e, b/181143772).
  • Es wurde ein Problem behoben, bei dem die Anwendung explizit eine Abhängigkeit von „lifecycle-common-java8“ (I8b8c8) annehmen musste.

Bekannte Probleme

  • Im SignInTemplate zeigt die Bildschirmtastatur ein Suchsymbol anstelle des Symbols „Eingabetaste“ an, wenn der Nutzer die Eingabe bestätigen möchte. Um das Problem zu umgehen, können Nutzer auf die Tastatur des Smartphones zugreifen, die aktiviert wird, wenn das Eingabefeld im Fokus ist.
  • In Android Auto-Version 6.5 werden die Callbacks zum Schwenken und Zoomen in SurfaceCallback möglicherweise fälschlicherweise für einige Touch-Gesten ausgelöst.

Auto-App-Testversion 1.0.0

Version 1.0.0-alpha01

24. März 2021

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

Dies ist der erste Jetpack-Release der zuvor geschlossenen Quelltestbibliothek. Wie Sie diese Bibliothek in Ihren Tests verwenden, erfahren Sie in unseren Beispielen.

Neue Funktionen

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

Version 1.0.0

Version 1.0.0

21. April 2021

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

Hauptfunktionen von Version 1.0.0

  • Anfang April haben wir angekündigt, dass Apps über androidx.car.app:app:1.0.0-rc01 im Produktionskanal veröffentlicht werden können. Die Car App Library Version 1.0.0 ist jetzt stabil und vollständig kompatibel mit Android Auto 6.1 und höher.
  • Im Entwicklungsleitfaden findest du Details zum Erstellen von Navigations-, Parkplatz- und Lade-Apps für Android Auto mithilfe der Bibliothek.

Fehlerkorrekturen

  • Eine Ausnahme wurde behoben, die auftrat, wenn ein Screen während des Starts per Pop-up aufgerufen wurde (70aae1, b/184664896).
  • Es wurde ein Problem behoben, bei dem ON_DESTROY auf einem Session nach ON_DESTROY eines Screen beobachtet wurde (0ceecb, b/183696617).

Version 1.0.0-rc01

24. März 2021

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

Fehlerkorrekturen

  • Es wurde ein Fehler in der Race-Bedingung behoben, bei dem NavigationManagerCallback#onStopNavigation aufgerufen wurde, nachdem der Callback gelöscht wurde. Dies ist der Fall, wenn der Callback gelöscht wurde, bevor das Callback-Executor tatsächlich ausgeführt wurde (I7fc5e, b/181143772).
  • Es wurde ein Problem behoben, bei dem die App explizit eine Abhängigkeit von lifecycle-common-java8 annehmen musste (I8b8c8).
  • Ein NullPointerException wurde behoben, das ausgelöst wurde, wenn die App einen stopNavigation-Aufruf empfängt, obwohl bereits ein Callback entfernt wurde (Ib8b89, b/181143772).
  • Verbesserungen daran, keine Aufrufe an die Anwendung weiterzuleiten, wenn ihr Lebenszyklus nicht mindestens den Status CREATED hat (I86965, b/179800224, b/177921120)
  • Es wurde ein Problem behoben, durch das eine im Manifest der App angegebene ungültige Mindest-API ausgelöst wurde, was zu einem ANR-Fehler auf dem Host führte. (Iffedd, b/174231592)

Version 1.0.0-beta01

24. Februar 2021

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

Dies ist der erste Jetpack-Release der Closed-Source-Bibliothek und ist mit Android Auto 6.1 oder höher kompatibel. Im Entwicklungsleitfaden findest du Details zur Erstellung von Auto-Apps mit der Bibliothek.

Neue Funktionen

Fehlerkorrekturen

  • Es wurde ein Problem behoben, durch das der falsche Screen fortgesetzt wurde, wenn Bildschirme nacheinander eingeblendet wurden. (b/177590791)