Auto-App
Letzte Aktualisierung | Stabile Version | Releasekandidat | Beta-Ausgabe | Alpharelease |
---|---|---|---|---|
17. April 2024 | 1.2.0 | 1.4.0-rc02 | − | 1.7.0-alpha02 |
Abhängigkeiten deklarieren
Zum Hinzufügen einer Abhängigkeit von der Auto-App-Bibliothek musst du deinem 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 Anwendung oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:
Groovig
dependencies { implementation "androidx.car.app:app:1.2.0" // For Android Auto specific functionality implementation "androidx.car.app:app-projected:1.2.0" // For Android Automotive specific functionality implementation "androidx.car.app:app-automotive:1.2.0" // For testing testImplementation "androidx.car.app:app-testing:1.2.0" }
Kotlin
dependencies { implementation("androidx.car.app:app:1.2.0") // For Android Auto specific functionality implementation("androidx.car.app:app-projected:1.2.0") // For Android Automotive specific functionality implementation("androidx.car.app:app-automotive:1.2.0") // For testing testImplementation("androidx.car.app:app-testing:1.2.0") }
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Dein Feedback hilft uns, Jetpack zu verbessern. Lassen Sie 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 eine neue erstellen. Durch Klicken auf die Stern-Schaltfläche können Sie zu einem vorhandenen Problem abstimmen.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Version 1.7
Version 1.7.0-alpha02
17. April 2024
androidx.car.app:app-*:1.7.0-alpha02
wird freigegeben. Version 1.7.0-alpha02 enthält diese Commits.
Neue Funktionen
- Wir haben verworfene Flags für kartenbasierte Vorlagen hinzugefügt, die von der Vorlage „
MapWithContent
“ in Zukunft unterstützt werden.
API-Änderungen
- Die alten
MapTemplate
,RoutePreviewNavigationTemplate
undPlaceListNavigationTemplate
werden eingestellt und die Verwendung des neuenMapWithContentTemplate
wird empfohlen (Ib0a08).
Version 1.7.0-alpha01
3. April 2024
androidx.car.app:app-*:1.7.0-alpha01
wird freigegeben. Wir haben unser Versionsverwaltungsschema für die Bibliothek verschoben, sodass es der aktiven CarApi-Version entspricht. Dies soll Verwechslungen bezüglich des Benennungsschemas aufgrund des Feedbacks von Entwicklern vermeiden. Aus diesem Grund werden Versionen 1.5 / 1.6, die direkt auf 1.7 Version 1.7.0-alpha01 diese Commits enthalten, übersprungen.
Neue Funktionen
- Karte mit Inhalt: Neue Vorlage mit dem Namen
MapWithContent
, die Listen / Raster / Bereich / Nachrichten als Inhalt innerhalb einer Karte unterstützt.RoutePreview
,PlaceListNavigation
– Kartenvorlagen wurden eingestellt.- Die Beispiel-Apps wurden aktualisiert, um die Funktionen eingestellter Vorlagen mit
MapWithContent
zu zeigen.
- Unterhaltungselement: Neue APIs zum Anzeigen von Unterhaltungen (IM, SMS) und der Assistant-Sprachausgabe im Auto.
- Fahrzeugabmessungen: Neue API zum Abrufen von Fahrzeugmaßen (derzeit Daten über AAOS).
API-Änderungen
- Bildtyp für zusätzliche kleine Zeilen als „experimentell“ markieren (I5184b)
CarInfo#fetchExteriorDimensions
API hinzugefügt, die den Zugriff auf äußere Abmessungen des Fahrzeugs wie Höhe und Breite ermöglicht (Ia40c5)- Tag
ExperimentalAPI
ausMapWithContentTemplate
entfernt (I66db8) - Aktualisieren Sie den
GridItem#setTitle
-Parameter so, dass Nullwerte zulässig sind. (I3d610) - Für die
GetHeader
API ist API 7 nicht erforderlich, da sie abwärtskompatibel ist (I8c812). - Unterstützung für
Header
inListTemplate
hinzufügen,headerAction
,headerTitle
,actionStrip
(I7ae01) verwerfen title
,headerAction
undactionStrip
inGridTemplate
einstellen und Unterstützung fürHeader
(I41a9c) hinzufügen- Anforderung von Stufe 7 für experimentelle APIs entfernen: Badge,
GridTemplate
Elementgröße und Bildform-Getter/Setter,GridItem
-Methoden zum Abrufen/Festlegen von Logos. (Id71eb) title
,headerAction
undactionStrip
inPaneTemplate
einstellen und neueHeader
-Unterstützung hinzufügen (I23154)- Die Telemetrie des Media Centers wurde von
BroadcastReceiver
zu „Benutzerdefinierte Aktion durchsuchen“ geändert. (I4185f) - Unterstützung für
Header
-Attribute inMessageTemplate
hinzugefügt. Die Unterstützung fürActionStrip
,headerAction
undtitle
wurde eingestellt. (Ie2de8) - Ständige Sichtbarkeit von Benachrichtigungen ändern (Icf8a8)
- Attribut
isLoading
aus der übergeordneten Vorlage entfernen (I651e6) - Füge Extras hinzu, um Medien-Apps über die wichtigsten UI-Parameter zu informieren (I85ca2)
- Analysefunktion für Mediacenter zu
MediaExtensions
hinzufügen (I7ce28) - Es wurde eine Option für ein sehr kleines Bild in Zeilen hinzugefügt. (I72c03)
Fehlerkorrekturen
- Aktualisieren Sie Javadoc für
ConversationItem
, um anzugeben, dass die Nachrichten von der ältesten zur neuesten Nachricht geordnet werden sollten. (I77a2a) - Aktualisieren Sie die Kürzungslogik für
ListTemplate
, um älteste Nachrichten ausConversationItem
zu entfernen (Ie0a61).
Version 1.4
Version 1.4.0-rc02
13. Dezember 2023
androidx.car.app:app-*:1.4.0-rc02
wird freigegeben. Version 1.4.0-rc02 enthält diese Commits. Nur kleinere Korrekturen
Fehlerkorrekturen
- Aktualisieren Sie Javadoc für
ConversationItem
, um anzugeben, dass die Nachrichten von der ältesten bis zur neuesten Nachricht sortiert werden sollen (I77a2a). - Aktualisieren Sie die Kürzungslogik für
ListTemplate
, um älteste Nachrichten ausConversationItem
zu entfernen (Ie0a61).
Version 1.4.0-rc01
1. November 2023
androidx.car.app:app-*:1.4.0-rc01
wurde ohne wichtige Ä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
wird freigegeben. Version 1.4.0-beta02 enthält diese Commits. Dieser Wert ist fast identisch mit „beta01“. Allerdings wird die compileSdk
-Anforderung auf 33 gesenkt.
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem Ladebildschirme auf Tabs nicht richtig angezeigt wurden. (cae860)
Version 1.4.0-beta01
9. August 2023
androidx.car.app:app-*:1.4.0-beta01
wird freigegeben. Version 1.4.0-beta01 enthält diese Commits.
Hinweis:1.4-beta01 erfordert CompilSdk34, das sich noch im Entwicklungsstatus befindet. Mit 1.4-beta02 wird dieses Problem behoben. Alternativ können Sie
android.suppressUnsupportedCompileSdk=34
in die Dateisettings.gradle
Ihres Projekts einfügen, um die Warnung vorübergehend zu unterdrücken.
Neue Funktionen
- Cluster-Kartenrendering für Navigations-Apps instrumentieren
- Neue Tab-Vorlage für verbessertes App-Layout und verbesserte Nutzerfreundlichkeit
- Unterstützung für Limits für adaptive Aufgaben
- 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
wird freigegeben. Version 1.4.0-alpha02 enthält diese Commits.
- Das Release von Alpha02 ist als Vorbereitung auf eine kommende Version von beta01 gedacht.
Neue Funktionen
- Kartenrendering bei Instrumenten-Cluster-Unterstützung für Navigations-Apps
- Tabs für Apps hinzugefügt, um das Layout zu verbessern
- Zusätzliche Rendering-Optionen für Listen-/Rastervorlagen
- Neue Kategorien für Wetter und Kommunikation hinzugefügt
- Mehrere APIs auf die nächste CarApi 7-Version verschieben
API-Änderungen
- Multimedia-Felder zu
CarMessage
hinzufügen (I5aaf6) - Fügt
ConversationItem
in der Auto-App-Bibliothek (Ie5ed6) benutzerdefinierte Aktionen hinzu - Fügen Sie Extras hinzu, um anzugeben, dass ein Medienelement in einem immersiven Audioformat abgespielt wird, und präsentieren Sie sein Logo für das Inhaltsformat (Icb5bb).
- Fügen Sie einen neuen Aktionstyp hinzu, die
ActionsConstraints
API, um die Schaltfläche „Schreiben“ zu unterstützen. (I31661) set/getTemplate
erstellt alsset/get ContentTemplate
(Ica036)- Der Vorlagenparameter wäre jetzt
@NonNull
. AktualisierteMapWithContentTemplate
API-Dokumentation (I0f8ed) - Entfernt das
@ExperimentalCarApi
-Tag für Aktionen inListTemplate
für die Einführung in CAL 1.4 (I2cfcb) - Entfernt das
@ExperimentalCarApi
-Tag fürTabTemplate
(Ifcb82) @ExperimentalCarApi
-Anmerkungen aus sekundären Aktionen und Dekorationen der Zeile entfernen (I8487e)- Fügt die Content-ID für einen aktiven Tab zu
TabTemplate
hinzu und stellt den Status „Aktiv“ auf Tabs ein (I96932) - Property „
ItemImageShape
“ zu „GridTemplate
“ hinzufügen (Ibf431) - Fügen Sie
GridTemplate
die EigenschaftItemSize
hinzu, mit der die Größe der Rasterelemente entsprechend den relativen kleinen, mittleren und großen Buckets gesteuert wird. (Icdb3b) - Geben Sie Entwicklern den API-Zugriff, um eine Kopie des aktuellen Bildschirmstapels zu erhalten. (I48107)
- Fügt der Auto-App-Bibliothek eine Kategorie für Wetter-Apps hinzu (I2be44)
- Fügt eine Kategorie zum Anrufen von Apps zur Auto-App-Bibliothek hinzu (Icab33)
GridItem.Builder#setBadge()
wurde durch überlastetesetImage()
-Methoden ersetzt (Id2000)- Symboleigenschaft zum Badge hinzufügen (I629b2)
- Methode zum Festlegen der Hintergrundfarbe des Punktlogos hinzufügen (I6411c)
- Fügen Sie
GridItem
eine Badge-Eigenschaft hinzu, damit ein Logo über einemGridItem
-Bild angezeigt werden kann. (I95de7) - Es wurde ein experimentelles Badge-Objekt hinzugefügt, das ein Badge darstellt, das über einem Bild angezeigt wird. (I9878d)
Version 1.4.0-alpha01
22. Februar 2023
androidx.car.app:app-*:1.4.0-alpha01
wird freigegeben. 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 - Extras hinzufügen, um den Untertitel eines Medienelements oder seine Beschreibung mit anderen Medienelementen zu verknüpfen (Ic84bf)
- API-Ebene für Zeilenaktionen auf Ebene 6 aktualisieren. (Ie0a69)
- Messaging-Callbacks zu A4C hinzufügen (Ie3986)
Fehlerkorrekturen
- Fehlende Java-Doc-Referenzen für
CarMessage
hinzugefügt. (I5db1c) equals()
undhashCode()
fürConversationItem
undCarMessage
(I6fd10) überschreibenConversationItem.mMessages
-Validierung verbessern (nicht null, nicht leer (Iafc51)@Keep
-Annotationen zuConversationItem
-Feldern hinzufügen (I5d250)- Aktualisieren Sie die Java-Dokumentation für die Zeilengestaltung und die sekundären Aktionen. (I000b6)
Version 1.3
Version 1.3.0-rc01
7. Dezember 2022
androidx.car.app:app-*:1.3.0-rc01
wird freigegeben. 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.
- Mit dieser Bibliothek erstellte Auto-Apps können jetzt mit API-Level 5 im Play Store bereitgestellt werden. Weitere Informationen findest du in unserem Entwicklungsleitfaden. Funktionen, die mit API-Level 5 oder niedriger gekennzeichnet sind, sind sowohl mit Android Auto 8.1 oder höher als auch mit Google Automotive App Host 1.4 und höher kompatibel.
Neue Funktionen
Neben den in der Auto-App-Bibliothek 1.3.0-alpha01 hinzugefügten Funktionen wurden im Rahmen von „beta01“ die folgenden Funktionen hinzugefügt. Alle hier genannten Funktionen sind nur bei Änderungen auf Hostseite ohne API-Änderungen möglich:
- Die unverankerte Navigationsleiste wird auch dann weiterhin angezeigt, wenn sich ein Nutzer in
PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
undMapTemplate
auf einem kartenbasierten Auswahlbildschirm befindet. Aktualisieren Sie dazu die Navigationsinformationen überNavigationManager.updateTrip()
. - Aktivieren Sie die Aktionsschaltfläche mit
FLAG_DEFAULT
, um eine Zeitüberschreitungsanimation zu erhalten. Nach Ablauf des Zeitlimits wird auf diese Schaltfläche standardmäßig geklickt. ([API 5 - All Templates]
) Row
-Subtexte werden nicht abgeschnitten, wenn das Auto geparkt ist, sondern während der Fahrt auf zwei Zeilen gekürzt. ([API 5 - All Templates]
)- Status „Unterstützung deaktiviert“ für
Action
,Toggle
,Row
([API 5 - All Templates]
)
API-Änderungen
- Einschränkungen in der
MapTemplate
-Liste lockern, um auswählbare Listen zu unterstützen (I961ed) - Entfernen Sie die Einschränkung für Headeraktionen, um benutzerdefinierte Symbole zuzulassen. (Iad28f)
- Fügen Sie
ActionsConstraints
die EinschränkungsetOnClickListenerAllowed()
hinzu. Dabei konnteAction
OnClickDelegate()
auf Aktionen außer den Standardsymboltypen festlegen. (TYPE_APP_ICON
,TYPE_BACK
undTYPE_PAN
) (I3c745)
Fehlerkorrekturen
- Android Automotive Template Host 1.4+ mit gebogenen Displays kompatibel (
[Host change]
)
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-Level 5: Das neue
MapTemplate
kann von Navigations-Apps verwendet werden, um Bereiche oder Listen von Inhalten 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-Level 5: Neue
Alert
API zur Anzeige in Kontextbenachrichtigungen auf derNavigationTemplate
(I163a7, I5ad70) - API-Level 5: Neue
Header
- undMapController
-Komponenten zur leichteren vorlagenübergreifenden Wiederverwendung (If5826) androidx.car.app.category.POI
wurde als Kategorie zum Aktivieren von POI-Apps hinzugefügt (androidx.car.app.category.PARKING
undandroidx.car.app.category.CHARGING
wurden eingestellt) (I59da1)
API-Änderungen
- API-Level 5: Neue
onClick
-Methode in derSurfaceCallback
-Schnittstelle, die das Tippen auf die Karte ermöglicht (Ia9777) - API-Ebene 5: Neue Flags
Action.FLAG_IS_PERSISTENT
undAction.FLAG_DEFAULT
zur Beschreibung vonAction
s (I96318, I5ad70) - API-Level 5: neuer aktivierter/deaktivierter Status für die Komponenten
Action
,Row
undToggle
(Hostunterstützung für den Release 1.3.0-beta01 der Bibliothek) (Id8a09) - API-Level 5: Die neue Komponente
Header
übersetHeader
aufPlaceListNavigationTemplate.Builder
undRoutePreviewNavigationTemplate.Builder
verwenden und die vorhandenen MethodensetTitle
undsetHeaderAction
verwerfen (I30e6a) - API-Level 5: Neue
setOnContentRefreshListner
-Methode fürPlaceListMapTemplate.Builder
undPlaceListNavigationTemplate.Builder
zur Verwendung mit Implementierungen der neuenOnContentRefreshListner
-Schnittstelle. - API-Level 5: Neue
setTripText
undsetTripIcon
auf derTravelEstimate.Builder
zur Anpassung der Reisekostenkarte (Idcc6d, Ic620d) - Im Titel der
PaneTemplate
werden Unterstützung fürCarIconSpan
hinzugefügt (Ia1ee0). - Unterstützung für
CarIconSpan
im Titel und Text einerRow
hinzugefügt (Ic1e3c) - Karten-
ActionStrip
s können jetzt bis zu vier Aktionen enthalten (If3522) - Car App API-Level auf 5 (I26b8e) aktualisieren
- Überschriften/Titel sind jetzt optional für
PlaceListMapTemplate
,PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
,GridTemplate
,ListTemplate
,LongMessageTemplate
,MessageTemplate
,PaneTemplate
undSignInTemplate
(I2078d, Icadde)
Fehlerkorrekturen
- Die
PaneTemplate
-Regeln zur Bildgröße wurden auf einen quadratischen Begrenzungsrahmen (Idd72e) aktualisiert. - Es wurde eine Ausnahme behoben, die auftrat, wenn der Bildschirmstapel nach
State.DESTROYED
geändert wurde. (I3c8eb) - Nullprüfung für das Abrufen des App-Symbols (I3f710) wurde hinzugefügt.
- Car Hardware API so aktualisieren, dass standardmäßig
STATUS_UNKNOWN
anstelle vonSTATUS_UNAVAILABLE
verwendet wird (Ic9444) - Vor dem Erstellen der Oberfläche prüfen, ob eine Anzeige vorhanden ist (Ice027a)
CarValue.equals()
-Fehler in Zusammenhang mitSTATUS_UNIMPLEMENTED
(I24451) beheben
Version 1.2
Version 1.2.0
9. November 2022
androidx.car.app:app-*:1.2.0
wird freigegeben. Version 1.2.0 enthält diese Commits.
- Dies ist eine Stabilisierungsversion und es gibt im Vergleich zu v1.2.0-rc01 keine Änderungen.
Version 1.2.0-rc01
23. März 2022
androidx.car.app:app-*:1.2.0-rc01
wird freigegeben. Version 1.2.0-rc01 enthält diese Commits.
- Dies ist eine Stabilisierungsversion und es gibt keine API-Änderungen im Vergleich zu
v1.2.0-beta02
. Es wurden neue experimentelle Funktionen (API-Level 5) hinzugefügt, die für zukünftige Android Auto- und Android Automotive-Releases vorgesehen sind.
Fehlerkorrekturen
- Es wurde eine Ausnahme behoben, die auftrat, wenn der Bildschirmstapel nach
State.DESTROYED
geändert wurde. (I3c8eb) - Die
CarSensors
API wurde aktualisiert, um anzugeben, 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 wurde für das Abbiegen von Kreisverkehr mit Winkeln optional (Ife7d1)
Version 1.2.0-beta02
26. Januar 2022
androidx.car.app:app-*:1.2.0-beta02
wird freigegeben. Version 1.2.0-beta02 enthält diese Commits.
Auto-Apps, die mit dieser Bibliotheksversion erstellt wurden, die auf die Android Automotive OS
-Plattform ausgerichtet ist, können jetzt im offenen Testkanal im Play Store veröffentlicht werden. Weitere Informationen finden Sie im Entwicklungsleitfaden.
Funktionen, die mit API-Level 4 oder niedriger gekennzeichnet sind, sind sowohl mit Android Auto
7.2 oder höher als auch mit der neuen Android Automotive OS
-Plattform kompatibel. Einschränkungen finden Sie im Abschnitt Known Issues
unten.
API-Änderungen
- POI-Vorlagen wurde die experimentelle
setOnContentRefreshListener
API hinzugefügt (I6bf22).
Fehlerkorrekturen
- Ein Speicherleck in
CarAppService
beim Aufheben der Bindung des Autohosts wurde behoben. (I5c9ca, b/203594731) - Die Javadoc zu
CarAppActivity
wurde aktualisiert, um die Anforderungen für den SingleTask-Startmodus (Id2f95) aufzunehmen. - Reduziert die visuelle Störung im Lebenslauf. (Iff7e0)
Bekannte Probleme
- Die
ActionStrip
-Kartenelemente inPlaceListNavigationTemplate
undRoutePreviewNavigateTemplate
sind in den nächstenAndroid Auto
- undAndroid Automotive OS
-Releases verfügbar.
Version 1.2.0-alpha02
15. Dezember 2021
androidx.car.app:app-*:1.2.0-alpha02
wird freigegeben. Version 1.2.0-alpha02 enthält diese Commits.
Funktionen, die mit API-Level 4 gekennzeichnet sind, wurden von experimentell auf stabil aktualisiert, darunter die ActionStrip
s der Karte in PlaceListNavigationTemplate
und RoutePreviewNavigateTemplate
, das CarIcon
-Bild in Pane
s, QRCodeSignInMethod
und die Möglichkeit, Renderinghinweise (z.B. Flags) in Action
festzulegen.
Neue Funktionen
- In Android Auto 7.1 und höher wurde die maximale Anzahl an Artikeln für
Pane
von 2 auf 4 erhöht.
API-Änderungen
CarUnit
wurde eine experimentelletoString()
-Methode hinzugefügt(I36a3b)
Fehlerkorrekturen
- Ein Absturz wurde behoben, der in
CarAppPermissionActivity
auftrat, wenn der Callback inaktiv war (If9823) - Das 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
wird freigegeben. Version 1.2.0-alpha01 enthält diese Commits.
Alle neuen v1.2.0
-Funktionen (API 4 und höher) sind derzeit in der Testphase und sind auf zukünftige Android Auto- und Android Automotive OS-Releases ausgerichtet. Weitere Informationen finden Sie im Entwicklungsleitfaden.
API-Änderungen
- Die
AutomotiveCarInfo
API wurde experimentell. (Ia13e5) - Car App Library API-Level 4 (I2a2e7) hinzugefügt
- API-Level 4: Unterstützung für das Festlegen von
CarIcon
inPane
(Ifcc12) wurde hinzugefügt. - API-Ebene 4: Anmeldemethode mit QR-Code hinzugefügt (Ib623e)
- API-Level 4: „set/getFlags“ wurde zu
Action
(Ic03ab) hinzugefügt - API-Level 4: Unterstützung für Schwenken und Zoomen in
PlaceListNavigationTemplate
undRoutePreviewNavigationTemplate
(I9d8a3) wurde hinzugefügt.
Fehlerkorrekturen
- API-Level 4: Hinzufügen eines Mechanismus, mit dem Apps Standortaktualisierungen an den Autohost senden können (I3bad3)
- Problem beheben, 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
wird freigegeben. Version 1.1.0 enthält diese Commits.
Dies ist eine Stabilisierungsversion und es gibt keine Änderungen im Vergleich zu v1.1.0-rc01
. Weitere Informationen zu neuen Funktionen in der Auto-App-Mediathek findest du auch in den Versionshinweisen für v1.2.0-alpha02
.
Wichtige Änderungen seit Version 1.0.0
- API-Level 2:
SignInTemplate
undLongMessageTemplate
, die für die Anmeldung verwendet werden können, wenn das Fahrzeug geparkt ist - API-Level 2: Unterstützung von Karteninteraktivität innerhalb der
NavigationTemplate
- API-Level 2: Unterstützung mehrerer Längen, damit Apps je nach Autodisplay-Größe mehrere Versionen eines Strings zur Anzeige zur Verfügung stellen können
- API-Level 3:
CarHardwareManager
Kann zur Abfrage von Hardwaredaten des Fahrzeugs verwendet werden, z. B. Modell und Marke, Kraftstoffstand und andere Sensoren.
Version 1.1.0-rc01
3. November 2021
androidx.car.app:app-*:1.1.0-rc01
wird freigegeben. Version 1.1.0-rc01 enthält diese Commits.
Dies ist eine Stabilisierungsversion und es gibt keine API-Änderungen im Vergleich zu v1.1.0-beta01
. 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
wird freigegeben. 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)- Möglichkeit zum Festlegen eines benutzerdefinierten Markenhintergrunds für Berechtigungsanfragen hinzugefügt (I74b76)
ScreenManager.getStackSize
(I0b16a) hinzugefügtScreenController
-Konstruktor entfernt, derTestCarContext
explizit annimmt (Iefebc)
Fehlerkorrekturen
- Beim Erstellen von
CarHardwareManager
(I48f9b) wurde eine API-Level-Prüfung hinzugefügt. - Prüfungen auf ungültige
CarSpan
-Nutzung in der gesamten API (I65ae6) hinzugefügt - Ein Problem wurde behoben, bei dem eine
Screen
, die während der Erstellung als abgeschlossen markiert wurde, den Stack in einem fehlerhaften Zustand behielt (I81b13). - Problem behoben, bei dem
CarNotificationManager.notify
einen Fehler für AutomotiveOS protokolliert hat, wenn Aktionen mit Symbolen imCarAppExtender
(I3633d) aufgetreten sind - Es wurde eine Handshakemethode für die App 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
wird freigegeben. Version 1.1.0-alpha02 enthält diese Commits.
Neue Funktionen
- API-Level 3: Es wurde ein
CarHardwareManager
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 für Android Auto 6.7 und höher im Kanal für offene Tests verfügbar. Für den Test in einer Desktopumgebung ist eine neue Version vonDesktop Head Unit
erforderlich, die separat veröffentlicht wird. Weitere Informationen dazu, wann die neue Version verfügbar ist, finden Sie auf der Seite Android-Apps für Autos testen. - Weitere Details und Designrichtlinien zur Verwendung dieser Funktionen in mit API-Level 3 kompatiblen Autohosts finden Sie im Entwicklungsleitfaden und in der Referenz zu Bibliothek.
API-Änderungen
- Die Lebenszyklusmethoden
SessionController
undScreenController
wurden in einer einzigenmoveToState
-Methode konsolidiert (I1ed00). CarContext#getHostInfo()
(I8977e) hinzugefügt- Verworfene Felder wurden entfernt. (I67168)
SessionController
undScreenController
wurden aktualisiert, um Konstruktoren direkt verfügbar zu machen (Iabf22).PinSignInMethod.Builder
undProviderSignInMethod.Builder
(I9f0cb) entfernt- „setCarAppResult()“ wurde hinzugefügt, um die Verwendung von Vorlagen-Apps für „für Ergebnis“ in AAOS (I37741) zu ermöglichen.
- Annotierte
CarHardware
-Schnittstellen mit@MainThread
. (Ib2f85) OnCarDataListener
wurde inOnCarDataAvailableListener
(I518ca) umbenannt- Die Methodennamen
CarInfo
,Speed
,Mileage
und Javadoc wurden aktualisiert. (I86672) Toll
wurde inTollCard
umbenannt. (I3e7c8)- Das verworfene
PinSignInMethod.getPin
wurde entfernt und durchPinSignInMethod.getPinCode
(I996ce) ersetzt. OnInputCompletedListener
entfernt (ersetzt durchInputCallback
). (Ib5be1)PinSignInMethod
so geändert, dassCharSequence
stattString
(I275d5) angenommen wird
Fehlerkorrekturen
- Javadoc-Fehlerbehebungen für Autohardware (I2abbc)
Externer Beitrag
Bekannte Probleme
- Im
SignInTemplate
kann die Verwendung vonInputSignInMethod
zu einemNullPointerException
im Autohost führen. Dieses Problem wird in der nächsten Version der Bibliothek behoben. Um das Problem zu umgehen, fügen Sie diese Zeile in die Proguard-Konfiguration Ihrer App ein:-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-Level 2: Neue
SignInTemplate
undLongMessageTemplate
, die für Anmeldevorgänge verwendet werden können, wenn das Fahrzeug geparkt ist. - API-Level 2: Neue Unterstützung für Interaktivität von Karten in
NavigationTemplate
- API-Level 2: Neue Textunterstützung für mehrere Längen, damit Apps je nach Bildschirmgröße des Autos mehrere Versionen eines Strings zur Anzeige zur Verfügung stellen können
- Weitere Details und Designrichtlinien zur Verwendung dieser Funktionen in mit API-Level 2 kompatiblen Autohosts finden Sie im Entwicklungsleitfaden und in der Javadoc-Bibliothek.
API-Änderungen
- Alle
*Callback
-Schnittstellenmethoden wurden als Standard festgelegt undOnRequestPermissionsCallback
->OnRequestPermissionsListener
(Ib3ec9) umbenannt - Die
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 wurden hinzugefügt. (Iff3c9)ActionStrip
-Support fürMessageTemplate
hinzugefügt (Ida657)setLoading
wurde zuMessageTemplate
hinzugefügt. (I2a4b5)ConnectionToCar
wurde umbenannt inCarConnection
(Ife9bd)NavigationTemplate
wurde geändert, um ein explizitesPanModeDelegate
(I13877) zurückzugeben- Parameterreihenfolge für
CarContext.requestPermissions
(Ib890a) aktualisiert - Metadatenschlüssel zum Definieren der Mindest-API-Ebene für Autos auf
androidx.car.api.minCarApiLevel
(Ib0d41) aktualisiert - Es wurde eine API erstellt, die die Beobachtung des Autoverbindungsstatus ermöglicht (Ifc935)
- Unterstützung zum Festlegen einer Ein/Aus-Schaltfläche für
Action
wurde hinzugefügt und der TypAction
für den Schwenkmodus wurde hinzugefügt (Ica6af). CarNotificationManager
wurde erstellt, um das Senden von Benachrichtigungen im Auto zu unterstützen (I10d7a)ConstraintManager
zur Bereitstellung von Listenlimits durch den Host (I8690e) hinzugefügt- Schwenkmodus und Kartenaktionsstreifen-API in
NavigationTemplate
(I77aa6) hinzugefügt - In
SurfaceCallback
wurde eine API zum Schwenken und Zoomen für Navigations-Apps hinzugefügt (Id5e9d). CarAppApiLevel
auf 2 (Ic1540) aktualisiert- Möglichkeit zum Anfordern von Berechtigungen von einem
CarAppService
(I5421e) hinzugefügt - Der Multi-Text API (Iacb62) wurde die Anmerkung
RequiresCarApi(2)
hinzugefügt. - Mehrere Textvarianten im Titel der Vorlage für die halbe Liste sind zulässig (Ib8df7)
- Neues
LongMessageTemplate
hinzugefügt (Car API-Level 2 erforderlich) (Ic5cee)
Fehlerkorrekturen
- Aktualisierte Anforderungen an die Bildgröße, um größere Autodisplays zu berücksichtigen (I116dc)
- Dem Vorlagentext dürfen nicht mehr als zwei Aktionen hinzugefügt werden (I32157)
- Beim Erstellen von
PendingIntent
s in den Set-Flags der Auto-App-Bibliothek wurde sichergestellt. (If84fe, b/186394900) - Javadoc wurde aktualisiert, um Textänderungen in
Row
beim Aktualisieren zuzulassen (If3f9c) androidx.activity:activity:1.2.0
ist jetzt eine API-Abhängigkeit (Id1cb9)SignInTemplate
undLongMessageTemplate
wurden so geändert, dass nur geparkte Aktionen im Text erforderlich sind. In der Dokumentation wird angegeben, dass diese nur angezeigt werden, wenn das Auto geparkt ist (Iddaa9).- Es wurde eine Ausnahme behoben, die auftrat, wenn während des Starts ein
Screen
per Pop-up angezeigt wurde (Ifcf40, b/184664896). - Zulässige benutzerdefinierte Textfarbe in
ForegroundCarColorSpan
(I69e59) - Problem behoben, bei dem
ON_DESTROY
auf einemSession
nachON_DESTROY
einerScreen
beobachtet wurde (I52e01, b/183696617) - Die Javadoc-Informationen wurden aktualisiert, wenn die verbleibende Zeit von
TravelEstimate
auf eine unbekannte Zeit festgelegt werden darf. (I99610, b/183632456) Action
wurde aktualisiert, umForegroundColorSpan
im Titel und beliebige benutzerdefinierte Hintergrundfarben zu unterstützen (I578e4)- Führen Sie
NavigationManagerCallback#onStopNavigation
nicht aus, wenn der Callback gelöscht wird, bevor der Executor ausgeführt 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
- In der
SignInTemplate
wird auf der Bildschirmtastatur anstelle des Eingabesymbols ein Suchsymbol angezeigt, wenn der Nutzer die Eingabe bestätigen möchte. Als Behelfslösung können Nutzer auf die Tastatur des Smartphones zugreifen, die aktiviert wird, wenn das Eingabefeld im Fokus ist. - In der Android Auto-Version 6.5 werden die Callbacks zum Schwenken und Zoomen in
SurfaceCallback
möglicherweise aufgrund einiger Touch-Gesten falsch aufgerufen.
Testversion von Auto-Apps 1.0.0
Version 1.0.0-alpha01
24. März 2021
androidx.car.app:app-testing:1.0.0-alpha01
wird freigegeben. Version 1.0.0-alpha01 enthält diese Commits.
Dies ist der erste Jetpack-Release der zuvor Closed-Source-Testbibliothek. Informationen zur Verwendung dieser Bibliothek in Tests finden Sie in den Beispielen.
Neue Funktionen
- Die Controller für die Modellklassen wurden entfernt. Modell-Getter sind jetzt Teil der öffentlichen API-Oberfläche, die die Validierung der in den Buildern festgelegten Werte ermöglicht.
- Die vorherige
CarAppServiceController
wurde durch die neueSessionController
für Testlogik in Bezug auf die Lebensdauer der Verbindung zu den Hots ersetzt.
Version 1.0.0
Version 1.0.0
21. April 2021
androidx.car.app:app:1.0.0
wird freigegeben. 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 Auto App Library 1.0.0 ist jetzt stabil und vollständig kompatibel mit Android Auto 6.1 und höher. - Weitere Informationen zum Erstellen von Navigations-, Parkplatz- und Lade-Apps für Android Auto mithilfe der Bibliothek findest du im Entwicklungsleitfaden.
Fehlerkorrekturen
- Es wurde eine Ausnahme behoben, die auftrat, wenn ein
Screen
während des Starts mit Pop-up angezeigt wurde (70aae1, b/184664896). - Problem behoben, bei dem
ON_DESTROY
auf einemSession
nachON_DESTROY
einerScreen
beobachtet wurde (0ceecb, b/183696617)
Version 1.0.0-rc01
24. März 2021
androidx.car.app:app:1.0.0-rc01
wird freigegeben. Version 1.0.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Ein Race-Bedingung-Fehler wurde 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
(I8b8c8) vornehmen musste. - Ein
NullPointerException
wurde behoben, das ausgelöst wurde, wenn die App einenstopNavigation
-Aufruf empfängt, obwohl bereits ein Callback entfernt wurde (Ib8b89, b/181143772). - Verbesserungen beim Weiterleiten von Anrufen an die App, wenn ihr Lebenszyklus nicht mindestens den Status
CREATED
hat (I86965, b/179800224, b/177921120) - Es wurde ein Problem behoben, bei dem eine im Manifest der App angegebene API mit einer ungültigen Mindest-API-Anzahl zu einem ANR-Fehler auf dem Host geführt hat. (Iffedd, b/174231592)
Version 1.0.0-beta01
24. Februar 2021
androidx.car.app:app:1.0.0-beta01
wird freigegeben. Version 1.0.0-beta01 enthält diese Commits.
Dies ist der erste Jetpack-Release der zuvor geschlossenen Quellbibliothek. Er ist mit Android Auto 6.1 oder höher kompatibel. Weitere Informationen zum Erstellen von Auto-Apps mithilfe der Bibliothek findest du im Entwicklungsleitfaden.
Neue Funktionen
- Es wurde ein
GridTemplate
eingeführt, mit dem deine App eine Liste von UI-Elementen in einem Rasterlayout anzeigen kann. - Es wurde eine
CarAppService.createHostValidator
-Methode eingeführt, um zu bestätigen, dass eine Hostverbindung von einer vertrauenswürdigen Quelle stammt (z. B. Android Auto). - Eine
CarAppExtender.Builder.setColor
API wurde hinzugefügt. (b/174231592)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem der falsche
Screen
fortgesetzt wurde, wenn Bildschirme nacheinander eingeblendet wurden. (b/177590791)