Auto-App

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:

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

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.

Neues Problem erstellen

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 und PlaceListNavigationTemplate werden eingestellt und die Verwendung des neuen MapWithContentTemplate 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 aus MapWithContentTemplate 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 in ListTemplate hinzufügen, headerAction, headerTitle, actionStrip (I7ae01) verwerfen
• title, headerAction und actionStrip in GridTemplate einstellen und Unterstützung für Header (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 und actionStrip in PaneTemplate einstellen und neue Header-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 in MessageTemplate hinzugefügt. Die Unterstützung für ActionStrip, headerAction und title 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 aus ConversationItem 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 aus ConversationItem 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 Datei settings.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 als set/get ContentTemplate (Ica036)
• Der Vorlagenparameter wäre jetzt @NonNull. Aktualisierte MapWithContentTemplate API-Dokumentation (I0f8ed)
• Entfernt das @ExperimentalCarApi-Tag für Aktionen in ListTemplate für die Einführung in CAL 1.4 (I2cfcb)
• Entfernt das @ExperimentalCarApi-Tag für TabTemplate (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 Eigenschaft ItemSize 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 überlastete setImage()-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 einem GridItem-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() und hashCode() für ConversationItem und CarMessage (I6fd10) überschreiben
• ConversationItem.mMessages-Validierung verbessern (nicht null, nicht leer (Iafc51)
• @Keep-Annotationen zu ConversationItem-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 und MapTemplate auf einem kartenbasierten Auswahlbildschirm befindet. Aktualisieren Sie dazu die Navigationsinformationen über NavigationManager.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änkung setOnClickListenerAllowed() hinzu. Dabei konnte Action OnClickDelegate() auf Aktionen außer den Standardsymboltypen festlegen. (TYPE_APP_ICON, TYPE_BACK und TYPE_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 der NavigationTemplate (I163a7, I5ad70)
• API-Level 5: Neue Header- und MapController-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 und androidx.car.app.category.CHARGING wurden eingestellt) (I59da1)

API-Änderungen

• API-Level 5: Neue onClick-Methode in der SurfaceCallback-Schnittstelle, die das Tippen auf die Karte ermöglicht (Ia9777)
• API-Ebene 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 für den Release 1.3.0-beta01 der Bibliothek) (Id8a09)
• API-Level 5: Die neue Komponente Header über setHeader auf PlaceListNavigationTemplate.Builder und RoutePreviewNavigationTemplate.Builder verwenden und die vorhandenen Methoden setTitle und setHeaderAction verwerfen (I30e6a)
• API-Level 5: Neue setOnContentRefreshListner-Methode für PlaceListMapTemplate.Builder und PlaceListNavigationTemplate.Builder zur Verwendung mit Implementierungen der neuen OnContentRefreshListner-Schnittstelle.
• API-Level 5: Neue setTripText und setTripIcon auf der TravelEstimate.Builder zur Anpassung der Reisekostenkarte (Idcc6d, Ic620d)
• Im Titel der PaneTemplate werden Unterstützung für CarIconSpan hinzugefügt (Ia1ee0).
• Unterstützung für CarIconSpan im Titel und Text einer Row hinzugefügt (Ic1e3c)
• Karten-ActionStrips 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 und SignInTemplate (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 von STATUS_UNAVAILABLE verwendet wird (Ic9444)
• Vor dem Erstellen der Oberfläche prüfen, ob eine Anzeige vorhanden ist (Ice027a)
• CarValue.equals()-Fehler in Zusammenhang mit STATUS_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 in PlaceListNavigationTemplate und RoutePreviewNavigateTemplate sind in den nächsten Android Auto- und Android 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 ActionStrips der Karte in PlaceListNavigationTemplate und RoutePreviewNavigateTemplate, das CarIcon-Bild in Panes, 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 experimentelle toString()-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 in Pane (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 und RoutePreviewNavigationTemplate (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 und LongMessageTemplate, 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: CarHardwareManagerKann 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ügt
• ScreenController-Konstruktor entfernt, der TestCarContext 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 im CarAppExtender (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 von Desktop 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 und ScreenController wurden in einer einzigen moveToState-Methode konsolidiert (I1ed00).
• CarContext#getHostInfo() (I8977e) hinzugefügt
• Verworfene Felder wurden entfernt. (I67168)
• SessionController und ScreenController wurden aktualisiert, um Konstruktoren direkt verfügbar zu machen (Iabf22).
• PinSignInMethod.Builder und ProviderSignInMethod.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 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 so geändert, dass CharSequence statt String (I275d5) angenommen wird

Fehlerkorrekturen

• Javadoc-Fehlerbehebungen für Autohardware (I2abbc)

Externer Beitrag

Bekannte Probleme

• Im SignInTemplate kann die Verwendung von InputSignInMethod zu einem NullPointerException 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 und LongMessageTemplate, 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 und OnRequestPermissionsCallback -> 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ür MessageTemplate hinzugefügt (Ida657)
• setLoading wurde zu MessageTemplate hinzugefügt. (I2a4b5)
• ConnectionToCar wurde umbenannt in CarConnection (Ife9bd)
• NavigationTemplate wurde geändert, um ein explizites PanModeDelegate (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 Typ Action 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 PendingIntents 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 und LongMessageTemplate 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 einem Session nach ON_DESTROY einer Screen 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, um ForegroundColorSpan 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 neue SessionController 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 einem Session nach ON_DESTROY einer Screen 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 einen stopNavigation-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)