wear protolayout

Abhängigkeiten deklarieren

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

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

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha05"

    // Use to implement support for Wear ProtoLayout
    implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha05"

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha05"
}

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha05")

    // Use to implement support for Wear ProtoLayout
    implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha05")

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha05")
}

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

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.3

Version 1.3.0-alpha04

13. November 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha04 wird veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.

Neue Funktionen

• Die Material3-Form wurde zu einer Klasse mit Feldern aktualisiert, die den tatsächlichen Wert der Ecke enthalten, genau wie in Wear Compose. (Ied8cd)
• Die Material 3-Farben wurden um das ColorScheme-Konzept erweitert, genau wie in Wear Compose. (If645e)
• Fügen Sie der Testbibliothek mehrere häufig verwendete Matcher hinzu. (Ie5cec)

Version 1.3.0-alpha03

30. Oktober 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha03 wird veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.

Neue Funktionen

• Fügen Sie der Testbibliothek (Id1110) LayoutElementAssertionsProvider, LayoutElementAssertion und LayoutElementMatcher hinzu.

Version 1.3.0-alpha02

16. Oktober 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha02 wird veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.

Neue Funktionen

• Erste Version der Material 3-Bibliothek. Enthält text-, edgeButton-, buttonGroup- und primaryLayout-Komponenten.

Behebung von Sicherheitsproblemen

• Seit dieser Änderung wird androidx mit protobuf 4.28.2 kompiliert, um CVE-2024-7254 zu beheben. Aktualisieren Sie die Abhängigkeit von Version 1.3.0-alpha01 von androidx.wear.protolayout:protolayout-proto und androidx.wear.protolayout:protolayout-external-protobuf auf 1.3.0-alpha02, um das Sicherheitsrisiko zu beheben.

Externer Beitrag

Version 1.3.0-alpha01

2. Oktober 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha01 wird veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

• Es wurde klargestellt, dass die Verfügbarkeit der Namen der Schriftfamilien „Roboto“ und „Roboto Flex“ von den Geräten abhängt. (I193be)
• Die Schriftfamilie „Roboto Flex“ wurde im AndroidX-Kachel-Renderer aktiviert. (I08e94)

Version 1.2

Version 1.2.1

16. Oktober 2024

androidx.wear.protolayout:protolayout-*:1.2.1 wird veröffentlicht. Version 1.2.1 enthält diese Commits.

Behebung von Sicherheitsproblemen

• Seit dieser Änderung wird androidx mit protobuf 4.28.2 kompiliert, um CVE-2024-7254 zu beheben. Aktualisieren Sie die Abhängigkeit von Version 1.2.0 von androidx.wear.protolayout:protolayout-proto und androidx.wear.protolayout:protolayout-external-protobuf auf Version 1.2.1, um das Sicherheitsrisiko zu beheben.

Version 1.2.0

7. August 2024

androidx.wear.protolayout:protolayout-*:1.2.0 wird veröffentlicht. Version 1.2.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.1.0

• FontStyle wurde aktualisiert und bietet jetzt zusätzliche Schriftartenunterstützung für die variablen Achsen sowie eine bessere API für die Schriftartenauswahl, um zukünftige Flex-Schriftarten zu unterstützen.
• Zusätzliche Modifikatoren werden unterstützt:
  • Transformations-Modifikator mit Verschiebung, Drehung und Skalierung mit oder ohne Animationen.
  • Sie können für jeden Eckradius unterschiedliche Werte (horizontal und vertikal) angeben.
• Die Barrierefreiheit aller Berührungsziele wurde verbessert, indem der anklickbare Bereich aller Elemente, die den Modifikator „Anklickbar“ verwenden, auf mindestens 48dp × 48dp erweitert wurde.
• PrimaryLayout und EdgeContentLayout wurden durch setResponsiveContentInsetEnabled verbessert, um das responsive Verhalten dieser Layouts auf verschiedenen Bildschirmgrößen besser zu unterstützen und die Einheitlichkeit von Ansichten zu verbessern.
• Verbesserte Skalierung/Nicht-Skalierung des Material-Texts für die nicht lineare Schriftskalierung von Android 14.
• Verbesserte Unterstützung für die linksläufige Layoutrichtung bei allen Bogenelementen.

Weitere Änderungen

• Eine vollständige Liste der Änderungen in Version 1.1.0 finden Sie in den Versionshinweisen für Beta 0.1.

Version 1.2.0-rc01

24. Juli 2024

androidx.wear.protolayout:protolayout-*:1.2.0-rc01 wird veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.

Fehlerkorrekturen

• Wir haben den Standard-Material-Chip so angepasst, dass er nur dann als Symbol verwendet werden kann, wenn kein primäres oder sekundäres Label übergeben wird. (Iceef9)
• Die Dokumentation zu Material-Layouts wurde aktualisiert und enthält jetzt Visualisierungen von der entsprechenden Seite, um die Layouts besser verständlich zu machen. (I0256a)

Version 1.2.0-beta01

10. Juli 2024

androidx.wear.protolayout:protolayout-*:1.2.0-beta01 wird veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.

Neue Funktionen

Die Version 1.2.0-beta01 von Wear ProtoLayout gibt an, dass diese Version der Bibliothek funktionsfähig ist und die API gesperrt ist (außer wenn sie als experimentell gekennzeichnet ist). Wear ProtoLayout 1.2 enthält die folgenden neuen Funktionen und APIs:

• FontStyle wurde aktualisiert und unterstützt jetzt folgende zusätzliche Schriftarten:
  • Unterschiedliche Schriftvarianten festlegen, z. B. FontSetting.weight und FontSetting.width
  • Für alle Ziffern dieselbe Breite festlegen – Tabellenziffern (FontSetting.tnum-Schriftfunktionseinstellung)
  • Die APIs zur Schriftauswahl wurden verbessert, um die kommenden Flex-Schriftarten zu unterstützen. Dazu können bevorzugte Schriftfamiliennamen angegeben werden.
• Erweiterter Corner-Modifikator, mit dem sich für jeden CornerRadius ein separater horizontaler und vertikaler Wert angeben lässt, um Gebäudeelemente mit asymmetrischen Ecken zu erstellen.
• Es wurde ein neuer Transformation-Modifikator hinzugefügt, mit dem LayoutElement verschoben, gedreht und skaliert werden kann. Diese Transformationen können mithilfe dynamischer Werte animiert werden.
• Allen Bogenelementen (Arc, ArcLine und ArcText) wurde setArcDirection mit den Optionen Clockwise, CounterClockwise und Normal hinzugefügt, um die Unterstützung in verschiedenen Layoutrichtungen (z. B. LTR und RTL) zu verbessern.
• Die Barrierefreiheit aller Berührungsziele wurde verbessert, indem der berührbare Bereich aller Elemente, die die Clickable-Modifikatortaste verwenden, auf mindestens 48dp × 48dp erweitert wurde.
• PrimaryLayout und EdgeContentLayout wurden durch setResponsiveContentInsetEnabled verbessert, um das responsive Verhalten dieser Layouts auf verschiedenen Bildschirmgrößen besser zu unterstützen und die Einheitlichkeit von Ansichten zu verbessern. Es wurde eine Linter-Warnung hinzugefügt, die die Verwendung dieser APIs mit einer schnellen Lösung vorschlägt.
• Verbesserte Skalierung/Nicht-Skalierung des Material-Text für die nicht lineare Schriftskalierung von Android 14.

API-Änderungen

• Der Standardname der Schriftfamilie (DEFAULT_SYSTEM_FONT) wird entfernt, da er impliziert, dass die preferredFontFamilies API nicht verwendet wird. (I39dab)
• Der an FontSetting.width übergebene Parameter muss positiv sein. (I1266f)

Version 1.2.0-alpha05

26. Juni 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha05 wird veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.

Neue Funktionen

• Fügen Sie Material.CompactChip die Methode hasText hinzu, um zu prüfen, ob der Textinhalt festgelegt wurde. (I6e8fc)

API-Änderungen

• FontFamily const-Konstanten werden in FontStyle anstelle der Builder-Klasse verschoben. (I06ced)
• Aktualisieren Sie die FontSetting.weight- und FontSetting.width-API, um Bereichsanmerkungen einzubeziehen, und ändern Sie den Parameter „weight“ in „int“. (Ia726c)

Fehlerkorrekturen

• Nicht skalierbare Texte in der Material Library funktionieren jetzt richtig mit der nicht linearen Schriftskalierung von Android 14. (I6601e)

Version 1.2.0-alpha04

29. Mai 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha04 wird veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.

API-Änderungen

• Die API für asymmetrische Ecken wurde hinzugefügt, um den Radius jeder Ecke mit zwei Werten separat angeben zu können. (Icbd69)
• Die FontSetting API wurde um folgende Funktionen erweitert:
  • Schriftarteinstellungen, z. B. die Einstellung der Schriftart als Tabellenschrift (If12b7)
  • Schriftartvarianteneinstellungen, z. B. die benutzerdefinierte Breite für variable Schriftarten (I2b36d)
• Die Schriftfamilien-API wurde der FontStyle hinzugefügt, um eine Bestellliste der zu verwendenden Schriftfamilien angeben zu können. (Iba9f5)
• Die Konstanten für die Höhe des Abstands zwischen Inhalt und sekundärem Label in LayoutDefaults von Material wurden umbenannt. Sie hatten ursprünglich den Präfix „Edge content“ (Randinhalt), um allgemeiner zu sein, da sie sowohl auf PrimaryLayout als auch auf EdgeContentLayout angewendet werden können. (I4dc32)

Fehlerkorrekturen

• Die Benennung der Achsen für variable Schriftarten wurde von axisName in axisTag geändert. (I02ba3)

Version 1.2.0-alpha03

14. Mai 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha03 wird veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.

Neue Funktionen

• API zum Festlegen benutzerdefinierter Gewichtswerte für FontStyle hinzugefügt (I7390a)

Fehlerkorrekturen

• Fehler in getTouchDelegateInfo aufgrund einer leeren Zielkarte beheben (I2accf)

Version 1.2.0-alpha02

1. Mai 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha02 wird veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.

API-Änderungen

• Es ist jetzt möglich, das Welleneffekt-Feedback für einzelne anklickbare Elemente zu deaktivieren. (If1ede)
• Die API für die Transformation wurde aus ArcModifiers entfernt, da diese Funktion dort nicht unterstützt wird (Ic0827)
• ArcDirectionProp Der Builder erwartet jetzt einen Wert im Konstruktor. (I76ada)
• Mit der Methode PlatformDataValues.Builder.putAll können Sie eine PlatformDataValue in eine andere zusammenführen. (I50ba3)
• Text#setIsScalable wird in Text#setScalable umbenannt. (If920e)
• Mit Material Text kann festgelegt werden, ob eine skalierbare Größe verwendet werden soll (wächst, wenn die Schriftgröße des Nutzers geändert wird). (Ibc849)
• Wir haben die Option hinzugefügt, die Inhaltsbeschreibung auf TitleChip festzulegen. (I5d21f)
• CompactChip funktioniert jetzt auch nur mit Symbol richtig. Außerdem wurde die API aktualisiert, um diese Option zuzulassen. (I6589e)

Fehlerkorrekturen

• Ein Problem mit potenziell doppelten Plattformdaten während der Initialisierung wurde behoben. (Iba0fd)
• Einen neuen Getter für DynamicDataNode einführen, um die Knotenkosten abzurufen. Die Kosten werden beim Erwerb eines dynamischen Knotenkontingents verwendet. Derzeit haben Knoten mit festen Werten eine Kostenpauschale von 0, alle anderen Knoten eine Kostenpauschale von 1. (Ia33e1)
• Entfernen Sie die Zähllogik aus den NO_OP_QUOTA_MANAGER. (Ib50b8)
• Wir haben eine Lint-Regel hinzugefügt, die eine Warnung meldet, wenn PrimaryLayout ohne setResponsiveContentInsetEnabled verwendet wird, und eine schnelle Lösung anbietet. (I12025)
• Die Anzahl der Knoten für dynamische Ausdrücke ist begrenzt. (Iffae8)

Version 1.2.0-alpha01

6. März 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha01 wird veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.

Neue Funktionen

• ProtoLayout Arc-Elementen kann jetzt ArcDirection (Clockwise, Counterclockwise oder Normal) hinzugefügt werden. Wenn Sie dieses Verhalten Arc, ArcLine oder ArcText hinzufügen, wird das Verhalten in RTL-Layouts korrigiert. (I90699)
• EdgeContentLayout wurde mit einem neuen setResponsiveContentInsetEnabled-Setter aktualisiert, um eine bessere Ausrichtung mit den UX-Richtlinien zu erreichen. Außerdem wurde die Konsistenz der Ansichten verbessert, indem das primäre Label an der festen Position oben und ein responsiver Einzug für Labels verwendet wird. (I60175)
• Wir haben PrimaryLayout.setResponsiveContentInsetEnabled hinzugefügt, um dem primären Label, dem sekundären Label und dem Chip unten in diesem Layout einen responsiven Einzug hinzuzufügen, damit die Inhalte nicht über den Bildschirmrand hinausragen. (I0c457)
• Es wurde eine Methode hinzugefügt, mit der die äußeren Ränder von CircularProgressIndicator entfernt werden können, damit es als kleinere Komponente verwendet werden kann. (I55c06)

API-Änderungen

• Der Tiles-Renderer schließt jetzt standardmäßig den Schriftabstand bei allen Textelementen aus, ohne dass es eine Option zum Einschließen gibt. (I3e300)

Fehlerkorrekturen

• Ein Problem mit der Textausrichtung wurde behoben, das auftrat, wenn Text elliptisch dargestellt, der Buchstabenabstand angepasst und der Text zentriert ausgerichtet wurde. (I716c7)
• Eine Problemumgehung für ein Problem beim Skia-Bogenzeichnen hinzugefügt. (I08f09)
• Die Zeichenrichtung von ArcLine für linksläufige Layouts korrigieren (I6c141)

Version 1.1

Version 1.1.0

7. Februar 2024

androidx.wear.protolayout:protolayout-*:1.1.0 wird veröffentlicht. Version 1.1.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.0.0

• Unterstützung von Farbverläufen und bessere Darstellung von Längen über 360 Grad in ArcLine.
• Die Datums- und Uhrzeitformatierung unterstützt verschiedene Zeitzonen für dynamische Datentypen.
• Bessere Optionen für die automatische Textgröße und den Textausschnitt, um abgeschnittenen Text zu verarbeiten.
• Spacer unterstützt erweiterte Abmessungen mit optionalem Gewicht.
• Anmerkung zur Schemaversionsanforderung für alle ProtoLayout APIs.
• Der Zielbereich für alle Clickable-Elemente wurde auf 48 × 48 dp erweitert, um die Anforderungen an die Barrierefreiheit zu erfüllen.
• Die Textabstände sind standardmäßig deaktiviert und gelten für alle Textelemente und Materialkomponenten, die Text enthalten.

Weitere Änderungen

• Eine vollständige Liste der Änderungen in Version 1.1.0 finden Sie in den Versionshinweisen für Beta 01.

Version 1.1.0-rc01

24. Januar 2024

androidx.wear.protolayout:protolayout-*:1.1.0-rc01 wird veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Fehlerkorrekturen

• PlatformTimeUpdateNotifierImpl wird sofort nach dem Aktivieren des Updates angeklickt. (I77145)
• CircularProgressIndicator wurde für linksläufige Layouts korrigiert. Ab sofort wird in allen Fällen im Uhrzeigersinn gezählt. (I95ee3)
• Eine Problemumgehung für ein Problem beim Skia-Bogenzeichnen hinzugefügt. (I08f09)

Version 1.1.0-beta01

10. Januar 2024

androidx.wear.protolayout:protolayout-*:1.1.0-beta01 wird veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

Neue Funktionen

Die Version 1.1.0-beta01 von Wear ProtoLayout gibt an, dass diese Version der Bibliothek funktionsfähig ist und die API gesperrt ist (außer wenn sie als experimentell gekennzeichnet ist). Wear ProtoLayout 1.1 enthält die folgenden neuen Funktionen und APIs:

• ArcLine unterstützt jetzt einen Farbverlauf, indem Brush mit SweepGradient kombiniert wird. Außerdem gibt es einen Schatten am Abschluss, um Längen über 360 Grad besser darzustellen. Dazu wird Shadow zur vorhandenen StrokeCap hinzugefügt.
• DynamicInstant unterstützt die Datums-/Uhrzeitformatierung mit Zeitzone. DynamicInstant und DynamicDuration können als Status- oder Plattformdatentypen verwendet werden.
• Mit der Funktion „Automatische Größenanpassung“ für die Textgröße können Sie mehrere Größen für FontStyle.setSizes festlegen. Die Textgröße wird dann automatisch an den verfügbaren Platz im übergeordneten Element angepasst. Außerdem haben wir die Optionen für den Auslassungspunkt bei Text, der überläuft, verbessert. Dazu haben wir TEXT_OVERFLOW_ELLIPSIZE hinzugefügt und TEXT_OVERFLOW_ELLIPSIZE_END eingestellt.
• Spacer unterstützt jetzt erweiterte Dimensionen mit optionalem Gewicht. Für die Erstellung von ExpandedDimensionProp haben wir die Hilfsmethode DimensionBuilders.weight hinzugefügt.
• Unterstützung für das dynamische Ausblenden und Einblenden von Layoutelementen mit Modifier.visible. Dazu gehören auch dynamische Werte in BoolProp.
• Alle ProtoLayout APIs haben jetzt eine Anmerkung zur Schemaversionsanforderung und die Version kann geprüft werden, bevor eine neuere API aufgerufen wird.
• Das Zielbereichs-Attribut Clickable wird jetzt im Renderer auf mindestens 48 × 48 Pixel erweitert, um die Anforderungen an die Barrierefreiheit besser zu erfüllen.
• Ähnlich wie bei anderen Material-Komponenten und Compose-Initiativen haben wir jetzt standardmäßig das Schriftabstand für alle Text-Elemente deaktiviert. Außerdem wurden AndroidTextStyle und zugehörige Setter aus der öffentlichen API entfernt. Folgende Fehler wurden behoben:
• Es wurde ein Setter hinzugefügt, mit dem sich die Position des Seitenrand-Inhalts in EdgeContentLayout so festlegen lässt, dass er vor anderen Inhalten erscheint.
• Es wird immer eine Ausnahme ausgelöst, wenn ein unbekannter ENUM-Wert gefunden wird.
• Das Ergebnis eines Ausdrucks wird ungültig, wenn er einen ungültigen numerischen Wert (NaN oder unendlich) ergibt oder eine ArithmeticException auslöst.

API-Änderungen

• Die SweepGradient API wurde aktualisiert, sodass im Konstruktor entweder Farben oder ColorStops akzeptiert werden können. (I6676f)

Fehlerkorrekturen

• Es wurde eine eingeschränkte API und Renderer-Unterstützung hinzugefügt, um die Richtung festzulegen, in der Bogenelemente gezeichnet werden. (Idef5a)
• Wenn RoundMode nicht angegeben wird, ist der Standardwert Floor in FloatToInt32Node. Der Knoten löst weiterhin eine Ausnahme aus, wenn die angegebene RoundMode nicht erkannt wird. (I1b2d8)

Version 1.1.0-alpha04

13. Dezember 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha04 wird veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.

Neue Funktionen

• Die Klasse VersionInfo implementiert nicht die Schnittstelle Comparable. (I8d13c)
• Der Renderer unterstützt jetzt die Option TEXT_OVERFLOW_ELLIPSIZE. (I7f085)

API-Änderungen

• Die Option „Textüberlauf“ TEXT_OVERFLOW_ELLIPSIZE_END wird nicht mehr unterstützt. Verwenden Sie stattdessen die neue API TEXT_OVERFLOW_ELLIPSIZE, die sehr ähnlich funktioniert. (I822d8)
• Ähnlich wie bei anderen Material-Komponenten und Compose-Initiativen haben wir jetzt standardmäßig das Schriftfeld für alle Textelemente deaktiviert. Außerdem wurden AndroidTextStyle und die zugehörigen Setter aus der öffentlichen API entfernt. (I79094, Ib0b03, I32959, Iaf7d5, Ifa298, I0a4ae, Ida9d3)
• Modifier.hidden wird durch Modifier.visible ersetzt (I56902)
• Für FontStyle#setSizes werden jetzt Ganzzahlargumente anstelle von SpProp-Argumenten akzeptiert. (I02b37)

Fehlerkorrekturen

• Löst eine Ausnahme aus, wenn ein nicht definierter oder nicht erkannter Enum-Wert gefunden wird. (I9d2cf)
• Refaktorieren Sie DynamicTypeBindingRequest. (I27b57)
• Das Ergebnis eines Ausdrucks wird ungültig, wenn er einen ungültigen numerischen Wert (NaN oder unendlich) ergibt oder eine ArithmeticException auslöst. (I681ae)

Version 1.1.0-alpha03

29. November 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha03 wird veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.

Neue Funktionen

• Experimentelle Unterstützung für das dynamische Ausblenden/Einblenden von Layoutelementen hinzugefügt (I64a78)
• Unterstützung für dynamische Werte für BoolProp hinzufügen (I2fe96)
• ProtoLayout-APIs Anmerkung zur Schemaversionsanforderung hinzufügen (I0f03c)
• Die API wurde um die neue Option in TextOverflow erweitert, mit der Text in einem festen übergeordneten Container durch Ellipsen ersetzt werden kann, auch wenn die maximale Anzahl von Zeilen nicht erreicht wird, aber nicht genügend Platz für den Text vorhanden ist. (I110a9)
• Hilfsmethode DimensionBuilders.weight zum Erstellen von ExpandedDimensionProp mit Gewicht hinzugefügt. (I4f72b)
• DynamicInstant und DynamicDuration können als Status- oder Plattformdatentypen verwendet werden. (I6819f)

API-Änderungen

• API aktualisieren, um DynamicZonedDateTime auszublenden und alle Vorgänge zu DyanamicInstant zu verschieben (I34b94)
• Für Spacer wird jetzt die erweiterte Dimension für Breite/Höhe unterstützt. (Ie7c94)
• Unterstützung der Erweiterung des Klickzielbereichs im Renderer (I39c79)

Version 1.1.0-alpha02

15. November 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha02 wird veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.

Neue Funktionen

• Der API wurde ein Feld vom Typ ArcLine StrokeCap Shadow hinzugefügt. (I830ec)
• Die API wurde erweitert, damit die Breite oder Höhe des Spacer-Elements angegeben werden kann. (I757ca)
• Wir haben eine experimentelle API hinzugefügt, mit der die Textgröße automatisch an den verfügbaren Platz im übergeordneten Element angepasst wird. (Ibbe63)
• Mindestgröße für anklickbare Elemente unterstützen (I178e3)
• Unterstützung für StrokeCap Shadow hinzugefügt. (I48b17)
• Unterstützung für den Renderer für den Farbverlauf „Sweep Gradient“ in ArcLine hinzufügen (I4d5bb)

Version 1.1.0-alpha01

18. Oktober 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha01 wird veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

Neue Funktionen

• Arcline wurde eine Pinseloption mit Unterstützung für SweepGradient hinzugefügt. (Ie7ce3)
• Unterstützung für die Datums- und Uhrzeitformatierung nach Zeitzone hinzugefügt. (Ibfae0)
• Es wurden Proto- und Java-Wrapper hinzugefügt, die für die Datums- und Uhrzeitformatierung mit Zeitzone erforderlich sind. (I97126)
• Es wurden Getter hinzugefügt, um den in einem DynamicDataValue gespeicherten Wert abzurufen. (Ie6cea)
• Es wurde ein Setter hinzugefügt, mit dem sich die Position des Seitenrand-Inhalts in EdgeContentLayout so festlegen lässt, dass er vor anderen Inhalten erscheint. (Ie8e8a)

Fehlerkorrekturen

• Ein Problem wurde behoben, durch das ein Ausdruck mit mehreren Zeitdatenquellenregistrierungen nicht sofort aktualisiert wurde. (I8e1a8)
• Ein Fehler wurde behoben, durch den das Stammelement bei Diff-Aktualisierungen nicht zentriert wurde. (Ie48f7)
• Nicht festgelegte (oder leere) Werte für Layouteinschränkungen werden nicht mehr ignoriert. (Ibc785)
• Verringerte Verzögerung zwischen dem Sichtbarwerden eines Layouts und der Initialisierung seiner Pipelineknoten. (I38d4e)

Version 1.0

Version 1.0.0

9. August 2023

androidx.wear.protolayout:protolayout-*:1.0.0 wird veröffentlicht. Version 1.0.0 enthält diese Commits.

Wichtige Funktionen von 1.0.0

Die ProtoLayout-Bibliothek bietet APIs zum Erstellen von Layouts und Ausdrücken, die auf verschiedenen Wear OS-Oberflächen verwendet werden können. Die Tiles-Bibliothek verwendet diese APIs beispielsweise, um die Plattformdatenbindung (für schnellere Aktualisierungen von Kacheln) und Animationen zu unterstützen.

Version 1.0.0-rc01

26. Juli 2023

androidx.wear.protolayout:protolayout-*:1.0.0-rc01 wird veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

• Eine Anleitung zur Migration von Google Pixel Tablet mit Google Pixel Tablet mit Android 12 auf ProtoLayout finden Sie hier.

API-Änderungen

• Die Methoden setLayoutConstraintForDynamicAnchorAngle und getLayoutConstraintForDynamicAnchorAngle wurden aus dem Arc-Element entfernt. Diese Methoden wurden versehentlich hinzugefügt und hatten keine Auswirkungen auf das bereitgestellte Layout. (If7d01)
• Wir haben die maximale Tiefe des Layouts einer ProtoLayout auf 30 verschachtelte LayoutElements beschränkt. (I8a74b)

Fehlerkorrekturen

• Wir haben eine Prüfung hinzugefügt, die ausgelöst wird, wenn DynamicColor für eine SpanText festgelegt wurde. (I0e5bc)
• Es wird klargestellt, dass die Maßeinheit der Datenquelle DAILY_CALORIES kcal ist. (Iaa785)

Version 1.0.0-beta01

21. Juni 2023

androidx.wear.protolayout:protolayout-*:1.0.0-beta01 wird veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

Neue Funktionen

• Einstellung der Uhr für zeitgebundene Tests zulassen (I05622)

API-Änderungen

• PlatformDataReceiver.onData() und StateBuilders.Builder.addKeyToValueMapping akzeptieren jetzt keine unsicheren Generiken mehr, sondern eine typsichere Zuordnung von DynamicDataKey zu DynamicDataValue. Das bedeutet, dass DynamicDataValue jetzt mit DynamicType eingegeben wird. HEART_RATE_ACCURACY_X-Konstanten wurden an den Stamm von PlatformHealthSources verschoben, um der Positionierung anderer Android-Konstanten zu entsprechen. HEART_RATE_ACCURACY_X-Intkonstanten werden jetzt direkt in DynamicHeartRateAccuracy.constant() und DynamicHeartRateAccuracy.dynamicDataValueOf() anstelle von Wertkonstanten verwendet. (I82ff5)
• Die Klasse PlatformHealthSources.Constants kann fälschlicherweise instanziiert werden. Dieses Problem wurde inzwischen behoben. (Icb849)
• PlatformTimeUpdateNotifier#setReceiver empfängt jetzt die Funktion Runnable anstelle von Supplier und Executor als Benachrichtigungsziel. (I9d938)
• Wir haben den Parametertyp in PlatformTimeUpdateNotifier#setReceiver von Callable in Supplier geändert. (I664bf)
• CompactChip und TitleChip unterstützen jetzt das Hinzufügen eines Symbols. (I5a01e)

Fehlerkorrekturen

• Aktualisieren Sie Prop-Nachrichten mit dynamischen Feldern, um stattdessen „oneof“ zu verwenden (I81739)
• Implementierung von Settern für Überladungen mit Settern wiederverwenden (Ied70c)
• Fingerabdrücke in Settern mit Überladungen korrekt aufzeichnen (I86ed2)

Version 1.0.0-alpha11

7. Juni 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha11 wird veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.

Neue Funktionen

• Wir haben ein PlatformDataKey für die Genauigkeit der Herzfrequenz hinzugefügt. (I7f9b8)

API-Änderungen

• Benennen Sie StateBuilders#getIdToValueMapping in getKeyToValueMapping um und ändern Sie den Rückgabetyp in Map<<AppDataKey<?>,DynamicDataValue>. (Iaa7ae)
• StateStore in einen Abschlusskurs umwandeln (I408ca)
• Die TimeGateway-Benutzeroberfläche wurde in der protolayout-expression-pipeline-Bibliothek durch PlatformTimeUpdateNotifier ersetzt, die die gewünschte Häufigkeit für die Aktualisierung von Zeitdaten angibt. (I60869)
• register/unregisterForData in PlatformDataProvider in set/clearReceiver umbenennen (I14b02)
• In Material Text wurde getExcludeFontPadding in hasExcludeFontPadding umbenannt. (Iea01d)
• Allen Chipkomponenten wurde ein Einsteller für die perfekte Ausrichtung des Labels hinzugefügt. Auf alle Chips wird jetzt ein Mindestziel für das Tippen angewendet. (I8ae92)
• LayoutDefaults#BUTTON_MAX_NUMBER wurde in MAX_BUTTONS umbenannt. (I84788)
• DAILY_DISTANCE wird in DAILY_DISTANCE_M umbenannt. (I4f758)

Fehlerkorrekturen

• Die Dokumentation zu Property-Typen wurde aktualisiert, um zu erläutern, warum ein statischer Wert erzwungen wird. Geben Sie den Standardwert an, der verwendet wird, wenn kein statischer Wert angegeben wurde. (I155aa)
• PlatformDataKey Namespaces sollten Java-Namenskonventionen folgen. (I47bda)

Version 1.0.0-alpha10

24. Mai 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha10 wird veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

Neue Funktionen

• Fügen Sie AppDataKey für den Zugriff auf den von der App gesendeten Status hinzu. Fügen Sie PlatformDataKey für den Zugriff auf Plattformdaten hinzu. Fügen Sie in StateStore Namespaceunterstützung hinzu. (I7985e)
• Unterstützung von Equal- und NotEqual-Vorgängen für DynamicBool. (I6a0c1)

API-Änderungen

• Der Kurs FontStyles ist jetzt abgeschlossen (Iaa2ea).
• LayoutElementBuilders#FontStyles wurde eingestellt. Verwenden Sie androidx.wear.protolayout.Typography oder erstellen Sie eine eigene FontStyle. (Ic929b)
• Versteckt die verschachtelte Action#Builder-Benutzeroberfläche in der Action-Benutzeroberfläche. Implementierungen von Builder werden bereits von den Klassen LoadAction und LaunchAction bereitgestellt. (I1d70c)
• Verwenden von DynamicFloat mit FloatProp zulassen Für FloatProp sind keine Layouteinschränkungen erforderlich, da es nicht als Prop zum Ändern des Layouts verwendet wird. (I286ac)
• Die Aktionen LoalAction und SetStateAction wurden entfernt, da sie noch nicht wirklich unterstützt wurden. (I5d6a6)
• Unterstützung für das ARGB_8888-Format für Inline-Bildressourcen hinzugefügt. (I8a07c)
• Benennen Sie StateEntryValue in DynamicDataValue um und aktualisieren Sie die Status-APIs, damit sie DynamicDataKey (If1c01) verwenden.
• Wir begrenzen die Anzahl der Einträge, die in der StateStore zulässig sind, um sicherzustellen, dass die Speichernutzung und die Zeit für die Statusaktualisierung für jede Instanz der StateStore gut begrenzt und kontrolliert werden. Daher muss der Entwickler darauf achten, dass die Karte nicht mehr als MAX_STATE_ENTRY_COUNT Einträge enthält. Andernfalls wird beim Erstellen oder Aktualisieren der StateStore eine IllegalStateException ausgegeben. (Ibadb3)
• Blenden Sie die Klassen OnLoadTrigger und OnConditionMetTrigger aus und benennen Sie setTrigger in setCondition für OnConditionMetTrigger um. (Ibf629)
• Aus Leistungs- und Kompatibilitätsgründen unterstützen die ProtoLayout-Renderer nicht alle Funktionen in AnimatedVectorDrawable-Ressourcen. Diese APIs werden als experimentell gekennzeichnet, bis wir die unterstützten APIs definieren können. (Ic6daf)
• Es wurden dynamische Typen für die zurückgelegte Strecke, die verbrannten Kalorien und die bewältigten Stockwerke pro Tag hinzugefügt. Schlüssel für Quellen zur Plattformintegrität sind jetzt unter PlatformHealthSources.Keys (Ib7637) zu finden.
• Die Methode Easing.cubicBezier ersetzt die CubicBezierEasing.Builder. Die Klasse EasingFunction wird entfernt und die Ease-Konstanten aus dieser Klasse sind jetzt direkt über die Easing-Benutzeroberfläche zugänglich. Außerdem wird setInfiniteRepeatable durch INFINITE_REPEATABLE_WITH_RESTART und INFINITE_REPEATABLE_WITH_REVERSE ersetzt (Ib41e7).
• Implementiere PlatformDataProvider, um Herzfrequenz und tägliche Schrittzahl anzugeben. Die SensorGateway-Benutzeroberfläche wird aus der öffentlichen API entfernt. (I55b84)
• Fügen Sie PlatformDataProvider hinzu und aktualisieren Sie StateStore, damit es bei PlatformDataProvider registriert wird, wenn der unterstützte Schlüssel des Anbieters vom Knoten aus der Ausdruckspipeline benötigt wird. (Ib616a)
• SensorGateway ist nicht mehr Closeable, da es keinen Status mehr beibehält. (I6b4f7)
• Verwendung von FloatProp mit DynamicFloat für den Fortschritt in CircularProgressIndicator zulassen Dies wird für Renderer unterstützt, die Version 1.2 unterstützen. Alte Renderer greifen auf staticValue zurück, falls angegeben, andernfalls auf 0 (I0d91b).
• Die MultiButtonLayout-Konstanten wurden in die LayoutDefaults.MultiButtonLayoutDefaults-Klasse verschoben, die jetzt die Schaltflächengrößen enthält, die von der Anzahl der Schaltflächen im Layout abhängen. (I13973)
• Unterstützung der Verwendung von StringProp mit DynamicString in Material Text Dies wird für Renderer unterstützt, die Version 1.2 unterstützen. Bei älteren Renderern wird der bereitgestellte statische Wert verwendet. Aktualisieren Sie den Rückgabetyp von Text#getText von String auf StringProp. (I7275b)

Version 1.0.0-alpha09

10. Mai 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha09 wird veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.

Neue Funktionen

• Wir haben ein experimentelles Layoutelement für Erweiterungen hinzugefügt. Hinweis: Dieses Element kann nicht standardmäßig verwendet werden und erfordert eine Renderererweiterung, die das Layoutelement verarbeiten kann. (I6581d)
• Unterstützung für StrokeCap für ArcLine hinzugefügt (I94951)
• Unterstützung für den bedingten Instant-Vorgang hinzugefügt. (I489a7)
• Unterstützung für den Vorgang „Bedingte Dauer“ hinzugefügt (Iab469)
• Es ist jetzt möglich, die Dauer in Sekunden anzugeben. (Ib5fa1)

API-Änderungen

• enable/disablePlatformSource-Methoden wurden aus DynamicTypeEvaluator entfernt. Der Anrufer sollte für Updates verantwortlich sein. (I78c6d)
• Größe gebundener Datentypen begrenzen (Ie2966)
• Unterstützung für die Beschreibung dynamischer Inhalte in protolayout-material hinzufügen (I62c8e)
• Verwenden Sie „long“ und @IntRange für Dauer und Verzögerung in „AnimationParameters“. (I388b6)

Version 1.0.0-alpha08

19. April 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha08 wird veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

Neue Funktionen

• AndroidTextStyle wurde zu LayoutElementBuilders hinzugefügt. (I8d967)
• Wir haben die Unterstützung für das Ausschließen von Schriftabständen in ProtoLayout Material Text hinzugefügt. (I17f5d)
• ARGB_8888 wird jetzt für Inline-Bilder unterstützt. (I18c1e)
• DynamicColor unterstützt jetzt den Vorgang onCondition. (I10927)

API-Änderungen

• Unterstützung für benutzerdefinierte Dauer für Rückwärtsanimation (I3251f)
• Wir haben den Modifikator SemanticDescription hinzugefügt. Außerdem kann ContentDescription nicht gebunden werden. (I3f1d)
• Die Methode DynamicBool.isFalse() wird jetzt durch DynamicBool.negate() ersetzt und DynamicBool.isTrue() wird entfernt. Außerdem führen NaN-DynamicFloat-Werte und die Einschränkung eines DynamicInt32 auf einen DynamicFloat jetzt zu einem ungültigen dynamischen Ergebnis. (I6ac1e)
• Bei Ganzzahl- und Gleitkommaformatierern wird jetzt das Builder-Muster verwendet. (Ieb213)

Fehlerkorrekturen

• Der statische Fallbackwert wurde aus animierbaren Feldern entfernt. (Ifcb01)
• DynamicTypeValueReceiver#onPreUpdate wurde entfernt. (I2dc35)
• Die Länge von Strings in dynamischen Ausdrücken ist jetzt begrenzt. (I4c93)
• Die Gradle-Abhängigkeiten sind jetzt bei Bedarf korrekt auf api anstelle von implementation festgelegt. (I40503)

Version 1.0.0-alpha07

5. April 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha07 wird veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

Neue Funktionen

• Unterstützung für dynamische Werte für StringProp hinzufügen (I04342)
• Bindbare Layoutelemente kennzeichnen (Ia110b)

API-Änderungen

• sensorGateway#registerSensorGatewayConsumer nimmt den Datentyp als Parameter anstelle der Methode in Consumer an. (Icf314)
• ObservableStateStore wurde in StateStore umbenannt. (Ieb0e2)
• Anstelle von Konstruktorargumenten wurde DynamicTypeEvaluator.Builder hinzugefügt, um mehr optionale Argumente zuzulassen, darunter ObservableStateStore, das jetzt standardmäßig auf einen leeren Store verweist. (I6f832)
• Die Reihenfolge der Parameter in DynamicTypeEvaluator wurde überarbeitet. (Ic1ba4)

Fehlerkorrekturen

• Signale von Plattformsensorquellen korrekt an Downstream-Knoten weitergeben (I5a922)

Version 1.0.0-alpha06

22. März 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha06 wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Neue Funktionen

• Wir haben eine experimentelle API für die Verwendung von Herzfrequenz und täglichen Schritten in dynamischen Ausdrücken hinzugefügt (Ifd711).
• Wir haben die Unterstützung für Verzögerungen beim Rückwärts- und Vorwärtsspulen von Animationen hinzugefügt. (Ic25f7)
• Wir haben die Unterstützung von DynamicColor für Rahmen und Hintergrund hinzugefügt.
• Wir haben die Unterstützung für dynamische Werte für Typen in DimensionBuilder hinzugefügt.
• Layout und Komponenten von tiles-material werden in protolayout-material verschoben

API-Änderungen

• LoadActionListener wurde zu ProtoLayoutViewInstance hinzugefügt. (If7806)

Fehlerkorrekturen

• FloatNodesTest (Id7281) wurde hinzugefügt
• Renderer-Absturz beim Laden einer strukturierten Bitmap behoben

Version 1.0.0-alpha05

8. März 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha05 wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

• Wir haben dem Modifiers-Objekt eine experimentelle Animation für „Inhaltsaktualisierungen“ hinzugefügt. Diese Animation wird ausgelöst, wenn sich das Element (mit dieser Änderung) oder eines seiner untergeordneten Elemente während eines Layoutupdates ändert. (bd03e5d)

API-Änderungen

• Repeatable wurde forwardRepeatDelayMillis und reverseRepeatDelayMillis hinzugefügt. Außerdem haben wir delayMillis in AnimationSpec in startDelayMillis (Ifb266) umbenannt.
• Für DynamicTypeEvaluator.bind-Methoden kann jetzt ein Executor übergeben werden. (I346ab)
• Wir haben der BoundDynamicType die Methode startEvaluation hinzugefügt, um die Bewertung nach der Bindung des dynamischen Typs auszulösen. (I19908)

Fehlerkorrekturen

• Das Animator-Objekt wird für nachfolgende Animationen eines einzelnen Elements wiederverwendet. (Ia3be9)

Version 1.0.0-alpha04

22. Februar 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha04 wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

• ObservableStateStore benachrichtigt die Zuhörer jetzt auch, wenn ein Schlüssel entfernt wird.
• Wir haben DeviceParameters die Renderer-Schemaversion und die Schriftgradskala hinzugefügt. Damit können Layouts bedingt als Reaktion auf verschiedene Versionen und Schrifteinstellungen erstellt werden.
• Wir haben die Unterstützung für die Animation von DynamicInt32-Werten hinzugefügt (I05485)
• Wir haben OnLoad- und OnConditionalMet-Trigger hinzugefügt. Damit können Animationen gestartet werden, die einen Trigger unterstützen.
• Wir haben das Layoutgewicht für maximierte Abmessungen und die Mindestgröße für umgebrochene Abmessungen hinzugefügt.
• Wir haben die dynamischen Typen „Dauer“ und „Instant“ hinzugefügt. Sie können damit einen bestimmten Zeitpunkt oder eine bestimmte Dauer in einem dynamischen Ausdruck darstellen.
• Wir haben die Unterstützung für AnimatedVectorDrawable und SeekableAnimatedVectorDrawable als Layoutressourcen hinzugefügt.

API-Änderungen

• Für Sensordaten ist API 29 oder höher erforderlich. (I8099e)
• Wir haben zwei launchAction-Hilfsmethoden zum Starten von Aktivitäten hinzugefügt.

Fehlerkorrekturen

• Benennen Sie set/getSpec in der Kacheln-Animation in set/getAnimationSpec um (I3d74b).

Version 1.0.0-alpha03

8. Februar 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha03 wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

• Wir haben der Bibliothek „protolayout-express“ die dynamischen Typen toByteArray() und fromByteArray() hinzugefügt.
• Der dynamischen Typen in der Protolayout-Expression-Bibliothek wurde toString() hinzugefügt.
• Wir haben die Unterstützung für die Bewertung dynamischer Typen hinzugefügt. Mit der Klasse DynamicTypeEvaluator aus der protolayout-expression-pipeline-Bibliothek können Sie einen zuvor erstellten dynamischen Typ (DynamicString, DynamicFloat, …) auswerten und aktualisierte Werte erhalten.
• Wenn Animationen nicht wiedergegeben werden können (entweder weil sie vom Evaluator deaktiviert wurden oder die Anzahl der laufenden Animationen das festgelegte Limit erreicht hat), werden die für den animierbaren Knoten festgelegten statischen Werte verwendet, um die Animation zu ersetzen.

Version 1.0.0-alpha02

25. Januar 2023

androidx.wear.protolayout:protolayout:1.0.0-alpha02, androidx.wear.protolayout:protolayout-expression:1.0.0-alpha02 und androidx.wear.protolayout:protolayout-proto:1.0.0-alpha02 werden losgelassen. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

• Layout-Builder von androidx.wear.tiles:tiles werden zu androidx.wear.protolayout:protolayout verschoben. Die in androidx.wear.tiles:tiles werden in einem der nächsten Alpha-Releases eingestellt.

Version 1.0.0-alpha01

11. Januar 2023

androidx.wear.protolayout:protolayout-expression:1.0.0-alpha01 und androidx.wear.protolayout:protolayout-proto:1.0.0-alpha01 werden freigegeben. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

• In dieser Version wird die neue Bibliothek „ProtoLayout Expression“ eingeführt, mit der Ausdrücke aus dynamischen Variablen erstellt werden können.