Compose Foundation

Mit den einsatzbereiten Bausteinen können Sie Jetpack Compose-Anwendungen schreiben und die Grundlage erweitern, um eigene Designsystemkomponenten zu erstellen.
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alpharelease
2. Juli 2025 1.8.3 - 1.9.0-beta02 -

Struktur

Compose ist eine Kombination aus 7 Maven-Gruppen-IDs innerhalb von androidx. Jede Gruppe enthält eine bestimmte Teilmenge von Funktionen mit jeweils eigenen Versionshinweisen.

In dieser Tabelle werden die Gruppen erläutert und es sind Links zu den jeweiligen Versionshinweisen enthalten.

GruppeBeschreibung
compose.animationAnimationen in Jetpack Compose-Anwendungen erstellen, um die Nutzerfreundlichkeit zu verbessern.
compose.compiler@Composable-Funktionen transformieren und Optimierungen mit einem Kotlin-Compiler-Plug-in ermöglichen
compose.foundationMit den einsatzbereiten Bausteinen können Sie Jetpack Compose-Anwendungen schreiben und die Grundlage erweitern, um eigene Designsystemkomponenten zu erstellen.
compose.materialJetpack Compose-UIs mit einsatzbereiten Material Design-Komponenten erstellen Dies ist der Einstiegspunkt auf höherer Ebene für Compose. Er soll Komponenten bereitstellen, die den auf www.material.io beschriebenen Komponenten entsprechen.
compose.material3Mit Material Design 3-Komponenten, der nächsten Generation von Material Design, können Sie Jetpack Compose-UIs erstellen. Material 3 umfasst aktualisierte Designs und Komponenten sowie Material You-Personalisierungsfunktionen wie dynamische Farben. Es ist auf den neuen visuellen Stil und die System-UI von Android 12 abgestimmt.
compose.runtimeGrundlegende Bausteine des Programmiermodells und der Statusverwaltung von Compose sowie die Core-Laufzeit für das Compose Compiler-Plug-in.
compose.uiGrundlegende Komponenten der Compose-Benutzeroberfläche, die für die Interaktion mit dem Gerät erforderlich sind, einschließlich Layout, Zeichnen und Eingabe.

Abhängigkeiten deklarieren

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

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

Groovy

dependencies {
    implementation "androidx.compose.foundation:foundation:1.8.3"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.foundation:foundation:1.8.3")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

Feedback

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

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung.

Version 1.9

Version 1.9.0-beta02

2. Juli 2025

androidx.compose.foundation:foundation-*:1.9.0-beta02 wird veröffentlicht. Version 1.9.0-beta02 enthält diese Commits.

Neue Funktionen

  • Unterstützung von Smart-Elementen im Kontextmenü und in der Auswahlleiste.

API-Änderungen

  • Ein Fehler wurde behoben, bei dem der Cursor auf bestimmten Hardwaretastaturen oder TV-Fernbedienungen nicht mit den Richtungstasten in das neue TextFields bewegt wurde, sondern der Fokus stattdessen auf ein anderes Composable-Element verschoben wurde. ComposeFoundationFlag.isTextFieldDpadNavigationFixEnabled wurde hinzugefügt, damit Sie diese Korrektur vorübergehend deaktivieren können, wenn sie ein unerwünschtes Verhalten verursacht, das nicht behoben werden kann. (Ie1922)

Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das fixierte Kopfzeilen nicht fixiert wurden, wenn ein angepinntes Element vorhanden war. (I9198d, b/385006133)
  • TextObfuscationMode.RevealLastTyped folgt jetzt der Systemeinstellung „TEXT_SHOW_PASSWORD“. (I41c0c)
  • Ein Fehler wurde behoben, bei dem in BasicTextField fälschlicherweise die Warnung „Aus Zwischenablage eingefügt“ angezeigt wurde, wenn die Textsymbolleiste zum ersten Mal geöffnet wurde. (I5fda2)

Version 1.9.0-beta01

18. Juni 2025

androidx.compose.foundation:foundation-*:1.9.0-beta01 wird veröffentlicht. Version 1.9.0-beta01 enthält diese Commits.

Aktuelle Änderungen

  • Die Modifikator-Knoten background und border implementieren jetzt SemanticsModifierNode. Dies kann dazu führen, dass dem Semantikbaum neue SemanticsNodes hinzugefügt werden, was wiederum zu Testfehlern in Tests führen kann, die Annahmen über die Struktur des Semantikbaums treffen. Tests, in denen onChild, onParent, onSibling und ähnliche Methoden zum Erstellen von Zusicherungen verwendet werden, können beispielsweise fehlschlagen, wenn zwischen dem aktuellen und dem Zielknoten ein neuer Knoten hinzugefügt wird. Die bevorzugte Methode, diese Fehler zu beheben, besteht darin, dem Zielknoten direkt ein testTag hinzuzufügen. Eine weitere Möglichkeit ist die Verwendung eines weniger strengen Abgleichs, z. B. onNode(hasAnyAncestor(hasText(“ancestor”)) and hasText(“target”)). (I638b5)

API-Änderungen

  • Benennen Sie Modifier.addTextContextMenuComponents in appendTextContextMenuComponents um. (I4c43f)
  • Die Funktionen AnnotatedOutputTransformation und addStyle wurden entfernt und in TextFieldBuffer übernommen. addStyle kann weiterhin nur von OutputTransformation aufgerufen werden. (I9930a, b/417991824)
  • „Clickable“ wurde so umgeschrieben, dass die Eingabe des suspend-Zeigers nicht verwendet wird. Diese Funktion wird durch ein Flag aktiviert. Wenn Sie einen Fehler in der neuen Implementierung feststellen, können Sie sie deaktivieren: ComposeFoundationFlags.isNonSuspendingPointerInputInClickableEnabled. (I85b65)
  • isFlingCancellationWithNestedScrollFixEnabled wurde eingeführt, um ein Problem mit der Weitergabe von Fling-Gesten bei verschachteltem Scrollen zu beheben. In diesem CL wird das in aosp/3260391 entfernte Verhalten für die Fortsetzung von Fling-Vorgängen wiederhergestellt. Wir brechen die Fling-Animation weiterhin ab, wenn das untergeordnete Element aus der Komposition entfernt wird. (I467f4, b/405910180, b/419049142, b/416784125)
  • WindowInsetsRulers: rulersIgnoringVisibility auf „Maximum“ geändert. getDisplayCutoutBounds() wurde in eine Erweiterungsfunktion von PlacementScope geändert. WindowInsetsAnimationProperties wurde in WindowInsetsAnimation und getAnimationProperties() in getAnimation() geändert. (I3816f)
  • InsetsRulers wurde in den gemeinsamen Code mit dem Namen WindowInsetsRulers geändert. Die API wurde vereinfacht, sodass alle Insets WindowInsetsRulers sind. Die Animationsattribute für nicht Lineale wurden in eine AnimationProperties-Klasse extrahiert. Mit WindowInsetsRulers.innermostOf() können mehrere WindowInsetsRulers zusammengeführt werden. (I2f0c6, b/415012444)

Fehlerkorrekturen

  • Fügen Sie die Verwendung von scrollAnimationSpec in ContentInViewNode wieder hinzu. Das Verhalten wurde während der scrollAnimationSpec-Einstellung entfernt, was dazu führte, dass Anwendungsfälle nicht mehr funktionierten. (I1436a, b/403301605)

Version 1.9.0-alpha04

4. Juni 2025

androidx.compose.foundation:foundation-*:1.9.0-alpha04 wird veröffentlicht. Version 1.9.0-alpha04 enthält diese Commits.

API-Änderungen

  • PrefetchScheduler und die Anpassung wurden zugunsten der internen Implementierung eingestellt, die alle Aufgaben automatisch erledigt. (I3a9a6, b/420551535)
  • Scrollable2DState wurde aktualisiert, sodass in der Methode canScroll anstelle eines Winkels ein Offset verwendet wird. (I28694, b/417268474)
  • addAnnotation in AnnotatedOutputTransformation wurde durch addStyle ersetzt. (I91c6f, b/417991824)
  • Stabilisierte LazyLayout. (If5db4)
  • Es wurde ein leerer Konstruktor für LazyLayoutPrefetchState und die zugehörigen Scheduling-Methoden schedulePrecomposition und schedulePrecompositionAndPremeasure stabilisiert. (I4362f, b/252853717)
  • ProcessTextKey für Android wurde eingeführt. Es wird für Kontextmenüelemente verwendet, die für PROCESS_TEXT-Intent-Aktionen hinzugefügt werden. (If0ac4)
  • Kontextmenü-APIs öffentlich machen Die Funktionen Modifier.addTextContextMenuComponents und Modifier.filterTextContextMenuComponents wurden eingeführt, um Elemente im Kontextmenü hinzuzufügen und zu entfernen. Außerdem wurden die folgenden elementaren APIs öffentlich gemacht, damit ein benutzerdefiniertes Kontextmenü erstellt werden kann:
    • TextContextMenuProvider
    • TextContextMenuDataProvider
    • TextContextMenuData
    • TextContextMenuComponent
    • LocalTextContextMenuDropdownProvider
    • LocalTextContextMenuToolbarProvider (I1b7b0)
  • LazyLayoutItemProvider stabil machen (Icce09, b/261565751)
  • Es wurden Android-Funktionen zur intelligenten Auswahl eingeführt, die über ComposeFoundationFlags.isSmartSelectionEnabled aktiviert/deaktiviert werden können. Außerdem wurde eine statische compositionLocal LocalTextClassifierCoroutineContext eingeführt, mit der der CoroutineContext angegeben werden kann, in dem der TextClassification-Job gestartet wird. (I1dbaa, b/139321320)

Version 1.9.0-alpha03

20. Mai 2025

androidx.compose.foundation:foundation-*:1.9.0-alpha03 wird veröffentlicht. Version 1.9.0-alpha03 enthält diese Commits.

API-Änderungen

  • AnnotatedOutputTransformation wurde hinzugefügt. Damit können Sie TextField vor dem Rendern Anmerkungen hinzufügen. (Ibc6f0, b/389978748)
  • LazyLayoutMeasurePolicy einführen und LazyLayoutMeasureScope stabilisieren (I8c5df, b/252853717)
  • BasicSecureTextField stellt jetzt den ScrollState des internen BasicTextField bereit. (I6e576)
  • Die Modifikatoren Modifier.onFirstVisible und Modifier.onVisibilityChanged wurden eingeführt. Sie sind Modifikatoren auf hoher Ebene, die auf Modifier.onLayoutRectChanged basieren. Diese Modifizierer wurden speziell für viele gängige Anwendungsanforderungen wie das Protokollieren von Impressionen und das automatische Abspielen von Videos entwickelt. Sie wurden mit Blick auf die Leistung entwickelt, sodass sie in wichtigen listenbasierten Szenarien verwendet werden können, ohne dass die Scrollleistung beeinträchtigt wird. Zusätzlich zu diesen Modifier-APIs wurden weitere APIs für RelativeLayoutBounds hinzugefügt, um diese Anwendungsfälle zu unterstützen und Entwicklern die Möglichkeit zu geben, ähnliche benutzerdefinierte Modifier zu erstellen, die genau auf ihren Anwendungsfall zugeschnitten sind. (I759b8)
  • Es wurde eine detectDragGestures-Überladung eingeführt, die die Steuerung von Touch-Slop und Ausrichtungssperre ermöglicht. (Iadb0d)
  • Einführung von Modifier.scrollable2D, Scrollable2DState und Companion-APIs für die Statuserstellung. Außerdem wurden allgemeine Funktionen für Scroll-Erweiterungen eingeführt. (Ic61c8, b/214410040)
  • Compose-64-Bit-Farbwerte sind nicht direkt mit Android-ColorLongs-Werten vergleichbar, da die Farbraum-IDs für einige Farbräume nicht in der richtigen Reihenfolge sind. Zum Konvertieren in und aus Android-Farbräumen werden zwei neue APIs hinzugefügt: toColorLong() und fromColorLong(). (I36899)

Fehlerkorrekturen

  • Text, der aus mehreren Text-Composables in einem SelectionContainer kopiert wird, enthält jetzt eine Zeilentrennzeichen \n zwischen Text aus den einzelnen Text-Composables. (I25332, b/285036739)

Version 1.9.0-alpha02

7. Mai 2025

androidx.compose.foundation:foundation-*:1.9.0-alpha02 wird veröffentlicht. Version 1.9.0-alpha02 enthält diese Commits.

API-Änderungen

  • Es wurde korrigiert, wie Änderungen bei der Zeigereingabe in VelocityTracker in DragGestureNode hinzugefügt werden. Dies kann mit dem neuen Flag isOffsetPositionBeforeAddingToVelocityTrackerEnabled gesteuert werden. (Ic7992, b/292556787, b/236451818)
  • await[Vertical/Horizontal]PointerSlopOrCancellation öffentlich machen (I6968b, b/298903681)
  • AbstractComposeView.consumeWindowInsets ist jetzt standardmäßig auf „false“ eingestellt. WindowInsets wird automatisch an die Größe und Position des untergeordneten Elements angepasst, wenn „false“ festgelegt ist. Daher muss es nicht mehr standardmäßig auf „true“ gesetzt werden. Damit wird das Problem behoben, dass untergeordnete Ansichten standardmäßig keine WindowInsets-Updates erhalten haben. Entwickler können die Aktualisierung deaktivieren, indem sie entweder den experimentellen ComposeFoundationLayout.isWindowInsetsDefaultPassThroughEnabled-Wert auf „true“ setzen oder vorzugsweise AbstractComposeView.consumeWindowInsets für alle Compose-Ansichtsinstanzen auf „true“ setzen. (I6fa0a, b/411868840)

Externe Beiträge

  • Pager-Absturz bei extrem großen beyondViewportPageCount-Werten behoben (Idb2db)

Version 1.9.0-alpha01

23. April 2025

androidx.compose.foundation:foundation-*:1.9.0-alpha01 wird veröffentlicht. Version 1.9.0-alpha01 enthält diese Commits.

Geändertes Verhalten

  • Für Lint-Prüfungen, die mit Compose ausgeliefert werden, ist jetzt mindestens AGP-Version 8.8.2 erforderlich. Wenn Sie AGP nicht aktualisieren können, können Sie stattdessen Lint aktualisieren, indem Sie android.experimental.lint.version=8.8.2 (oder eine neuere Version) in Ihrer gradle.properties verwenden. Um Compose-Lint-Prüfungen in der IDE auszuführen, ist Android Studio Ladybug oder höher erforderlich.

  • Wichtige Änderung: Die Überladungen clickable, combinedClickable, selectable, toggleable und triStateToggleable ohne Indication-Parameter unterstützen jetzt nur noch IndicationNodeFactory-Instanzen, die über LocalIndication bereitgestellt werden. Diese Änderung wird angewendet, wenn Sie Ihre Verwendungen dieser Modifikatoren mit dieser Version von Compose neu kompilieren. Binäre / transitive Abhängigkeiten sind nicht betroffen. Wenn Sie LocalIndication eine eingestellte Indication-Implementierung zur Verfügung stellen und diese APIs verwenden, kommt es zur Laufzeit zu einem Absturz. Diese Verhaltensänderung ist erforderlich, um die Leistung zu verbessern und zu ermöglichen, dass Composable-Funktionen, die diese Modifikatoren verwenden, während der Neuzusammenstellung übersprungen werden. Sie können ComposeFoundationFlags.isNonComposedClickableEnabled=false verwenden, um diese Verhaltensänderung vorübergehend zu deaktivieren und Compose zu aktualisieren, ohne dass die Migration Sie daran hindert. Dieses Flag wird nach einer stabilen Version entfernt. Migrieren Sie alle verworfenen Indication-Implementierungen, um stattdessen IndicationNodeFactory zu verwenden. Sie können auch die Überladungen mit einem expliziten Indication-Parameter verwenden. Diese Überladungen unterstützen weiterhin nicht-IndicationNodeFactory-Instanzen von Indication. Aus Leistungsgründen wird dies jedoch nicht empfohlen. (I6bcdc, b/316914333)

API-Änderungen

  • API zum Erstellen benutzerdefinierter Aufzählungslisten über AnnotatedString einführen (I1d066, b/383269496, b/139326648)
  • „Compose“ zum Auslösen von ViewTreeObserver.OnScrollChanged zulassen Dieses Verhalten wird unter dem Flag isOnScrollChangedCallbackEnabled eingeführt. Außerdem haben wir eine Erweiterungsfunktion von DelegatableNode dispatchOnScrollChanged eingeführt. (I34b9d, b/238109286)
  • Für Projekte, die mit Kotlin 2.0 veröffentlicht wurden, ist KGP 2.0.0 oder höher erforderlich (Idb6b5).
  • Unterstützung für Lint-Prüfung für TextFieldState hinzugefügt, damit der Wert in der Komposition gespeichert wird. Verwenden Sie stattdessen am besten rememberTextFieldState. (I53d74)
  • Unterstützung für Lint-Prüfung für FocusRequester hinzugefügt, damit sie in der Komposition berücksichtigt wird (I6bf91)
  • Unterstützung für Lint-Prüfung für BringIntoViewRequester hinzugefügt, damit der Wert in der Komposition gespeichert wird. (Ibfba6)
  • Es wurden Bereiche für schedulePrefetch-Aufrufe in Raster- und Listenstrategien eingeführt, um sie an die LazyListPrefetchState-Funktionen zur Bereitstellung von Größen- und Indexinformationen anzupassen. (Iad80c)
  • Wichtige Änderung: Die Überladungen clickable, combinedClickable, selectable, toggleable und triStateToggleable ohne Indication-Parameter unterstützen jetzt nur noch IndicationNodeFactory-Instanzen, die über LocalIndication bereitgestellt werden. Diese Änderung wird angewendet, wenn Sie Ihre Verwendungen dieser Modifikatoren mit dieser Version von Compose neu kompilieren. Binäre / transitive Abhängigkeiten sind nicht betroffen. Wenn Sie LocalIndication eine eingestellte Indication-Implementierung zur Verfügung stellen und diese APIs verwenden, kommt es zur Laufzeit zu einem Absturz. Diese Verhaltensänderung ist erforderlich, um die Leistung zu verbessern und zu ermöglichen, dass Composable-Funktionen, die diese Modifikatoren verwenden, während der Neuzusammenstellung übersprungen werden. Sie können ComposeFoundationFlags.isNonComposedClickableEnabled=false verwenden, um diese Verhaltensänderung vorübergehend zu deaktivieren und Compose zu aktualisieren, ohne dass die Migration Sie daran hindert. Dieses Flag wird nach einer stabilen Version entfernt. Migrieren Sie alle verworfenen Indication-Implementierungen, um stattdessen IndicationNodeFactory zu verwenden. Sie können auch die Überladungen mit einem expliziten Indication-Parameter verwenden. Diese Überladungen unterstützen weiterhin nicht-IndicationNodeFactory-Instanzen von Indication. Aus Leistungsgründen wird dies jedoch nicht empfohlen. (I6bcdc, b/316914333)
  • Einführung eines Flags zur Steuerung des automatischen verschachtelten Prefetch-Verhaltens: isAutomaticNestedPrefetchEnabled (I8d448)
  • Führen Sie eine Überladung für LazyGridState und rememberLazyGridState ein, die ein LazyLayoutCacheWindow akzeptiert. (I51151)
  • Es werden Lineale für Fenstereinsätze hinzugefügt. Fügt DerivedRuler hinzu, damit ein Ruler aus einem anderen Ruler berechnet werden kann. Ändert PlacmentScope, um die Anzeigedichte zu implementieren. (I658bc, b/359260964)
  • Es wurde eine Factory-Funktion WindowInsets() ohne Argumente hinzugefügt, um das Erstellen leerer WindowInsets zu vereinfachen. (I65f62, b/395311689)
  • PaddingValues.Zero für einen leeren PaddingValues hinzugefügt. (If193e, b/386255688)

Fehlerkorrekturen

  • Die state-Überladung von BasicTextField sorgt dafür, dass der Cursor im Blickfeld bleibt, wenn sich seine Größe ändert. (I0eb41, b/406187741)
  • Die onVisibleItemsUpdated-APIs in LazyListPrefetchStrategy und LazyGridPrefetchStrategy wurden aktualisiert, um über den ursprünglichen Status zu informieren. (If2cfa)

Version 1.8

Version 1.8.3

18. Juni 2025

androidx.compose.foundation:foundation-*:1.8.3 wird veröffentlicht. Version 1.8.3 enthält diese Commits.

Version 1.8.2

20. Mai 2025

androidx.compose.foundation:foundation-*:1.8.2 wird veröffentlicht. Version 1.8.2 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Fehler behoben, der dazu führte, dass bei der Berechnung der Anzahl der zu ladenden Elemente für die Fokus-Suche durch null geteilt wurde. Die Prüfung wurde auf alle Layouts angewendet, in denen LazyLayoutBeyondBoundsState verwendet wird. (8e6dc8)

Version 1.8.1

7. Mai 2025

androidx.compose.foundation:foundation-*:1.8.1 wird veröffentlicht. Version 1.8.1 enthält diese Commits.

Fehlerkorrekturen

  • Ein Fehler in BasicText und TextAutoSize wurde behoben. Bei Verwendung von TextOverflow.Ellipsize wurde Text kleiner als optimal dargestellt. (I1e1d8, b/396582066)
  • Ein Fehler in BasicTextField wurde behoben, der zu verschiedenen Abstürzen führte, wenn TextFieldDecorator den Aufruf von innerTextField übersprang. (I2638c), b/308398612
  • Ein Fehler in TextField wurde behoben, der dazu führte, dass die Textsymbolleiste und die Auswahl-Ziehpunkte vollständig verschwanden, wenn die TextFieldState-Instanz geändert wurde. (I8068a), b/390477786
  • Ein Fehler in BasicText wurde behoben, durch den die Platzierung des Texts nicht aktualisiert wurde, wenn die Mindestbreite geändert wurde und textAlign auf einen anderen Wert als den Standardwert festgelegt war. (I77a96), b/406305552

Version 1.8.0

23. April 2025

androidx.compose.foundation:foundation-*:1.8.0 wird veröffentlicht. Version 1.8.0 enthält diese Commits.

Version 1.8.0-rc03

9. April 2025

androidx.compose.foundation:foundation-*:1.8.0-rc03 wird veröffentlicht. Version 1.8.0-rc03 enthält diese Commits.

Version 1.8.0-rc02

26. März 2025

androidx.compose.foundation:foundation-*:1.8.0-rc02 wird veröffentlicht. Version 1.8.0-rc02 enthält diese Commits.

Version 1.8.0-rc01

12. März 2025

androidx.compose.foundation:foundation-*:1.8.0-rc01 wird veröffentlicht. Version 1.8.0-rc01 enthält diese Commits.

Version 1.8.0-beta03

26. Februar 2025

androidx.compose.foundation:foundation-*:1.8.0-beta03 wird veröffentlicht. Version 1.8.0-beta03 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde die neue Semantikeigenschaft InputText hinzugefügt, die den Wert eines Textfelds erfasst, bevor die Ausgabetransformation angewendet wird. (Iae46a, b/395911609, b/176949051)
  • Die verworfenen AutoSize-Überladungen wurden entfernt. Verwenden Sie stattdessen die TextAutoSize APIs, die dieselbe Funktion bieten. (I2c90f)
  • Ein Caching-Problem mit TextAutoSize wurde behoben. Ein zweiter Layoutdurchlauf mit denselben Einschränkungen konnte dazu führen, dass die zweitgrößte passende Schriftgröße anstelle der größten verwendet wurde. (Id367f)

Version 1.8.0-beta02

12. Februar 2025

androidx.compose.foundation:foundation-*:1.8.0-beta02 wird veröffentlicht. Version 1.8.0-beta02 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das Overscroll-Implementierungen mit LayoutModifierNode in scrollenden Containern nicht richtig funktionierten.

Version 1.8.0-beta01

29. Januar 2025

androidx.compose.foundation:foundation-*:1.8.0-beta01 wird veröffentlicht. Version 1.8.0-beta01 enthält diese Commits.

API-Änderungen

  • SemanticsNodeInteraction.semanticsId() wurde entfernt. Verwenden Sie stattdessen SemanticsNodeInteraction.fetchSemanticsNode().id. (Ie397a)
  • Die requestAutofill API wird außerhalb des Autofill-Managers neu geschrieben. (Id1929)
  • ContextualFlowRow und ContextualFlowColumn wurden als veraltet markiert. Diese experimentelle Komponente wurde in Version 1.7 eingeführt und war noch nicht stabil. Die Implementierung wurde als unerwünscht eingestuft. In Zukunft wird möglicherweise eine Komponente bereitgestellt, die die Anwendungsfälle abdeckt, für die diese Komponente vorgesehen war.
    • FlowRow und FlowColumn haben experimentelle Überladungen, die in Version 1.7 eingeführt wurden und einen overflow-Parameter enthalten. Die Verwendung dieses Parameters wurde eingestellt. Stattdessen können die Überladungen ohne diesen Parameter verwendet werden. Das Standardverhalten für „overflow“ für diese Überladungen ist „Clip“, wie es seit der Einführung war.
    • Viele Anwendungsfälle für ContextualFlowRow lassen sich mit FlowRow realisieren, aber das ist nicht immer der Fall. ContextualFlowRow kann vollständig im Userspace implementiert werden. Sie können versuchen, die Implementierung zu kopieren und bei Bedarf anzupassen. Wir hoffen, diese Anwendungsfälle in Zukunft anders lösen zu können. (Ibafec)

Fehlerkorrekturen

  • Problem behoben, bei dem das Textlayout mit Auslassungszeichen während Animationen manchmal falsch übersetzt wurde. Weitere Informationen finden Sie unter b/389707025 (Ie55b1, b/389707025).
  • Es wurde ein Fehler in BasicText behoben, wenn TextAutoSize und maxLines auf 1 gesetzt waren. (Ic0450, b/376834366)
  • Die Mindesthöhe der intrinsischen Textinhalte berücksichtigt jetzt den Parameter minLines. Das bedeutet, dass die gemeldete Mindesthöhe für intrinsische Elemente nicht kleiner ist als die Höhe, die zum Erfüllen des Parameters minLines erforderlich ist (I225f9, b/388299762).

Version 1.8.0-alpha08

15. Januar 2025

androidx.compose.foundation:foundation-*:1.8.0-alpha08 wird veröffentlicht. Version 1.8.0-alpha08 enthält diese Commits.

API-Änderungen

  • AutoSize: AutoSize wurde in TextAutoSize umbenannt und es wurden APIs veröffentlicht, mit denen benutzerdefinierte TextAutoSize-Implementierungen erstellt werden können. Ein Beispiel für eine benutzerdefinierte Implementierung der automatischen Textgröße finden Sie unter TextAutoSizeSample. (I85756)
  • Das Feature-Flag DetectTapGesturesEnableNewDispatchingBehavior wurde in ComposeFoundationFlags verschoben und in isDetectTapGesturesImmediateCoroutineDispatchEnabled umbenannt. Das alte Flag wurde verworfen und wird jetzt an ComposeFoundationFlags.isDetectTapGesturesImmediateCoroutineDispatchEnabled delegiert. (I62932)

Fehlerkorrekturen

  • DetectTapGesturesEnableNewDispatchingBehavior ist standardmäßig aktiviert. Die TapGestureDetector-APIs verwenden jetzt standardmäßig das neue Dispatching-Verhalten (sofortiges Dispatching). (I9f2bc, b/369648479)
  • Die requiredWidth/Height/Size-Modifikatoren wurden korrigiert, damit intrinsische Größen richtig verarbeitet werden. (Ie3d7d, b/368113212)

Externe Beiträge

  • BasicTooltip wurde in Foundation und BasicTooltip/Tooltip in Material 3 vereinheitlicht. (Ifc2e6)
  • Eine neue Zwischenablage-Schnittstelle und eine Kompositionslokale dafür wurden hinzugefügt. (I80809)

Version 1.8.0-alpha07

11. Dezember 2024

androidx.compose.foundation:foundation-*:1.8.0-alpha07 wird veröffentlicht. Version 1.8.0-alpha07 enthält diese Commits.

API-Änderungen

  • Das Flag ComposeFoundationFlags.RemoveBasicTextGraphicsLayerEnabled wurde gelöscht, mit dem die Entfernung des internen graphicsLayer aus BasicText rückgängig gemacht wurde. Wenn Sie dieses Flag verwendet haben, teilen Sie uns bitte die Gründe mit, indem Sie einen Fehler melden. Sie können auch einfach Modifier.graphicsLayer() an Ihre BasicText-Aufrufe übergeben, um das gleiche Verhalten wie zuvor zu erzielen. (Id9f90)
  • Es wurde eine Standardimplementierung für die neue stickyHeader-DSL hinzugefügt. (I68986)
  • Die lokale Verwendung von LocalAutofillHighlightColor-Kompositionen muss einen Farbtyp verwenden. (I0e05b)
  • OverscrollEffect#withoutDrawing wurde in OverscrollEffect#withoutVisualEffect umbenannt. (I1a154)

Fehlerkorrekturen

  • Folgekorrektur für ein Problem bei der Zielberechnung von AnchoredDraggable, bei dem das Ziel bei bestimmten Wischbewegungen am falschen Anker festgelegt werden konnte. (I23b87, b/367660226)

Externe Beiträge

  • BringIntoViewResponderModifierNode in die Benutzeroberfläche einfügen, um eine neue Möglichkeit zur Implementierung der Funktion „In Ansicht bringen“ zu bieten und die Implementierung auf Plattformebene zu ermöglichen (Ia6dd8)
  • Wir ändern die Art und Weise, wie der Cursor gezeichnet wird, geringfügig. Mit LocalCursorBlinkEnabled können Sie das Zeichnen des Cursors in Tests deaktivieren. (I4c697)

Version 1.8.0-alpha06

13. November 2024

androidx.compose.foundation:foundation-*:1.8.0-alpha06 wird veröffentlicht. Version 1.8.0-alpha06 enthält diese Commits.

API-Änderungen

  • Fügt den Modifikator stylusHoverIcon hinzu. (Iff20a, b/331289114)
  • Die confirmValueChange von AnchoredDraggableState wurde eingestellt. Anstatt Statusänderungen zu blockieren, sollten nicht zulässige Anker nicht im aktiven Ankersatz enthalten sein. Außerdem sollte ein OverscrollEffect verwendet werden, um die Nichtverfügbarkeit der angeforderten Aktion anzugeben. (Ia717f)
  • Ändert den Autofill-Manager in eine Schnittstelle. (I84914, b/376080755)
  • Es werden die APIs OverscrollEffect#withoutDrawing und OverscrollEffect#withoutEventHandling hinzugefügt. Mit diesen APIs wird eine umschlossene Instanz des bereitgestellten Overscroll-Effekts erstellt, die keine Ereignisse zeichnet bzw. verarbeitet. So kann Overscroll in einer separaten Komponente gerendert werden, die Ereignisse sendet. Sie können beispielsweise das Zeichnen des Overscrolls in einer Lazy List deaktivieren und den Overscroll dann separat oben oder an anderer Stelle zeichnen. (Idbb3d, b/266550551, b/204650733, b/255554340, b/229537244)
  • Unterstützung für das automatische Ausfüllen in der Textsymbolleiste hinzugefügt (Ie6a4c)
  • Die Methoden OverscrollConfiguration und LocalOverscrollConfiguration werden eingestellt und rememberPlatformOverscrollFactory wird hinzugefügt, um eine Instanz der Standardimplementierung für das Überscrollen zu erstellen oder deren Parameter anzupassen. Wenn Sie das Overscroll-Verhalten deaktivieren möchten, verwenden Sie LocalOverscrollFactory provides null anstelle von LocalOverscrollConfiguration provides null. Wenn Sie die Farbe oder das Padding des Glühens ändern möchten, verwenden Sie anstelle von LocalOverscrollConfiguration provides OverscrollConfiguration(myColor, myPadding) LocalOverscrollFactory provides rememberPlatformOverscrollFactory(myColor, myPadding). (Ie71f9, b/255554340, b/234451516)
  • Das Attribut effectModifier für OverscrollEffect wurde in node: DelegatableNode geändert, um es an andere APIs anzugleichen. (Ic0b46, b/255554340)
  • Die experimentelle GlobalAssertions API wurde entfernt. Es war für die Ausführung von Barrierefreiheitstests vorgesehen. Verwenden Sie stattdessen enableAccessibilityChecks(). (I59322)

Version 1.8.0-alpha05

30. Oktober 2024

androidx.compose.foundation:foundation-*:1.8.0-alpha05 wird veröffentlicht. Version 1.8.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Unterstützung für die automatische Anpassung der Textgröße. Übergeben Sie eine AutoSize-Instanz (z. B. AutoSize.StepBased) an Ihre bevorzugte Text-Composable-Funktion (z. B. BasicText) und die Textgröße wird an den verfügbaren Platz angepasst. (Ice7e0, b/139320827)
  • Es werden die APIs OverscrollFactory und LocalOverscrollFactory hinzugefügt, um das Overscroll-Verhalten innerhalb einer Hierarchie zu konfigurieren. Der über LocalOverscrollFactory bereitgestellte Wert wird standardmäßig verwendet, um eine OverscrollEffect zu erstellen. Verwenden Sie rememberOverscrollEffect(), um einen Effekt aus der aktuellen bereitgestellten Factory zu erstellen und zu speichern. (I51ca4, b/255554340)

API-Änderungen

  • Einführung von CompositionLocal, mit dem der Farbton der Hervorhebung für das erfolgreiche Ausfüllen der Autofill-Funktion geändert werden kann. (I32092)
  • ScrollableDefaults.overscrollEffect wurde entfernt. Verwenden Sie stattdessen rememberOverscrollEffect. Dadurch wird eine Instanz der aktuellen Overscroll-Implementierung erstellt, die mit LocalOverscrollFactory bereitgestellt wird. (I1651a, b/255554340),(b/234451516)
  • Es wird eine neue AutofillManager-Schnittstelle eingeführt, mit der der Autofill-Vorgang für Nutzer optimiert werden kann, sowie ein isSemanticAutofillEnabled-Flag zum Aktivieren dieser neuen Version von Autofill. (I9d484)
  • Entfernt CombinedClickableNode. Diese experimentelle API wurde vorübergehend bereitgestellt, um die Leistungsoptimierung zu ermöglichen, wird aber nicht mehr benötigt. Verwenden Sie stattdessen Modifier.combinedClickable direkt, wie bei anderen Modifier-APIs. (I4b658)
  • Fügt Überladungen für horizontalScroll, verticalScroll, LazyColumn, LazyRow, LazyHorizontalGrid, LazyVerticalGrid, LazyHorizontalStaggeredGrid, LazyVerticalStaggeredGrid, HorizontalPager und VerticalPager hinzu, mit denen ein benutzerdefiniertes OverscrollEffect angegeben werden kann. Das bereitgestellte OverscrollEffect empfängt Ereignisse und wird innerhalb der Grenzen dieser Komponenten gerendert. Das zweimalige Zeichnen derselben OverscrollEffect wird nicht unterstützt. Sie können also nicht dieselbe OverscrollEffect, die für eine dieser Komponenten bereitgestellt wurde, separat mit Modifier.overscroll zeichnen. Der Anwendungsfall, bei dem der Overscroll außerhalb der Grenzen dieser Komponenten gezeichnet wird, wird in Zukunft separat behandelt. (I2dc42, b/266550551, b/234274772, b/224572538, b/353805117)

Version 1.8.0-alpha04

16. Oktober 2024

androidx.compose.foundation:foundation-*:1.8.0-alpha04 wird veröffentlicht. Version 1.8.0-alpha04 enthält diese Commits.

API-Änderungen

  • Fügt die Callbacks DelegatableNode#onDensityChange und DelegatableNode#onLayoutDirectionChange hinzu, damit der Knotenstatus aktualisiert werden kann, wenn sich diese ändern. (I04f3e, b/340662451)
  • Der Absatz und ParagraphIntrinsics enthalten jetzt eine Liste aller Annotationen, die auf AnnotatedString angewendet werden. Zuvor enthielten sie nur eine Liste von SpanStyles. (I12f80)
  • PointerInputModifierNode#touchBoundsExpansion wurde eingeführt. Damit können die Berührungsbegrenzungen eines einzelnen Zeigereingabe-Modifikators vergrößert werden. (Iccf02, b/335339283)

Fehlerkorrekturen

  • Ein Fehler wurde behoben, durch den Positionsgrenzwerte, die an AnchoredDraggableDefaults.flingBehavior übergeben wurden, in einigen Szenarien nicht richtig berücksichtigt wurden. (Ifdf0d, b/367660226)
  • Es wurde ein Fehler behoben, der bei verschachtelten scrollbaren Elementen auftrat, die während eines laufenden Fling-Vorgangs aus dem Knotenbaum entfernt wurden. Diese Knoten brechen den Fling nun ab und senden das onPostFling-Ereignis mit der verbleibenden Geschwindigkeit. Außerdem führen wir das Flag NewNestedScrollFlingDispatchingEnabled ein, um das Verhalten bei Regressionen zu steuern. Das Flag wird vor der Betaphase entfernt. (I05c37, b/371168883)
  • Ein Fehler wurde behoben, bei dem OverscrollEffects, das an Modifier.anchoredDraggable übergeben wurde, 2D- statt 1D-Deltas empfangen hat. (Ie52c0)

Version 1.8.0-alpha03

2. Oktober 2024

androidx.compose.foundation:foundation-*:1.8.0-alpha03 wird veröffentlicht. Version 1.8.0-alpha03 enthält diese Commits.

API-Änderungen

  • Aktualisierung der Kotlin-Version auf 1.9 (I1a14c)
  • Flag DraggableAddDownEventFixEnabled (I848d5) eingeführt
  • Es wurde eine neue Semantikrolle namens „Carousel“ eingeführt, um das Listenverhalten in Pager-Elementen für Barrierefreiheitsdienste zu emulieren. (Id354b, b/354109776, b/239672673)
  • Der implizite graphicsLayer-Modifier wurde aus der zusammensetzbaren Funktion BasicText entfernt. Es wurde das experimentelle Flag ComposeFoundationFlags.RemoveBasicTextGraphicsLayerEnabled hinzugefügt, um zum alten Verhalten zurückkehren zu können. (Ie478d)
  • Modifier.recalculateWindowInsets() wurde hinzugefügt, damit Kinder in der Hierarchie insetsPadding verwenden können, auch wenn Eltern sie ohne consumeWindowInsets() ausgerichtet haben. (I7f9e4)

Fehlerkorrekturen

  • Implementieren Sie die Erkennung von Touch-Gesten in detectDragGestures, ziehbaren und scrollbaren Elementen. Wenn ein untergeordnetes Element eine Geste nicht mehr ausführt, kann das übergeordnete Element sie übernehmen. So können Sie Gesten kontinuierlicher und integrierter ausführen. (Ic88fe)
  • Das Verhalten beim Abbrechen von Fling-Gesten in scrollbaren Elementen wurde aktualisiert. Wenn ein scrollbares Element durch einen schnellen Wischvorgang an den Rand gelangt, wird die Geschwindigkeit des Wischvorgangs jetzt korrekt an das nächste scrollbare Element in der Kette weitergegeben, anstatt dass der Wischvorgang fortgesetzt wird. (I9326a)

Version 1.8.0-alpha02

18. September 2024

androidx.compose.foundation:foundation-*:1.8.0-alpha02 wird veröffentlicht. Version 1.8.0-alpha02 enthält diese Commits.

API-Änderungen

  • TextOverflow.StartEllipsis und TextOverflow.MiddleEllipsis sind jetzt verfügbar. Damit können Auslassungszeichen am Anfang oder in der Mitte der Zeile des einzeiligen Texts platziert werden (I38913, b/185418980).

Version 1.8.0-alpha01

4. September 2024

androidx.compose.foundation:foundation-*:1.8.0-alpha01 wird veröffentlicht. Version 1.8.0-alpha01 enthält diese Commits.

Version 1.7

Version 1.7.8

12. Februar 2025

androidx.compose.foundation:foundation-*:1.7.8 wird veröffentlicht. Version 1.7.8 enthält diese Commits.

Fehlerkorrekturen

  • Absturz in BasicTextField mit Eingabetransformation beim Ersetzen eines Teils des eingefügten Texts behoben. (I73702)

Version 1.7.7

29. Januar 2025

androidx.compose.foundation:foundation-*:1.7.7 wird veröffentlicht. Version 1.7.7 enthält diese Commits.

Fehlerkorrekturen

  • Der IndexOutOfBound-Absturz bei Linkannotationen wurde behoben. (Ic96d2)
  • In einigen Grenzfall-Szenarien mit Links wurde das Problem behoben, dass die Komposition unendlich oft wiederholt wurde. (I04a03)

Bekannte Fehler

  • Es wurde ein Fehler gefunden, der in seltenen Fällen auf Android-API-Ebene 35 zu einem unerwarteten Zeilenumbruch führen kann. Das Problem kann in Version 1.7 nicht behoben werden. Es wird in Version 1.8 behoben. (b/391378120)

Version 1.7.6

11. Dezember 2024

androidx.compose.foundation:foundation-*:1.7.6 wird veröffentlicht. Version 1.7.6 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das Inline-Inhalte von Text für Bedienungshilfen nicht sichtbar waren.
  • Ein Problem wurde behoben, bei dem AndroidEmbeddedExternalSurface nicht richtig zurückgesetzt wurde und beim Wiederverwenden in einer Lazy List hängen blieb.

Version 1.7.5

30. Oktober 2024

androidx.compose.foundation:foundation-*:1.7.5 wird veröffentlicht. Version 1.7.5 enthält diese Commits.

Fehlerkorrekturen

  • Achte darauf, dass angepinnte Elemente nicht zweimal im Bereich für das Content-Padding untergeordnet werden. (Ic6224)

Version 1.7.4

16. Oktober 2024

androidx.compose.foundation:foundation-*:1.7.4 wird veröffentlicht. Version 1.7.4 enthält diese Commits.

Fehlerkorrekturen

  • Ein Fehler wurde behoben, der in Textfeldern zu seltenen Abstürzen führte. (I475c6, b/313010266)
  • ReusableContentHost wurde aus dem Stammverzeichnis von Lazy-Layout-Elementen entfernt. Dies war eine mögliche Ursache für Abstürze aufgrund von „measure called on a deactivated node“. (Id6e60)

Version 1.7.3

2. Oktober 2024

androidx.compose.foundation:foundation-*:1.7.3 wird veröffentlicht. Version 1.7.3 enthält diese Commits.

Fehlerkorrekturen

  • Ein Speicherleck mit BasicText wurde behoben, wenn „minLines“ auf einen anderen Wert als den Standardwert gesetzt war.

Version 1.7.2

18. September 2024

androidx.compose.foundation:foundation-*:1.7.2 wird veröffentlicht. Version 1.7.2 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem mit dem Ziehen von Elementen wurde behoben. Es fehlten Down-Ereignisse, wodurch Fling-Gesten langsamer als normal aussahen.

Version 1.7.1

10. September 2024

  • An Android-Artefakten wurden keine Änderungen vorgenommen. -desktop Artefakte wurden entfernt und -jvmStubs- und -linuxx64Stubs-Artefakte wurden hinzugefügt. Keines dieser Ziele ist für die Verwendung vorgesehen. Sie sind Platzhalter, um die Bemühungen von Jetbrains Compose zu unterstützen.

Version 1.7.0

4. September 2024

androidx.compose.foundation:foundation-*:1.7.0 wird veröffentlicht. Version 1.7.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.6.0

  • Die Leistung von Modifier.clickable, Modifier.focusable, Modifier.indication, Modifier.scrollable und Modifier.draggable wurde deutlich verbessert. Im Rahmen dieser Bemühungen wurden zusätzlich zu internen Änderungen die folgenden API-Änderungen vorgenommen:
    • Es wurde eine neue Indication API (IndicationNodeFactory) hinzugefügt. Dies führt zu leistungsfähigeren Indication-Implementierungen im Vergleich zur vorherigen (jetzt eingestellten) rememberUpdatedInstance API. Informationen zur Migration finden Sie unter developer.android.com.
    • clickable / combinedClickable / selectable / toggleable akzeptiert jetzt einen Nullable-Parameter MutableInteractionSource. Wenn „null“ und die angegebene Indication ein IndicationNodeFactory ist, kann die Indication nur bei Bedarf verzögert erstellt werden, was die Leistung verbessert. Wenn Sie MutableInteractionSource nicht hochladen und verwenden, empfehlen wir, „null“ anstelle von remember { MutableInteractionSource() } zu übergeben.
    • Indication#rememberUpdatedInstance wurde eingestellt. Sie führt zu einem hohen unvermeidlichen Leistungsverlust und verhindert andere Optimierungen. Verwenden Sie stattdessen die neue IndicationNodeFactory API.
  • BasicTextField mit einem TextFieldState ist jetzt stabil und wir empfehlen allen Aufrufstellen, die Migration von BasicTextField(value, onValueChange) zu BasicTextField(TextFieldState) zu starten.
  • Das ClickableText wurde eingestellt. Wenn Sie klickbare Links in Ihren Text einfügen möchten, verwenden Sie BasicText mit der neuen Annotation LinkAnnotation in Ihrem AnnotatedString. Mit LinkAnnotation können Sie das Styling basierend auf dem Linkstatus anpassen (z.B. fokussiert, mit dem Mauszeiger darauf).
  • Einführung von ContextualFlowRow und Enhanced FlowRow/Column mit MaxLines und Overflow. Wir freuen uns, Verbesserungen an den experimentellen Funktionen FlowRow und FlowColumn anzukündigen. Sie bieten jetzt Unterstützung für maxLines und Überlauf. Außerdem stellen wir die neuen Funktionen ContextualFlowRow und ContextualFlowColumn vor. Dieses Update soll leistungsoptimierte Komponenten bereitstellen. ContextualFlow* eignet sich hervorragend für eine große Anzahl von Elementen, die eine kleine maxLines-Konfiguration und dynamische Schaltflächen vom Typ „+N mehr anzeigen“ verwenden. FlowRow und FlowColumn eignen sich hervorragend für eine kleine Anzahl von Elementen (weniger als 100). Wichtig: Wenn Sie das vorhandene Verhalten in FlowRow oder FlowColumn beibehalten möchten, bei dem alle Elemente unabhängig davon zusammengesetzt werden, ob sie dem maximalen Wert der sekundären Achse entsprechen, legen Sie bei der Initialisierung „overflow“ auf FlowRowOverflow.Visible oder FlowColumnOverflow.Visible fest. Unter ContextualFlowRowSample und FlowRowSample finden Sie Beispiele für diese neuen Funktionen in Aktion. (Ib9135, b/293577082)
  • Unterstützung für Animationen zum Ein- und Ausblenden von Elementen wurde in LazyColumn und LazyRow hinzugefügt. Bisher war es möglich, den Modifizierer Modifier.animateItemPlacement() hinzuzufügen, um Animationssequenzen für die Platzierung (Neuanordnung) zu unterstützen. Wir haben diesen Modifikator eingestellt und einen neuen, nicht experimentellen Modifikator namens Modifier.animateItem() eingeführt, mit dem Sie alle drei Animationstypen unterstützen können: Einblenden, Ausblenden und Neuanordnen. (I2d7f7, b/150812265)
  • Experimentelle Unterstützung für lange Screenshots in Compose-Scrollcontainern mithilfe der offiziellen Android API (ScrollCaptureCallback) implementiert.
  • Die Quellen „Drag“ und „Fling“ werden durch UserInput und SideEffect ersetzt, um der erweiterten Definition dieser Quellen Rechnung zu tragen, die jetzt Animationen („Side Effect“) sowie Mausrad und Tastatur (UserInput) umfasst.NestedScroll
  • LazyLayout-Prefetch-Anfragen können jetzt als dringend markiert werden. Das bedeutet, dass wir davon ausgehen, dass dieser Artikel im nächsten Frame benötigt wird, und das Frame-Budget ignorieren möchten, um mehr Arbeit im Voraus zu erledigen (Id513f).
  • Unterstützung der Funktion zum Schreiben mit Eingabestift auf Geräten nach Android U. (I002e4)
  • Verschiedene APIs wurden auf „Stabil“ hochgestuft.
    • Pager, Andocken, Fenstereinzüge

Version 1.7.0-rc01

21. August 2024

androidx.compose.foundation:foundation-*:1.7.0-rc01 wird veröffentlicht. Version 1.7.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Regressionsfehler behoben, bei dem der Absturz auftrat, wenn ein Element in einem übergeordneten Element, das fokussierbar (oder anklickbar) und deaktiviert ist, den Fokus hatte. (b/317561689)

Version 1.7.0-beta07

7. August 2024

androidx.compose.foundation:foundation-*:1.7.0-beta07 wird veröffentlicht. Version 1.7.0-beta07 enthält diese Commits.

Fehlerkorrekturen

  • Die Funktionen SemanticsNodeInteraction für die Texteingabe performTextReplacement, performTextInput und performTextClearance lösen jetzt Zusicherungsfehler aus, wenn sie für schreibgeschützte TextFields aufgerufen werden. (I4ae8f)
  • Ein visueller Fehler bei Hyperlinks wurde behoben. (I23311)
  • Der Modifikator contentReceiver funktioniert jetzt auch mit einigen IMEs.
  • Generierung von Geschwindigkeit: Die Weitergabe von NaN-Werten in Compose UI und Foundation wird verhindert.

Version 1.7.0-beta06

24. Juli 2024

androidx.compose.foundation:foundation-*:1.7.0-beta06 wird veröffentlicht. Version 1.7.0-beta06 enthält diese Commits.

Version 1.7.0-beta05

10. Juli 2024

androidx.compose.foundation:foundation-*:1.7.0-beta05 wird veröffentlicht. Version 1.7.0-beta05 enthält diese Commits.

Fehlerkorrekturen

  • Behebung des Problems mit der Behandlung von NaN-Werten in SnapFlingBehavior und Pager.

Version 1.7.0-beta04

26. Juni 2024

androidx.compose.foundation:foundation-*:1.7.0-beta04 wird veröffentlicht. Version 1.7.0-beta04 enthält diese Commits.

Fehlerkorrekturen

  • Abstürze beim Messen sehr langer Textzeilen (z. B. 10.000 Zeichen) vermeiden (8157ab)
  • Problem behoben, bei dem die Messung von sehr großem Text im neuen BasicTextField zum Absturz führte (6b7575)
  • Macht eine Verhaltensänderung bei der Messung von Zeilen/Spalten rückgängig, die die Textnutzung in bestimmten Szenarien beeinträchtigt (69e8ba)

Version 1.7.0-beta03

12. Juni 2024

androidx.compose.foundation:foundation-*:1.7.0-beta03 wird veröffentlicht. Version 1.7.0-beta03 enthält diese Commits.

Version 1.7.0-beta02

29. Mai 2024

androidx.compose.foundation:foundation-*:1.7.0-beta02 wird veröffentlicht. Version 1.7.0-beta02 enthält diese Commits.

API-Änderungen

  • Fügt eine experimentelle API zum Konfigurieren des Prefetch-Verhaltens von LazyGrids hinzu, ähnlich der vorhandenen experimentellen API für LazyLists. Dazu gehört auch die Unterstützung für das Prefetching von Elementen in verschachtelten LazyGrids-Elementen. Ähnlich wie bei LazyListPrefetchStrategy werden standardmäßig die ersten beiden verschachtelten Elemente jedes Grids vorab abgerufen. Dies kann jedoch mit den neuen APIs LazyGridPrefetchStrategy(nestedPrefetchItemCount) und LazyListPrefetchStrategy#onNestedPrefetch konfiguriert werden. (I591c4)
  • SemanticsProperties.Editable wurde in IsEditable umbenannt und SemanticsPropertyReceiver.editable in den Wert isEditable geändert. Das Attribut ist jetzt ein boolescher Wert und wird immer durch Textfelder angegeben. (I8acd8)
  • Die Standardwerte für basicMarquee wurden in das Objekt MarqueeDefaults verschoben. (I12ff6)
  • Der Parameter basicMarquee delayMillis wurde in repeatDelayMillis umbenannt. (I12ff6)
  • API zum Formatieren der Links aktualisiert: TextLinkStyles wurde in TextStyle verschoben und TextDefaults wurde aus dem Material entfernt (I5477b)

Fehlerkorrekturen

  • LayoutCoordinates.introducesFrameOfReference wurde in LayoutCoordinates.introducesMotionFrameOfReference umbenannt, um den Zweck besser widerzuspiegeln. Die zugehörige Funktion zum Berechnen von Koordinaten basierend auf diesem Flag wurde umbenannt. (I3a330)
  • „Standard“ wurde aus den MarqueeDefaults-Properties entfernt. (I1d8a0)
  • Die Eigenschaft „Marquee“ wurde aus MarqueeDefaults-Properties entfernt. (Iad4f4)
  • TextLinkStyles wurde aus dem Kurs „TextStyle“ entfernt. Stattdessen ist TextLinkStyles Teil des LinkAnntation-Konstruktors und der AnnotatedString.fromHtml-Methode (I90b2b).
  • Ein Fehler wurde behoben, durch den der Pager beim schnellen Wischen in Richtung einer Grenze einrastete, obwohl er sich bereits an der Grenze befand. (I9f373, b/339171222)
  • In BTF2 werden jetzt die richtigen Mausauswahlgesten verwendet. (Ibe8c6)

Externe Beiträge

  • „Make compose/measure time calculation content-type based in prefetch to improve accuracy“ (Iea622) noch einmal einreichen
  • Die Berechnung der Zeit für das Erstellen/Messen von Inhalten wird im Prefetch-Prozess auf den Inhaltstyp abgestimmt, um die Genauigkeit zu verbessern (Ibccb1).
  • WindowInsetsPadding-Modifizierer aus dem gemeinsamen Quellenset verfügbar machen (I070b2)

Version 1.7.0-beta01

14. Mai 2024

androidx.compose.foundation:foundation-*:1.7.0-beta01 wird veröffentlicht. Version 1.7.0-beta01 enthält diese Commits.

API-Änderungen

  • Die Property KeyboardOptions.shouldShowKeyboardOnFocus wurde als nicht mehr unterstützte, ausgeblendete Property für die binäre Kompatibilität wieder hinzugefügt. (I15cfe)
  • Bei Komponenten mit horizontaler Ausrichtung werden Drag-Deltas in Modifier.anchoredDraggable jetzt standardmäßig umgekehrt, wenn sie in einem RTL-Layout verwendet werden. (I3c6d9)
  • AnnotatedString.hasEqualsAnnotations heißt jetzt hasEqualAnnotations. (I685c0)
  • Die API zum Abrufen von Links mit Material-Design im Text wurde aktualisiert. Konkret wurden die Methoden aus TextDefaults zum Erstellen thematischer LinkAnnotations und zum Parsen von HTML mit thematischen Links entfernt. Stattdessen wurde eine TextLinkStyles-Klasse hinzugefügt, mit der die Links als Parameter für die Text-Composable-Funktion formatiert werden können. (I31b93)
  • onDragStarted und onDragStopped wurden durch nicht suspendierte Callbacks ersetzt. (I59de8)

Fehlerkorrekturen

  • Ein Fehler wurde behoben, durch den Pager abstürzte, wenn contentPadding größer als die eingehenden Einschränkungen war. Der Pager erzwingt jetzt, dass negative Werte, die von PageSize zurückgegeben werden, auf 0 gesetzt werden. (Iba5d8, b/314008560)

Version 1.7.0-alpha08

1. Mai 2024

androidx.compose.foundation:foundation-*:1.7.0-alpha08 wird veröffentlicht. Version 1.7.0-alpha08 enthält diese Commits.

Neue Funktionen

  • Für BasicTextField und SelectionContainer wurde ein Kontextmenü hinzugefügt, das durch Klicken mit der rechten Maustaste aufgerufen werden kann und Optionen zum Ausschneiden, Kopieren, Einfügen und Auswählen aller Elemente enthält. (If8c93, Ia2b49, I6f268)

API-Änderungen

  • LazyLayout-Prefetch-Anfragen können jetzt als dringend markiert werden. Das bedeutet, dass wir davon ausgehen, dass dieser Artikel im nächsten Frame benötigt wird, und das Frame-Budget ignorieren möchten, um mehr Arbeit im Voraus zu erledigen (Id513f).
  • isPositionedByParentWithDirectManipulation wurde in introducesFrameOfReference umbenannt. Beachten Sie, dass dies nun umgekehrt ist. Das bedeutet, dass die meisten LayoutCoordinates standardmäßig einen Bezugsrahmen einführen und die Eigenschaft nur dann „false“ ist, wenn sie direkt manipuliert wird. Wenn Sie die Position nur mit denjenigen abfragen möchten, die einen Bezugsrahmen einführen, verwenden Sie positionInLocalFrameOfReference(...). Oder positionInLocalLookaheadFrameOfReference von einem LookaheadScope. (Ifc5f7)
  • onClicked wurde in LinkInteractionListener in onClick umbenannt (Iaa35c)
  • Aktions-Lambda für getScrollViewportLength gemäß Feedback des API-Teams ändern. (Ibc74a)
  • Die Delegierungs-APIs für das Schreiben mit Eingabestift wurden umbenannt. (Ica45f, b/327271923)
  • Benennen Sie TextInclusionStrategy.isInside in isIncluded um. Machen Sie den Rückgabetyp von Paragraph/MultiParagraph#getRangeForRect() zu „keine Nullwerte zulässig“. (I51f26)

Fehlerkorrekturen

  • In SelectionContainer wurde allen Kontextmenüs für Text die Option „Alles auswählen“ hinzugefügt. (Ib750e, b/240143283)
  • Das Erstellen von Screenshots langer scrollender Container mit reverseScrolling=true wurde korrigiert. (I7c59c)
  • Ein Problem wurde behoben, durch das sich die currentValue von AnchoredDraggableState beim Annähern an die Grenzen des Status geändert hat. (Iea30b, b/333846848)

Externe Beiträge

  • PrefetchExecutor wurde in PrefetchScheduler umbenannt, um die Verantwortlichkeiten besser widerzuspiegeln. (Ib9154)
  • Unterstützung für das Prefetching von Elementen in verschachtelten LazyLists-Elementen wurde hinzugefügt, z.B. ein LazyColumn, das verschachtelte LazyRows rendert. Diese Änderung soll die Anzahl der Frame-Drops beim Scrollen für diese LazyLists-Elemente verringern. Standardmäßig werden die ersten zwei verschachtelten Elemente vorab abgerufen. Dieses Verhalten kann jedoch mit den neuen APIs LazyLayoutPrefetchStrategy(nestedPrefetchItemCount) und LazyListPrefetchStrategy#onNestedPrefetch gesteuert werden. (I51952)

Version 1.7.0-alpha07

17. April 2024

androidx.compose.foundation:foundation-*:1.7.0-alpha07 wird veröffentlicht. Version 1.7.0-alpha07 enthält diese Commits.

Neue Funktionen

  • Es wurde ein TextDefaults-Objekt hinzugefügt, das Methoden zum Erstellen eines LinkAnnotation-Objekts und zum Parsen von HTML-getaggten Strings enthält, in denen MaterialTheme auf die Links angewendet wird. (I98532, b/139312671)
  • Unterstützung für das Ein- und Ausblenden von Elementen wurde inLazyVerticalGrid und LazyHorizontalGrid hinzugefügt. Bisher war es möglich, den Modifizierer Modifier.animateItemPlacement() hinzuzufügen, um Animationssequenzen für die Platzierung (Neuanordnung) zu unterstützen. Wir haben diesen Modifikator eingestellt und einen neuen, nicht experimentellen Modifikator namens Modifier.animateItem() eingeführt, mit dem Sie alle drei Animationstypen unterstützen können: Einblenden, Ausblenden und Neuanordnen. (Ib7d12, b/330510929)
  • Unterstützung für Animationen zum Ein- und Ausblenden von Elementen wurde in LazyVerticalStaggeredGrid und LazyHorizontalStaggeredGrid hinzugefügt. Bisher war es möglich, den Modifizierer Modifier.animateItemPlacement() hinzuzufügen, um Animationssequenzen für die Platzierung (Neuanordnung) zu unterstützen. Wir haben diesen Modifikator eingestellt und einen neuen, nicht experimentellen Modifikator namens Modifier.animateItem() eingeführt, mit dem Sie alle drei Animationstypen unterstützen können: Einblenden, Ausblenden und Neuanordnen. (I69bc9, b/330511290)

API-Änderungen

  • Fügt ContextMenuColors und das zugehörige LocalContextMenuTheme ProvidableCompositionLocal hinzu. Die Farben des Kontextmenüs für Textfelder und auswählbaren Text können durch Bereitstellen der Komposition lokal geändert werden. (Ifa154)
  • Textlinks haben jetzt zusätzlich zum normalen Stil, zum Stil für den Mauszeiger und zum Fokusstil auch einen Stil für den gedrückten Zustand. (I5f864, b/139312671)
  • Einführung von ViewConfiguration.HandwritingGestureLineMargin für Handschriftgesten Unterstützung der Handschrift-Geste für BasicTextField. (Ie6e13, b/325660505)
  • DelegatableNode.scrollIntoView wurde für die Version 1.7 entfernt, da wir nicht genügend Zeit hatten, die restliche zugehörige API-Oberfläche zu stabilisieren. Diese Funktion wird in Version 1.8 wieder eingeführt (I6cf61, b/333421581, b/332900232).
  • Beim Abfragen von Layoutkoordinaten können Sie jetzt das Argument excludeDirectManipulationOffset verwenden, um den von übergeordneten Layouts festgelegten Versatz auszuschließen, bei denen die untergeordneten Elemente mit Placeable.PlacementScope.withDirectManipulationPlacement platziert wurden. Ebenso kann ein Layout, das die Position seiner untergeordneten Elemente häufig ändert, diese jetzt mit withDirectManipulationPlacement platzieren (z. B. „Scroll“, das standardmäßig implementiert ist). Das macht approachLayout-basierte Animationen intuitiver, da Sie nun unterscheiden können, welcher Offset animiert und welcher direkt angewendet werden soll, wenn Sie sich für die Animation des Ansatzes entscheiden. (I60ec7)
  • Wir stellen requestScrollToItem für LazyStaggeredGrid vor. Für jeden Messdurchlauf kann der Client jetzt die Beibehaltung des Index basierend auf dem Schlüssel deaktivieren, indem er requestScrollToItem aufruft. Das bestehende Verhalten ändert sich dadurch nur, wenn requestScrollToItem aufgerufen wird. (I63983)
  • requestScrollToPage in Pager vorstellen Für jeden Messdurchlauf kann der Client jetzt die Beibehaltung des Index basierend auf dem Schlüssel deaktivieren, indem er requestScrollToPage aufruft. Das bestehende Verhalten ändert sich dadurch nur, wenn requestScrollToPage aufgerufen wird. (Ic4213)
  • requestScrollToItem für LazyGrids eingeführt. Für jeden Messdurchlauf kann der Client jetzt die Beibehaltung des Index basierend auf dem Schlüssel deaktivieren, indem er requestScrollToItem aufruft. Das bestehende Verhalten ändert sich dadurch nur, wenn requestScrollToItem aufgerufen wird. (I0a7a0)
  • ClickableText ist als veraltet markiert. Wenn Sie dem Text Links hinzufügen möchten, erstellen Sie ein AnnotatedString mit einem LinkAnnotation, das Ihrem Link entspricht, und übergeben Sie dieses AnnotatedString an die Text-Composable-Funktion (I34d4b, b/323346994).
  • UrlAnnotation wurde verworfen. Verwenden Sie stattdessen LinkAnnotation.Url. Wenn Sie Material-Theming verwenden, erstellen Sie die Anmerkung mit dem TextDefaults-Objekt, damit das Material-Theming angewendet wird (I8d180, b/323346545).
  • String.parseAsHtml wurde in AnnotatedString.Companion.fromHtml umbenannt (I43dcd)
  • Der parseAsHtml-Methode wurden Formatierungsargumente (linkStyle, focusedLinkStyle, hoveredLinkStyle) und ein Listener für Linkinteraktionen hinzugefügt. Beim Parsen des HTML-getaggten Strings mit <a>-Tags wird für jedes solche Tag ein LinkAnnotation.Url erstellt und die Styling-Objekte und der Link-Interaktionslistener werden an jede Anmerkung übergeben. (I7c977)
  • LinkAnnotation verwendet jetzt die statusbasierten Formatierungsargumente und ein LinkInteractionListener. Fügen Sie AnnotatedString diese Anmerkung hinzu, um einen Hyperlink zu erhalten. Durch die Übergabe von focusedState und/oder hoveredState können Sie die visuelle Konfiguration für Links definieren, wenn sie fokussiert und/oder mit dem Mauszeiger darauf gezeigt wird. (I81ce4, b/139312671)
  • Das Feature-Flag für lange Screenshots wurde entfernt. (I28648, b/329128246)
  • LazyColumn rendert jetzt fixierte Kopfzeilen in langen Screenshots korrekt. (I8d239, b/329296635)
  • Die meisten der verbleibenden experimentellen APIs, die mit der neuen BasicTextField eingeführt wurden, wurden stabilisiert. (I714e2)
  • Der Parameter textObfuscationCharacter wurde BasicSecureTextField hinzugefügt. Er steuert, welches Zeichen beim Verschleiern des Inhalts verwendet wird. (I0588b)
  • Die NestedScroll-Quellen „Drag“ und „Fling“ werden durch UserInput und SideEffect ersetzt, um der erweiterten Definition dieser Quellen Rechnung zu tragen, die jetzt Animationen („Side Effect“) sowie Mausrad und Tastatur (UserInput) umfasst. (I40579)
  • Einführung von LocalBringIntoViewSpec, einem plattformabhängigen Fokus-Scrolling-Verhalten, das auf der Scrollable-Modifikatorebene angewendet wird. (I27aa5, b/317453911)
  • TextFieldCharSequence wurde entfernt. TextFieldBuffer.originalValues wird durch TextFieldBuffer.originalText und TextFieldBuffer.originalSelection ersetzt. (I2c7d6)
  • ImeOptions.hintLocales ist nicht mehr nullable. Wenn Sie eine leere Liste mit Gebietsschemas übergeben möchten, verwenden Sie LocaleList.Empty. (Ic5bc4)
  • getOffsetFractionForPage wurde in getOffsetDistanceInPages umbenannt. (Ia05e2)

Fehlerkorrekturen

  • Wenn InputTransformations mit next zusammengeführt werden, werden ihre KeyboardOptions jetzt mit der neuen Methode KeyboardOptions.merge korrekt nach einzelnen Optionen zusammengeführt. (Ie5304, b/295951492)
  • Bei der targetValue von AnchoredDraggableState werden Positionsgrenzwerte nicht mehr berücksichtigt. Sie hat jetzt einen impliziten Grenzwert von 50 %. Das bedeutet, dass sich die targetValue in der Mitte zwischen zwei Ankern ändert. (I82c2c)

Externe Beiträge

  • 2 Scroll-APIs umbenannt (I56a75)

Version 1.7.0-alpha06

3. April 2024

androidx.compose.foundation:foundation-*:1.7.0-alpha06 wird veröffentlicht. Version 1.7.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Unterstützung für Animationen zum Ein- und Ausblenden von Elementen wurde in LazyColumn und LazyRow hinzugefügt. Bisher war es möglich, den Modifizierer Modifier.animateItemPlacement() hinzuzufügen, um Animationssequenzen für die Platzierung (Neuanordnung) zu unterstützen. Wir haben diesen Modifikator eingestellt und einen neuen, nicht experimentellen Modifikator namens Modifier.animateItem() eingeführt, mit dem Sie alle drei Animationstypen unterstützen können: Einblenden, Ausblenden und Neuanordnen. (I2d7f7, b/150812265)
  • Kunden von LazyColumn/LazyRow können jetzt die Beibehaltung eines Index basierend auf dem Schlüssel für den bevorstehenden Messdurchlauf deaktivieren, indem sie einen nicht suspendierten LazyListState.requestToScroll aufrufen. (I98036, b/209652366)
  • Die Methode parseAsHtml für formatierte Strings wurde hinzugefügt. Damit lässt sich ein mit HTML-Tags markierter String in AnnotatedString konvertieren. Beachten Sie, dass nicht alle Tags unterstützt werden. So können Sie beispielsweise noch keine Aufzählungslisten anzeigen. (I84d3d)
  • Experimentelle Unterstützung für lange Screenshots in Compose-Scrollcontainern mit der offiziellen Android API (ScrollCaptureCallback) wurde implementiert. Diese Funktion ist experimentell und wird derzeit möglicherweise nicht in allen Fällen korrekt ausgeführt. Aus diesem Grund ist sie derzeit standardmäßig deaktiviert. Um die automatische CMEK-Bereitstellung zu aktivieren, setzen Sie das Flag ComposeFeatureFlag_LongScreenshotsEnabled auf „true“. Dieses Flag wird vor der Betaversion von 1.7 entfernt. (I2b055, b/329296471)
  • Einführung der neuen GraphicsLayer-API, um mehr Flexibilität bei der Platzierung und dem Rendern von GraphicsLayer-Instanzen zu bieten und intrinsische Rendering-Funktionen zu unterstützen, ohne dass eine Koordination mit Composable-Implementierungen erforderlich ist, um GraphicsLayer-Modifikatorinstanzen anzugeben.

API-Änderungen

  • Alle KeyboardOptions-Parameter haben jetzt standardmäßig den Wert „Nicht angegeben“. Die Methode KeyboardOptions.merge wurde hinzugefügt.
  • KeyboardOptions.autoCorrect wurde in autoCorrectEnabled umbenannt und ist jetzt nullable. Ein Nullwert gibt an, dass kein Wert angegeben wurde. (Ia8ba0, b/295951492)
  • outOfBoundsPageCount wurde in beyondViewportPageCount umbenannt. (I129c6)
  • fun ClipEntry.getMetadata() wird in val ClipEntry.clipMetadata geändert. (I50155)
  • TextFieldState.valueAsFlow() wurde entfernt. snapshotFlow { state.text } oder snapshotFlow { TextFieldCharSequence(state.text, state.selection) } verwenden (I7d629)
  • Die InputTransformation.transformInput-Parameter wurden neu organisiert. originalValue: TextFieldCharSequence wurde entfernt. Stattdessen enthält TextFieldBuffer jetzt diesen Wert mit demselben Namen. Außerdem wurde der Parameter valueWithChanges: TextFieldBuffer entfernt. TextFieldBuffer ist jetzt der Empfängerbereich für die Funktion. (I919cc)
  • Bei der BasicTextField(state)-Variante und BasicSecureTextField wird jetzt KeyboardActionHandler anstelle von KeyboardActions verwendet, um Aktionen zu verarbeiten, die über die Softwaretastatur ausgeführt werden. (I58dda)
  • APIs zur Delegation des Schreibens mit Eingabestift zur Unterstützung des Schreibens mit Eingabestift in „falschen“ Texteingabefeldern. (I9c09c, b/327271923)
  • KeyboardOptions.shouldShowKeyboardOnFocus wurde in showKeyboardOnFocus umbenannt. (Ib4b7a, b/295951492)
  • Der Parameter hintMediaTypes wurde aus Modifier.contentReceiver entfernt. Entwickler wurden bereits aufgefordert, den Medientyp der empfangenen TransferableContent zu prüfen, da er möglicherweise nicht mit der konfigurierten hintMediaTypes kompatibel ist. (I82f99)
  • Die Parameter von BasicSecureTextField wurden neu angeordnet. Die Parameter keyboardType und imeAction wurden zugunsten der vollständigen KeyboardOptions-Klasse entfernt. Die Standardeinstellungen für BasicSecureTextField bleiben unverändert. Außerdem wurde der Parameter scrollState entfernt. (Ibbfa9)
  • Der Typ von TextFieldState.text wurde von TextFieldCharSequence in CharSequence geändert. Daher wurden TextFieldState.selection: TextRange und TextFieldState.composition: TextRange? hinzugefügt, um die aktuellen Auswahl- und Kompositionswerte direkt aus dem Statusobjekt zu lesen.
  • TextFieldState.forEachTextValue wurde entfernt. (Idb2a2)
  • Die Funktionen ClipboardManager.getClipMetadata und ClipboardManager.hasClip wurden entfernt. Verwenden Sie clipEntry.getMetadata(), um die Metadaten des aktuellen Clipausschnitts zu lesen. Prüfen Sie auch das Ergebnis von ClipboardManager.getClip, um festzustellen, ob es null ist oder nicht. So können Sie herausfinden, ob die Zwischenablage einen aktuellen Clip enthält. (I50498)
  • ClipboardManager.setClip akzeptiert jetzt „null“, um die Zwischenablage zu leeren. (I7d2e9)
  • ReceiveContentListener wird in eine Funktionsschnittstelle konvertiert. Die Modifier.receiveContent-Überladung, die eine Lambda-Funktion akzeptiert, wurde ebenfalls entfernt, da ReceiveContentListener jetzt eine Funktionsschnittstelle ist.
  • Modifier.receiveContent wird in Modifier.contentReceiver umbenannt. (I1e6af)
  • TransferableContent.consumeEach wurde in TransferableContent.consume umbenannt. (I1e462)
  • rememberTextFieldState ist jetzt eine stabile API. (I37999)

Fehlerkorrekturen

  • Ein Fehler wurde behoben, durch den die BasicTextField(state)-Variante nicht mit CJK-Tastaturen(kompositionsbasiert) funktionierte. (I54425)
  • Es wurde ein Fehler behoben, bei dem in bestimmten Szenarien mit der Wiederverwendung von Modifier.Node in Modifier.dragAndDropTarget() auf veraltete Daten verwiesen werden konnte. (I05bb1)
  • Eine kürzlich vorgenommene Vertragsänderung wurde rückgängig gemacht. Bei dieser Änderung wurden AnchoredDraggableState#anchoredDrag-Aufrufe am Ende eines anchoredDrag-Vorgangs beendet. (I95715)

Version 1.7.0-alpha05

20. März 2024

androidx.compose.foundation:foundation-*:1.7.0-alpha05 wird veröffentlicht. Version 1.7.0-alpha05 enthält diese Commits.

API-Änderungen

  • Die experimentelle lokale Komposition LocalTextLinkStyle zum Formatieren von Hyperlinks wurde entfernt. (Iebfa7)
  • Die experimentelle Überschreibung von BasicText mit dem Argument onLinkClicked wurde entfernt. Eine Ersatz-API für die Unterstützung von Hyperlinks wird in Zukunft folgen. (I107d5)
  • Methoden und Attribute für Codepoints unter TextFieldState und TextFieldBuffer wurden entfernt. Außerdem wurden die inChars-Suffixe aus den verbleibenden APIs für Auswahl und Komposition entfernt. (Ief7ce)
  • Die currentValue von AnchoredDraggable wird jetzt aktualisiert, wenn ein Ankerpunkt passiert wird. Verwenden Sie settledValue, um die vorherige currentValue-Semantik zu erhalten. Die Aktualisierung erfolgt nur, wenn ein Ankerpunkt erreicht wird. Der Fortschritt wird jetzt als Funktion (mit Start- und Endpunkt) und nicht mehr als Attribut dargestellt. (Ibe6e8, b/318707189, b/298271489, b/294991954)
  • BasicTextField(state), TextFieldState, InputTransformation, OutputTransformation, TextFieldLineLimits, TextFieldDecorator sind jetzt stabil. (I9582b)
  • InterceptPlatformTextInput wurde eingeführt, um das Schreiben von IME-Tests auf niedriger Ebene und anderen IME-Anwendungsfällen auf niedriger Ebene zu erleichtern. PlatformTextInputTestOverride wurde eingestellt. (I862ed, b/322680547)
  • restrictedConstraints() in zwei Methoden aufgeteilt: fitPrioritizingWidth() und fitPrioritizingHeight() (I6d7fd)

Externe Beiträge

  • Es wurden zwei neue APIs isLastScrollForward/isLastScrollBackward hinzugefügt, um die Scrollrichtung für die letzte Scrollaktion zu prüfen. Sie geben „false“ zurück, wenn noch keine Scrollaktion erfolgt ist. (I63a0e)

Version 1.7.0-alpha04

6. März 2024

androidx.compose.foundation:foundation-*:1.7.0-alpha04 wird veröffentlicht. Version 1.7.0-alpha04 enthält diese Commits.

API-Änderungen

  • Unterstützung der Funktion zum Schreiben mit Eingabestift auf Geräten nach Android U. (I002e4)
  • hintLocales wurde KeyboardOptions hinzugefügt, damit TextFields IMEs mit bestimmten Gebietsschemas darauf hinweisen kann, eine bevorzugte Sprache voreinzustellen. (Id18c2)
  • Die experimentellen Überladungen BasicTextField2 und BasicSecureTextField, die die Parameter value: String und onValueChange: () -> String verwendet haben, wurden entfernt. (I568b4)
  • Fügen Sie InputTransformation eine optionale applySemantics-Funktion hinzu, um die Semantik des BasicTextField2 zu beeinflussen, auf das sie angewendet wird. (I74a2f, b/170648072)
  • In diesem CL wird die semantische Aktion GetScrollViewportLength hinzugefügt, damit Informationen zu den Komponenten, die in Compose gescrollt werden, an das A11y-System weitergeleitet werden können. In diesem CL wird die Verwendung der genannten Property auch in scrollbaren Foundation-Listen angewendet. (Ic5fa2)
  • BasicTextField2 wird in BasicTextField umbenannt. (Ie5713)
  • FocusRequester.createRefs ist jetzt stabil (I4d92c, b/261436820)
  • DelegatableNode.scrollIntoView() wurde eingeführt, damit Änderungsknoten scrollIntoView-Anfragen direkt stellen können. (I2b3b7, b/299939840)
  • DelegatableNode.requireView() wurde eingeführt, damit Modifikator-Knoten den aktuellen Android-View abrufen können, ohne einen Kompositions-Local zu lesen. (I40768)
  • Wir führen Kontextinformationen zum Layout in den Bereichen „Kontextbezogener Ablauf – Zeile“ und „Kontextbezogener Ablauf – Spalte“ ein. Dazu gehören Zeilenindex, Position und Einschränkungen für maximale Breite und Höhe, damit die angegebene Position beibehalten wird. Elemente, die die maximale Breite/Höhe überschreiten, können je nach Überlaufeinstellungen in die nächste Zeile verschoben oder ausgelassen werden. (Id13f8, b/292114798)

Fehlerkorrekturen

  • Ein Fehler wurde behoben, der unter bestimmten Umständen beim Umschalten der Attribute enabled oder readOnly von TextField einen Absturz verursachte. (Iae17b)

Version 1.7.0-alpha03

21. Februar 2024

androidx.compose.foundation:foundation-*:1.7.0-alpha03 wird veröffentlicht. Version 1.7.0-alpha03 enthält diese Commits.

API-Änderungen

  • DelegatableNode.requireLayoutCoordinates() wurde eingeführt, um die aktuelle LayoutCoordinates einer Modifier.Node abzurufen, ohne onPlaced überschreiben und die Koordinaten selbst in einem Attribut speichern zu müssen. (Ia8657)
  • DelegatableNode.currentLayoutCoordinates wurde eingeführt, um die aktuelle LayoutCoordinates einer Modifier.Node abzurufen, ohne onPlaced überschreiben und die Koordinaten selbst in einem Attribut speichern zu müssen. (Iaebaa)
  • Leistungsoptimierungen in DraggableAnchors, die von AnchoredDraggable verwendet werden. (I89cff)
  • BasicTextField2 und zugehörige APIs im Paket androidx.compose.foundation.text2 werden nach androidx.compose.foundation.text verschoben. (I9f635)
  • BasicTextField2 akzeptiert keinen CodepointTransformation-Parameter mehr. Verwenden Sie BasicSecureTextField oder OutputTransformation. (Id34ff)
  • Es wurde eine Methode hinzugefügt, mit der nur die Anmerkungen von zwei AnnotatedStrings verglichen werden können. (I32659)
  • Wir präsentieren ContextualFlowRow und die optimierte FlowRow/Column mit MaxLines und Overflow. Wir freuen uns, Verbesserungen an den experimentellen Funktionen FlowRow und FlowColumn anzukündigen. Sie bieten jetzt Unterstützung für maxLines und Überlauf. Außerdem stellen wir die neuen Funktionen ContextualFlowRow und ContextualFlowColumn vor. Dieses Update soll leistungsoptimale Komponenten bereitstellen. ContextualFlow* eignet sich hervorragend für eine große Anzahl von Elementen, die eine kleine maxLines-Konfiguration und dynamische Schaltflächen vom Typ „+N Mehr anzeigen“ verwenden. FlowRow und FlowColumn eignen sich hervorragend für eine kleine Anzahl von Elementen, weniger als 100 Elemente. Wichtig: Wenn Sie das bisherige Verhalten in FlowRow oder FlowColumn beibehalten möchten, bei dem alle Elemente unabhängig davon zusammengesetzt werden, ob sie in die maximale Größe der Querachse passen, legen Sie overflow bei der Initialisierung auf FlowRowOverflow.Visible oder FlowColumnOverflow.Visible fest. Unter ContextualFlowRowSample und FlowRowSample finden Sie Beispiele für diese neuen Funktionen in Aktion. (Ib9135, b/293577082)

Fehlerkorrekturen

  • Bei der Cursoranimation werden keine Frames mehr zwischen den Status „Ein“ und „Aus“ angefordert. (Ia2253)
  • Die eingestellten Kopierkonstruktoren von KeyboardOptions kopieren jetzt alle Eigenschaften korrekt. (If12de)

Version 1.7.0-alpha02

7. Februar 2024

androidx.compose.foundation:foundation-*:1.7.0-alpha02 wird veröffentlicht. Version 1.7.0-alpha02 enthält diese Commits.

API-Änderungen

  • HorizontalPager, VerticalPager und PagerState werden als stabil eingestuft. (I67660, b/316966909)
  • Die Kompositionslokale LocalTextLinkStyle wurde hinzugefügt, mit der sich der Stil der Links im Text in der gesamten App ändern lässt. Wenn Sie in der App ein eigenes Theme verwenden, sollten Sie diese Kompositionslokale entsprechend Ihrem Theme festlegen. Wenn Sie das Material-Design verwenden, wird die Farbe des Links standardmäßig auf die primäre Farbe von Material festgelegt. (I7eb10)
  • Der Modifikator receiveContent wurde eingeführt, mit dem Entwickler Rich Content in Jetpack Compose empfangen können.
  • receiveContent ist in BasicTextField2 integriert, um Rich Content zu akzeptieren, der über die Softwaretastatur oder durch Einfügen aus der Zwischenablage bereitgestellt wird. (I81b72)
  • Bei dieser Änderung ersetzen wir SnapFlingBehavior durch TargetedFlingBehavior im Pager, um andere Anwendungsfälle zu ermöglichen und mehr Flexibilität zu bieten. (I762ea)
  • Mit dieser Änderung werden die Snapping APIs stabil. Außerdem bereinigen wir einen Teil des Testcodes und fügen weitere Beispiele für das Andocken hinzu. (Id8da9)
  • Wir führen TargetedFlingBehavior ein, ein FlingBehavior, mit dem Informationen zum Status der laufenden Animation und zum Ziel-Scroll-Offset weitergegeben werden können. (I6a207)

Fehlerkorrekturen

  • BasicTextField2 sorgt jetzt dafür, dass der Cursor beim Tippen im Blickfeld bleibt, wenn er aus dem Blickfeld gescrollt wurde oder sich aufgrund der Eingabe aus dem Blickfeld bewegen würde. (Ieb856, b/237190748)

Externe Beiträge

  • Fügt eine experimentelle API zum Konfigurieren des Prefetch-Verhaltens von LazyLists hinzu. (I022a4)

Version 1.7.0-alpha01

24. Januar 2024

androidx.compose.foundation:foundation-*:1.7.0-alpha01 wird veröffentlicht. Version 1.7.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Es wurde ein neues Indication API hinzugefügt: IndicationNodeFactory. Dies führt zu leistungsfähigeren Indication-Implementierungen im Vergleich zur vorherigen (jetzt eingestellten) rememberUpdatedInstance-API. Informationen zur Migration finden Sie unter developer.android.com.
  • clickable / combinedClickable / selectable / toggleable akzeptiert jetzt einen Nullable-Parameter MutableInteractionSource. Wenn „null“ und das bereitgestellte Indication ein IndicationNodeFactory ist, kann das Indication nur bei Bedarf verzögert erstellt werden, was die Leistung verbessert. Wenn Sie das MutableInteractionSource nicht hochladen und verwenden, wird empfohlen, „null“ zu übergeben.

API-Änderungen

  • Einführung von DecayAnimation in AnchoredDraggable: Durch diese Änderung wird AnchoredDraggable ein decayAnimationSpec-Parameter hinzugefügt, mit dem beim Festlegen auf einen der Anker eine Decay-Animation verwendet werden kann. Im Rahmen der Änderung wird auch die vorhandene animationSpec in snapAnimationSpec umbenannt, um den Anwendungsfall jeder Spezifikation besser nachvollziehen zu können.
  • BasicTextField2 ist für Testzwecke verfügbar. Die Funktion sollte in etwa mit BasicTextField vergleichbar sein und das Verhalten sollte produktionsreif sein. Die API befindet sich jedoch noch in der Testphase. Vor der Stabilisierung wird sie in BasicTextField umbenannt und in dasselbe Paket verschoben.
  • Der erste Entwurf der OutputTransformation API für BasicTextField2 wurde eingeführt. Diese API ersetzt die meisten Anwendungsfälle von VisualTransformation in der alten BasicTextField. Sie ist jedoch noch nicht vollständig und einige Dinge funktionieren nicht richtig. Wir freuen uns über Feedback zur API-Nutzerfreundlichkeit für Ihre Anwendungsfälle. (aosp/2708848)
  • Die Funktion LinkAnnotation wurde eingeführt, mit der Links und anklickbare Elemente in Text eingefügt werden können. Die Links-Funktion ist noch nicht vollständig und es werden weitere API-Änderungen folgen.
  • Der Modifikator receiveContent wurde eingeführt, mit dem Entwickler Rich Content in Jetpack Compose empfangen können.
  • receiveContent ist in BasicTextField2 integriert, um Rich Content zu akzeptieren, der über die Softwaretastatur oder durch Einfügen aus der Zwischenablage bereitgestellt wird.
  • Mit KeyboardOptions.shouldShowKeyboardOnFocus können Sie das Standardverhalten von BasicTextField deaktivieren, bei dem bei Fokus eine Softwaretastatur angefordert wird.
  • TextInputService und LocalTextInputService wurden eingestellt. Verwenden Sie stattdessen PlatformTextInputModifierNode, um die IME-APIs der Plattform direkt einzubinden. (aosp/2862698)
  • Indication#rememberUpdatedInstance wurde eingestellt. Sie führt zu einem hohen unvermeidlichen Leistungsverlust und verhindert andere Optimierungen. Verwenden Sie stattdessen die neue IndicationNodeFactory API.

Fehlerkorrekturen

  • Bei Übergabe von VisualTransformation wird jetzt eine kleine Auswahl von Offsetzuordnungen vorab validiert.BasicTextField So lassen sich häufige Programmierfehler erkennen, die in späteren Mess- oder Ziehungsdurchläufen zu nicht behebaren Ausnahmen führen. Wenn während der Komposition eine Ausnahme ausgelöst wird, ist es wahrscheinlicher, dass Entwickler diese Fehler während der Entwicklung sehen und so Produktionsabstürze vermieden werden. (I0fd42)
  • VisualTransformation löst keinen Fehler aus, wenn Sie einen ungültigen Index für einen ungültigen Index zurückgeben (b/316401857 ).

Version 1.6

Version 1.6.8

12. Juni 2024

androidx.compose.foundation:foundation-*:1.6.8 wird veröffentlicht. Version 1.6.8 enthält diese Commits.

Version 1.6.7

1. Mai 2024

androidx.compose.foundation:foundation-*:1.6.7 wird veröffentlicht. Version 1.6.7 enthält diese Commits.

Version 1.6.6

17. April 2024

androidx.compose.foundation:foundation-*:1.6.6 wird veröffentlicht. Version 1.6.6 enthält diese Commits.

Fehlerkorrekturen

  • Ein Fehler wurde behoben, der unter bestimmten Umständen beim Umschalten der Attribute enabled oder readOnly von TextField einen Absturz verursachte. (Iae17b)

Version 1.6.5

3. April 2024

androidx.compose.foundation:foundation-*:1.6.5 wird veröffentlicht. Version 1.6.5 enthält diese Commits.

Fehlerkorrekturen

  • Es wurden Debugging-Protokolle für schwer reproduzierbare Fehler in Zeile/Spalte hinzugefügt: (b/300280216 und b/297974033)

Version 1.6.4

20. März 2024

androidx.compose.foundation:foundation-*:1.6.4 wird veröffentlicht. Version 1.6.4 enthält diese Commits.

Fehlerkorrekturen

  • Die Auswahl durch langes Drücken und Ziehen, bei der im ersten Frame des Ziehens die Layoutgrenzen des Texts überschritten werden, führt nicht mehr zum Absturz. (Icdf90, b/325307463)

Version 1.6.3

6. März 2024

androidx.compose.foundation:foundation-*:1.6.3 wird veröffentlicht. Version 1.6.3 enthält diese Commits.

Version 1.6.2

21. Februar 2024

androidx.compose.foundation:foundation-*:1.6.2 wird veröffentlicht. Version 1.6.2 enthält diese Commits.

Fehlerkorrekturen

  • Beheben, dass AnimateContentSize nicht richtig zurückgesetzt wird (I07051)
  • Problem behoben, bei dem intrinsicHeight von Text unter bestimmten Umständen zu stark im Cache gespeichert wurde. (3cd398, b/217910352)

Version 1.6.1

7. Februar 2024

androidx.compose.foundation:foundation-*:1.6.1 wird veröffentlicht. Version 1.6.1 enthält diese Commits.

Fehlerkorrekturen

  • Das Problem mit der Messung von gestaffelten Rastern beim Scrollen über das Limit hinaus wurde behoben. (bffc39)
  • Prüfung für Layout mit großen Abmessungen hinzugefügt. (e74af5)
  • Die Platzierung von Elementen mit der Größe 0 am Anfang des gestaffelten Rasters wurde korrigiert. (785f94)
  • Rufen Sie den onRelease-Callback in derselben Reihenfolge wie onForgotten auf. (31ce3b)

Version 1.6.0

24. Januar 2024

androidx.compose.foundation:foundation-*:1.6.0 wird veröffentlicht. Version 1.6.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.5.0

  • Mit dem neuen Modifier Modifier.anchoredDraggable können Sie zwischen vordefinierten Ankern ziehen und animieren. Dieser Modifikator soll Modifier.swipeable ersetzen. Informationen zur Verwendung und Migration von Modifier.swipeable finden Sie in der Migrationsanleitung.
  • Es wurde eine Drag-and-drop-Funktion zwischen Apps und Komponenten hinzugefügt. DragAndDropTarget, Modifier.dragAndDropSource und andere APIs für den Einstieg
  • Modifier.draggable2D ist der neue Modifier, der das Ziehen in 2D erleichtert. Beispiel
  • AndroidExternalSurface und AndroidEmbeddedExternalSurface wurden hinzugefügt, um das Hinzufügen von oberflächenbezogenen Komponenten in Compose zu erleichtern.
  • Verschiedene API-Änderungen und Verbesserungen in Pager und snapFlingBehaviour
  • Verschiedene APIs für Fokus, Text und Insets wurden in stabile APIs umgewandelt.

Version 1.6.0-rc01

10. Januar 2024

androidx.compose.foundation:foundation-*:1.6.0-rc01 wird veröffentlicht. Version 1.6.0-rc01 enthält diese Commits.

API-Änderungen

  • Der Erweiterungskonstruktor DragAndDropTarget() wurde entfernt. Erstellen Sie mit object: DragAndDropTarget {} eine neue Instanz. (I32318)

Version 1.6.0-beta03

13. Dezember 2023

androidx.compose.foundation:foundation-*:1.6.0-beta03 wird veröffentlicht. Version 1.6.0-beta03 enthält diese Commits.

Fehlerkorrekturen

  • Absturz behoben, der bei sehr großen Texten mit unendlichen Einschränkungen aufgetreten ist. (I1a7df, b/312294386)
  • PlatformImeOptions ist jetzt eine konkrete Klasse anstelle einer Schnittstelle. (If40a4)

Version 1.6.0-beta02

29. November 2023

androidx.compose.foundation:foundation-*:1.6.0-beta02 wird veröffentlicht. Version 1.6.0-beta02 enthält diese Commits.

Fehlerkorrekturen

  • Fehler behoben: canScroll wird nach dem Scrollen nur mit neuem Layout nicht aktualisiert. (I60a86)
  • Korrektur für Modifier.animateItemPlacement() und LookaheadScope nach kurzen Scrollvorgängen. (I3a2b7)

Version 1.6.0-beta01

15. November 2023

androidx.compose.foundation:foundation-*:1.6.0-beta01 wird veröffentlicht. Version 1.6.0-beta01 enthält diese Commits.

API-Änderungen

  • Der Modifikator DragAndDropTarget akzeptiert jetzt explizit das empfangende DragAndDropTarget und hat eine Lambda-Funktion, um eine Drag-and-drop-Sitzung zu starten. Es gibt jetzt zwei Factory-Funktionen für ein DragAndDropModifierNode. Eine zum Empfangen von Übertragungen und eine zum Übertragen von Daten (I69481)
  • maximumFlingVelocity wird jetzt als Float dargestellt. Die Dokumentation wurde aktualisiert, um die Einheit maximumFlingVelocity klarer zu erläutern. (I8adc7)
  • onDragAndDropStart in der DragAndDropModifierNode-Factory wurde in acceptDragAndDropTransfer umbenannt.

    acceptsDragAndDropTransfer wurde dem dragAndDropTarget Modifier hinzugefügt, um die Annahme aus einer Drag-and-drop-Sitzung zu ermöglichen. Diese Lambda-Funktion gibt eine gültige DragAndDropTarget zurück, wenn Sie an einer Drag-and-drop-Sitzung interessiert sind. Andere Lambdas für die Verarbeitung von Drag-Vorgängen wurden dadurch ersetzt.

    Eine DragAndDropTarget-Factory-Funktion wurde hinzugefügt, um Daten aus Drag-and-drop-Sitzungen zu empfangen (Iebf3a).

  • Durch die Bereitstellung von startDragImmediately in AnchoredDraggable können Ziehgesten erkannt werden. Es ist sinnvoll, diese Eigenschaft festzulegen, wenn das Widget zu einem Zielanker animiert wird. Beispiel (Ie6d13, b/285139987)

  • Die Foundation Tooltip APIs sind jetzt @ExperimentalFoundationApi (I30b0b).

  • DragAndDropInfo wurde als Typ entfernt. DragAndDropModifierNode.drag akzeptiert jetzt Parameter für transferData, die Dekorationsgröße und die Lambda-Funktion für das Ziehen von Dekorationen DrawScope.

    DragAndDropTarget hat Methoden für bestimmte Drag-and-drop-Ereignisse anstelle einer einzelnen abstrakten Methode.

    onDragAndDropEvent in der Factory-Funktion für ein DragAndDropModifierNode wurde in onDragAndDropStart umbenannt, um besser zu verdeutlichen, dass das bereitgestellte DragAndDropTarget nur für eine bestimmte Drag-and-drop-Sitzung gültig ist.

    Die DragAndDropEventType wurde entfernt (I645b1)

  • PlatformTextInputModifierNode.runTextInputSession wurde in establishTextInputSession umbenannt. (I03cd0)

  • Ersetzen Sie OriginalText durch TextSubstitution. (Ifa5a8)

  • PlatformTextInputModifierNode.textInputSession wurde in runTextInputSession umbenannt. (Ie9c6b)

  • Die untergeordneten Elemente von SubcomposeLayout (und Layouts wie LazyColumn, die darauf basieren), die zur Wiederverwendung in der Zukunft beibehalten werden, gelten als deaktiviert. Es wurde eine neue assertIsDeactivated()-Test-API eingeführt, um solche Knoten zu testen. Bei den restlichen Test-APIs werden deaktivierte Knoten standardmäßig herausgefiltert. (I2ef84, b/187188981)

  • Der Parameter clippingEnabled von Modifier.magnifier wurde in clip umbenannt.

  • Der Parameter magnifierCenter von Modifier.magnifier ist jetzt nullable, das Standardverhalten bleibt aber gleich. (I6aa66)

  • Die Material SwipeToReveal-APIs (für Karten und Chips) basieren jetzt auf einer slotbasierten API (wie von Compose empfohlen) anstelle von datenklassenbasierten Instanzen, um diese Slots zu erstellen. Dies ist eine wichtige Änderung. In der Demo und im Beispielcode finden Sie Beispiele für die Verwendung der neuen API. (Ia8943)

Fehlerkorrekturen

  • Implementieren Sie „equals“ und „hashcode“ für PageSize.Fixed. (Ie3ede, b/300134276)
  • Es wurde ein Fehler behoben, der dazu führte, dass das BasicText-Layout nicht verkleinert wurde, wenn sich minWidth geändert hat und minWidth kleiner als die ursprünglichen Messbeschränkungen maxWidth (Idb19c) war.
  • Renderer-Unterstützung für Sweep Gradient in ArcLine hinzufügen. (I4d5bb)
  • Binärkompatibilitätsproblem bei Änderung des Window Inset behoben (Iee695)
  • Die Material-Kernschicht für Material3-Chips/-Schaltflächen wurde entfernt, da die Microbenchmarks ohne sie eine bessere Leistung zeigen. (I55555)

Version 1.6.0-alpha08

18. Oktober 2023

androidx.compose.foundation:foundation-*:1.6.0-alpha08 wird veröffentlicht. Version 1.6.0-alpha08 enthält diese Commits.

Neue Funktionen

API-Änderungen

  • Bei Modifier.dragAndDrawSource wurde das onDrawDragShadow-Lambda in drawDragDecoration umbenannt und bei DragAndDropInfo wurde der Größenparameter in dragDecorationSize umbenannt. (Id0e30, b/303904810)
  • Der Parameter decorationBox von BasicTextField2 wurde in decorator umbenannt. Der Typ wird in ein entsprechendes Fun-Interface TextFieldDecorator geändert. (I23c1c)

Fehlerkorrekturen

  • Verbesserte Dokumentation zu BasicTextField in Bezug auf die onValueChange-Anforderungen. (I90fc9, b/160257648)

Version 1.6.0-alpha07

4. Oktober 2023

androidx.compose.foundation:foundation-*:1.6.0-alpha07 wird veröffentlicht. Version 1.6.0-alpha07 enthält diese Commits.

API-Änderungen

  • PlatformTextInputMethodTestOverride wurde eingeführt, um Tests für benutzerdefinierte Texteditoren zu schreiben. (Id159b)
  • GraphicsSurface wurde in AndroidExternalSurface umbenannt (I11680)
  • Das temporäre Flag DisableNonLinearFontScalingInCompose wurde hinzugefügt, um die nicht lineare Skalierung der Schriftgröße zu deaktivieren. Legen Sie DisableNonLinearFontScalingInCompose = true in Ihren Tests fest, wenn Sie Zeit für die Bereinigung benötigen. Dieses Flag wird in Compose 1.6.0-beta01 entfernt. (Ic9486)
  • Die Sammlungen ColorList und ColorSet wurden hinzugefügt, um Zuweisungen zu vermeiden. (I744bd)
  • Mit dieser Änderung wird shortSnapVelocityThreshold entfernt, das zu einem Implementierungsdetail der Implementierungen von SnapLayoutInfoProvider geworden ist. (I65f6d)
  • Es wurde der dragAndDropSource-Modifikator zum Starten von Drag-and-drop-Vorgängen und der dragAndDropTarget-Modifikator zum Empfangen von Drag-and-drop-Vorgängen hinzugefügt (Ib7828, b/286038936).
  • Dokumentation und Positionsmethode für SnapPositionInLayout aktualisieren. Führen Sie Inhalts-Paddings in die Positionsmethode in SnapPositionInLayout ein. (Id7938, b/300116110)
  • UndoState wurde zu TextFieldState hinzugefügt. Damit können Nutzer ihre Änderungen rückgängig machen oder wiederholen. (Icc024)

Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das basicMarquee nach einer Geschwindigkeitsänderung nicht animiert wurde. (Id2e77, b/297974036)

Version 1.6.0-alpha06

20. September 2023

androidx.compose.foundation:foundation-*:1.6.0-alpha06 wird veröffentlicht. Version 1.6.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Neue zusammensetzbare Wrapper für SurfaceView, TextureView: GraphicsSurface() und EmbeddedGraphicsSurface(). Es handelt sich um eine experimentelle API, die Änderungen und Modifikationen unterliegt. (I9ddb2)
  • Modifier.magnifier() ist jetzt eine stabile API. Dazu gehört auch das Entfernen von MagnifierStyle zugunsten von Inline-Parametern im Modifikator selbst. (I83bec, b/298381260, b/262367109, b/261438887)

API-Änderungen

  • Mit der Einführung von updateCurrentPage und updateTargetPage in ScrollScope sind die letzten Voraussetzungen für die Anpassung des animierten Scrollens durch PagerState.scroll geschaffen. (I9cad5, b/267744105, b/243786897)
  • Entfernen Sie die Dichte aus SnapFlingBehavior. Bei allen Implementierungen von SnapLayoutInfoProvider gibt es bereits eine Möglichkeit, auf die Dichte zuzugreifen. Der Empfängerbereich könnte entfernt werden, was zu einer weniger komplexen Implementierung von SnapFlingBehavior und SnapLayoutInfoProviders führen würde. (I153c3)
  • Weitere Modifikatoren als stabil markiert (I56af1, b/298046462)
  • SnapStepSize wurde aus SnapLayoutInfoProvider entfernt. Die Berechnung sollte anhand der Layoutinformationen erfolgen und über die Annäherungs- oder Einrast-Offsets bereitgestellt werden. (If320c)

Geändertes Verhalten

  • In Compose wird jetzt eine nicht lineare Schriftartskalierung verwendet, um die Lesbarkeit und Barrierefreiheit zu verbessern. Wenn die Schriftgröße in den Systemeinstellungen größer als 100% ist, wird kleiner Text normal vergrößert, bereits großer Text jedoch nur geringfügig. Außerdem werden in SP definierte Zeilenhöhen automatisch angepasst, damit sie proportional zur beabsichtigten Höhe bei 100% Skalierung bleiben. Weitere Informationen finden Sie unter Best Practices für die Schriftartskalierung. (I11518)

Fehlerkorrekturen

  • Entfernen Sie die Verwendung von rememberSaveable für Tooltips. (Icc131, b/299500338)

Version 1.6.0-alpha05

6. September 2023

androidx.compose.foundation:foundation-*:1.6.0-alpha05 wird veröffentlicht. Version 1.6.0-alpha05 enthält diese Commits.

API-Änderungen

  • Fügen Sie Überladungen für BasicSecureTextField hinzu, die einen unveränderlichen Wert und einen Callback zum Ändern dieses Werts akzeptieren, genau wie die aktuelle BasicTextField-API. (Ia4882)
  • Fügen Sie Modifier.preferKeepClear() hinzu, um die Komponierbarkeit zu markieren und ab API 33 keine schwebenden Fenster zu verwenden. (Ib51d5, b/297260115)
  • Die Fling-Geschwindigkeiten in View-Komponenten wie ScrollView und RecyclerView sind auf ViewConfiguration.ScaledMaximumFlingVelocity begrenzt. Compose enthält jetzt eine eigene Version von maximumFlingVelocity, die für Draggable gilt. (Ibf974)
  • Die verworfenen Überladungen Pager und PagerState wurden entfernt. (Iea07e)
  • BasicTooltipBox wurde zu compose.foundation hinzugefügt und PlainTooltipBox und RichTooltipBox wurden aktualisiert, um TooltipBox mit den neuen Composables PlainTooltip und RichTooltip zu verwenden. (I79e1d)

Version 1.6.0-alpha04

23. August 2023

androidx.compose.foundation:foundation-*:1.6.0-alpha04 wird veröffentlicht. Version 1.6.0-alpha04 enthält diese Commits.

API-Änderungen

  • Die ReusableComposition-Schnittstelle zum Verwalten des Lebenszyklus und der Wiederverwendung von Unterkompositionen wurde hinzugefügt. (I812d1, b/252846775)
  • Modifier.focusGroup wurde zu stabilen APIs hochgestuft. (I7ffa3)
  • Fügen Sie Überladungen für BasicTextField2 hinzu, die einen unveränderlichen Wert und einen Callback zum Ändern dieses Werts akzeptieren, genau wie die aktuelle BasicTextField-API. (I3f2b8)
  • GridItemSpan::currentLineSpan ist jetzt eine stabile API. (Icc29c)
  • Die Canvas-API, die contentDescription akzeptiert, ist jetzt stabil. (Ib3d29)
  • viewportSize in ScrollState eingeführt, um die viewPort-Größe der Komponente zu ermitteln, die ScrollState verwendet, nachdem die Messung erfolgt ist. (I8b85a, b/283102682)
  • Ein Problem wurde behoben, bei dem das Prefetching in Pager nicht dem Verhalten in Views entsprach. (I93352, b/289088847)
  • Modifier.consumeWindowInsets(PaddingValues) ist jetzt stabil.
    • Die Deprecated Modifier.consumedWindowInsets API wurde entfernt. Verwenden Sie stattdessen Modifier.consumeWindowInsets. (Id72bb)

Version 1.6.0-alpha03

9. August 2023

androidx.compose.foundation:foundation-*:1.6.0-alpha03 wird veröffentlicht. Version 1.6.0-alpha03 enthält diese Commits.

API-Änderungen

  • Überladung von LazyLayout hinzugefügt. Es wird jetzt eine Lambda-Funktion von LazyLayoutItemProvider akzeptiert, nicht mehr ein einfaches Objekt wie zuvor. Die vorherige Überlastung ist veraltet. (I42a5a)
  • Unterstützung für die Konfiguration von privateImeOptions hinzugefügt (Idb772)

Fehlerkorrekturen

  • Es wurde ein Fehler behoben, bei dem in Textfeldern die Tastatur angezeigt wurde und sie bearbeitet werden konnten, wenn readOnly auf „true“ gesetzt war. Außerdem wurde ein Fehler behoben, durch den die Tastatur nicht angezeigt wurde, wenn readOnly im Fokus von „true“ zu „false“ geändert wurde. (I34a19, b/246909589)

Version 1.6.0-alpha02

26. Juli 2023

androidx.compose.foundation:foundation-*:1.6.0-alpha02 wird veröffentlicht. Version 1.6.0-alpha02 enthält diese Commits.

API-Änderungen

  • PagerLayoutInfo wurde mit Informationen eingeführt, die nach einer Maßnahme in Pager erhoben wurden. Außerdem wurde PageInfo eingeführt, die Informationen zu einer einzelnen gemessenen Seite in Pager. (Iad003, b/283098900)
  • Zusätzliche Anmerkungen zum Angeben zulässiger Eingaben für Composables (I51109)
  • SemanticsNodeInteraction.requestFocus wurde als bequemere und besser auffindbare Möglichkeit zum Anfordern des Fokus in Tests hinzugefügt. (Ie8722)
  • Die PlatformTextInput* API wurde komplett neu gestaltet. (I6c93a, b/274661182, b/267235947, b/277380808)
  • SoftwareKeyboardController und LocalSoftwareKeyboardController sind nicht mehr experimentell. LocalSoftwareKeyboardController ist jetzt auch eine richtige CompositionLocal. (I4c364)
  • Modifier.transformable bietet jetzt den Schwenk-Deltawert im Parameter canPan, um die Richtung des Schwenks zu bestimmen und ihn zuzulassen oder zu unterbinden. (I692aa, b/266829800)
  • Aktualisiert den Modifikator consumeWindowInsets, um die Superklasse AbstractComposeView zu erweitern (Iacd74, b/269479941)

Version 1.6.0-alpha01

21. Juni 2023

androidx.compose.foundation:foundation-*:1.6.0-alpha01 wird veröffentlicht. Version 1.6.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Eine neue AnchoredDraggable API wurde in Foundation eingeführt. Damit lassen sich Komponenten erstellen, die zwischen diskreten Status gezogen werden können, z. B. modale Bottom Sheets. Diese API ersetzt die Swipeable API von Material. (I4a2ed)

API-Änderungen

  • Unterstützung von InputConnection#requestCursorUpdates (I0c69b)
  • scrollAnimationSpec wurde eingeführt, um benutzerdefinierte Animationsspezifikationen zu ermöglichen. BringIntoViewCalculator wurde auf BringIntoViewScroller aktualisiert. (Idb741)
  • Fügen Sie den Typ ResourceResolutionException hinzu, um Throwables zu umschließen, die beim Versuch, Bitmap-Assets zu laden, mit einer Beschreibung des Asset-Pfads, der nicht geladen werden konnte, ausgelöst werden. (I19f44, b/230166331, b/278424788)
  • Es wurden semantische Eigenschaften und Aktionen zur Unterstützung der Textübersetzung hinzugefügt. (I4a6bc)
  • Es wurde eine BringIntoViewCalculator API eingeführt, mit der angepasst werden kann, wie Komponenten wie Scrollable auf bringIntoView-Anfragen reagieren. Die Überladung von „scrollable“ wurde geändert, sodass optional eine Instanz von BringIntoViewCalculator akzeptiert wird. (Iaf5af)

Fehlerkorrekturen

  • Es wurde eine Lint-Prüfung hinzugefügt, die warnt, wenn Sie eine MutableInteractionSource in der Komposition erstellen, ohne sie zu merken. Das ist ähnlich wie bei den Lint-Prüfungen zum Erstellen von veränderbarem Status / Animatable. (I5daae)
  • Unterstützung für die Auswahl per Maus hinzugefügt. Bei der Auswahl per Touch wird die Auswahl wortweise erweitert und zeichenweise verkleinert. (Ic0c6c, b/180639271)
  • Die FocusTargetModifierNode-Schnittstelle wurde hinzugefügt, mit der eine benutzerdefinierte FocusTarget erstellt werden kann. (I9790e)

Version 1.5

Version 1.5.4

18. Oktober 2023

androidx.compose.foundation:foundation-*:1.5.4 wird veröffentlicht. Version 1.5.4 enthält diese Commits.

Version 1.5.3

4. Oktober 2023

androidx.compose.foundation:foundation-*:1.5.3 wird veröffentlicht. In dieser Version gab es keine Änderungen.

Version 1.5.2

27. September 2023

androidx.compose.foundation:foundation-*:1.5.2 wird veröffentlicht. Version 1.5.2 enthält diese Commits.

Fehlerkorrekturen

  • Ein Fehler im Text wurde behoben, der unter bestimmten Umständen zu Abstürzen führte, wenn die Semantik ungültig wurde.

Version 1.5.1

6. September 2023

androidx.compose.foundation:foundation-*:1.5.1 wird veröffentlicht. Version 1.5.1 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Fehler behoben, bei dem in Textfeldern die Tastatur angezeigt wurde und sie bearbeitet werden konnten, wenn readOnly auf „true“ gesetzt war. Außerdem wurde ein Fehler behoben, durch den die Tastatur nicht angezeigt wurde, wenn readOnly im Fokus von „true“ zu „false“ geändert wurde. (I34a19, b/246909589)

Version 1.5.0

9. August 2023

androidx.compose.foundation:foundation-*:1.5.0 wird veröffentlicht. Version 1.5.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.4.0

  • Viele grundlegende Modifikatoren, darunter Modifier.clickable,Modifier.draggable, Modifier.scrollable und Layoutmodifikatoren, wurden zur Modifier.Node API migriert, wodurch der Aufwand für die erste Komposition reduziert wird.
  • Verbesserungen bei der Stabilität von Pager. Viele Fehler wurden behoben.
  • pageCount-Parameter befinden sich jetzt in PagerState statt im Pager selbst.

Version 1.5.0-rc01

26. Juli 2023

androidx.compose.foundation:foundation-*:1.5.0-rc01 wird veröffentlicht. Version 1.5.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Es ist eine optionale Prüfung verfügbar, mit der empfohlen wird, mutableStateOf()-Aufrufe zu den entsprechenden spezialisierten Typen für Primitiven zu migrieren. Die Lint-ID lautet AutoboxingStateCreation. Bisher war diese Prüfung standardmäßig für alle Projekte aktiviert. Wenn Sie diese Warnung im Editor von Android Studio und in den Lint-Ausgaben Ihres Projekts sehen möchten, ändern Sie den Schweregrad von „Informational“ zu „Warning“ (oder höher), indem Sie warning "AutoboxingStateCreation" in der build.gradle- oder build.gradle.kts-Konfiguration Ihres Moduls deklarieren, wie unten gezeigt (I34f7e):

        android {
            lint {
                warning "AutoboxingStateCreation"
            }
            ...
        }
    

Version 1.5.0-beta03

28. Juni 2023

androidx.compose.foundation:foundation-*:1.5.0-beta03 wird veröffentlicht. Version 1.5.0-beta03 enthält diese Commits.

Version 1.5.0-beta02

7. Juni 2023

androidx.compose.foundation:foundation-*:1.5.0-beta02 wird veröffentlicht. Version 1.5.0-beta02 enthält diese Commits.

Version 1.5.0-beta01

24. Mai 2023

androidx.compose.foundation:foundation-*:1.5.0-beta01 wird veröffentlicht. Version 1.5.0-beta01 enthält diese Commits.

API-Änderungen

  • Implementiere PlatformDataProvider, um Herzfrequenz und tägliche Schritte bereitzustellen. Die SensorGateway-Schnittstelle wird aus der öffentlichen API entfernt. (I55b84)

Fehlerkorrekturen

  • Zuweisungen bei Messungen von Lazy Lists/Grids usw. reduzieren (Iaf9e2)
  • Weniger Zuweisungen beim Anwenden von Snapshots (I65c09)
  • Zuweisungen aus federnden Animationen entfernt (Ie9431)
  • Zuweisung aus TextLayout (I0fd11) entfernt
  • Mehrere Zuweisungen beim Tracking der Zeigergeschwindigkeit entfernt (I26bae)

Version 1.5.0-alpha04

10. Mai 2023

androidx.compose.foundation:foundation:1.5.0-alpha04 und androidx.compose.foundation:foundation-layout:1.5.0-alpha04 werden veröffentlicht. Version 1.5.0-alpha04 enthält diese Commits.

API-Änderungen

  • Optimierte TextStyle.merge(...) mit vollständiger Parameterliste hinzugefügt. (Iad234, b/246961787)
  • Stelle eine SnapLayoutInfoProvider vor, die mit LazyGridState verwendet werden kann. (I92134, b/269237141, b/260914964)
  • Das experimentelle Modifier.animateItemPlacement() wurde für den Artikelbereich „Lazy Staggered Grids“ hinzugefügt. Sie können sie auf die Elemente anwenden, um die Animationsposition zu ändern oder die Elemente neu anzuordnen. (I4b62d, b/257034719)
  • GridCells.FixedSize zu „Stabil“ hochstufen Mit FixedSize wird ein LazyGrid definiert, in dem jede Zelle eine genaue Größe auf der Querachse hat. Der verbleibende Platz wird durch die Anordnung auf der Querachse verteilt. (I8542f)
  • Der Empfängerbereich PagerScope für „Pager“ und eine Hilfsfunktion zum Berechnen eines bestimmten Seitenoffsets wurden eingeführt. (If2577)
  • Führen Sie snapPositionalThreshold ein, wenn Sie ein Snap-Fling-Verhalten erstellen. Mit diesem Parameter können Sie einen Positionsschwellenwert für das kurze Einrasten in Pager angeben. (If8f7f)
  • SnapLayoutInfoProvider.calculateSnappingOffsetBounds wurde durch calculateSnappingOffset ersetzt. Bei dieser neuen Methode wird einfach der nächste zu fixierende Offset angefordert. Die Berechnung der Grenzen sollte auf Implementierungsebene erfolgen, da sie davon abhängen kann, wie das Einrasten erfolgen soll. (I923a4)
  • Die LazyStaggeredGrid-APIs wurden auf „Stabil“ hochgestuft. (I633a5)
  • Entfernen Sie pageCount aus Horizontal/VerticalPager. Dies sollte bei der Erstellung des Status angegeben werden. PagerState und rememberPagerState wurden aktualisiert, um die pageCount zu akzeptieren. (Ieb52d, b/266965072)
  • Entfernen Sie pageCount aus Horizontal/VerticalPager. Dies sollte bei der Erstellung des Status angegeben werden. PagerState und rememberPagerState wurden aktualisiert, um die pageCount zu akzeptieren. (Ifa3cb, b/266965072)
  • Stellen Sie shortSnapVelocityThreshold in SnapFlingBehavior von Pager vor. (I7379e, b/275579012)
  • Fügt FlowRowScope und FlowColumnScope hinzu. (I54fe2)

Fehlerkorrekturen

  • Aufrufe zum Abrufen der Semantik für Text, wenn Einschränkungen minWidth und minHeight enthalten, stürzen nicht mehr ab. (Ibd072)
  • Ein Regressionsfehler wurde behoben, durch den die Tastatur für Textfelder in Dialogfeldern, die nicht mit der Dialog-Composable-Funktion erstellt wurden, nicht angezeigt wurde. (I82551, b/262140644)

Version 1.5.0-alpha03

19. April 2023

androidx.compose.foundation:foundation:1.5.0-alpha03 und androidx.compose.foundation:foundation-layout:1.5.0-alpha03 werden veröffentlicht. Version 1.5.0-alpha03 enthält diese Commits.

Mit diesem Release wird der neue Text-Rendering-Stack für Compose aktiviert. Der neue Stack ist leistungsoptimiert. Sie sollten keine sichtbaren Änderungen feststellen.

Wenn Sie Änderungen im gerenderten Text feststellen, können Sie das Problem beheben, indem Sie NewTextRendering1_5 = false festlegen, um den Verhaltensunterschied zu bestätigen. Wenn Sie diese Einstellung festlegen, wird die Komposition erzwungen. Bitte melden Sie alle Verhaltensunterschiede als Fehler.

Das Debug-Flag wird vor der Veröffentlichung von Version 1.5 beta01 entfernt.(Iada23, b/246960758)

API-Änderungen

  • FlowColumn/FlowRow inline einfügen. (Idab37)

Version 1.5.0-alpha02

5. April 2023

androidx.compose.foundation:foundation:1.5.0-alpha02 und androidx.compose.foundation:foundation-layout:1.5.0-alpha02 werden veröffentlicht. Version 1.5.0-alpha02 enthält diese Commits.

API-Änderungen

  • Unterstützung für Zellen mit fester Größe in LazyGrid und Anordnung mit Cross-Axis-Anordnung hinzugefügt. (I83ed9, b/235121277, b/267942510)
  • Unterstützung für Lanes mit fester Größe in LazyStaggeredGrid und Anordnung mit Cross-Axis-Anordnung hinzugefügt. (I7d519)
  • UrlAnnotation in AnnotatedStrings können jetzt über Bedienungshilfen wie TalkBack geöffnet werden. (If4d82, b/253292081)
  • Die semantische Aktion InsertTextAtCursor für Textfelder wurde hinzugefügt. (I11ed5)
  • Bei textbezogenen Testaktionen (z.B. performTextInput) wird der Fokus jetzt direkt über die semantische Aktion angefordert, anstatt auf das Feld zu klicken. (I6ed05)
  • Unterstützung für die Anordnung/den Abstand auf der sekundären Achse mit verticalArrangement in FlowRow und horizontalArrangement in FlowColumn wurde hinzugefügt. Außerdem entfernen wir die verticalAlignment und horizontalAlignment der obersten Ebene in FlowRow/FlowColumn. Entwickler können stattdessen Modifier.align verwenden. So werden Verwechslungen zwischen den Namenskonventionen von verticalAlignment und verticalArrangement vermieden. (I87b60, b/268365538)

Version 1.5.0-alpha01

22. März 2023

androidx.compose.foundation:foundation:1.5.0-alpha01 und androidx.compose.foundation:foundation-layout:1.5.0-alpha01 werden veröffentlicht. Version 1.5.0-alpha01 enthält diese Commits.

API-Änderungen

  • Text und BasicText wurden so umgestaltet, dass das neue Modifiers-System verwendet wird. Das führt in vielen Fällen zu erheblichen Leistungssteigerungen. Es sollten keine Änderungen sichtbar sein. (If1d17, b/246961435)
  • Die Semantikaktion PerformImeAction wurde hinzugefügt, um die IME-Aktion für Texteditor-Knoten aufzurufen. (Ic606f, b/269633506)

Fehlerkorrekturen

  • Die internen Komponenten von Modifier.hoverable wurden aktualisiert. Der Modifikator hoverable wird im Inspector nur angezeigt, wenn er aktiviert ist. (I82103)

Version 1.4

Version 1.4.3

3. Mai 2023

androidx.compose.foundation:foundation:1.4.3 und androidx.compose.foundation:foundation-layout:1.4.3 werden ohne Änderungen veröffentlicht (nur eine Versionsaktualisierung).

Version 1.4.2

19. April 2023

androidx.compose.foundation:foundation:1.4.2 und androidx.compose.foundation:foundation-layout:1.4.2 werden veröffentlicht. Version 1.4.2 enthält diese Commits.

Version 1.4.1

5. April 2023

androidx.compose.foundation:foundation:1.4.1 und androidx.compose.foundation:foundation-layout:1.4.1 werden veröffentlicht. Version 1.4.1 enthält diese Commits.

Version 1.4.0

22. März 2023

androidx.compose.foundation:foundation:1.4.0 und androidx.compose.foundation:foundation-layout:1.4.0 werden veröffentlicht. Version 1.4.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.3.0

  • Die Emoji-Kompatibilitätsintegration wurde Text und TextField sowie dem untergeordneten Absatz hinzugefügt. Sie ist standardmäßig aktiviert, wenn „emojicompat“ konfiguriert ist.
  • EmojiCompat kann für einen bestimmten Text mit PlatformParagraphStyle konfiguriert werden.
  • Unterstützung für den gesamten Zeilenbereich in LazyStaggeredGrid hinzugefügt (I28252)
  • Experimentelles onHover wird ClickableText hinzugefügt (I6938f)
  • Es wurden neue experimentelle Überladungen für die Funktion runComposeUiTest und die Funktionen create*ComposeRule eingeführt, die CoroutineContext-Parameter akzeptieren. Der Kontext wird für die Testzusammensetzung und alle LaunchedEffect- und rememberCoroutineScope()-Aufrufe in der Zusammensetzung verwendet. (I10614, b/265177763)
  • FlowRow und FlowColumn sind jetzt als @ExperimentalFoundationApi verfügbar. Damit lässt sich ein flexibleres zeilen- und spaltenbasiertes Layout von Komponenten erstellen, die in eine neue Zeile umgebrochen werden, wenn auf der Hauptachse nicht genügend Platz ist. (I3a7b2)
  • Modifier.basicMarquee() ist als experimentelle Funktion verfügbar, um Inhalte mit einem Laufbandeffekt anzuzeigen. (I2df44, b/139321650)

Version 1.4.0-rc01

8. März 2023

androidx.compose.foundation:foundation:1.4.0-rc01 und androidx.compose.foundation:foundation-layout:1.4.0-rc01 werden veröffentlicht. Version 1.4.0-rc01 enthält diese Commits.

API-Änderungen

  • Es wurde eine neue Low-Level-API PlatformTextInputAdapter eingeführt, mit der benutzerdefinierte Text-Input-Implementierungen erstellt werden können, die direkt mit Plattform-APIs kommunizieren. (I58df4)
  • Unterstützung für umgekehrtes Layout für LazyStaggeredGrid hinzugefügt. (I3ef4a)

Fehlerkorrekturen

  • Die Semantikaktion von BasicTextFieldSetText aktualisiert den Textpuffer jetzt mit demselben Codepfad wie IME-Updates und die Testfunktionen (z.B. performTextReplacement).
  • Die Texttestfunktionen performTextClearance, performTextReplacement und performTextSelection verwenden jetzt SemanticsActions. (I0807d, b/269633168, b/269624358)

Version 1.4.0-beta02

22. Februar 2023

androidx.compose.foundation:foundation:1.4.0-beta02 und androidx.compose.foundation:foundation-layout:1.4.0-beta02 werden veröffentlicht. Version 1.4.0-beta02 enthält diese Commits.

API-Änderungen

  • Es wurde ein neuer Modifier.Node.onReset()-Callback hinzugefügt, mit dem Sie einen lokalen Status zurücksetzen können, um den Fall richtig zu verarbeiten, in dem Layout wiederverwendet wird (z. B. als Element von LazyColumn). FocusTargetModifierNode wurde korrigiert, um den Fokusstatus richtig zurückzusetzen. (I65495, b/265201972)
  • Der Parameter BlendMode wurde den Methoden DrawScope.drawText, Paragraph.paint und MultiParagraph.paint hinzugefügt, um verschiedene Mischalgorithmen beim Zeichnen von Text auf dem Canvas zu unterstützen. (I57508)
  • Die modifierElementOf() API wurde entfernt. Leiten Sie stattdessen direkt von ModifierNodeElement ab. (Ie6d21)

Fehlerkorrekturen

  • Durch Anpassen der Auswahlgriffe kann kein Teilzeichen mehr ausgewählt werden. (Idedd1)
  • Absturz behoben, der auftrat, wenn Strg + Rücktaste auf ein leeres TextField gedrückt wurde (I0427f, b/244185537)

Version 1.4.0-beta01

8. Februar 2023

androidx.compose.foundation:foundation:1.4.0-beta01 und androidx.compose.foundation:foundation-layout:1.4.0-beta01 werden veröffentlicht. Version 1.4.0-beta01 enthält diese Commits.

Neue Funktionen

  • Seit Version 1.3 wurde die Emoji-Kompatibilitätsintegration für Text und TextField sowie für das untergeordnete Element „Paragraph“ hinzugefügt. Sie ist standardmäßig aktiviert, wenn „emojicompat“ konfiguriert ist.
  • EmojiCompat kann für einen bestimmten Text mit PlatformParagraphStyle konfiguriert werden.

API-Änderungen

  • Es wurde eine gemeinsame Implementierung der PinnableContainer API hinzugefügt, die in allen LazyLayouts verwendet wird, um Elemente beizubehalten, die aus der Komposition entfernt werden, aber weiterhin aktiv sein müssen. (If45a4)
  • PinnableContainer.PinnedHandle.unpin() wurde in release() umbenannt (I4667a)

Externe Beiträge

  • Das Attribut „mainAxisItemSpacing“ wurde den Attributen „LazyListLayoutInfo“, „LazyGridLayoutInfo“ und „LazyStaggeredGridItemInfo“ hinzugefügt (I52fad)

Version 1.4.0-alpha05

25. Januar 2023

androidx.compose.foundation:foundation:1.4.0-alpha05 und androidx.compose.foundation:foundation-layout:1.4.0-alpha05 werden veröffentlicht. Version 1.4.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Unterstützung für den vollständigen Zeilenbereich in LazyStaggeredGrid hinzugefügt (I28252)
  • Experimentelles onHover wird ClickableText hinzugefügt (I6938f)
  • Es wurden neue experimentelle Überladungen für die Funktion runComposeUiTest und die Funktionen create*ComposeRule eingeführt, die CoroutineContext-Parameter akzeptieren. Der Kontext wird für die Testzusammensetzung und alle LaunchedEffect- und rememberCoroutineScope()-Aufrufe in der Zusammensetzung verwendet. (I10614, b/265177763)

API-Änderungen

  • Die Pre-/Post-APIs von OverscrollEffect werden in den kombinierten „Decorator“-Funktionen applyToScroll und applyToFling zusammengeführt. In der Dokumentation finden Sie aktualisierte Beispiele für die Implementierung eines Overscroll-Effekts mit der neuen API. (I8a9c4, b/255554340)
  • Weitere Typen/Nullwerte von Inline-/eingestellten/ausgeblendeten Funktionen (I24f91)
  • Die APIs LineBreak und Hyphens in TextStyle sind jetzt stabil. (Ic1e1d)

Fehlerkorrekturen

  • Der Cursor in Textfeldern blinkt jetzt auch dann weiter, wenn Animationen deaktiviert sind. (I95e70, b/265177763)
  • Modifier.basicMarquee wird jetzt auch animiert, wenn Animationen in den Systemeinstellungen deaktiviert sind. (I23389, b/262298306, b/265177763)

Externe Beiträge

  • notifyFocusedRect-Methoden in TextInputSession und TextInputService sind nicht mehr veraltet. (I23a04, b/262648050)

Version 1.4.0-alpha04

11. Januar 2023

androidx.compose.foundation:foundation:1.4.0-alpha04 und androidx.compose.foundation:foundation-layout:1.4.0-alpha04 werden veröffentlicht. Version 1.4.0-alpha04 enthält diese Commits.

Neue Funktionen

  • FlowRow und FlowColumn sind jetzt als @ExperimentalFoundationApi verfügbar. Damit lässt sich ein flexibleres zeilen- und spaltenbasiertes Layout von Komponenten erstellen, die in eine neue Zeile umgebrochen werden, wenn auf der Hauptachse nicht genügend Platz ist. (I3a7b2)
  • Modifier.basicMarquee()ist als experimentelle Funktion verfügbar, um Inhalte mit einem Laufbandeffekt anzuzeigen. (I2df44, b/139321650)

API-Änderungen

  • FocusRequesterModifier ist zugunsten von FocusRequesterNode veraltet (I7f4d7, b/247708726, b/255352203, b/253043481, b/247716483, b/254529934, b/251840112, b/251859987, b/257141589)
  • Der AndroidFont-Konstruktor mit variationSettings ist jetzt eine stabile API und kann zum Erstellen neuer Arten von Schriftartdeskriptoren verwendet werden. (I5adcc, b/261565807)
  • Die PinnableContainer-API wurde eingeführt, die von Lazy Lists über eine Kompositionslokale weitergegeben wird und das Anpinnen des aktuellen Elements ermöglicht. Das bedeutet, dass das Element nicht verworfen wird, wenn es aus dem Blickfeld gescrollt wird. Mit Modifier.focusable() wird beispielsweise das aktuell fokussierte Element über diesen Mechanismus angepinnt. (Ib8881, b/259274257, b/195049010)
  • Die Art und Weise, wie scrollbare Elemente auf bringIntoViewRequesters reagieren, und fokussierbare Elemente wurden neu geschrieben, um die Komplexität dieser Vorgänge besser zu modellieren und mehr Grenzfälle zu berücksichtigen. (I2e5fe, b/241591211, b/192043120, b/237190748, b/230756508, b/239451114)
  • Weitere Informationen zur Nullable-Eigenschaft des Rückgabetyps von eingestellten, ausgeblendeten Funktionen (Ibf7b0)
  • Experimentelles TextMotion zu TextStyle hinzugefügt, um Text entweder als Static(default) oder als animiert zu definieren. Verwenden Sie TextMotion.Animated, wenn Text durch Animation skaliert, verschoben oder gedreht wird. (I24dd7)
  • TextFieldFocusModifier hinzufügen, um das Fokusnavigationsverhalten für die Android-Plattform zu korrigieren (I00303)
  • Das maxSize: IntSize-Argument in drawText wurde durch size: Size ersetzt, um es an andere DrawScope-Funktionen anzugleichen. size ist standardmäßig auf Size.Unspecified festgelegt, was das bisherige Standardverhalten nicht ändern sollte. (Icd27d)

Fehlerkorrekturen

  • Die Physik des Einrastens in SnapFlingBehaviour wurde angepasst, um ein natürlicheres Gefühl zu vermitteln.

Bekanntes Problem

  • Beim Aktualisieren von androidx.compose.foundation:1.4.0-alpha03 auf androidx.compose.foundation:1.4.0-alpha04 kann der Fehler java.lang.NoSuchFieldError auftreten. Hier wurde das Problem ursprünglich gemeldet. Ein Fix wurde eingereicht und ist im nächsten Compose-Update verfügbar. Als Behelfslösung können Sie Ihre androidx.compose.material- und androidx.compose.material3-Bibliotheken auf die neueste Version(1.1.0-alpha04) aktualisieren oder Ihre androidx.compose.foundation-Bibliothek auf Version 1.4.0-alpha03 downgraden.

Version 1.4.0-alpha03

7. Dezember 2022

androidx.compose.foundation:foundation:1.4.0-alpha03 und androidx.compose.foundation:foundation-layout:1.4.0-alpha03 werden veröffentlicht. Version 1.4.0-alpha03 enthält diese Commits.

API-Änderungen

  • Bei UI-Tests mit einer Compose-Regel werden Fortsetzungen, die während withFrameNanos-Rückrufen fortgesetzt werden, erst nach Abschluss aller Frame-Rückrufe gesendet. Dies entspricht dem Verhalten von Compose bei normaler Ausführung. Tests, die auf dem alten Verhalten basieren, können jedoch fehlschlagen. Dies sollte sich nur auf Code auswirken, der withFrameNanos oder withFrameMillis direkt aufruft und Logik außerhalb des an diese Funktionen übergebenen Rückrufs enthält, die möglicherweise in die Rückrufe verschoben werden muss. In dieser CL finden Sie Beispiele für Änderungen am Animationstest.
  • Dem Konstruktor und der Factory-Funktion von TestMonotonicFrameClock wurde der optionale Parameter onPerformTraversals: (Long) -> Unit hinzugefügt, um Code nach withFrameNanos-Callbacks, aber vor dem Fortsetzen der Coroutinen der Aufrufer auszuführen. (Idb413, b/254115946, b/222093277, b/255802670)
  • Einführung von Aktionen zur Seitenbarrierefreiheit: PageUp, PageDown, PageLeft, PageRight. Diese sind erst ab API 29 verfügbar. (Ida4ab)
  • Einführung von HorizontalPager und VerticalPager, mit denen Composables auf Pager-ähnliche Weise angezeigt werden können. PagerState wurde eingeführt, um die Pager zu steuern und Informationen zum aktuellen Status des Pagers abzufragen. Es wurde PageSize eingeführt, mit dem die Größe einer Pager-Seite gesteuert werden kann. Damit lassen sich karussellartige Pager erstellen. Es wurde PagerSnapDistance eingeführt, um zu steuern, wie das Andocken beim Wischen in einem Pager funktioniert. (I01120)
  • Es wurde eine Überladung in SnapFlingBehavior.performFling eingeführt, um besser nachvollziehen zu können, wo der Fling endet. (I569f6)
  • OverscrollEffect#isEnabled wurde entfernt. Anstatt sich dieses Flag merken und festlegen zu müssen, sollten Sie in Fällen, in denen kein Overscroll angezeigt werden soll (z. B. wenn ScrollableState#canScrollForward/backward beide „false“ zurückgeben), keine Ereignisse an den Overscroll-Effekt senden. (I1a4b0, b/255554340, b/255557085)
  • ScrollableState#canScrollForward und ScrollableState#canScrollBackward wurden hinzugefügt, um abzufragen, ob ein ScrollableState in beide Richtungen gescrollt werden kann (ob es sich am Minimum oder Maximum des Bereichs befindet). Der Standardwert ist „true“, um die Abwärtskompatibilität mit vorhandenen Implementierungen von ScrollableState zu gewährleisten. Damit kann dem Nutzer angezeigt werden, dass noch Platz zum Scrollen vorhanden ist. Außerdem kann so vermieden werden, dass Delta an ScrollableStates gesendet werden, die in einer bestimmten Richtung keinen Platz zum Scrollen haben, um unnötige Arbeit zu reduzieren. (Idf1a0, b/255557085)
  • Eine Modifier API zum Abfragen von Scrollinformationen für übergeordnete Elemente wurde hinzugefügt. (I2ba9d, b/203141462)
  • Wird in Clickable verwendet, um Tippinteraktionen richtig zu verzögern, wenn aus Gesten Scroll-Ereignisse werden könnten.
  • Das Problem, dass Clickables Ripples nicht richtig verzögert hat, wenn es in einem Scrollable ViewGroup verwendet wurde, wurde behoben.
  • Die Schubladen und Sheets wurden aktualisiert, um das Drücken korrekt zu verzögern, falls Gesten zu Scroll-Ereignissen werden können.
  • Aktualisieren Sie die Benennung von snapStepSize, damit sie mit anderen Methoden in SnapLayoutInfoProvider übereinstimmt. (Ife67c)
  • EmojiCompat wurde zu Compose hinzugefügt (Ibf6f9, b/139326806)
  • consumedWindowInsets() wurde in consumeWindowInsets() und withConsumedWindowInsets() in onConsumedWindowInsetsChanged() umbenannt. Außerdem wurden die Modifikatoren öffentlich gemacht. (Ie44e1)

Fehlerkorrekturen

  • Der Absturz mit Modifier.animateItemPlacement() und Lazy Grids wurde behoben. Das Problem trat unter bestimmten Bedingungen auf, wenn die Anzahl der neuen Elemente geringer war als die vorherige. (I0bcac, b/253195989)

Version 1.4.0-alpha02

9. November 2022

androidx.compose.foundation:foundation:1.4.0-alpha02 und androidx.compose.foundation:foundation-layout:1.4.0-alpha02 werden veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.

API-Änderungen

  • awaitFirstDown und waitForUpOrCancellation akzeptieren jetzt ein PointerEventPass, um mehr Flexibilität zu bieten. (I7579a, b/212091796)
  • beyondBoundCount-API von Lazy*-APIs zurücksetzen (I12197)
  • Parameter in Lazy APIs eingeführt, um Elemente außerhalb des sichtbaren Bereichs zu erstellen und zu platzieren (I69e89, b/172029355)
  • Der Parameter minLines wurde den BasicText und BasicTextField hinzugefügt. Damit kann die Mindesthöhe dieser Composables in Bezug auf die Anzahl der Zeilen festgelegt werden (I24294, b/122476634).

Version 1.4.0-alpha01

24. Oktober 2022

androidx.compose.foundation:foundation:1.4.0-alpha01 und androidx.compose.foundation:foundation-layout:1.4.0-alpha01 werden veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.

API-Änderungen

  • Es wurde eine neue Methode, awaitEachGesture(), für Gestenerkennung hinzugefügt. Sie funktioniert ähnlich wie forEachGesture(), aber die Schleife über Gesten erfolgt vollständig innerhalb von AwaitPointerEventScope, sodass keine Ereignisse zwischen den Iterationen verloren gehen können.
  • forEachGesture() wurde zugunsten von awaitEachGesture() eingestellt, da bei forEachGesture() Ereignisse zwischen Gesten verloren gehen können. (Iffc3f, b/251260206)
  • WindowInsets.imeAnimationSourc und WindowInsets.imeAnimationTarget wurden hinzugefügt, um den Fortschritt der Animation zu bestimmen und zu wissen, wo sich die IME nach Abschluss der Animation befindet. (I356f1, b/217770337)

Version 1.3

Version 1.3.1

9. November 2022

androidx.compose.foundation:foundation:1.3.1 und androidx.compose.foundation:foundation-layout:1.3.1 werden veröffentlicht. Version 1.3.1 enthält diese Commits.

Fehlerkorrekturen

  • Leistungsproblem in BeyondBoundsLayout beheben (aosp/2255266)
  • ContentInViewModifier liest keine Layoutkoordinaten, sofern nicht angehängt (aosp/2241316)

Version 1.3.0

24. Oktober 2022

androidx.compose.foundation:foundation:1.3.0 und androidx.compose.foundation:foundation-layout:1.3.0 werden veröffentlicht. Version 1.3.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.2.0

  • Es wurden experimentelle Versionen von LazyVerticalStaggeredGrid und LazyHorizontalStaggeredGrid eingeführt.
  • SnapFlingBehavior, rememberSnapFlingBehavior und andere entsprechende APIs wurden als experimentell hinzugefügt.
  • Bei Modifier.clickable, Modifier.toggleable und Modifier.selectable werden jetzt Welleneffekte angezeigt, wenn sie mit der Tastatur oder dem Steuerkreuz auf einer Fernbedienung angeklickt werden.

Version 1.3.0-rc01

5. Oktober 2022

androidx.compose.foundation:foundation:1.3.0-rc01 und androidx.compose.foundation:foundation-layout:1.3.0-rc01 werden veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.

API-Änderungen

  • Die neue Variable lowVelocityAnimationSpec wird im Ansatzschritt verwendet, wenn die Fling-Geschwindigkeit nicht ausreicht, um abzunehmen. (Iaeb27)
  • Die neue experimentelle API „Hyphens“ wurde hinzugefügt, um die automatische Silbentrennung in Text zu unterstützen (Iaa869).

Version 1.3.0-beta03

21. September 2022

androidx.compose.foundation:foundation:1.3.0-beta03 und androidx.compose.foundation:foundation-layout:1.3.0-beta03 werden veröffentlicht. Version 1.3.0-beta03 enthält diese Commits.

API-Änderungen

  • Es wurden Optionen zum Anpassen des Zeilenumbruchs in Text hinzugefügt. (I86907)
  • BringIntoViewResponder können jetzt während der Verarbeitung einer Anfrage die aktuellsten Grenzen abrufen. (If86a5, b/241591211)
  • Unterstützung für Abstände zwischen Elementen in der experimentellen Staggered Grid (I10b82) einführen
  • Einführung von Inhalts-Padding für experimentelle Staggered Grid (I342ea)
  • Das size:IntSize-Argument wurde in der TextMeasurer.measure-Methode durch constraints: Constraints ersetzt, um Mindestbreitenbeschränkungen zu unterstützen. (I37530, b/242707525)
  • Modifier.withConsumedWindowInsets() wurde hinzugefügt, um WindowInsets für die Verwendung außerhalb von windowInsetsPadding abzurufen.
  • MutableWindowInsets wurde hinzugefügt, um WindowInsets ohne Neukomposition einfach ändern zu können. (I7fd28, b/237019262, b/243119659)

Version 1.3.0-beta02

7. September 2022

androidx.compose.foundation:foundation:1.3.0-beta02 und androidx.compose.foundation:foundation-layout:1.3.0-beta02 werden veröffentlicht. Version 1.3.0-beta02 enthält diese Commits.

API-Änderungen

  • Erste Version der experimentellen StaggeredGrid (Ia48be)
  • FocusDirection.In und FocusDirection.Out wurden in FocusDirection.Enter und FocusDirection.Exit umbenannt (Ia4262, b/183746982)
  • Es wurde eine rememberSnapFlingBehavior-Überladung eingeführt, mit der das Einrasten in LazyLists schnell aktiviert werden kann. (Ifb48a)
  • Die snapFlingBehavior-Factory wurde durch eine konkrete SnapFlingBehavior-Klasse ersetzt. Die SnapLayoutInfoProvider-Methoden wurden auf die Dichte beschränkt, um die Konvertierung von Dp<->Px für die API-Nutzer zu vereinfachen. (I54a11)
  • LazyLayoutMeasureScope.measure wurde aktualisiert, um eine Liste von platzierbaren Elementen zurückzugeben. Dabei wird die gewünschte Unveränderlichkeit des zurückgegebenen Werts hervorgehoben. (I48b7c)
  • SnapLayoutInfoProvider wurde eingeführt. Es verwendet ein LazyListState, um eine Instanz von SnapLayoutInfoProvider zu erstellen, mit der ein Snap FlingBehavior für LazyLists aktiviert werden kann. (I2dd10)

Fehlerkorrekturen

  • AwaitPointerEventScope#awaitLongPressOrCancellation wird so umgestaltet, dass es anderen Await-Funktionen entspricht (I646e6).

Version 1.3.0-beta01

24. August 2022

androidx.compose.foundation:foundation:1.3.0-beta01 und androidx.compose.foundation:foundation-layout:1.3.0-beta01 werden veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.

API-Änderungen

  • pointerPosition aus OverscrollEffect entfernt – Effekte, bei denen es auf die Zeigerposition ankommt, können stattdessen Modifier.pointerInput { } in effectModifier verwenden, um die aktuelle Zeigerposition abzurufen. (I9f606, b/241239306)
  • AwaitPointerEventScope#awaitLongPressOrCancellation als zusätzlicher Baustein für die komplexere Gestenerkennung verfügbar gemacht (I04374, b/181577176)
  • lazyListSnapLayoutInfoProvider wurde eingeführt, um das Einrasten in Lazy Lists zu ermöglichen. (I3ecdf)
  • SnapFlingBehavior wurde eingeführt, ein Fling-Verhalten, das das Einrasten von Listen ermöglicht. Geben Sie eine Instanz von SnapLayoutInfoProvider mit Informationen zu Ihrem Andocklayout an. (Ie754c)

Version 1.3.0-alpha03

10. August 2022

androidx.compose.foundation:foundation:1.3.0-alpha03 und androidx.compose.foundation:foundation-layout:1.3.0-alpha03 werden veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.

API-Änderungen

  • Für Ressourcen-Schriftarten können jetzt Schriftartvariationen festgelegt werden (API 26+). (I900dd, b/143703328)
  • Unterstützung variabler Schriftarten in DeviceFontFamilyNameFont (Ic1279, b/143703328)
  • Die experimentelle Anmerkung wurde aus PlatformTextStyle und LineHeightStyle entfernt. (I64bef)
  • Für Textfelder werden jetzt detailliertere Ausnahmen ausgelöst, wenn die von einem VisualTransformation bereitgestellte OffsetMapping ungültige Indexe zurückgibt. (Ie73f9, b/229378536)
  • Einführung experimenteller APIs zum Teilen der Logik des Elementanbieters zwischen Lazy-Layouts. (Ic891c)
  • ScrollableDefaults.reverseDirection() ist nicht mehr experimentell. (Iba646)
  • SemanticsModifier.id wurde verworfen und die Semantik-ID wurde stattdessen in LayoutInfo.semanticsId verschoben. (Iac808, b/203559524)
  • checkScrollableContainerConstraints() ist nicht mehr experimentell. (I2c290)
  • Modifier.clipScrollableContainer() ist nicht mehr experimentell. (Ia2b44)
  • TextInputService.show|hideSoftwareKeyboard einstellen Verwenden Sie stattdessen SoftwareKeyboardController im App-Code und TextInputSession im IME-Verwaltungscode. (I14e4c, b/183448615)

Version 1.3.0-alpha02

27. Juli 2022

androidx.compose.foundation:foundation:1.3.0-alpha02 und androidx.compose.foundation:foundation-layout:1.3.0-alpha02 werden veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.

API-Änderungen

  • Die Erweiterungsfunktion drawText wurde für DrawScope hinzugefügt, um das Zeichnen von Text mit mehreren Stilen in Composables und Modifiers zu ermöglichen, die auf einem DrawScope wie Canvas und drawBehind basieren. (I16a62, b/190787898)

Fehlerkorrekturen

  • Die Bildschirmtastatur wird jetzt ausgeblendet, wenn ein Textfeld deaktiviert wird, während es fokussiert ist. (I6e3e4, b/237308379)
  • Wenn wir dem Velocity Tracker InputEventChange-Ereignisse hinzufügen, berücksichtigen wir jetzt Deltas anstelle von Positionen. So wird die Geschwindigkeit in allen Fällen korrekt berechnet, auch wenn sich das Zielelement bewegt (Icea9d, b/216582726, b/223440806, b/227709803).
  • Wenn ein scrollbares Element ein fokussiertes untergeordnetes Element hat, wird jetzt richtig gescrollt, damit das fokussierte untergeordnete Element im Blickfeld bleibt, wenn seine Größe verringert wird, auch wenn die Größe animiert wird. (I80867, b/230756508, b/220119990)
  • Ein Absturz wurde behoben, der auftrat, wenn TextField geleert und neu befüllt wurde, während die Auswahl aktiv war. (I1235b, b/208655565, b/214253689)

Version 1.3.0-alpha01

29. Juni 2022

androidx.compose.foundation:foundation:1.3.0-alpha01 und androidx.compose.foundation:foundation-layout:1.3.0-alpha01 werden veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.

API-Änderungen

  • Der Annotationstyp UrlAnnotation und die zugehörigen Methoden wurden eingeführt, um die Unterstützung von TalkBack-Links in AnnotatedStrings zu ermöglichen. (I1c754, b/231495122)

Fehlerkorrekturen

  • BasicTextField cursorBrush kann jetzt animiert werden, ohne dass der Cursor-Timer neu gestartet wird. (I812e6, b/236383522)

Version 1.2

Version 1.2.1

10. August 2022

androidx.compose.foundation:foundation:1.2.1 und androidx.compose.foundation:foundation-layout:1.2.1 werden veröffentlicht. Version 1.2.1 enthält diese Commits.

Version 1.2.0

27. Juli 2022

androidx.compose.foundation:foundation:1.2.0 und androidx.compose.foundation:foundation-layout:1.2.0 werden veröffentlicht. Version 1.2.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.1.0

  • LazyVerticalGrid und LazyHorizontalGrid sind jetzt stabil.
  • Sie können jetzt einen Inhaltstyp für Elemente in Lazy Lists und Grids angeben. So können die Komponenten Elemente effizienter wiederverwenden.
  • Lazy Lists und Grids haben jetzt den Parameter userScrollEnabled, mit dem das Scrollen über Nutzergesten deaktiviert werden kann.
  • Es wurde eine neue experimentelle API namens LazyLayout hinzugefügt. Sie wird intern verwendet, um Lazy Lists und Grids zu unterstützen.
  • Die OverscrollEffect API wurde als experimentell eingeführt. Sie können benutzerdefinierte Overscroll-Effekte definieren und benutzerdefinierten scrollbaren Containern einen Standardeffekt hinzufügen.
  • Es wurden APIs für die Interoperabilität von verschachteltem Scrollen eingeführt, um die Interoperabilität zwischen Ansichten und Compose-Scrolling-Akteuren zu ermöglichen.
  • Allen Scrollcontainern wurde die Möglichkeit hinzugefügt, mit Maus und Trackpad zu scrollen.

Version 1.2.0-rc03

29. Juni 2022

androidx.compose.foundation:foundation:1.2.0-rc03 und androidx.compose.foundation:foundation-layout:1.2.0-rc03 werden veröffentlicht. Version 1.2.0-rc03 enthält diese Commits.

  • Keine Änderungen seit Version 1.2.0-rc02.

Version 1.2.0-rc02

22. Juni 2022

androidx.compose.foundation:foundation:1.2.0-rc02 und androidx.compose.foundation:foundation-layout:1.2.0-rc02 werden veröffentlicht. Version 1.2.0-rc02 enthält diese Commits.

Version 1.2.0-rc01

15. Juni 2022

androidx.compose.foundation:foundation:1.2.0-rc01 und androidx.compose.foundation:foundation-layout:1.2.0-rc01 werden veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.

API-Änderungen

  • Es wurde eine experimentelle OverscrollEffect eingeführt, um benutzerdefinierte Overscroll-Effekte zu ermöglichen. Außerdem gibt es die Modifier.scrollable-Überladungen, die sie akzeptieren.
  • Die experimentelle LocalOverScrollConfiguration wurde von foundation.gesture in das Fundamentpaket verschoben und in LocalOverscrollConfiguration umbenannt (If19fb, b/204650733).
  • Schnittstellen in Compose-Bibliotheken werden jetzt mit den Standard-Schnittstellenmethoden von JDK8 erstellt (I5bcf1).
  • Es wurde eine experimentelle API checkScrollableContainerConstraints() eingeführt, mit der geprüft werden kann, ob verschachtelte scrollbare Container vorhanden sind. Sie können es verwenden, wenn Sie eigene scrollbare Lazy-Layouts über LazyLayout erstellen. (Id6fab, b/233352497)
  • Die eingestellte LazyVerticalGrid wurde aus dem androidx.compose.foundation.lazy-Paket entfernt. Die neue stabile API befindet sich unter androidx.compose.foundation.lazy.grid (I73c76, b/225192009).

Version 1.2.0-beta03

1. Juni 2022

androidx.compose.foundation:foundation:1.2.0-beta03 und androidx.compose.foundation:foundation-layout:1.2.0-beta03 werden veröffentlicht. Version 1.2.0-beta03 enthält diese Commits.

API-Änderungen

  • Die neuen experimentellen IntervalList und MutableIntervalList wurden hinzugefügt. Damit lässt sich eine Liste von Werten über mehrere Intervalle darstellen. Das ist nützlich, wenn Sie eine eigene DSL definieren möchten, die der von LazyColumn verwendeten ähnelt, wobei Listenelemente über mehrere item-/items-Aufrufe definiert werden können. (I2d05e, b/228580728)

Fehlerkorrekturen

  • Die Dokumentation für WindowInsets.ime wurde dahingehend aktualisiert, dass ime-Einzüge bereits ab API 23 gemeldet werden, aber nur animiert ab API 30. (Ia7fc0, b/230756508)
  • Wenn Sie die Entf-Taste drücken, während sich der Cursor am Ende eines Textfelds befindet, stürzt die App nicht mehr ab.
  • Für DeleteSurroundingTextCommand und DeleteSurroundingTextInCodePointsCommand müssen die Konstruktorargumente jetzt nicht negativ sein. (Ica8e6, b/199919707)

Version 1.2.0-beta02

18. Mai 2022

androidx.compose.foundation:foundation:1.2.0-beta02 und androidx.compose.foundation:foundation-layout:1.2.0-beta02 werden veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.

  • Die Auflösung herunterladbarer Schriftarten, die die Layoutgröße von Text oder TextField nicht ändert, wurde zuvor nicht neu gezeichnet, was zu einer veralteten Schriftartdarstellung führte. Dieser Bugfix sorgt dafür, dass das Textlayout immer ein erneutes Zeichnen auslöst (b/229727404). (I1d49e, b/229727404)

Version 1.2.0-beta01

11. Mai 2022

androidx.compose.foundation:foundation:1.2.0-beta01 und androidx.compose.foundation:foundation-layout:1.2.0-beta01 werden veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.

Neue Funktionen

  • Dies ist die erste Betaversion von 1.2.

API-Änderungen

  • Experimentelle BeyondBoundsInterval hinzugefügt, die von benutzerdefinierten Implementierungen von LazyList verwendet werden kann, wenn Elemente außerhalb der sichtbaren Grenzen angeordnet werden (Ifabfb, b/184670295)
  • LineHeightBehavior wird in LineHeightStyle umbenannt.
  • LineVerticalAlignment wird in LineHeightStyle.Alignment umbenannt.
  • LineHeightTrim wird in LineHeightStyle.Trim umbenannt
  • Standardkonstruktorwerte aus LineHeightStyle wurden entfernt (I582bf, b/181155707)
  • Es wurden Standardwerte für die optionalen Elemente der LazyLayoutItemProvider-Schnittstelle hinzugefügt. (Iba8a0)
  • In der LazyLayoutItemProvider-API gibt es jetzt anstelle einer Factory, die das zusammensetzbare Lambda nach Index zurückgibt, eine einfachere zusammensetzbare Funktion „Item“, die den Index akzeptiert. (Id2196)
  • LazyLayoutItemsProvider wurde in LazyLayoutItemProvider umbenannt (I0638c)
  • LazyLayoutItemsProvider.itemsCount wird in itemCount umbenannt (Id409c)
  • TextStyle und SpanStyle wurde „Pinsel“ hinzugefügt, um Text mit Farbverlauf zu zeichnen. (I53869, b/187839528)
  • Die Attribute trimFirstLineTop und trimLastLineBottom von LineHeightBehavior wurden in einem einzigen Enum geändert: LineHeightTrim. LineHeightTrim hat Werte für vier Status, die durch zwei boolesche Werte definiert werden: FirstLineTop, LastLineBottom, „Both“ (Beide) und „None“ (Keine) (Ifc6a5, b/181155707).
  • LineHeightBehavior wurde zu TextStyle hinzugefügt. Mit ParagraphStyle. LineHeightBehavior wird festgelegt, ob die Zeilenhöhe auf die Oberkante der ersten Zeile und die Unterkante der letzten Zeile angewendet wird. Außerdem wird die Ausrichtung der Zeile im von TextStyle(lineHeight) bereitgestellten Bereich definiert.

    So ist es beispielsweise möglich, über LineHeightBehavior(alignment = LineVerticalAlignment.Center, trimFirstLineTop=false, trimLastLineBottom = false) ein ähnliches Verhalten wie bei CSS zu erzielen.

  • trimFirstLineTop- und trimLastLineBottom-Konfigurationen funktionieren nur dann richtig, wenn includeFontPadding auf „false“ gesetzt ist. (I97332, b/181155707)

  • Der experimentelle Modifikator imeNestedScroll() wurde hinzugefügt, damit Entwickler die IME durch Scrollen steuern können. (I60759)

Fehlerkorrekturen

  • Ein Regressionsfehler wurde behoben, durch den das Tastaturfeld nicht ausgeblendet wurde, wenn es aus der Komposition entfernt wurde, während es fokussiert war. (I7a410, b/230536793, b/225541817)
  • Unterstützung von Auslassungspunkten, wenn die Höhe begrenzt ist und nicht alle Textzeilen passen (Ie528c, b/168720622)
  • BringIntoViewRequester.bringIntoView wird jetzt immer angehalten, bis die Anfrage abgeschlossen ist oder durch eine neuere, nicht überschneidende Anfrage unterbrochen wird. Sich überschneidende Anfragen werden in die Warteschlange gestellt. (I43e7f, b/216790855)
  • Bei gleichzeitigen BringIntoViewRequester.bringIntoView-Aufrufen für Rechtecke, die sich vollständig überlappen, wird jetzt nur noch die Anfrage des größeren Rechtecks berücksichtigt. (I34be7, b/216790855, b/184760918)
  • Standardmäßig aktiviert includeFontPadding. Sie können die includeFontPadding mit dem Attribut TextStyle.platformTextStyle deaktivieren. In naher Zukunft werden wir das Standardverhalten ändern. Bis dahin können wir jedoch die Verbesserungen der Zeilenhöhe (aosp/2058653) besser integrieren und Probleme mit dem Abschneiden von TextField beheben. (I01423, b/171394808)
  • Modifier.bringIntoViewRequester verwendet onGloballyPositioned nicht mehr. (I630f5)

Externe Beiträge

  • MouseInjectionScope.scroll(delta = someDelta) wird jetzt unter Android invertiert, wenn wir vertikal scrollen. Wenn „someDelta“ positiv ist, wird nach unten gescrollt. (Ifb697, b/224992993)

Version 1.2.0-alpha08

20. April 2022

androidx.compose.foundation:foundation:1.2.0-alpha08 und androidx.compose.foundation:foundation-layout:1.2.0-alpha08 werden veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.

API-Änderungen

  • Alle verfügbaren Schriftstärken für Systemschriftarten auf Android werden angezeigt, wenn FontFamily.SansSerif verwendet wird. Dabei werden intern Fallback-Schriftartnamen wie „sans-serif-medium“ für API 21–28 verwendet. Dies ist eine Verhaltensänderung, da zuvor nur die Schriftstärken 400 und 700 in API 21–28 unterstützt wurden. (I380fe, b/156048036, b/226441992)
  • Die Parameter „Constraints“ werden jetzt für „Paragraph“ und „MultiParagraph“ akzeptiert. Das Übergeben von Constraints.maxHeight ist derzeit ein No-Op, ermöglicht aber in Zukunft einige Berechnungen, z. B. das Kürzen basierend auf der Höhe. (I6afee, b/168720622)
  • SubcomposeSlotReusePolicy.getSlotsToRetain() akzeptiert jetzt eine benutzerdefinierte MutableSet-ähnliche Klasse, der keine neuen Elemente hinzugefügt werden können. (Icd314)
  • Die teilweise Nutzung (Down- oder Position) wurde in PointerInputChange eingestellt. Mit consume() können Sie die Änderung vollständig übernehmen. Mit isConsumed können Sie feststellen, ob die Änderung bereits von jemand anderem übernommen wurde.
  • PointerInputChange::copy() erstellt jetzt immer eine oberflächliche Kopie. Das bedeutet, dass Kopien von PointerInputChange verbraucht werden, sobald eine der Kopien verbraucht wird. Wenn Sie ein ungebundenes PointerInputChange erstellen möchten, verwenden Sie stattdessen den Konstruktor. (Ie6be4, b/225669674)
  • Die neue experimentelle LazyLayout API wird eingeführt. So können Sie eigene Komponenten wie LazyColumn von LazyVerticalGrid erstellen. Die API befindet sich noch in der Anfangsphase und kann in zukünftigen Releases geändert werden. (Iba2bc, b/166591700)
  • AndroidFont verwendet jetzt typefaceLoader als Konstruktorparameter. (I2c971)
  • WindowInsets-Begleit-Apps geben jetzt die Sichtbarkeit (ob sie auf dem Bildschirm angezeigt werden, unabhängig davon, ob sie sich mit dem Fenster überschneiden) und die Größe an, die sie haben könnten, wenn sie auf dem Gerät verfügbar, aber derzeit nicht aktiv sind. (I65182, b/217770337)

Version 1.2.0-alpha07

6. April 2022

androidx.compose.foundation:foundation:1.2.0-alpha07 und androidx.compose.foundation:foundation-layout:1.2.0-alpha07 werden veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.

API-Änderungen

  • Es wurde eine PinnableParent-API hinzugefügt, mit der untergeordnete Elemente von Lazy Layouts verhindern können, dass die aktuell zusammengesetzten Elemente verworfen werden (Ibbdd0, b/184670295).
  • LazyListLayoutInfo und LazyGridLayoutInfo haben jetzt die Felder beforeContentPadding und afterContentPadding (I3b628, b/200920410)
  • KeyboardType.Decimal wurde als Alternative zu Keyboard.Number hinzugefügt, um das Dezimaltrennzeichen speziell in IME einzuschließen. (Iec4c8, b/209835363)
  • Der neue Schriftartdeskriptor „Font(DeviceFontFamilyName)“ ermöglicht es, während der Schriftart-Fallback-Ketten optional nach auf dem System installierten Schriftarten zu suchen. (I30468, b/219754572)
  • PointerEventType.Scroll und PointerEvent.scrollDelta sind jetzt stabile APIs (I574c5, b/225669674)
  • Die temporäre Kompatibilitätskonfiguration für includeFontPadding, die in TextStyle/ParagraphStyle. includeFontPadding hinzugefügt wurde, kann über TextStyle(platformStyle = PlatformTextStyle(includeFontPadding = true/false)) geändert werden. Dies ist eine vorübergehende Konfigurationsoption, um die Migration zu ermöglichen. Sie wird wieder entfernt. (If47be, b/171394808)
  • FontFamily.Resolver wurde aktualisiert, um die Bedienungshilfe-Einstellung „Systemweiter Fettdruck“ (I6c1e7) zu integrieren.
  • Mit der Erweiterungseigenschaft consumeWindowInsets von ComposeView können Entwickler die Verwendung von Android WindowInsets deaktivieren. So können separate ComposeViews in der Hierarchie jeweils WindowInsets anwenden, ohne sich gegenseitig zu beeinträchtigen. (I0ef08, b/220943142)

Version 1.2.0-alpha06

23. März 2022

androidx.compose.foundation:foundation:1.2.0-alpha06 und androidx.compose.foundation:foundation-layout:1.2.0-alpha06 werden veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.

API-Änderungen

  • Die Semantikaktion RequestFocus wurde hinzugefügt, um den Fokus auf das fokussierbare Ziel zu richten. (I17b71)
  • FocusOrder wurde jetzt in FocusProperties zusammengeführt und focusProperties() bietet jetzt alle Funktionen von focusOrder(). FocusOrder und focusOrder() wurden eingestellt. focusOrder(), das focusRequester akzeptiert, sollte durch den Modifikator focusRequester() in Kombination mit focusProperties() ersetzt werden. So können die Modifizierer besser voneinander getrennt werden. (I601b7)
  • WindowInsets.asPaddingValues(Density) wurde hinzugefügt, damit Entwickler die Konvertierung durchführen können, ohne sich in der Komposition zu befinden. (I94c35)
  • Die Verarbeitung von Vektordrawables wurde aktualisiert, um das automatische Spiegeln zu unterstützen. Dadurch wird der Inhalt eines VectorPainter gespiegelt, wenn die aktuelle Layoutrichtung RTL ist. (I79cd9, b/185760237)

Fehlerkorrekturen

  • Scroll-Modifikatoren (Modifier.verticalScroll(), Modifier.horizontalScroll() und Modifier.scrollable()) scrollen jetzt so, dass die fokussierte Composable sichtbar bleibt, wenn der Scrollbereich in der Größe geändert wird und die fokussierte Composable zuvor sichtbar war.
  • Textfelder bleiben jetzt über der Tastatur, wenn sie fokussiert sind und die Tastatur angezeigt wird, wenn sie sich in einem nicht verzögert scrollbaren Element befinden und der Soft-Input-Modus ADJUST_RESIZE ist. (I4a485, b/190539358, b/192043120, b/216842427)

Version 1.2.0-alpha05

9. März 2022

androidx.compose.foundation:foundation:1.2.0-alpha05 und androidx.compose.foundation:foundation-layout:1.2.0-alpha05 werden veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.

API-Änderungen

  • LazyVerticalGrid und LazyHorizontalGrid sind jetzt stabil. (I307c0)
  • LazyGridItemInfo.Unknown wurde durch separate LazyGridItemInfo.UnknownRow und LazyGridItemInfo.UnknownColumn ersetzt (I56d51)
  • LazyVerticalGrid/LazyHorizontalGrid und alle zugehörigen APIs wurden in das Unterpaket .grid verschoben. Bitte aktualisieren Sie Ihre Importe von androidx.compose.foundation.lazy auf androidx.compose.foundation.lazy.grid. (I2d446, b/219942574)
  • Text: includeFontPadding ist jetzt standardmäßig deaktiviert. Die Beschneidungsprobleme, die durch includeFontPadding=false verursacht werden, wurden behoben. Bei hohen Skripts sollte es nicht mehr zu Beschneidungen kommen. (I31c84, b/171394808)
  • Die gemessene Schnittstelle macht jetzt die parentData-Property verfügbar (I3313f)
  • Experimentelles Modifier.onFocusedBoundsChanged eingeführt, um die Grenzen von untergeordneten Elementen mit Fokus zu beobachten. (I14283, b/220030968, b/190539358, b/192043120, b/216842427)
  • „LazyHorizontalGrid“ wurde hinzugefügt. (I61ae7, b/191238807)
  • Eine neue LazyVerticalGrid API zum Definieren von Größen für die Querachse wurde hinzugefügt (I17723).
  • „FocusGroup“-Modifikator hinzugefügt (I64bc0, b/213508274, b/184670295)

Fehlerkorrekturen

  • In WindowInsets.toString() werden jetzt die richtigen Werte angezeigt. (I1585d)

Externe Beiträge

  • Aktualisiert auf Kotlinx-Coroutines 1.6.0 (I3366d)

Version 1.2.0-alpha04

23. Februar 2022

androidx.compose.foundation:foundation:1.2.0-alpha04 und androidx.compose.foundation:foundation-layout:1.2.0-alpha04 werden veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.

API-Änderungen

  • BringIntoViewResponders müssen Anfragen nicht mehr manuell an übergeordnete Responder weiterleiten, sondern müssen stattdessen sofort das Rechteck zurückgeben, das ihr übergeordnetes Element in den Blickpunkt rücken soll. (I8e66a)
  • Asynchrones Laden von Schriftarten im Textblock unterstützen (I77057, b/214587005)
  • LazyVerticalGrid unterstützt jetzt line breaking vor Elementen mit einem Bereich, der nicht in die aktuelle Zeile passt. (I05c40, b/207462103)
  • excludeFromSystemGestures wurde in systemGesturesExclusion umbenannt (I19526)
  • LazyVerticalGrid unterstützt jetzt „reverseLayout“. (I6d7d7, b/215572963, b/211753558)
  • Fügen Sie die Methode WindowInsets.only() hinzu, damit Entwickler nur Dimensionen aus WindowInsets einbeziehen können. (I14c94, b/217768486)
  • Die Funktionen ComposableTarget, ComposableTargetMarker und ComposableOpenTarget wurden hinzugefügt, mit denen zur Kompilierzeit gemeldet werden kann, wenn eine zusammensetzbare Funktion für einen Applier aufgerufen wird, für den sie nicht vorgesehen ist.

    In den meisten Fällen können die Annotationen vom Compose-Compiler-Plug-in abgeleitet werden. Die direkte Verwendung dieser Annotationen sollte daher selten sein. Die Fälle, die nicht abgeleitet werden können, umfassen das Erstellen und Verwenden eines benutzerdefinierten Appliers, abstrakte zusammensetzbare Funktionen (z. B. Schnittstellenmethoden), Felder oder globale Variablen, die zusammensetzbare Lambdas sind (lokale Variablen und Parameter werden abgeleitet), oder wenn ComposeNode oder eine zugehörige zusammensetzbare Funktion verwendet wird.

    Bei benutzerdefinierten Appliern muss für die zusammensetzbaren Funktionen, die ComposeNode oder ReusableComposeNode aufrufen, die Annotation CompoableTarget für die Funktion und alle zusammensetzbaren Lambda-Parametertypen hinzugefügt werden. Es wird jedoch empfohlen, eine Annotation zu erstellen, die mit ComposableTargetMarker annotiert ist, und dann die markierte Annotation anstelle von ComposableTarget direkt zu verwenden. Eine mit ComposableTargetMarker markierte zusammensetzbare Annotation entspricht einem ComposbleTarget mit dem vollständig qualifizierten Namen der Attributklasse als „applier“-Parameter. Ein Beispiel für die Verwendung von ComposableTargetMarker finden Sie unter anroidx.compose.ui.UiComposable. (I38f11)

Fehlerkorrekturen

  • Es ist jetzt zulässig, negative Scroll-Offsets an LazyGridState.scrollToItem() und LazyGridState.animateScrollToItem() zu übergeben. (I025c6, b/211753558)
  • Unterstützung des asynchronen Schriftartenladens für TextField. (Icc4bf, b/214587005)

Version 1.2.0-alpha03

9. Februar 2022

androidx.compose.foundation:foundation:1.2.0-alpha03 und androidx.compose.foundation:foundation-layout:1.2.0-alpha03 werden veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.

API-Änderungen

  • notifyFocusedRect-Methoden in TextInputSession und TextInputService sind jetzt veraltet und werden nicht mehr aufgerufen. Verwenden Sie stattdessen BringIntoViewRequester. (Ia4302, b/192043120, b/216842427, b/178211874)
  • Animationen wurden für Elemente von Lazy Grids mit Modifier.animateItemPlacement() aktiviert. (Ib6621, b/211753218)
  • BringIntoViewRequester leitet Anfragen jetzt an die Hosting-Android-Ansicht weiter. (Ia7a51)
  • FontFamilyResolver ist jetzt über LocalFontFamilyResolver.current verfügbar.
    • createFontFamilyResolver(context) und createFontFamilyResolver(context, coroutineScope) wurden hinzugefügt, um neue FontFamily-Resolver außerhalb der Compose-Verwendung zu erstellen.
    • Für Paragraph und MultiParagraph wird jetzt FontFamily.Resolver verwendet.
    • TextLayoutResult.layoutInput.fontFamilyResolver enthält jetzt den Resolver, der für dieses Layout verwendet wird. TextLayoutResult.layoutInput.resourceLoader ist veraltet und wird nicht mehr verwendet. (Id5a45, b/174162090)
  • AndroidFont wurde hinzugefügt, eine neue Low-Level-API zum Bereitstellen neuer Arten von Schriftartressourcendeskriptoren unter Android. Beispielsweise können Sie Schriftarten aus einem app-spezifischen Backend laden, optional vorinstallierte Schriftarten auf dem Gerät suchen oder eine Schriftart aus einer Ressource laden, die nicht von den aktuellen Schriftart-Factories bereitgestellt wird.
    • Die Font.ResourceLoaded API wurde erweitert, um optionales und asynchrones Laden von Schriftarten zu unterstützen. Es wird nicht empfohlen, dass Anwendungsentwickler diese API direkt verwenden. Informationen zum Hinzufügen neuer Schriftarttypen finden Sie unter AndroidFont.
    • Mit der Erweiterungsfunktion Font.AndroidResourceLoader kann ein Font.ResourceLoader außerhalb der Komposition erstellt werden.
    • Der Parameter loadingStrategy wurde ressourcenbasierten Schriftarten hinzugefügt, um das asynchrone Laden zu ermöglichen, wenn in Ressourcen-Schriftartreferenzen herunterladbare Schriftarten in XML angegeben sind. (Ie5aea, b/174162090)
  • Der Konstruktor Typeface(FontFamily) wurde eingestellt. Diese Funktion wurde zuvor zum Vorabladen von Schriftarten verwendet. Das kann bei herunterladbaren Schriftarten bis zu 10 Sekunden dauern. Bei herunterladbaren Schriftarten kann dieser Aufruf 10 Sekunden lang blockiert werden. Verwenden Sie stattdessen FontFamilyResolver.preload.
    • fontResource(FontFamily): Typeface ist veraltet. Diese Funktion wurde zuvor zum Vorabladen von Schriftarten verwendet. Das kann bei herunterladbaren Schriftarten bis zu 10 Sekunden dauern. Verwenden Sie stattdessen FontFamilyResolver.preload (If8e7c, b/174162090).
  • Sie können jetzt den Inhaltstyp für die Elemente von LazyVerticalGrid angeben. Die Funktionen „item“ / „items“ für LazyGridScope akzeptieren jetzt einen solchen Parameter. Wenn Sie solche Informationen angeben, kann die Logik für die Wiederverwendung von Elementen effizienter arbeiten und Inhalte nur zwischen Elementen ähnlichen Typs wiederverwenden. (I7b355, b/215372836)
  • LazyListLayoutInfo und LazyGridLayoutInfo haben jetzt neue Properties: viewportSize, orientation, reverseLayout (Ifc8ed, b/200920410)
  • Sie können jetzt den Inhaltstyp für die Elemente der Funktionen „item“/„items“ von „LazyColumn“/„LazyRow“ angeben. „LazyListScope“ akzeptiert jetzt einen solchen Parameter. Wenn Sie solche Informationen angeben, kann die Logik für die Wiederverwendung von Elementen effizienter arbeiten und Inhalte nur zwischen Elementen ähnlichen Typs wiederverwenden. (I26506)
  • Der SubcomposeLayoutState-Konstruktor, der maxSlotsToRetainForReuse akzeptiert, wurde eingestellt. Stattdessen gibt es einen neuen Konstruktor, der SubcomposeSlotReusePolicy akzeptiert. Das ist eine neue Schnittstelle, mit der sich genauer steuern lässt, welche Slots für die zukünftige Wiederverwendung beibehalten werden sollen. (I52c4d)
  • Fügt Modifiers für WindowInsets hinzu, sowohl für Padding als auch für die Größenanpassung. So können sich einige Inhalte in den Inset-Bereich erstrecken, während die primären Inhalte außerhalb des Inset-Bereichs bleiben. Mit windowInsetsPadding kann beispielsweise der Inhaltsbereich so aufgefüllt werden, dass Bereiche vermieden werden, die vollständig oder teilweise abgedeckt werden könnten. (Id0395, b/213942085)

Fehlerkorrekturen

  • Textfelder bleiben jetzt über der Tastatur, wenn sie fokussiert sind und die Tastatur angezeigt wird, sofern der Modus für die Softwaretastatur ADJUST_PAN ist. (I8eaeb, b/190539358, b/192043120)
  • Auf dem Desktop wird die Komposition lokal für FontFamily.Resolver verwendet.
    • Die Desktopversion von FontLoader wird eingestellt
    • Neue createFontFamilyResolver-Fabrik auf dem Computer (I6bbbb, b/174162090)
  • Der Eingabetyp der Bildschirmtastatur flackert nicht mehr, wenn der Fokus zwischen Textfeldern gewechselt wird. (I1bf50, b/187746439)
  • Bei Textfeldern ist kein zusätzliches Zurückdrücken mehr erforderlich, wenn der Cursorgriff angezeigt wird. (Ideb4b, b/205726883)
  • Das Verhalten der Lupe bei der Textauswahl wurde optimiert, um der Plattformlupe zu entsprechen. (Idd918, b/206833278)

Version 1.2.0-alpha02

26. Januar 2022

androidx.compose.foundation:foundation:1.2.0-alpha02 und androidx.compose.foundation:foundation-layout:1.2.0-alpha02 werden veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.

API-Änderungen

  • NonRestartableComposable wurde Methoden hinzugefügt, die Überladungen vorhandener Methoden ohne komplexe Logik sind. Dadurch werden die vom Compiler generierten Memoization-Prüfungen (equals) für alle Parameter reduziert, die in der aufgerufenen inneren Funktion wiederholt werden. (I90490)
  • excludeFromSystemGesture-Modifikatoren für den einfachen Zugriff auf setSystemGestureExclusionRects (I46f07) von Android hinzugefügt

Fehlerkorrekturen

  • Das Verhalten der Lupe bei der Textauswahl wurde optimiert, um der Plattformlupe zu entsprechen. (Idd918, b/206833278)
  • LazyColumn, LazyRow, Modifier.verticalScroll und andere Container, die Modifier.scrollable verwenden, unterstützen jetzt das Scrollen mit dem Mausrad. (I2b5e1, b/198214718)

Version 1.2.0-alpha01

12. Januar 2022

androidx.compose.foundation:foundation:1.2.0-alpha01 und androidx.compose.foundation:foundation-layout:1.2.0-alpha01 werden veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.

API-Änderungen

  • Der neue Parameter userScrollEnabled wurde LazyColumn, LazyRow und LazyVerticalGrid hinzugefügt, damit Nutzer das durch Touch-Gesten oder Bedienungshilfen ausgelöste Scrollen vorübergehend oder dauerhaft deaktivieren können. Das programmgesteuerte Scrollen über die Methoden im Status ist weiterhin zulässig. (I7eae9, b/201150093)
  • onSizeChanged-Callback zum Lupenmodifikator hinzufügen. (I6879f)
  • Das Lupen-Widget wird jetzt angezeigt, wenn Sie Auswahlziehpunkte in einem SelectionContainer ziehen. (I30b38, b/139320979)

Fehlerkorrekturen

  • Das Problem wurde behoben, dass der Cursor-Ziehpunkt TextField nicht ausgeblendet wurde, wenn er aus dem Blickfeld gescrollt wurde. (I14552, b/208883748)

Abhängigkeitsupdates

  • Jetzt von Kotlin 1.6.10 abhängig.

Version 1.1

Version 1.1.1

23. Februar 2022

androidx.compose.foundation:foundation:1.1.1 und androidx.compose.foundation:foundation-layout:1.1.1 werden veröffentlicht. Version 1.1.1 enthält diese Commits.

Fehlerkorrekturen

  • Fehler bei NullPointerException unter androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList beheben (aosp/1947059, b/206677462)
  • Ein Absturz, der durch Zwischenablageinhalte beim Lesen aus der Zwischenablage unter Android verursacht wurde, wurde behoben. (I06020, b/197769306)
  • RTL-Problem in LazyVerticalGrid behoben (aosp/1931080, b/207510535)

Version 1.1.0

9. Februar 2022

androidx.compose.foundation:foundation:1.1.0 und androidx.compose.foundation:foundation-layout:1.1.0 werden veröffentlicht. Version 1.1.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.0.0

  • Stabile Unterstützung für den Overscroll-Effekt von Android 12
  • Verbesserungen bei der Größe von Berührungszielen
  • Im Vergleich zu Compose 1.0 wird der Layoutbereich von Material-Komponenten erweitert, um den Richtlinien für Bedienungshilfen in Material Design für die Größe von Berührungszielen zu entsprechen. Der Berührungszielbereich einer Schaltfläche wird beispielsweise auf eine Mindestgröße von 48 × 48 dp erweitert, auch wenn Sie die Größe der Schaltfläche kleiner festlegen. Dadurch wird Compose Material an das Verhalten von Material Design Components angepasst. So ist das Verhalten konsistent, wenn Sie Views und Compose mischen. Diese Änderung sorgt auch dafür, dass beim Erstellen der Benutzeroberfläche mit Compose Material-Komponenten die Mindestanforderungen für die Barrierefreiheit von Touch-Zielen erfüllt werden.
  • Stabile Unterstützung für Navigation Rail
  • Eine Reihe zuvor experimenteller APIs wird auf stabil umgestellt.
  • Unterstützung für neuere Versionen von Kotlin

Version 1.1.0-rc03

26. Januar 2022

androidx.compose.foundation:foundation:1.1.0-rc03 und androidx.compose.foundation:foundation-layout:1.1.0-rc03 werden veröffentlicht. Version 1.1.0-rc03 enthält diese Commits.

Fehlerkorrekturen

  • Aktualisiert zur Unterstützung von Compose Material 1.1.0-rc03

Version 1.1.0-rc01

15. Dezember 2021

androidx.compose.foundation:foundation:1.1.0-rc01 und androidx.compose.foundation:foundation-layout:1.1.0-rc01 werden veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Es ist jetzt zulässig, negative Scroll-Offsets an LazyListState.scrollToItem() und LazyListState.animateScrollToItem() zu übergeben. (Iceb90, b/184252837)
  • Ein Fehler wurde behoben, der dazu führte, dass Scrollaktionen für die Barrierefreiheit (I7cbfb) fehlten.

Version 1.1.0-beta04

1. Dezember 2021

androidx.compose.foundation:foundation:1.1.0-beta04 und androidx.compose.foundation:foundation-layout:1.1.0-beta04 werden veröffentlicht. Version 1.1.0-beta04 enthält diese Commits.

Neue Funktionen

  • Aktualisiert, um mit Kotlin 1.6.0 kompatibel zu sein

API-Änderungen

  • Nullwerte in androidx.core.view bereinigt(I7078a, b/204917439)
  • Es wurden experimentelle APIs hinzugefügt, mit denen PointerInputchange als Ganzes genutzt werden kann oder mit denen geprüft werden kann, ob es genutzt wurde oder nicht. (I2e59d)
  • Ein Lupen-Widget wird angezeigt, wenn der Cursor oder die Auswahl-Handles in Textfeldern gezogen werden. (I5391e, b/203781358)

Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das sich die Textziehpunkte nicht bewegten, wenn sich die IME-Sichtbarkeit änderte. (I25f2e)

Version 1.1.0-beta03

17. November 2021

androidx.compose.foundation:foundation:1.1.0-beta03 und androidx.compose.foundation:foundation-layout:1.1.0-beta03 werden veröffentlicht. Version 1.1.0-beta03 enthält diese Commits.

API-Änderungen

  • LazyVerticalGrid unterstützt jetzt auch horizontale Spannen. (I7e2fa, b/176758183)
  • Es wurde eine experimentelle Funktion zum Animieren von Lazy-List-Elementpositionen hinzugefügt. In LazyItemScope ist ein neuer Modifikator namens Modifier.animateItemPlacement() verfügbar. Anwendungsbeispiel:

      var list by remember { mutableStateOf(listOf("A", "B", "C")) }
      LazyColumn {
          item {
              Button(onClick = { list = list.shuffled() }) {
                  Text("Shuffle")
              }
          }
          items(list, key = { it }) {
              Text("Item $it", Modifier.animateItemPlacement())
          }
      }
    
    • Wenn Sie einen Schlüssel über LazyListScope.item oder LazyListScope.items bereitstellen, werden durch diesen Modifikator Animationen für das Neuanordnen von Elementen aktiviert. Neben der Neuanordnung von Elementen werden auch alle anderen Positionsänderungen, die durch Ereignisse wie Anordnungs- oder Ausrichtungsänderungen verursacht werden, animiert. (I59e7b, b/150812265)

Version 1.1.0-beta02

3. November 2021

androidx.compose.foundation:foundation:1.1.0-beta02 und androidx.compose.foundation:foundation-layout:1.1.0-beta02 werden veröffentlicht. Version 1.1.0-beta02 enthält diese Commits.

Fehlerkorrekturen

  • Wellen und andere Hinweise werden jetzt nur noch verzögert, wenn sie sich in einem Modifier.scrollable()-Container befinden, anstatt immer bei einem Down-Ereignis verzögert zu werden. (Ibefe0, b/203141462)
  • Die experimentelle BringIntoView API wurde hinzugefügt. Mit ihr können Sie eine Anfrage an übergeordnete Elemente senden, damit diese scrollen, um ein Element in den sichtbaren Bereich zu bringen (Ib918d, b/195353459).

Externe Beiträge

  • Modifier.pointerHoverIcon wurde hinzugefügt (I95f01)

Version 1.1.0-beta01

27. Oktober 2021

androidx.compose.foundation:foundation:1.1.0-beta01 und androidx.compose.foundation:foundation-layout:1.1.0-beta01 werden veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

Fehlerkorrekturen

  • Die experimentelle BringIntoView API wurde hinzugefügt. Mit ihr können Sie eine Anfrage an übergeordnete Elemente senden, damit diese scrollen, um ein Element in den sichtbaren Bereich zu bringen (Ib918d, b/195353459).

Version 1.1.0-alpha06

13. Oktober 2021

androidx.compose.foundation:foundation:1.1.0-alpha06 und androidx.compose.foundation:foundation-layout:1.1.0-alpha06 werden veröffentlicht. Version 1.1.0-alpha06 enthält diese Commits.

API-Änderungen

  • Für „Layout“ wurde eine überladene Version ohne untergeordnete Elemente hinzugefügt, die effizienter ist (Ib0d9a).
  • SemanticsNodeInteraction.performSemanticsAction gibt jetzt das SemanticsNodeInteraction zurück, für das die Funktion aufgerufen wurde. (I9e5db)
  • Added performScrollToNode(matcher: SemanticsMatcher) that scrolls a scrollable container to the content that is matched by the given matcher. (Ic1cb8)

Version 1.1.0-alpha05

29. September 2021

androidx.compose.foundation:foundation:1.1.0-alpha05 und androidx.compose.foundation:foundation-layout:1.1.0-alpha05 werden veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.

API-Änderungen

Fehlerkorrekturen

  • Die Barrierefreiheitsunterstützung für scrollbare Elemente (sowohl Lazy- als auch Nicht-Lazy-Elemente) in Bezug auf das Scrollen wurde korrigiert (I6cdb0).

Version 1.1.0-alpha04

15. September 2021

androidx.compose.foundation:foundation:1.1.0-alpha04 und androidx.compose.foundation:foundation-layout:1.1.0-alpha04 werden veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.

API-Änderungen

  • Die Methoden performGesture und GestureScope wurden verworfen und durch performTouchInput und TouchInjectionScope ersetzt. (Ia5f3f, b/190493367)
  • touchBoundsInRoot wurde zu SemanticsNode hinzugefügt. Diese enthält die Mindestgröße für Berührungszielbereiche, damit Entwickler sicherstellen können, dass Berührungszielbereiche die Mindestanforderungen für die Barrierefreiheit erfüllen. (I2e14b, b/197751214)

Fehlerkorrekturen

  • Auf Geräten mit Android 12 wird jetzt das Dehnen beim Overscrollen unterstützt. (Iccf3c, b/171682480)

Version 1.1.0-alpha03

1. September 2021

androidx.compose.foundation:foundation:1.1.0-alpha03 und androidx.compose.foundation:foundation-layout:1.1.0-alpha03 werden veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.

Neue Funktionen

  • Compose 1.1.0-alpha03 wurde aktualisiert und hängt jetzt von Kotlin 1.5.30 ab. (I74545)

API-Änderungen

  • Es wurde ein Glüheffekt für das Scrollen hinzugefügt. Es wurde eine neue experimentelle OverScrollConfiguration-API hinzugefügt, mit der der visuelle Overscroll-Effekt konfiguriert werden kann. Geben Sie „null“ an, um den Overscroll-Effekt zu deaktivieren. (I0c304, b/171682480)
  • AwaitPointerEventScope hat jetzt withTimeout() und withTimeoutOrNull() (I507f0, b/179239764, b/182397793)
  • Es wurde eine Testmethode zum Abrufen der beschnittenen Grenzen hinzugefügt. (I6b28e)
  • Der ViewConfiguration wurde eine Mindestgröße für den Berührungszielbereich hinzugefügt, die in der Semantik und bei der Zeigereingabe verwendet wird, um die Barrierefreiheit zu gewährleisten. (Ie861c)

Version 1.1.0-alpha02

18. August 2021

androidx.compose.foundation:foundation:1.1.0-alpha02 und androidx.compose.foundation:foundation-layout:1.1.0-alpha02 werden veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.

API-Änderungen

  • DpSize-Versionen für Modifier.size und requiredSize hinzugefügt (I3fc7e, b/194219828)

Version 1.1.0-alpha01

4. August 2021

androidx.compose.foundation:foundation:1.1.0-alpha01 und androidx.compose.foundation:foundation-layout:1.1.0-alpha01 werden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

API-Änderungen

  • Die Methode DrawScope#drawImage wurde aktualisiert und verwendet jetzt Quell- und Zielrechtecke, um einen optionalen Parameter „FilterQuality“ zu verwenden. Das ist nützlich für Pixelkunst, die beim Hochskalieren für pixelbasierte Kunst bewusst verpixelt werden soll. Die Composables „BitmapPainter“ und „Image“ wurden aktualisiert, sodass sie auch einen optionalen Parameter „FilterQuality“ verwenden (Ie4fb0, b/180311607).
  • Im TextField wird die Auswahl jetzt gelöscht, wenn die Zurück-Schaltfläche gedrückt wird. Das entspricht dem Verhalten von EditText unter Android. (I3ca16, b/174173645)
  • Cursor-Handle hinzufügen (I07a82, b/173016579)

Fehlerkorrekturen

  • Das Scrollen über semantische Aktionen für Lazy Lists und reguläre Scrollkomponenten ist jetzt animiert (Id9066, b/190742024).

Externe Beiträge

  • LazyVerticalGrid akzeptiert jetzt sowohl Parameter für die horizontale als auch für die vertikale Anordnung. (If9c92)

Version 1.0

Version 1.0.5

3. November 2021

androidx.compose.foundation:foundation:1.0.5 und androidx.compose.foundation:foundation-layout:1.0.5 werden veröffentlicht. Version 1.0.5 enthält diese Commits.

Fehlerkorrekturen

  • Ein Absturz beim Tracking von „derivedStateOf“-Instanzen wurde behoben. (aosp/1792247)

Version 1.0.4

13. Oktober 2021

androidx.compose.foundation:foundation:1.0.4 und androidx.compose.foundation:foundation-layout:1.0.4 werden veröffentlicht. Version 1.0.4 enthält diese Commits.

Abhängigkeitsupdates

  • Aktualisiert, um von Kotlin 1.5.31 abhängig zu sein

Version 1.0.3

29. September 2021

androidx.compose.foundation:foundation:1.0.3 und androidx.compose.foundation:foundation-layout:1.0.3 werden veröffentlicht. Version 1.0.3 enthält diese Commits.

Abhängigkeitsupdates

  • Aktualisiert, um von Kotlin 1.5.30 abhängig zu sein

Version 1.0.2

1. September 2021

androidx.compose.foundation:foundation:1.0.2 und androidx.compose.foundation:foundation-layout:1.0.2 werden veröffentlicht. Version 1.0.2 enthält diese Commits.

Aktualisiert zur Unterstützung der Compose-Version 1.0.2. Compose 1.0.2 ist weiterhin mit Kotlin 1.5.21 kompatibel.

Version 1.0.1

4. August 2021

androidx.compose.foundation:foundation:1.0.1 und androidx.compose.foundation:foundation-layout:1.0.1 werden veröffentlicht. Version 1.0.1 enthält diese Commits.

Abhängigkeitsupdates

  • Die Abhängigkeit wurde auf Kotlin 1.5.21 aktualisiert.

Version 1.0.0

28. Juli 2021

androidx.compose.foundation:foundation:1.0.0 und androidx.compose.foundation:foundation-layout:1.0.0 werden veröffentlicht. Version 1.0.0 enthält diese Commits.

Wichtige Funktionen von Version 1.0.0

Dies ist die erste stabile Version von Compose. Weitere Informationen finden Sie im offiziellen Compose-Release-Blog.

Bekannte Probleme

  • Wenn Sie Android Studio Bumblebee Canary 4 oder AGP 7.1.0-alpha04/7.1.0-alpha05 verwenden, kann es zu folgendem Absturz kommen:

      java.lang.AbstractMethodError: abstract method "void androidx.lifecycle.DefaultLifecycleObserver.onCreate(androidx.lifecycle.LifecycleOwner)"
    

    Um das Problem zu beheben, erhöhen Sie vorübergehend die minSdkVersion in Ihrer build.gradle-Datei auf 24 oder höher. Dieses Problem wird in der nächsten Version von Android Studio Bumblebee und AGP 7.1 behoben. (b/194289155)

Version 1.0.0-rc02

14. Juli 2021

androidx.compose.foundation:foundation:1.0.0-rc02 und androidx.compose.foundation:foundation-layout:1.0.0-rc02 werden veröffentlicht. Version 1.0.0-rc02 enthält diese Commits.

  • Die Darstellung von Rahmen für generische Formen wurde aktualisiert, um Probleme mit Pfaden zu beheben, die mit festen Abmessungen definiert sind. (aosp/1748871, b/191817116)

Version 1.0.0-rc01

1. Juli 2021

androidx.compose.foundation:foundation:1.0.0-rc01 und androidx.compose.foundation:foundation-layout:1.0.0-rc01 werden veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

API-Änderungen

  • Canvas unterstützt jetzt einen „contentDescription“-Parameter für die Barrierefreiheit. (Ib547c)

Fehlerkorrekturen

  • Deaktivierte Schaltflächen, Karten, Kästchen und insgesamt Modifier.clickable(enabled=false) verhindern, dass Klicks an das übergeordnete Element weitergeleitet werden. (Ic2c3b, b/183908811)

Version 1.0.0-beta09

16. Juni 2021

androidx.compose.foundation:foundation:1.0.0-beta09 und androidx.compose.foundation:foundation-layout:1.0.0-beta09 werden veröffentlicht. Version 1.0.0-beta09 enthält diese Commits.

API-Änderungen

  • ManualFrameClock wurde entfernt. Wenn Sie Animationen steuern möchten, verwenden Sie stattdessen composeTestRule.mainClock. (I3c3e8, b/189951065)
  • Die Enums „Role“ und „LiveRegionMode“ werden in Inline-Klassen mit privatem Konstruktor geändert (Id1890).
  • „KeyboardCapitalization“ wird in eine Inline-Klasse konvertiert. (Id5a1c)
  • „TextOverflow“ wird in eine Inline-Klasse geändert. (I433af)

Fehlerkorrekturen

  • Wenn Sie jetzt die eindeutigen Schlüssel für LazyColumn-/Row-Elemente angeben, wird die Scrollposition basierend auf dem Schlüssel beibehalten. Wenn Sie also Elemente vor dem aktuell sichtbaren Element hinzufügen oder entfernen, bleibt das Element mit dem angegebenen Schlüssel das erste sichtbare Element. (Id263f, b/184257857)
  • Die wichtigsten Konstanten sind derzeit @ExperimentalComposeUiApi. Code, der verwendet wird, kann private Konstanten vor der Stabilisierung deklarieren. (Ia5d48)
  • IdlingStrategy wurde zu AndroidComposeTestRule hinzugefügt. Testframeworks können damit einen alternativen Mechanismus installieren, um auf das Erreichen des Leerlaufzustands zu warten. Verwenden Sie AndroidComposeTestRule.setIdlingStrategyFactory(), bevor Ihr Test beginnt, um Ihre eigene Strategie zu installieren. (I608fa)

Hinzugefügte Profilregeln

In dieser Version werden den folgenden Compose-Modulen Profilregeln hinzugefügt (I14ed6):

  • androidx.compose.animation
  • androidx.compose.animation-core
  • androidx.compose.foundation
  • androidx.compose.foundation-layout
  • androidx.compose.material
  • androidx.compose.material-ripple
  • androidx.compose.runtime
  • androidx.compose.ui
  • androidx.compose.ui.geometry
  • androidx.compose.ui.graphics
  • androidx.compose.ui.text
  • androidx.compose.ui.text
  • androidx.compose.ui.unit
  • androidx.compose.ui.util

Was sind Profilregeln?

  • Profilregeln für eine Bibliothek werden in einer Textdatei baseline-prof.txt angegeben, die sich im Verzeichnis src/main oder einem entsprechenden Verzeichnis befindet. In der Datei wird eine Regel pro Zeile angegeben. Eine Regel ist in diesem Fall ein Muster, das mit Methoden oder Klassen in der Bibliothek abgeglichen wird. Die Syntax für diese Regeln ist eine Obermenge des menschenlesbaren ART-Profilformats, das bei der Verwendung von adb shell profman --dump-classes-and-methods ... verwendet wird. Diese Regeln können entweder auf Methoden oder auf Klassen ausgerichtet sein.

  • Eine Methodenregel hat das folgende Muster:

    <FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
    
  • Eine Klassenregel hat das folgende Muster:

    <CLASS_DESCRIPTOR>
    
  • Dabei ist <FLAGS> eines oder mehrere der Zeichen H, S und P, um anzugeben, ob diese Methode als „Hot“, „Startup“ oder „Post Startup“ gekennzeichnet werden soll.

  • <CLASS_DESCRIPTOR> ist der Deskriptor für die Klasse, zu der die Zielmethode gehört. Die Klasse androidx.compose.runtime.SlotTable hätte beispielsweise den Deskriptor Landroidx/compose/runtime/SlotTable;.

  • <METHOD_SIGNATURE> ist die Signatur der Methode und enthält den Namen, die Parametertypen und die Rückgabetypen der Methode. Die Methode fun isPlaced(): Boolean für LayoutNode hat beispielsweise die Signatur isPlaced()Z.

  • Diese Muster können Platzhalter (**, * und ?) enthalten, damit eine einzelne Regel mehrere Methoden oder Klassen abdeckt.

Was bewirken die Regeln?

  • Eine Methode mit dem Flag H ist eine „heiße“ Methode und sollte vorab kompiliert werden.

  • Eine Methode mit dem Flag S wird beim Start aufgerufen und sollte vorab kompiliert werden, um die Kosten für die Kompilierung und Interpretation der Methode beim Start zu vermeiden.

  • Eine Methode mit dem Flag P wird nach dem Start aufgerufen.

  • Eine Klasse, die in dieser Datei vorhanden ist, wird beim Start verwendet und sollte im Heap vorab zugewiesen werden, um die Kosten für das Laden der Klasse zu vermeiden.

So funktioniert's

  • Bibliotheken können diese Regeln definieren, die in AAR-Artefakten enthalten sind. Wenn dann eine App erstellt wird, die diese Artefakte enthält, werden diese Regeln zusammengeführt und die zusammengeführten Regeln werden verwendet, um ein kompaktes binäres ART-Profil zu erstellen, das spezifisch für die App ist. ART kann dieses Profil dann verwenden, wenn die App auf Geräten installiert wird, um ein bestimmtes Subset der Anwendung vorab zu kompilieren und so die Leistung der Anwendung zu verbessern, insbesondere beim ersten Ausführen. Hinweis: Dies hat keine Auswirkungen auf debugfähige Anwendungen.

Version 1.0.0-beta08

2. Juni 2021

androidx.compose.foundation:foundation:1.0.0-beta08 und androidx.compose.foundation:foundation-layout:1.0.0-beta08 werden veröffentlicht. Version 1.0.0-beta08 enthält diese Commits.

API-Änderungen

  • Das Enum „NestedScrollSource“ wurde durch eine Inline-Klasse ersetzt. (Ie321b, b/187055290)
  • Die Verwendung von Enums wurde in Inline-Klassen umgestaltet, um Probleme mit erschöpfenden „when“-Anweisungen zu vermeiden, wenn neue Enum-Werte hinzugefügt werden. (I2b5eb)
  • Es wurde ein Tipp-Timeout für klickbare/umschaltbare Elemente hinzugefügt, um zu verhindern, dass während eines Scroll- oder Ziehvorgangs ein Ripple-Effekt angezeigt wird (Ia2704, b/168524931).
  • Die Semantik-Properties „ContentDescription“ und „Text“ sind nicht mehr einzelne Werte, sondern Listen. So können sie zusammengeführt werden, anstatt aneinandergehängt zu werden. Außerdem wurden bessere Test-APIs bereitgestellt, um diese Änderungen zu nutzen (Ica6bf, b/184825850).
  • Modifier.focusModifier() wurde verworfen und durch Modifier.focusTarget() ersetzt (I6c860)
  • Das KeyboardType-Enum wird durch eine Inline-Klasse ersetzt. (I73045, b/187055290)
  • Das FocusState-Enum wurde durch eine FocusState-Schnittstelle ersetzt (Iccc1a, b/187055290)
  • Das ImeAction-Enum wird durch eine Inline-Klasse ersetzt. (I18be5, b/187055290)
  • AnnotatedString.withAnnotation-Funktionen sind jetzt ExperimentalTextApi anstelle von ExperimentalComposeApi. (I0cd0a)
    • Der TextUnit-Konstruktor mit TextUnitType ist jetzt ExperimentalTextApi anstelle von ExperimentalComposeApi.
  • PaddingValues ist jetzt @Stable statt @Immutable (I88c50)

Fehlerkorrekturen

  • Behebung von Abstürzen bei langem Drücken des leeren Bereichs in nicht leerem Text. (I33ab5, b/187437299)
  • Symbolleiste nach „Alle auswählen“ anzeigen (I495d9, b/185919613)
  • Problem behoben, bei dem scrollbare Container ihre untergeordneten Elemente auf der Querachse abgeschnitten haben. Das Problem war leicht zu reproduzieren, wenn Sie eine LazyRow mit Card-Elementen hatten. Der Schatten wird jetzt nicht mehr abgeschnitten. (Icb635, b/186318448)
  • Ein Problem wurde behoben, bei dem Wellen oder andere Hinweise bei einem langen Klick mit Modifier.combinedClickable manchmal hängen blieben (I2298c, b/186223077).
  • Die Positionsänderung wird jetzt automatisch von detectDragGesures, detectVerticalGestures und detectHorizontalGestures übernommen. Es ist nicht mehr erforderlich, „change.consumePositionChange“ in den „onDrag“-Callbacks aufzurufen (I42fc4, b/185096350, b/187320697).
  • Modifier.onGloballyPositioned() wurde geändert, um die Koordinaten dieses Modifikators in der Modifikator-Kette zu melden, nicht die Layoutkoordinaten nach Anwendung aller Modifikatoren. Das bedeutet, dass die Reihenfolge der Modifizierer jetzt beeinflusst, welche Koordinaten gemeldet werden. (Ieb67d, b/177926591)

Version 1.0.0-beta07

18. Mai 2021

androidx.compose.foundation:foundation:1.0.0-beta07 und androidx.compose.foundation:foundation-layout:1.0.0-beta07 werden veröffentlicht. Version 1.0.0-beta07 enthält diese Commits.

API-Änderungen

  • Die Logik zum Vorabrufen des nächsten sichtbaren Elements wird für LazyColumn/Row eingeführt (I8a4bc, b/184940225).
  • Auswahlgriff für Clips hinzugefügt (Iff80d, b/183408447)

Fehlerkorrekturen

  • Bei LazyColumn/Row bleiben jetzt bis zu zwei zuvor sichtbare Elemente aktiv (werden nicht verworfen), auch wenn sie bereits herausgescrollt wurden. So kann die Komponente die aktiven Unterkompositionen wiederverwenden, wenn ein neues Element zusammengesetzt werden muss. Das verbessert die Scrollleistung. (Ie5555)
  • Entfernen Sie „paintBackground“. (I38660)
  • Zeichnen Sie den Auswahlhintergrund mit DrawScope. (I73c61, b/186674472)
  • Ein Fehler in Beta 06 wurde behoben, der sich auf Zeilen/Spalten mit „spacedBy“-Anordnungen für die Darstellung gewichteter untergeordneter Elemente ausgewirkt hat. (Ifaf8c, b/187326588)

Version 1.0.0-beta06

5. Mai 2021

androidx.compose.foundation:foundation:1.0.0-beta06 und androidx.compose.foundation:foundation-layout:1.0.0-beta06 werden veröffentlicht. Version 1.0.0-beta06 enthält diese Commits.

API-Änderungen

  • Konflikt mit Navigationsgeste beheben (I1145e)
  • Es wurden die Accessibility-APIs „CollectionInfo“ und „CollectionItemInfo“ hinzugefügt, mit denen Sammlungen und ihre Elemente für Bedienungshilfen markiert werden können (Id54ef, b/180479017).
  • SemanticsActions.ScrollToIndex wurde hinzugefügt, um in einer Liste mit indexierten Elementen zum Element mit einem bestimmten Index zu scrollen, und SemanticsProperties.IndexForKey, um den Index eines Elements in einer Liste mit Elementen mit Schlüssel abzurufen. Beide Aktionen werden von LazyList implementiert.
    • Die Funktionen SemanticsNodeInteraction.performScrollToIndex und SemanticsNodeInteraction.performScrollToKey wurden hinzugefügt. Mit SemanticsNodeInteraction.performScrollToIndex wird eine Liste zum angegebenen Index gescrollt und mit SemanticsNodeInteraction.performScrollToKey wird eine Liste zum Element mit dem angegebenen Schlüssel gescrollt. (I4fe63, b/178483889, b/161584524)
  • Unterstützung für das Speichern von AnnotatedString in TextFieldValue.Saver. Die Hilfsfunktionen „addTtsAnnotation“ und „withAnnotation“ wurden zu „AnnotatedString.Builder“ hinzugefügt (I8cbdc, b/178446304).
  • Standardparameterwerte für 0.dp wurden PaddingValues(horizontal, vertical) hinzugefügt (I05571, b/181336792)

Fehlerkorrekturen

  • Untergeordnete Zeilen und Spalten mit weight(fill = false) sorgen nicht mehr dafür, dass der übergeordnete Container den gesamten verfügbaren Platz auf der Hauptachse ausfüllt. (Ied94d, b/186012444, b/184355105)

Version 1.0.0-beta05

21. April 2021

androidx.compose.foundation:foundation:1.0.0-beta05 und androidx.compose.foundation:foundation-layout:1.0.0-beta05 werden veröffentlicht. Version 1.0.0-beta05 enthält diese Commits.

API-Änderungen

  • Die FlingBehavior-Schnittstelle ist jetzt mit @Stable gekennzeichnet. Alle Implementierungen müssen dem @Stable-Vertrag entsprechen. (I93354, b/184830577)

Fehlerkorrekturen

  • Die Barrierefreiheits-Scrollaktionen ACTION_SCROLL_FORWARD, ACTION_SCROLL_BACKWARD, accessibilityActionScrollLeft, accessibilityActionScrollUp, accessibilityActionScrollRight und accessibilityActionScrollDown wurden korrigiert. Anstatt bis zum Ende des scrollbaren Bereichs zu scrollen, wird jetzt um eine Bildschirmseite in die angegebene Richtung gescrollt. (Ieccb0)
  • Die AndroidManifest-Dateien aus „ui-test-manifest“ und „ui-tooling-data“ sind jetzt mit Android 12 kompatibel (I6f9de, b/184718994).

Version 1.0.0-beta04

7. April 2021

androidx.compose.foundation:foundation:1.0.0-beta04 und androidx.compose.foundation:foundation-layout:1.0.0-beta04 werden veröffentlicht. Version 1.0.0-beta04 enthält diese Commits.

API-Änderungen

  • Benennen Sie hideSoftwareKeyboard und showSoftwareKeyboard in SoftwareKeyboardController in hide() bzw. show() um.
    • Die vollständige CompositionLocal-Schnittstelle für LocalSoftwareKeyboardController wird bereitgestellt, sodass sie festgelegt werden kann (besonders nützlich in Tests) (I579a6).
  • TextOverflow.Visible wird eingeführt. (Ic8f89)
  • Öffentliche Instanzen von RowScope, ColumnScope, BoxScope und BoxWithConstraintsScope wurden entfernt. (I4e83e, b/181869067)

Fehlerkorrekturen

  • Das Problem wurde behoben, bei dem Elemente von LazyColumn/LazyRow, die sich an den Rändern befinden, nach dem schnellen Fling falsch positioniert wurden (Ie4d13, b/183877420).
  • Vor dieser Änderung konnten lokale zusammensetzbare Funktionen basierend auf ihren Parametern übersprungen werden. Nach dieser Änderung werden keine lokalen zusammensetzbaren Funktionen mehr übersprungen. Diese Änderung wurde vorgenommen, weil es üblich und zu erwarten ist, dass lokale Funktionen Parameter vom übergeordneten Element erfassen. Das Überspringen von Parametern ist eine häufige Fehlerquelle.

    Zusammenfassend lässt sich sagen:

    @Composable fun Counter(count: Int, onCountChange: (Int) -> Unit) {
      @Composable fun ShowCount() { Text("Count: $count") }
      ShowCount()
      Button(onClick={ onCountChange(count + 1) }) {
        Text("Increment")
      }
    }
    

    Vor dieser Änderung wurde die zusammensetzbare Funktion ShowCount immer übersprungen, auch nachdem der Parameter count aktualisiert wurde. Diese Änderungen haben wir jedoch nicht vorgenommen (I5648a)

Version 1.0.0-beta03

24. März 2021

androidx.compose.foundation:foundation:1.0.0-beta03 und androidx.compose.foundation:foundation-layout:1.0.0-beta03 werden veröffentlicht. Version 1.0.0-beta03 enthält diese Commits.

API-Änderungen

  • DefaultMonotonicFrameClock ist veraltet. Wenn Sie withFrameNanos oder Recomposer.runRecomposeAndApplyChanges ohne MonotonicFrameClock aufrufen, wird jetzt IllegalStateException ausgegeben. (I4eb0d)

Fehlerkorrekturen

  • FlingBehavior.performFling() wird jetzt auch aufgerufen, wenn die Geschwindigkeit 0 ist (I0b6e5, b/181237123).

Version 1.0.0-beta02

10. März 2021

androidx.compose.foundation:foundation:1.0.0-beta02 und androidx.compose.foundation:foundation-layout:1.0.0-beta02 werden veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.

API-Änderungen

  • Es wurden mehrere kleine Optimierungen in der Messlogik von LazyColumn hinzugefügt (Ic6889).
  • Added new LocalSoftwareKeyboardController composition local API to replace previous SoftwareKeyboardController interface on TextField. (I5951e, b/168778053)
  • Added new LocalSoftwareKeyboardController composition local API to replace previous SoftwareKeyboardController interface on TextField. (I84472, b/168778053)

Fehlerkorrekturen

  • Einschränkungen für die öffentliche Nutzung experimenteller APIs erzwingen (I6aa29, b/174531520)

Version 1.0.0-beta01

24. Februar 2021

androidx.compose.foundation:foundation:1.0.0-beta01 und androidx.compose.foundation:foundation-layout:1.0.0-beta01 werden veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

Dies ist die erste Version von Compose 1.0.0 Beta.

API-Änderungen

  • Der Callback „onStart“ wurde zu detectDragGestures hinzugefügt (I67269, b/179995594).
  • Modifikatoren für die Größenanpassung an intrinsische Werte sind nicht mehr experimentell. (I15744)
  • Geräteprofil-Assertions entfernt (I798d2)
  • Der SoftwareKeyboardController-Callback wurde aus allen Textfeldern entfernt und wird in Kürze durch eine neue API ersetzt. (Iae869, b/168778053)
  • MeasureBlocks wurde in MeasurePolicy umbenannt und ist jetzt eine unterhaltsame Benutzeroberfläche. Layout-APIs wurden aktualisiert / vereinfacht, um MeasurePolicy zu verwenden. (Icab48, b/167662468, b/156751158)
  • InteractionState wurde durch [Mutable]InteractionSource ersetzt.
    • Schnittstellen sind für das Ausgeben / Erfassen von Interaktionsereignissen verantwortlich.
    • Anstatt interactionState = remember { InteractionState() } an Komponenten wie Button und Modifier.clickable() zu übergeben, verwenden Sie interactionSource = remember { MutableInteractionSource() }.
    • Statt Interaction.Pressed in interactionState sollten Sie stattdessen die Erweiterungsfunktionen für InteractionSource verwenden, z. B. InteractionSource.collectIsPressedAsState().
    • Bei komplexen Anwendungsfällen können Sie InteractionSource.interactions verwenden, um den Stream von Interaktionen zu beobachten. Weitere Informationen finden Sie in der Dokumentation und den Beispielen zu „InteractionSource“.
    • (I85965, b/152525426, b/171913923, b/171710801, b/174852378)
  • Die eingestellten LayoutCoordinates-Methoden wurden entfernt. Verwenden Sie stattdessen die Funktion anstelle der Eigenschaft für „positionInParent“ und „boundsInParent“ (I580ed, b/169874631, b/175142755).
  • Es wurde eine neue TextInputSession für Eingabesitzungen aus Low-Level-Textkomponenten wie CoreTextField erstellt. (I8817f, b/177662148)
  • „Placeable“ macht jetzt „measuredSize“ verfügbar, die die Größe darstellt, die für das untergeordnete Layout tatsächlich gemessen wurde. Diese Größe entspricht möglicherweise nicht den Messbeschränkungen. (Ib2729, b/172560206, b/172338608)
  • „selectionGroup“-Modifikator hinzugefügt, mit dem Sammlungen von Tabs oder Optionsfeldern für Barrierefreiheitszwecke markiert werden können (Ie5c29)
  • LazyListState.animateScrollToItem hinzufügen

    Mit dieser Methode wird ein sanfter Bildlauf zu einem bestimmten Element in der Liste ausgeführt. (I4bfd7)

  • ScrollableState.smoothScrollBy() wurde in animateScrollBy() umbenannt. LazyListState.snapToItemIndex() wurde in scrollToItem() umbenannt. ScrollState.smoothScrollTo() wurde in animateScrollTo() umbenannt. (I35ded)

  • Modifier.zoomable wurde durch Modifier.transformable ersetzt. smoothPanBy und smoothRotationBy wurden als Funktionen hinzugefügt. (Ifc32b, b/175294473)

  • Die defaultFactory für compositionLocalOf und staticCompositionLocalOf ist jetzt erforderlich und nicht mehr optional.

    Durch diese Änderung wird ein potenzieller Typfehler für nicht nullable-Typen entfernt, für die keine Standardfactory angegeben wurde. Bisher wurde dadurch eine Nullreferenz für einen Typ zurückgegeben, der keine Nullwerte zulässt.

    Für Typen mit zulässigen Nullwerten sollten Sie { null } als Standard-Factory angeben.

    Wir empfehlen, keine lokalen Variablen mit nicht nullable-Typen zu verwenden, es sei denn, es kann ein sinnvoller Standardwert angegeben werden. Wenn kein sinnvoller Standardwert vorhanden ist, sollte die Lambda-Funktion defaultFactory eine Ausnahme auslösen. Wenn jedoch eine Ausnahme ausgelöst wird, haben die Nutzer des Lokals eine implizite Abhängigkeit davon, dass es bereitgestellt wird, die nicht vom Typsystem erzwungen wird. (Ifbd2a)

  • Indication#createIndication() wurde in Indication#rememberUpdatedIndication(InteractionState) geändert und der Parameter InteractionState wurde aus IndicationInstance#drawIndication() entfernt. IndicationInstance sollte nur für das Zeichnen visueller Effekte zuständig sein und nicht Animationen starten oder den Status als Reaktion auf InteractionState-Änderungen schreiben. Diese Animationen und Statusänderungen sollten stattdessen in rememberUpdatedIndication() erfolgen. Der Parameter indication in Modifier.indication wurde ebenfalls in einen erforderlichen Parameter geändert. (Ic1764, b/152525426)

  • Textaktionen prüfen jetzt automatisch den Fokus (I13777, b/179648629)

  • runBlockingWithManualClock entfernt (I15cdc, b/179664814)

  • Die Scrollposition in Modifier.verticalScroll()/horizontalScroll() wird jetzt mit Ints dargestellt (I81298).

  • Die Pakete der Methoden „smoothScrollBy“ und „scrollBy“ wurden in androidx.compose.foundation.gestures.* geändert (I3f7c1, b/175294473).

  • FlingConfig wurde in FlingBehavior umbenannt und ermöglicht jetzt die Anpassung der Suspend-Animation anstelle vordefinierter Decays. (I02b86, b/175294473)

  • Größenmodifizierer wurden umbenannt. „Modifier.width“/„height“/„size“ wurden in „requiredWidth“/„requiredHeight“/„requiredSize“ umbenannt. Modifier.preferredWidth/preferredHeight/preferredSize wurden in width/height/size umbenannt. (I5b414)

  • „defaultMinSizeConstraints“ wurde in „defaultMinSize“ umbenannt. (I4eaae)

  • Modifier.tapGestureFilter wurde entfernt. Verwenden Sie stattdessen Modifier.pointerInput { detectTapGestures(...) }. (I266ed, b/175294473)

  • Die teilweise Verarbeitung wurde aus dem Zeigereingabesystem entfernt. Die empfohlene Methode zum Koordinieren des teilweisen Verbrauchs ist Modifier.nestedScroll. (Ie9c9b)

  • Die Ausrichtung wurde in das Fundamentpaket verschoben. VelocityTracker wurde von ui.gesture zu ui.input.pointer verschoben. (Iff4a8, b/175294473)

  • AnimationClockObservable und abgeleitete Klassen wurden entfernt. AnimatedFloat wurde entfernt. (Icde52, b/177457083)

  • drawerState.open() und drawerState.close() sind jetzt suspend-Funktionen. Verwenden Sie rememberCoroutineScope(), um den Bereich der Komposition abzurufen, um sie aufzurufen (I16f60, b/175294473).

  • „Providers“ wurde in „CompositionLocalProvider“ umbenannt.

    • Der Konstruktor „Composition“ akzeptiert keinen Schlüsselparameter mehr und wurde eingestellt.
    • currentCompositeKeyHash wurde in eine zusammensetzbare Property auf oberster Ebene anstelle einer zusammensetzbaren Funktion auf oberster Ebene umgewandelt.
    • „CompositionData“ und „CompositionGroup“ wurden in den Namespace „androidx.compose.runtime.tooling“ verschoben.
    • ComposableLambda ist jetzt eine Schnittstelle anstelle einer konkreten Klasse und hat keine Typparameter mehr.
    • ComposableLambdaN ist jetzt eine Schnittstelle anstelle einer konkreten Klasse und hat keine Typparameter mehr.
    • Die Funktion „snapshotFlow“ wurde in den Namespace „androidx.compose.runtime“ verschoben.
    • Die Zusammenführungsmethode von SnapshotMutationPolicy ist nicht mehr experimentell.
    • Die @TestOnly-Funktion „clearRoots“ auf oberster Ebene wurde entfernt. Das ist nicht mehr erforderlich.
    • Die Funktionen „keySourceInfoOf“ und „resetSourceInfo“ wurden entfernt. Sie sind nicht mehr erforderlich.
    • Composer.collectKeySourceInformation wurde entfernt. Das ist nicht mehr erforderlich.
    • Die Methoden „isJoinedKey“, „joinedKeyLeft“ und „joinedKeyRight“ wurden entfernt. Sie sind nicht mehr erforderlich.
    • Verschiedene APIs der obersten Ebene wurden verschoben und in verschiedenen Dateien neu organisiert. Aufgrund der Dateiklassensemantik von Kotlin wird dadurch die binäre Kompatibilität, nicht aber die Quellkompatibilität beeinträchtigt. Für die meisten Nutzer sollte das kein Problem darstellen.
    • (I99b7d, b/177245490)
  • Modifier.scrollable wurde überarbeitet. Jetzt wird die Scrollable-Schnittstelle anstelle der ScrollableController-Klasse verwendet (I4f5a5, b/174485541, b/175294473).

  • „Modifier.draggable“ akzeptiert jetzt „DraggableState“ anstelle einer einfachen Lambda-Funktion. Sie können den Status über rememberDraggableState { delta -> } erstellen, um das gleiche Verhalten wie zuvor zu erhalten (Ica70f, b/175294473).

  • Die Modifikatoren „requiredWidth(IntrinsicSize)“ und „requiredHeight(IntrinsicSize)“ wurden für die erforderliche Größenanpassung an intrinsische Größen hinzugefügt. (I0a6b4)

  • Die verworfene Funktion emptyContent() wurde entfernt. Verwenden Sie stattdessen {}. (Idb33f, b/179432510)

  • Einige zuvor verworfene APIs wurden gelöscht (Ice5da, b/178633932)

Fehlerkorrekturen

  • Es wurde eine neue lokale Kompositions-API für LocalSoftwareKeyboardController hinzugefügt, um die vorherige SoftwareKeyboardController-Schnittstelle für TextField zu ersetzen. (I658b6, b/168778053)

Version 1.0.0-alpha12

10. Februar 2021

androidx.compose.foundation:foundation:1.0.0-alpha12 und androidx.compose.foundation:foundation-layout:1.0.0-alpha12 werden veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.

API-Änderungen

  • Für Modifier.pointerInput sind jetzt Remember-Schlüssel erforderlich, um anzugeben, wann die Pointer-Eingabeerkennungs-Coroutine für neue Abhängigkeiten neu gestartet werden soll. (I849cd)
  • Aktualisierung für Tests: Mit hasText() wird sowohl der Eingabe- als auch der Label-/Hinweis-/Platzhaltertext im Textfeld geprüft (Iab803)
  • PaddingValues.Absolute wurde hinzugefügt und kann in APIs verwendet werden, die PaddingValues akzeptieren. (Ia5f30)
  • onImeActionPerformed ist veraltet. Verwenden Sie stattdessen KeyboardActions (If0bbd, b/179071523).
  • Um die Namenskonventionen besser an ImageBitmap und ImageVector anzupassen, wurde ImagePainter in BitmapPainter umbenannt, um VectorPainter zu entsprechen. (Iba381, b/174565889)
  • Bessere APIs für Unterstring-Tests, wobei der Unterstring jetzt ein Argument ist (Icbe78)
  • Es wurde ein InfiniteAnimationPolicy-Coroutine-Kontextelement eingeführt, das in Endlosanimationen angewendet wird. Standardmäßig ist keine Richtlinie installiert, außer wenn Tests mit ComposeTestRule ausgeführt werden. (I50ec4, b/151940543)
  • Animatable.snapTo und Animatable.stop sind jetzt suspend-Funktionen (If4288)
  • ComponentActivity.setContent wurde in das Modul androidx.activity:activity-compose verschoben und befindet sich jetzt unter androidx.activity.compose.setContent. (Icf416)
  • Die Methoden „Destructuring“ und „copy()“ wurden aus mehreren Klassen entfernt, in denen sie nur selten verwendet wurden. (I26702, b/178659281)
  • Unterstützung für benutzerdefinierte Schlüssel für LazyColumn/LazyRow wurde hinzugefügt. So können wir die Neuordnung von Artikeln besser handhaben. Der in remember {}-Blöcken gespeicherte Status wird also zusammen mit dem Element verschoben, wenn Sie Elemente neu anordnen oder das Element aus der Mitte entfernen.

    LazyColumn {
        items(users, key = { user -> user.id }) { ... }
    }
    
  • „Indication#createInstance“ wurde in „@Composable“ geändert und „LocalIndication“ enthält jetzt eine „Indication“ und nicht „() -> Indication“. (I5eeea, b/157150564)

  • Constraints.enforce wurde durch Constraints.constrain ersetzt. (I8b8ea)

  • „loadFontResource“ ist veraltet. Verwenden Sie stattdessen „fontResource“. „imageResource“, „loadImageResource“, „vectorResource“ und „loadVectorResource“ sind veraltet. Verwenden Sie stattdessen „painterResource“. (I6b809)

  • Aus Leistungsgründen werden für die ScrollAxisRange-Semantik jetzt Lambdas verwendet, die Floats zurückgeben, anstatt direkter Float-Werte. (If4a35, b/178657186)

  • Es wurde die Semantik „EditableText“ hinzugefügt, um bearbeitbaren Eingabetext des Textfelds für die Barrierefreiheit zu kennzeichnen, sowie entsprechende Testmethoden zum Prüfen der Semantik (I8e07a).

  • „Modifier.clickable“ unterstützt jetzt keine Doppel- und Langklicks mehr. Verwenden Sie Modifier.combinedClickable, um diese Funktion zu erreichen. (Iafad1)

  • toIntPx() wurde in roundToPx() umbenannt. (I9b7e4, b/173502290)

  • „IntBounds“ wurde in „IntRect“ umbenannt und die API wurde verbessert. (I1f6ff)

  • „Modifier.dragGestureFilter“ wurde eingestellt. Verwenden Sie stattdessen Modifier.pointerInput { detectDragGestures (...)}. Alternativ können Sie Modifier.draggable für das Ziehen auf einer Achse verwenden (I0ba93, b/175294473).

  • Umgebungen wurden umbenannt, um der Umbenennung von „Ambient“ in „CompositionLocal“ zu entsprechen. Ambients hießen früher „AmbientFoo“, jetzt heißen CompositionLocals „LocalFoo“. (I2d55d)

  • Die Auswahl wurde in die Grundlage verschoben. (I7892b)

  • Ähnlich wie wir zuvor die zusammensetzbare Funktion state { 0 } entfernt und die Verwendung von remember { mutableStateOf(0) } gefördert haben, werden wir die zusammensetzbare Funktion savedInstanceState { 0 } entfernen. Verwenden Sie stattdessen rememberSaveable { mutableStateOf(0) }. Der Wert wird automatisch gespeichert und wiederhergestellt, wenn der Typ, der in MutableState verwendet wird, im Bundle gespeichert werden kann. Wenn Sie zuvor ein benutzerdefiniertes Saver-Objekt übergeben haben, müssen Sie jetzt eine neue Überladung von „rememberSaveable“ mit dem Parameter stateSaver verwenden. Die Verwendung sieht so aus: val holder = rememberSaveable(stateSaver = HolderSaver) { mutableStateOf(Holder(0)) } (Ib4c26, b/177338004)

  • Semantik für Passwörter für die Barrierefreiheit hinzugefügt (I231ce)

  • ProgressBarRangeInfo.Indeterminate wurde hinzugefügt, um unbestimmte Fortschrittsanzeigen für die Barrierefreiheit zu kennzeichnen (I6fe05).

  • Die Spielzeit in Animationen wird jetzt in Nanosekunden angegeben (If776a)

  • @ComposableContract wurde zugunsten von drei spezifischeren Annotationen eingestellt.

    @ComposableContract(restartable = false) wurde zu @NonRestartableComposable. @ComposableContract(readonly = true) wurde zu @ReadOnlyComposable. @ComposableContract(preventCapture = true) wurde zu @DisallowComposableCalls. @ComposableContract(tracked = true) wurde entfernt. (I60a9d)

  • Die Dienstprogramme emptyContent() und (@Composable () -> Unit).orEmpty() wurden eingestellt, da sie keine positiven Auswirkungen auf die Leistung oder den Wert mehr haben (I0484d).

  • Recomposers können jetzt geschlossen werden. Geschlossene Recomposers führen die Recomposition so lange fort, bis die untergeordneten Coroutinen der Komposition abgeschlossen sind. „Recomposer.shutDown“ wurde in „cancel“ umbenannt, um es von „close“ abzugrenzen. (Ib6d76)

  • APIs im Zusammenhang mit LazyVerticalGrid sind als experimentell gekennzeichnet (Ia53e3, b/178519862).

  • rememberSavedInstanceState() wurde in rememberSaveable() umbenannt und in das Paket androidx.compose.runtime.saveable verschoben. (I1366e, b/177338004)

  • „RestorableStateHolder“ wurde in „SaveableStateHolder“ umbenannt und in das Paket „androidx.compose.runtime.saveable“ verschoben. Die innere Methode „RestorableStateProvider“ wurde in „SaveableStateProvider“ umbenannt. Der generische Typ wurde entfernt, sodass Sie einfach „Any“ als Schlüssel übergeben können. Die experimentelle Anmerkung ist nicht mehr erforderlich. (I0902e, b/174598702)

  • „Saver“, „listSaver()“, „mapSaver()“ und „autoSaver“ wurden von „androidx.compose.runtime.savedinstancestate“ nach „androidx.compose.runtime.saveable“ verschoben (I77fe6).

  • Das Artefakt androidx:compose:runtime:runtime-saved-instance-state wurde in androidx:compose:runtime:runtime-saveable umbenannt (I6dcac).

  • Viele seit Langem eingestellte APIs im ui-Paket wurden gelöscht. (I2f2dc)

  • Das Artefakt „compose:runtime-dispatch“ ist jetzt veraltet. MonotonicFrameClock befindet sich jetzt in compose:runtime und AndroidUiDispatcher in compose:ui. (Ib5c36)

  • Parameter für RounderCornerShape, CutCornerShape und CornerBasedShape wurden von „left“/„right“ in „start“/„end“ umbenannt, um die automatische Spiegelung der Form in RTL-Richtung zu unterstützen. AbsoluteRounderCornerShape und AbsoluteCutCornerShape wurden für Fälle eingeführt, in denen keine automatische Spiegelung gewünscht ist. (I61040, b/152756983)

  • „canDrag“ wurde aus „Modifier.scrollable“ entfernt. (Id66e7, b/175294473)

  • Die API, auf die das Compose-Compiler-Plug-in ausgerichtet ist, wurde umgestaltet, sodass anstelle einer konkreten Klasse eine Schnittstelle verwendet wird. Außerdem wird in der Schnittstelle kein Typparameter mehr verwendet.

    Dies ist eine interne Änderung, die sich nicht auf die Quellcodekompatibilität auswirken sollte, aber eine binäre funktionsgefährdende Änderung ist. (I3b922, b/169406779)

  • Modifier.scaleGestureFilter wurde entfernt. Verwenden Sie stattdessen „Modifier.zoomable“. Alternativ können Sie Modifier.pointerInput { detectMultitouchGestures { ... }} verwenden (Id5da1, b/175294473).

  • AnimatedValue/Float wurde eingestellt. Verwenden Sie stattdessen „Animatable“. (I71345, b/177457083)

    • CoreText und CoreTextField aus der öffentlichen API entfernt
    • Nicht mehr unterstützte SelectionContainer-Überladung entfernt (I99c19)
  • Entfernen der eingestellten Funktionen für das Scrollen ohne Unterbrechung Die Funktionen für das Scrollen ohne Unterbrechung wurden wie in der letzten Version angekündigt vollständig entfernt. Bitte konvertieren Sie die Funktionen mit denselben Namen in suspend-Funktionen. Ein Koroutinenbereich kann über rememberCoroutineScope() abgerufen werden. (I3d39c, b/178169563)

  • androidx.compose.foundation.layout.ConstraintLayout wurde zugunsten von androidx.constraintlayout.compose.ConstraintLayout eingestellt. Sie müssen eine Abhängigkeit von androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha01 hinzufügen. (I87adc)

  • „tapGestureFilter“, „doubleTapGestureFilter“, „longPressGestureFilter“ und „pressIndicaitonGestureFilter“ wurden eingestellt. Verwenden Sie stattdessen Modifier.clickable oder Modifier.pointerInput mit der Funktion detectTapGestures. (I6baf9, b/175294473)

  • Recomposer.current() wurde entfernt. [Zusammenfassung]ComposeView wird jetzt standardmäßig verzögert erstellt und verwendet Recomposers mit Fensterbereich, die vom ViewTreeLifecycleOwner für das Fenster gesteuert werden. Die Recomposition und auf „withFrameNanos“ basierende Animations-Ticks werden pausiert, während der Lebenszyklus des Hosts angehalten wird. (I38e11)

  • Recomposer.runningRecomposers bietet jetzt einen globalen StateFlow von schreibgeschützten RecomposerInfo-Objekten, mit denen der laufende Kompositionsstatus im Prozess beobachtet werden kann. Diese API sollte gegenüber Recomposer.current() bevorzugt werden, da diese jetzt als eingestellt gilt. (If8ebe)

Version 1.0.0-alpha11

28. Januar 2021

androidx.compose.foundation:foundation:1.0.0-alpha11 und androidx.compose.foundation:foundation-layout:1.0.0-alpha11 werden veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.

API-Änderungen

  • scrollBy ohne Unterbrechung einstellen, scrollTo ohne Unterbrechung entfernen

    Wir empfehlen jetzt, das Scrollen mit Suspend-Funktionen zu steuern und zu warten, bis das Scrollen abgeschlossen ist. Im Rahmen dieser Umstellung werden die Versionen dieser Funktionen, die nicht zum Sperren verwendet werden, eingestellt und/oder entfernt. (Ie9ced)

  • smoothScrollBy ohne suspend wird eingestellt Wir empfehlen jetzt, suspend-Funktionen zu verwenden, um das Scrollen zu steuern und zu warten, bis das Scrollen abgeschlossen ist. Im Rahmen dieser Umstellung werden die Versionen dieser Funktionen, die nicht suspendiert werden, eingestellt. (I12880)

  • Dem Bild und dem Symbol wurde der Parameter „Inhaltsbeschreibung“ hinzugefügt. Sie wird verwendet, um Bedienungshilfen (I2ac4c) eine Beschreibung zu geben.

  • BasicTextField hat einen neuen Parameter namens „decorationBox“ erhalten. Damit können dem Textfeld Dekorationen wie Symbole, Platzhalter und Labels hinzugefügt und der Trefferbereich vergrößert werden. (I16996)

  • Der Parameter „canDrag“ wurde aus „Modifier.draggable“ entfernt (Ic4bec, b/175294473).

  • Die AnimatedFloat.fling-Funktion, die FlingConfig akzeptiert, wurde entfernt. Verwenden Sie stattdessen „suspendAnimatable.animateDecay“. (I4659b, b/177457083)

  • data class aus den folgenden Kursen entfernt:

    • InlineTextContent
    • LocaleList
    • (I605c7)
  • Klickbare, ein- und ausschaltbare sowie auswählbare Elemente können jetzt außerhalb der Komposition erstellt werden (I0a130, b/172938345, b/175294473).

  • ScrollableColumn/Row wurden verworfen. Die Verwendung von „ScrollableColumn“ ist weniger effizient als „LazyColumn“, wenn Sie viele Inhalte haben, die gescrollt werden müssen, da mit „LazyColumn“ nur sichtbare Elemente zusammengestellt, gemessen und gezeichnet werden können. Um zu verhindern, dass Nutzer ineffiziente Methoden verwenden, haben wir beschlossen, ScrollableColumn und ScrollableRow einzustellen und stattdessen die Verwendung von LazyColumn und LazyRow zu fördern. Nutzer können sich weiterhin gegen das Lazy-Verhalten entscheiden und die Modifikatoren direkt verwenden, z. B. „Column(Modifier.verticalScroll(rememberScrollState()))“ (Ib976b, b/170468083).

  • Neue items(count: Int)-Factory-Methode für den Bereich von LazyColumn/LazyRow/LazyVerticalGrid. items(items: List) und itemsIndexed(items: List) sind jetzt Erweiterungsfunktionen und müssen daher manuell importiert werden, wenn sie verwendet werden. Neue Erweiterungsüberladungen für Arrays: „items(items: Array)“ und „itemsIndexed(Array)“ (I803fc, b/175562574)

  • Die verworfene Funktion „AbsoluteArrangement“ wurde entfernt. (Iffa96, b/177641870)

  • Der Parameter „propagateMinConstraints“ wurde „Box“ hinzugefügt, um anzugeben, ob die eingehenden Mindestanforderungen an den Inhalt der Box weitergegeben werden sollen oder nicht. Der Standardwert ist „false“. (I0125b, b/152613457)

Fehlerkorrekturen

  • Die APIs „onCommit“, „onDispose“ und „onActive“ wurden zugunsten der APIs „SideEffect“ und „DisposableEffect“ eingestellt (If760e).
  • „WithConstraints“ wurde als „BoxWithConstraints“ überarbeitet und nach „foundation.layout“ verschoben. (I9420b, b/173387208)
  • Änderungen an Factory-Funktionen für Font/FontFamily/Typeface

    • Es wurden Factory-Funktionen hinzugefügt, die mit einem Großbuchstaben beginnen.
    • Bisherige Factory-Funktionen mit Kleinbuchstaben am Anfang wurden eingestellt.
    • Neue Factory-Funktionen geben die FontFamily anstelle von Unterklassen zurück.
    • Konstruktoren der Unterklassen ausgeblendet, sodass sie nur über Factory-Funktionen erstellt werden können.
    • Font.asFontFamily wurde in Font.toFontFamily umbenannt
    • (I42aa7)
  • ComposeContentTestRule wurde eingeführt. Diese Klasse erweitert ComposeTestRule und definiert setContent, das aus ComposeTestRule entfernt wurde. Es wurde eine Factory-Methode createEmptyComposeRule() hinzugefügt, die ein ComposeTestRule zurückgibt und keine Activity für Sie startet. Verwenden Sie diese Option, wenn Sie Ihre Aktivität während des Tests starten möchten, z. B. mit ActivityScenario.launch (I9d782, b/174472899).

  • animateAsState heißt jetzt animateFooAsState, wobei Foo der Typ der animierten Variablen ist, z. B.Float, Dp oder Offset. (Ie7e25)

  • Die Dichte ist jetzt der Empfängerbereich für Arrangement-Schnittstellen. (I18aad)

  • TextFieldValue akzeptiert AnnotatedString. Diese Änderung betrifft jedoch nur die API. Die Bearbeitung von Text mit mehreren Formatierungen ist noch nicht implementiert.

    • initial wurde aus den Konstruktorparametern von EditingBuffer entfernt. (I326d5)
  • invalidate und compositionReference() sind jetzt zugunsten von currentRecomposeScope bzw. rememberCompositionReference veraltet. (I583a8)

  • AnnotatedString wird so geändert, dass sie von kotlin.CharSequence abgeleitet wird. Daher sind „length“ und „subSequence“ jetzt Instanzfunktionen und Erweiterungsfunktionen wurden entfernt. (Iaf429)

  • „Duration“ und „Uptime“ werden durch „Long milliseconds“ ersetzt. Durch diesen Schritt wird die Abhängigkeit der Zeigereingabe von diesen Klassen entfernt. (Ia33b2, b/175142755, b/177420019)

  • RememberObserver ersetzt CompositionLifecycleObserver und CompositionLifecycleObserver ist jetzt veraltet.

    RememberObserver ist ein Ersatz für CompositionLifecycleObserver mit geänderter Semantik und umbenannten Methoden. Die Umstellung auf die neue API kann mechanisch für Objekte erfolgen, die nur einmal gespeichert werden. Das ist und bleibt die empfohlene Vorgehensweise. Wenn jedoch in einer Komposition mehr als einmal auf eine Referenz verwiesen wurde, wird onRemembered für jeden Verweis aufgerufen, während onEnter nur einmal aufgerufen wird. onEnter wurde mehrmals aufgerufen, wenn das Objekt in untergeordneten Kompositionen wie WithConstraints und Scaffold verwendet wurde. Dadurch war die Garantie für den einzelnen onEnter-Aufruf nicht zuverlässig und wurde für RememberObserver entfernt.

    RememberObserver fügt onAbandoned hinzu, das aufgerufen wird, wenn die RememberObserver-Instanz vom Callback zurückgegeben wird, der an remember übergeben wurde, aber nicht im Kompositionsstatus gespeichert wurde und daher nie onRemembered aufgerufen wird. Das kann passieren, wenn die Komposition aufgrund einer Ausnahme vorzeitig beendet wird oder wenn die Komposition verworfen wird, weil der Status, für den sie erstellt wurde, nicht mehr aktuell oder anderweitig nicht mehr erforderlich ist. Wenn die Instanz von RememberObserver, die der Empfehlung für einzelne Referenzen oben folgt, eine externe Ressource verfolgt, weisen sowohl onForgotten als auch onAbandoned darauf hin, dass die Ressource nicht mehr benötigt wird. Wenn das Objekt die in onRemembered begonnene Arbeit oder zugewiesene Ressourcen verfolgt, kann onAbandoned ignoriert werden, da es nicht aufgerufen wird, wenn onRemembered aufgerufen wird. (I02c36)

  • TransformedText.transformedText wurde in TransformedText.text umbenannt

    • „TransformedText“ ist keine Datenklasse mehr (Ie672a)
  • Die folgenden Klassen sind keine Datenklassen mehr:

    • AnnotatedString
    • ParagraphStyle
    • SpanStyle
    • TextStyle
    • FontWeight
    • TextDecoration
    • TextGeometricTransform
    • TextIndex
    • TextLayoutResult
    • TextLayoutInput (Iaff99)
  • Experimentelle monotonicFrameAnimationClockOf-Methoden entfernt (Ib753f, b/170708374)

  • Globale Koordinatenmethoden wurden eingestellt und neue fensterbasierte Koordinatenmethoden eingeführt. (Iee284)

  • Verwenden Sie stattdessen „ImeAction.None“.

    • Verwenden Sie ImeAction.Default anstelle von ImeAction.Unspecified (Ie1bcc).
  • FocusRequester.createRefs ist jetzt als experimentell gekennzeichnet, da sich die Funktion ändern kann. (I2d898, b/177000821)

  • SemanticsPropertyReceiver.hidden wurde in „invisibleToUser“ umbenannt und mit @ExperimentalComposeUiApi gekennzeichnet. „AccessibilityRangeInfo“ wurde in „ProgressBarRangeInfo“ umbenannt. „stateDescriptionRange“ wurde in „progressBarRangeInfo“ umbenannt. „AccessibilityScrollState“ wurde in „ScrollAxisRange“ umbenannt. „horizontalAccessibilityScrollState“ wurde in „horizontalScrollAxisRange“ umbenannt. „verticalAccessibilityScrollState“ wurde in „verticalScrollAxisRange“ umbenannt. (Id3148)

  • VisualTransformation wurde in ein funktionales Interface geändert (I3bba4)

  • TestCoroutineDispatcher in Tests verwenden (I532b6)

  • PointerInputData wurde entfernt und PointerInputChange wurde so geändert, dass es alle Felder von PointerInputData enthält. PointerInputEvent und PointerInputEventData wurden intern gemacht, da sie in keiner öffentlichen API verwendet werden. (Ifff97, b/175142755)

  • TextInputService.onStateUpdated wurde in updateState umbenannt (Id4853)

  • Entfernen Sie „displaySize“, da diese Eigenschaft vermieden werden sollte. In der Regel ist es besser, die Größe von onRoot() oder zumindest die Fenstergröße zu verwenden. (I62db4)

Version 1.0.0-alpha10

13. Januar 2021

androidx.compose.foundation:foundation:1.0.0-alpha10 und androidx.compose.foundation:foundation-layout:1.0.0-alpha10 werden veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

API-Änderungen

  • ImeOptions und KeyboardOptions sind keine Datenklasse mehr (I3c898, b/168684531)
  • Änderungen an der VisualTransformation API
    • OffsetMap wurde in OffsetMapping umbenannt
    • „OffsetMapping.identityOffsetMap“ wurde in „OffsetMapping.Identity“ umbenannt.
    • „PasswordTransformation“ ist keine Datenklasse mehr
    • „OffsetMapping“ in eigene Datei verschoben
    • (I0bdf3)
  • Änderungen an der EditOperations API
    • „EditOperation“ in „EditCommand“ umbenannt
    • Befehlssuffix für konkrete Implementierungen von „EditOperation“ hinzugefügt
    • „EditCommand“-Objekte sind keine Datenklassen mehr
    • Die Funktion „EditOperation.process“ wurde in „applyTo“ umbenannt.
    • InputEventListener wurde in InputEventCallback umbenannt
    • (I0a366)
  • Velocity wurde so geändert, dass es aus Komponenten besteht und mathematische Operationen unterstützt. (Ib0447)
  • @ExperimentalTesting wurde in @ExperimentalTestApi umbenannt, um mit ähnlichen experimentellen API-Annotationen übereinzustimmen (Ia4502, b/171464963).
  • Die experimentelle Methode „stickyHeader“ für „LazyColumn“/„LazyRow“ wurde hinzugefügt (I0a81d).
  • Ranamed Color.useOrElse() to Color.takeOrElse() (Ifdcf5)
  • TestUiDispatcher ist veraltet. Verwenden Sie stattdessen Dispatchers.Main (Ic171f, b/175385255).
  • Schaltfläche zu „foundation/Strings.kt“ hinzufügen (I4a5b7, b/172366489)
  • nativeClass wurde in das UI-Modul verschoben und als intern festgelegt. Die Verwendung von „nativeClass“ in „equals“-Implementierungen wurde aktualisiert, sodass stattdessen „is MyClass“ verwendet wird. (I4f734)
  • FlowRow und FlowColumn wurden verworfen. Verwenden Sie stattdessen ein benutzerdefiniertes Layout. (I09027)
  • „Modifier.focus()“ und „Modifier.focusRequester()“ sind veraltet. Verwenden Sie stattdessen „Modifier.focusModifier()“ und „Modifier.focusReference()“. (I75a48, b/175160751, b/175160532, b/175077829)
  • SelectionRegistrar.notifySelectableChange wurde eingeführt, um SelectionManager über Selectable-Updates zu informieren. (I6ff30, b/173215242)
  • fun Dp.isFinite() wurde in val Dp.isFinite geändert (I50e00)
  • „Constraints#satisfiedBy“ wurde in „isSatisfiedBy“ umbenannt. (I9cf5c)
  • „isSpecified“, „isUnspecified“ und „useOrElse“ für Inline-Klassen mit einer „Unspecified“-Konstante hinzugefügt. (I93f7b, b/174310811)

Fehlerkorrekturen

  • Neue auf Coroutinen basierende API Animatable, die für gegenseitigen Ausschluss zwischen den Animationen sorgt. Neue DecayAnimationSpec zur Unterstützung mehrdimensionaler Decay-Animationen (I820f2, b/168014930)
  • Unterstützung für deaktivierte und schreibgeschützte Textfelder hinzugefügt (I35279, b/171040474, b/166478534)
  • animate() wurde durch animateAsState() ersetzt, das anstelle von T ein State<T> zurückgibt. Dies ermöglicht eine bessere Leistung, da der Ungültigkeitsbereich auf den Ort eingegrenzt werden kann, an dem der Statuswert gelesen wird. (Ib179e)
  • Fügen Sie die Semantics-Rollen-API hinzu und fügen Sie „Role“ als Parameter für den klickbaren, auswählbaren und umschaltbaren SemanticsModifier hinzu. „Modifier.progressSemantics“ wurde so geändert, dass es auch für „Slider“ verwendet werden kann. (I216cd)
  • Auf das native „keyEvent“ kann jetzt über „keyEvent.nativeKeyEvent“ zugegriffen werden (I87c57, b/173086397).

Version 1.0.0-alpha09

16. Dezember 2020

androidx.compose.foundation:foundation:1.0.0-alpha09 und androidx.compose.foundation:foundation-layout:1.0.0-alpha09 werden veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.

API-Änderungen

  • Scrollable-Schnittstelle hinzufügen

    So können ScrollState und LazyListState als gemeinsamer Typ behandelt werden, sodass benutzerdefiniertes Scrollen für beide Typen implementiert werden kann.

    Außerdem wird „smoothScrollBy“ in eine Erweiterungsfunktion für „Scrollable“ verschoben, um diese Funktion zu nutzen. (I2153b)

  • LazyVerticalGrid wurde hinzugefügt. (I17267, b/162213211)

  • LazyColumnFor, LazyRowFor, LazyColumnForIndexed und LazyRowForIndexed werden eingestellt. LazyColumn und LazyRow verwenden (I5b48c)

  • Für das Anhalten von APIs für die Zeigereingabe wurde HandlePointerInputScope in AwaitPointerEventScope und handlePointerInput() in awaitPointerEventScope() umbenannt. (Idf0a1, b/175142755)

  • „LazyListState.layoutInfo“ wurde hinzugefügt, um die Liste der Größen und Offsets der aktuell sichtbaren Elemente verfügbar zu machen (If8678, b/170472532).

  • Die Annotation „ExperimentalPointerInput“ (Ia7a24) wurde entfernt.

  • Unterstützung für InteractionState für TextFields wurde hinzugefügt. (I61d91)

  • Füge den Parameter „reverseLayout“ für „LazyColumn“/„Row“ hinzu. Wenn true, werden Elemente von unten nach oben zusammengesetzt. LazyListState.firstVisibleItemIndex == 0 bedeutet, dass sich das erste Element unten befindet. (I552ae, b/166589935)

  • Für LazyColumn wurde der Parameter „verticalArrangement“ hinzugefügt. Der Parameter „horizontalArrangement“ wurde für „LazyRow“ hinzugefügt. Mit „Arrangement“ können wir einen Abstand zwischen Elementen einfügen und die Anordnung der Elemente festlegen, wenn nicht genügend Elemente vorhanden sind, um die Mindestgröße auszufüllen. (Icf79a, b/170394300)

  • detectMultitouchGestures verwendet jetzt einen Callback mit kombinierten Parametern für Schwerpunkt, Schwenken, Zoomen und Drehen. (Ie6e1c)

  • ContentDrawScope wurde in das Modul „ui-graphics“ verschoben, um mit DrawScope zusammen zu sein. (Iee043, b/173832789)

Fehlerkorrekturen

  • Lambdas in Offset-Modifizierern geben jetzt „IntOffset“ anstelle von „Float“ zurück. (Ic9ee5, b/174137212, b/174146755)
  • SlotTable, SlotReader und SlotWriter wurden aus der öffentlichen API entfernt. Diese wurden zuvor als „InternalComposeAPI“ gekennzeichnet. Sie sind jetzt intern im Compose-Modul.

    CompositionData und CompositionGroup wurden als Ersatz für die ui-tooling API hinzugefügt, um Kompositionsinformationen zu extrahieren. Diese sind öffentlich, aber nicht für die Verwendung außerhalb der UI-Tooling-API vorgesehen, da sie die Rohinformationen liefern, die die UI-Tooling-API interpretiert (I31a9c).

  • ShaderBrush wurde so umgestaltet, dass eine Shader-Instanz erst erstellt wird, wenn Größeninformationen der Zeichenumgebung verfügbar sind. Das ist nützlich, um Verläufe zu definieren, die zur Kompositionszeit die gesamten Zeichenbegrenzungen eines Composables einnehmen, ohne dass benutzerdefinierte DrawModifier-Implementierungen erforderlich sind.

    Verworfene Konstruktor-APIs für Gradientenfunktionen zugunsten von Factory-Methoden für ein Gradient-Objekt. (I511fc, b/173066799)

  • „Modifier.focusObserver“ wurde eingestellt. Verwenden Sie stattdessen Modifier.onFocusChanged oder Modifier.onFocusEvent (I30f17, b/168511863, b/168511484).

  • Die Autofill API ist jetzt eine experimentelle API und erfordert die Einwilligung (I0a1ec).

  • Destrukturierungsdeklarationen zum Erstellen von FocusRequester-Instanzen hinzugefügt (I35d84, b/174817008)

  • „accessibilityLabel“ wurde in „contentDescription“ umbenannt. „accessibilityValue“ wurde in „stateDescription“ umbenannt. (I250f2)

  • Es wurden mehrere neue Funktionen in SelectionRegistrar eingeführt und onPositionChange wurde in notifyPositionChange umbenannt. (Ifbaf7)

  • AndroidOwner made internal (Ibcad0, b/170296980)

  • Neue Funktion „infiniteRepeatable“ zum Erstellen eines InfiniteRepeatableSpec (I668e5)

  • Die Applier-Schnittstelle wurde geändert, um das Erstellen von Bäumen von unten nach oben statt von oben nach unten zu vereinfachen.

    Die Methode insert() wurde in insertTopDown() umbenannt.

    Die neue Methode insertBottomUp() wurde hinzugefügt.

    Ein Applier fügt Knoten in den Baum ein, den er bearbeitet, indem er je nach Leistung insertTopDown() oder insertBottomUp() verwendet.

    Einige Bäume, z. B. LayoutNode und View, lassen sich viel effizienter von unten nach oben als von oben nach unten erstellen. Vor dieser Änderung war ein Stapel von Einfügungen erforderlich, um Bottom-up zu implementieren. Dieser musste in jeden Applier kopiert werden, der aus Leistungsgründen eine Bottom-up-Konstruktion benötigte. Mit dieser Änderung wird insertBottomUp() durch Applier überschrieben, um einen Baum von unten nach oben zu erstellen, und insertTopDown(), um den Baum von oben nach unten zu erstellen. (Icbdc2)

  • Die painterResource-API wurde hinzugefügt, um das undurchsichtige Laden von Painter-Objekten aus gerasterten Asset-Formaten (z. B. PNGs) oder VectorDrawables zu ermöglichen. Verbraucher müssen den Typ des Assets nicht mehr im Voraus bestimmen und können diese Methode aufrufen, um ein Painter-Objekt zu erhalten, das in Image-Composables oder Painter-Modifizierern verwendet werden kann. (I2c703, b/173818471)

  • Die Factory-Funktion „buildAnnotatedString“ wurde hinzugefügt, um eine AnnotatedString zu erstellen. Die Builder-Funktion „annotatedString“ wurde eingestellt. (Idfe0b)

Version 1.0.0-alpha08

2. Dezember 2020

androidx.compose.foundation:foundation:1.0.0-alpha08 und androidx.compose.foundation:foundation-layout:1.0.0-alpha08 werden veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

API-Änderungen

  • Der Parameter maxLines wurde aus CoreTextField entfernt. Wenn Sie die Höhe des Textfelds durch die Anzahl der Zeilen einschränken möchten, verwenden Sie stattdessen BasicTextField. (Iec002)
  • Die await*TouchSlop()-Methoden wurden so geändert, dass sie das Herunterdrücken des Mauszeigers nicht erkennen, und in *OrCancellation umbenannt. Außerdem ist der Parameter orientationLock nicht mehr erforderlich. (Ie96e1)
  • Es wurde eine Lint-Prüfung für die Benennung und Position von zusammensetzbaren Lambda-Parametern hinzugefügt, um die Einhaltung der Compose-Richtlinien zu prüfen. Außerdem wurden einige APIs, die children als Namen für ihr nachgestelltes Lambda verwenden, gemäß Lint-Prüfung und Anleitung zu content migriert. (Iec48e)
  • foundation:foundation-text-APIs wurden in foundation:foundation verschoben. Die Paketstruktur ist gleich geblieben (Id3eb2).
  • Neuer Multitouch-Gesterkennungs-Mechanismus, einschließlich Hilfsfunktionen zum Erkennen von Drehen, Zoomen und Schwenken. (Ic459d)
  • Neuer Drag-Gesten-Erkennungsmechanismus, der die Pointer-Eingabe-API unterbricht, einschließlich der Ausrichtungssperre. (Icef25)
  • VectorAsset wurde in ImageVector umbenannt. VectorAsset wurde in Builder verschoben und umbenannt, um gemäß den API-Council-Richtlinien eine innere Klasse von ImageVector zu sein. Es wurde ein Typalias von VectorAssetBuilder hinzugefügt, um für die Kompatibilität auf ImageVector.Builder zu verweisen. (Icfdc8)
  • ImageAsset und zugehörige Methoden wurden in ImageBitmap umbenannt. (Ia2d99)
  • Semantische Eigenschaften der Grundlage in „ui“ verschoben (I6f05c)
  • Auf Coroutinen basierende Scrolling-APIs hinzufügen:

    Es wurden LazyListState.snapToItem und LazyListState.smoothScrollBy sowie APIs auf niedrigerer Ebene für die Scrollsteuerung hinzugefügt. Diese APIs bieten eine Suspend-Schnittstelle zur Steuerung des Scrollens, die wartet, bis das Scrollen abgeschlossen ist, bevor sie zurückkehrt. (Ie5642)

  • In BasicTextField, TextField und OutlinedTextField wurde ein „singleLine“-Parameter hinzugefügt. Setzen Sie diesen Parameter auf „true“, damit das Textfeld eine einzelne horizontal scrollbare Zeile ist. (I57004, b/168187755)

  • Es wurde ein Gestenerkennungstool für Tippen, Doppeltippen, langes Drücken und Drückanzeige mit dem neuen suspendierenden Zeigereingabe-Tool hinzugefügt. Außerdem wurden einige Dienstprogramme hinzugefügt, die es Entwicklern erleichtern, eigene Gestenerkennung zu schreiben. (I00807)

  • „Modifier.focusable“ wurde in „foundation“ ein „need“ hinzugefügt. Damit können Sie einer Komponente das Verhalten hinzufügen, dass sie fokussierbar ist, und dabei die richtige Semantik und Barrierefreiheit berücksichtigen. (I41eb9, b/152525426, b/162865824)

  • Zuvor verworfene APIs wurden entfernt: „Border“ wurde entfernt. Verwenden Sie stattdessen „BorderStroke“. „Modifier.drawBorder“ wurde entfernt. Verwenden Sie stattdessen „Modifier.border“. „Modifier.gravity“ wurde entfernt. Verwenden Sie stattdessen „Modifier.align“. Stack wurde entfernt, verwenden Sie stattdessen Box (I32c2b, b/172470874)

  • „AbsoluteArrangement“ wurde in „Arrangement.Absolute“ umbenannt. (If26f2)

Fehlerkorrekturen

  • Die DrawModifier-APIs wurden vom Paket androidx.compose.ui in das Paket androidx.compose.ui.draw verschoben. Die Datei „DrawModifierDeprecated.kt“ wurde erstellt, um Typaliase/Hilfsmethoden für die Migration von den eingestellten zu den aktuellen APIs bereitzustellen. (Id6044, b/173834241)
  • „Modifier.drawLayer“ wurde in „Modifier.graphicsLayer“ umbenannt. Außerdem wurden zugehörige Klassen gemäß dem Feedback des API-Teams in „GraphicsLayer“ aktualisiert. (I0bd29, b/173834241)
  • <T> wurde aus der SubcomposeLayout-Deklaration entfernt. Sie können es jetzt verwenden, ohne einen Typ anzugeben. (Ib60c8)
  • Die Felder „uptime“ und „position“ von „PointerInputData“ sind jetzt nicht mehr nullable. (Id468a)
  • Mit MaterialTheme werden jetzt die richtigen Farben für Auswahlhandles und den Auswahlhintergrund festgelegt. Nicht-Material-Apps können die Farben für die Auswahl manuell mit AmbientTextSelectionColors anpassen. (I1e6f4, b/139320372, b/139320907)
  • Der Ausrichtungsparameter von „Box“ wurde in „contentAlignment“ umbenannt. (I2c957)
  • Die offsetPx-Modifikatoren wurden in „offset“ umbenannt. Sie akzeptieren jetzt Lambda-Parameter anstelle von „State“. (Ic3021, b/173594846)
  • WindowManager.isWindowFocused wurde hinzugefügt, um zu prüfen, ob das Hostfenster im Fokus ist, sowie ein WindowFocusObserver, der einen onWindowFocusChanged-Callback bereitstellt. (I53b2a, b/170932874)
  • Der Parameter „resetInput“ wurde zu TextInputService#onStateUpdated hinzugefügt (I3e8f5, b/172239032, b/171860947).
  • Aktualisierte TextFieldValue API
    • TextFieldValue.composition ist jetzt schreibgeschützt
    • Entfernte Ausnahme für ungültigen Auswahlbereich (I4a675, b/172239032)
  • Wir haben die verworfenen Ambients mit dem Suffix Ambient ersetzt und neue Eigenschaften mit dem Präfix „Ambient“ eingeführt, die anderen Ambients und den Compose-API-Richtlinien entsprechen. (I33440)
  • Android-Typeface-Wrapper hinzugefügt. Sie können einen Android-Schriftfont über die Funktion typeface laden, z.B. typeface(Typeface.DEFAULT). typefaceFromFontFamily() wurde auch in typeface() umbenannt (I52ab7)
  • Es wurde ein Lint-Check hinzugefügt, um zu prüfen, ob in Modifier-Factories intern androidx.compose.ui.composed {} verwendet wird, anstatt als @Composable gekennzeichnet zu sein. (I3c4bc)
  • Es wurde ein Lint-Check hinzugefügt, um zu prüfen, ob Modifier-Factory-Funktionen als Erweiterungen für Modifier definiert sind, damit sie flüssig verkettet werden können. (I07981)
  • Das Semantikargument „mergeAllDescendants“ wurde in „mergeDescendants“ umbenannt. (Ib6250)
  • Die Zeitsteuerung in Tests (TestAnimationClock und ihre Verwendung) ist jetzt experimentell (I6ef86, b/171378521).
  • Altes ui-test-Modul und seine Stubs entfernen (I3a7cb)
  • TextUnit.Inherit wurde in TextUnit.Unspecified umbenannt, um die Einheit an andere Einheiten anzupassen. (Ifce19)
  • Die Benutzeroberfläche für die Ausrichtung wurde aktualisiert und funktionsfähig gemacht. (I46a07, b/172311734)
  • Das Modul foundation:foundation-text wurde in foundation:foundation (Idac0f) zusammengeführt.
  • Die Funktionen „place(Offset)“ und „placeRelative(Offset)“ werden eingestellt. Verwenden Sie stattdessen Überladungen mit Ganzzahl-Offsets (I4c5e7).
  • id wurde für LayoutIdParentData in layoutId umbenannt. Measurable.id wurde in Measurable.layoutId umbenannt. (Iadbcb, b/172449643)

Version 1.0.0-alpha07

11. November 2020

androidx.compose.foundation:foundation:1.0.0-alpha07, androidx.compose.foundation:foundation-layout:1.0.0-alpha07 und androidx.compose.foundation:foundation-text:1.0.0-alpha07 sind veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

API-Änderungen

  • Ähnlich wie bei Modifier.fillMaxSize[Width|Height] werden jetzt auch Bruchzahlen in Modifier.fillParentMaxSize[Width|Height] im Rahmen von LazyColumn/Row unterstützt (I797e2, b/166586426).
  • KeyboardOptions.toImeOptions wurde aus der öffentlichen API entfernt. (Ic2e45)
  • Die Grundlagen AmbientTextStyle, ProvideTextStyle und AmbientContentColor wurden eingestellt. Verwenden Sie stattdessen die neuen Versionen, die in der Materialbibliothek verfügbar sind. Für Nicht-Material-Anwendungen sollten Sie stattdessen eigene Designsystem-spezifische Ambient-Themen erstellen, die in Ihren eigenen Komponenten verwendet werden können. (I74acc, b/172067770)
  • foundation.Text wurde eingestellt und durch material.Text ersetzt. Eine einfache, neutrale Text-API, die keine Werte aus einem Theme verwendet, finden Sie unter androidx.compose.foundation.BasicText. (If64cb)
  • maxLines für TextFields hinzugefügt (Ib2a5b)
  • TextFields für die Akzeptanz von KeyboardOptions aktualisieren (Ida7f3)
  • KeyboardOptions für die Verwendung in TextFields hinzugefügt (I9ca32)
  • Fügt BasicText als designunabhängige API für Text parallel zu BasicTextField hinzu. (I28268)
  • Die Annotation „ExperimentalLazyDsl“ wurde entfernt. LazyColumn/LazyRow kann jetzt ohne @OptIn verwendet werden (Idab7a, b/166584730)
  • BaseTextField wurde eingestellt. Verwenden Sie stattdessen BasicTextField. (I896eb)
  • BasicTextField wurde als Ersatz für CoreTextField und BaseTextField hinzugefügt (Id4cea).
  • Entfernen der eingestellten LazyColumnItems/LazyRowItems (I1d8a8)
  • Die eingestellten Composables für die Größenanpassung an intrinsische Messungen wurden entfernt. (I18537, b/171811496)
  • „relativePaddingFrom“ wurde in „paddingFrom“ umbenannt. Der Modifier „paddingFromBaseline“ wurde hinzugefügt, um die Angabe von Abständen von Layoutgrenzen zu Text-Baselines zu vereinfachen. (I0440a, b/170633813)
  • Der Parameter „matchHeightConstraintsFirst“ wurde dem Modifizierer „aspectRatio“ hinzugefügt. Mit ihm kann angegeben werden, dass der Modifizierer zuerst an die Höhenbeschränkungen angepasst werden soll, bevor die entsprechenden Breitenbeschränkungen berücksichtigt werden. (Ie7c43, b/155290593)
  • Die verworfene DpConstraints-Klasse wurde entfernt. (I87884, b/171702471)

Fehlerkorrekturen

  • Die Inline-Klasse „ScaleFactor“ wurde eingeführt, um Skalierungsfaktoren für die horizontalen und vertikalen Achsen unabhängig voneinander darzustellen und so Anwendungsfälle mit nicht einheitlicher Skalierung zu unterstützen.
    • Der Klasse „ContentScale“ wurde die Methode „computeScaleFactor“ hinzugefügt.
    • „ContentScale.FillBounds“ wurde hinzugefügt, um eine nicht einheitliche Skalierung durchzuführen, mit der die Quellgrenzen so gedehnt werden, dass sie das Ziel vollständig ausfüllen.
    • Es wurden Operatormethoden zum Berechnen von ScaleFactor-Parametern mit Size-Parametern hinzugefügt.
    • (Ic96a6, b/172291582)
  • „captureToBitmap“ wurde zu „captureToImage“ verschoben. (I86385)
  • Markiert CoreText als @InternalTextApi. Verwenden Sie stattdessen BasicText. (I6aaeb)
  • KeyboardOptions in ImeOptions umbenennen (I82f36)
  • KeyboardType und ImeAction wurden in KeyboardOptions verschoben (I910ce)
  • CoreTextField wurde mit @InternalTextApi markiert. BasicTextField verwenden (Ie2469)
  • Die Annotation „ExperimentalSubcomposeLayoutApi“ wurde entfernt. SubcomposeLayout kann jetzt ohne @OptIn verwendet werden (I708ad).
  • Einführung des Moduls „ui-test-junit4“ (Ib91f8)
  • Die Icon API wurde aktualisiert, um Color.Unspecified als mögliche Tönungsfarbe zu akzeptieren. Das bereitgestellte Asset oder der Painter wird dann ohne ColorFilter gezeichnet. Bisher wurde bei dem Versuch, die Tönung mit Color.Unspecified zu ignorieren, eine transparente Farbe verwendet, sodass nichts gerendert wurde. (I049e2, b/171624632)
  • „MeasureResult“ wurde aus „MeasureScope“ verschoben. (Ibf96d, b/171184002)
  • Mehrere layoutbezogene Symbole wurden von androidx.compose.ui nach androidx.compose.layout.ui verschoben. (I0fa98, b/170475424)
  • androidx.ui.test wurde zu androidx.compose.ui.test verschoben (I9ffdb)
  • FirstBaseline und LastBaseline wurden in das Paket androidx.compose.ui.layout verschoben (Ied2e7).
  • SelectionContainer ohne den Callback (Ibfadb) hinzugefügt
  • Tests für die Positionen von SelectionHandles in SelectionContainer hinzugefügt. (Ie93db)
  • IME-Option für die automatische Korrektur der Tastatur hinzugefügt (I57b8d)

Version 1.0.0-alpha06

28. Oktober 2020

androidx.compose.foundation:foundation:1.0.0-alpha06, androidx.compose.foundation:foundation-layout:1.0.0-alpha06 und androidx.compose.foundation:foundation-text:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

  • androidx.compose.foundation.Icon wurde zu androidx.compose.material.Icon verschoben. Wenn Sie die Material-Bibliothek nicht verwenden möchten, können Sie auch die Image-Komponente / Modifier.paint() mit einem Painter verwenden. (I9f622)
  • interactionState wurde zu Modifier.scrollable, ScrollableColumn und LazyColumnFor hinzugefügt (I81566, b/169509805)
  • alignByBaseline wurde zu RowScope hinzugefügt und alignWithSiblings wurde in alignBy umbenannt (I06503, b/170628732)
  • Box wurde zu einer Inline-Funktion. (Ibce0c, b/155056091)
  • maxLines wurde zu CoreTextField hinzugefügt (Ibee58, b/143687793)
  • CoreTextField wurde um Softwrap erweitert. (I21a4b)

Fehlerkorrekturen

  • VectorPainter wird zugunsten von rememberVectorPainter eingestellt, um besser zu verdeutlichen, dass die zusammensetzbare API intern „remember“ verwendet, um Daten über Kompositionen hinweg beizubehalten. (Ifda43)
  • Übergänge in ComposeTestRule aktivieren; Option zum Aktivieren des blinkenden Cursors aus ComposeTestRule entfernen. (If0de3)
  • Dem CoreTextField wurde die Option für einzeilige Tastaturen hinzugefügt (I72e6d).
  • Die Radius API wurde in CornerRadius umbenannt, um besser zu verdeutlichen, wie sie in Compose verwendet wird. Die Dokumentation wurde aktualisiert, um darauf hinzuweisen, dass negative Eckenradien auf null begrenzt werden. (I130c7, b/168762961)
  • Möglichkeit hinzugefügt, Prüftoolinformationen in einem zusammengesetzten Modifier anzugeben (Idee08, b/163494569)
  • IME-Option „KeyboardCapitalization“ hinzugefügt (I8ac38)
  • Position des RTL-Ziehpunktes korrigieren (I6e1e0)
  • Breaking Change: Der Rückgabewert wurde aus PointerInputFilter.onPointerEvent(...) entfernt, da der einzige Wert, der bei Zeigerereignissen geändert werden kann, die Verbrauchsdaten sind. Anstatt Daten von PointerInputFilter.onPointerEvent(...) zurückzugeben, können Sie jetzt einfach die Verbrauchsdaten der übergebenen PointerEvents ändern. (I6acd0)
  • Die Option „Alle auswählen“ wurde dem Auswahlmenü hinzugefügt (Ief02b).

Version 1.0.0-alpha05

14. Oktober 2020

androidx.compose.foundation:foundation:1.0.0-alpha05, androidx.compose.foundation:foundation-layout:1.0.0-alpha05 und androidx.compose.foundation:foundation-text:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

API-Änderungen

  • CoreTextField unterstützt jetzt die Cursorfunktion (Id23aa)
  • Die APIs „contentColor()“ und „currentTextStyle()“ werden eingestellt und durch die Ambient-Variablen „AmbientContentColor“ und „AmbientTextStyle“ ersetzt. Sie können auf den aktuellen Wert zugreifen, indem Sie .current für die Ambient-Eigenschaft verwenden, wie bei jedem anderen Ambient. Diese Änderung wurde vorgenommen, um die Einheitlichkeit zu verbessern und mehrere Möglichkeiten zur Erledigung derselben Aufgabe zu vermeiden. Außerdem wurden einige Ambient-Properties umbenannt, um ihren Zweck besser zu beschreiben:

    • ContentColorAmbient -> AmbientContentColor
    • TextStyleAmbient -> AmbientTextStyle
    • IndicationAmbient -> AmbientIndication
    • EmphasisAmbient -> AmbientEmphasisLevels
    • RippleThemeAmbient -> AmbientRippleTheme (I37b6d)

Fehlerkorrekturen

  • Im Rahmen der Standardisierung von Sentinel-Werten für Inline-Klassen wird „Color.Unset“ in „Color.Unspecified“ umbenannt, um die Konsistenz mit anderen Inline-Klassen zu gewährleisten (I97611, b/169797763).
  • Aktionen für Bedienungshilfen zum Kopieren, Einfügen und Ausschneiden hinzugefügt (I6db4f)
  • „TextOverflow.None“ wurde eingeführt. Wenn „overflow“ auf „None“ gesetzt ist, wird kein Überlauf mehr verarbeitet und die tatsächliche Größe wird an „LayoutNode“ gemeldet. (I175c9, b/158830170)
  • Die Parameter „Size.Unspecified“ wurden von „Float.POSITIVE_INFINITY“ zu „Float.NaN“ aktualisiert. Die Painter-Implementierungen wurden aktualisiert, um auch Size.Unspecified und nicht endliche Größen zu berücksichtigen. (I95a7e)
  • Paging-Compose-Modul und Paging-Integration hinzugefügt (Ib85da)
  • LazyListScope so ändern, dass Nullwerte empfangen werden (I1765b)
  • OnPositionedModifier wurde in OnGloballyPositionedModifier umbenannt und onPositioned() in onGloballyPositioned(). (I587e8, b/169083903)
  • Beispiele für LazyColumn/Row hinzugefügt (Idc16d)
  • Korrektur für die Methoden „items“ und „itemsIndexed“, um „emptyList“ zuzulassen (I06647)
  • DSL zum Angeben von Prüferinformationen hinzufügen (Ic9a22)
  • Verschiebe „Lang drücken“ in „Text“. (Iff2bc)
  • „Auswahl im Text“ deaktivieren und Demo (Ie7e97)
  • Unterstützung der Konvertierung von AnnotatedString in SpannableString für die Barrierefreiheit. (Ief907)
  • PointerInputFilter.onPointerInput(...) wurde entfernt. Verwenden Sie stattdessen PointerInputFilter.onPointerEvent(...). (I6f04a)

Version 1.0.0-alpha04

1. Oktober 2020

androidx.compose.foundation:foundation:1.0.0-alpha04, androidx.compose.foundation:foundation-layout:1.0.0-alpha04 und androidx.compose.foundation:foundation-text:1.0.0-alpha04 sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

API-Änderungen

  • Der Stapel wurde in „Box“ umbenannt. Die zuvor vorhandene foundation.Box wird zugunsten der neuen Box in compose.foundation.layout eingestellt. In der neuen Box werden untergeordnete Elemente übereinander gestapelt, wenn sie mehrere untergeordnete Elemente enthält. Das ist anders als bei der vorherigen Box, die sich ähnlich wie eine Spalte verhalten hat. (I94893, b/167680279)
  • Die Parameter für die Box-Dekoration wurden eingestellt. Wenn Sie Dekorationen/Abstände für Ihre Box festlegen möchten, verwenden Sie stattdessen Modifiers (Modifier.background, Modifier.border, Modifier.padding) (Ibae92, b/167680279).
  • Fügen Sie eine neue LazyListState-Klasse hinzu. So kann die Scrollposition von LazyRow- und LazyColumn-Komponenten beobachtet und gesteuert werden. Instanzen können mit rememberLazyListState() erstellt und an den Statusparameter der Komponente übergeben werden. In dieser ersten Version sind derzeit das erste sichtbare Element und die Offsets zu sehen. (Ic7cb7, b/159307669)
  • Die Position der Lazy List und der Scroll-Offset werden jetzt gespeichert und bei der Neuerstellung von Aktivitäten wiederhergestellt (Ie045f, b/166589058).
  • Aktion für langes Klicken hinzufügen (I6281b, b/156468846)
  • Das MutatorMutex-Dienstprogramm wurde hinzugefügt, um einen einzelnen Mutator des freigegebenen Status im Zeitverlauf beizubehalten und in Konflikt stehende Mutatoren nach Priorität abzubrechen (I3f975).
  • Annotate rootAnimationClockFactory, transitionsEnabled, blinkingCursorEnabled and textInputServiceFactory with @VisibleForTesting, make them internal API and hide their kdoc (I554eb, b/168308412)
  • Der Parameter „inlineContent“ wurde aus „Text with String input“ entfernt. Sie wird nicht verwendet, da inlineContent mit AnnotatedString funktionieren muss. (Ief403)
  • Die verworfenen benutzerdefinierten Arrangement-APIs wurden entfernt. (Ic576d, b/168297922, b/168297923)
  • Der Parameter unbounded wurde den wrapContentSize-Modifizierern hinzugefügt, damit das Layoutelement mit unendlichen maximalen Einschränkungen gemessen werden kann. (I77951, b/158559319)
  • Wir haben statische Importe von Inhalten von Layout-Scopes (z.B. „alignWithSiblings“ in „RowScope“) verhindert. Verwenden Sie stattdessen die explizite Bereichsalternative: with(RowScope) { Modifier.alignWithSiblings(FirstBaseline) }. (I216be, b/166760797)

Fehlerkorrekturen

  • Viele Grafik-APIs wurden aktualisiert.
    • Die APIs für die Skalierungs- und Rotations-Transformation wurden aktualisiert, sodass sie einen einzelnen Offset-Parameter für die Darstellung der Pivot-Koordinate anstelle separater Gleitkommaparameter für die x-/y-Koordinaten in DrawScope und DrawTransform verwenden.
    • Die Methoden „Rect.expandToInclude“ und „Rect.join“ wurden entfernt.
    • Die Dokumentation zum Radius wurde aktualisiert und enthält jetzt neben „elliptisch“ auch „oval“.
    • Dokumentation hinzugefügt, um darauf hinzuweisen, dass der öffentliche Konstruktor für die Inline-Klasse „Radius“ nicht direkt aufgerufen werden darf, sondern Radius-Objekte über ihre Funktionskonstruktoren instanziiert werden müssen.
    • Die RoundRect-APIs zum Abfragen von topRight, bottomRight, bottomCenter usw. wurden entfernt.
    • Rect.shift zugunsten von Rect.translate eingestellt
    • Entfernte APIs „RoundRect.grow“ und „Rect.shrink“
    • RoundRect.outerRect wurde in Rect.boundingRect umbenannt
    • Die Methoden „RoundRect.middleRect/tallMiddleRect/wideMiddleRect“ und „Rect.isStadium“ wurden entfernt.
    • RoundRect.longestSide wurde in RoundRect.maxDimension umbenannt.
    • RoundRect.shortestSide wurde in RoundRect.minDimension umbenannt
    • RoundRect.center ist jetzt eine Eigenschaft anstelle einer Funktion.
    • Der RoundRect-Konstruktor wurde aktualisiert, sodass er Radius-Eigenschaften anstelle von einzelnen Parametern für x-/y-Radiuswerte verwendet.
    • Entfernte Größen-APIs, bei denen davon ausgegangen wurde, dass es sich um ein Rechteck mit dem Ursprung bei 0,0 handelt
    • Destrukturierungs-API zu Radius hinzugefügt
    • Verschiedene RoundRect-Erweiterungsfunktionen wurden zu Eigenschaften migriert.
    • (I8f5c7, b/168762961)
  • Leistungsoptimierungen für das Scrollen von LazyColumnFor/LazyRowFor durch Vermeidung unnötiger Neukompositionen bei jedem Scrollen (I64f65, b/168293643, b/167972292, b/165028371)
  • Absturz in LazyColumnFor/LazyRowFor nach dem Scrollen und Ändern von Elementen behoben und automatisches Aufwärtsscrollen implementiert, wenn das zuvor sichtbare Element entfernt wurde, damit keine leeren Lücken mehr am Ende angezeigt werden (I220ab, b/161480164, b/167855468)
  • Das Verschachteln von scrollbaren Containern in derselben Richtung wie ScrollableContainer und LazyColumnFor ist nicht mehr zulässig. Sie wurde nie unterstützt und hat das Flinging und die Lazy-Komposition der Elemente von LazyColumnFor unterbrochen (I6e101).
  • Viele Grafik-APIs wurden aktualisiert.
    • Die DrawScope-APIs wurden mit Methoden für Transformationen mit Bereich aktualisiert, um anzugeben, dass die Transformation nur innerhalb des Callbacks angewendet und nach dem Aufrufen des Callbacks entfernt wird.
    • Die Dokumentation zu „clipPath“ wurde aktualisiert. Es wird jetzt auf „Path“ anstelle von abgerundeten Rechtecken verwiesen.
    • Der Abstand in der Dokumentation für den rechten Parameter in „clipPath“ wurde korrigiert.
    • DrawScope.drawCanvas wurde in drawIntoCanvas umbenannt und der Größenparameter wurde entfernt.
    • Die dx/dy-Parameter in der Inset-Methode wurden in „horizontal“ und „vertical“ umbenannt.
    • Es wurde eine Inset-Überladung hinzugefügt, die für alle vier Grenzen denselben Inset-Wert bereitstellt.
    • Dokumentation zur Inset-Methode entfernt, in der angegeben wurde, dass „inset“ auf alle vier Seiten angewendet wird
    • Aktualisierte Dokumentation für die Klasse „Rect“
    • Die Kommentare zu Rechteckparametern wurden an den kdoc-Stil angepasst.
    • Rect.join und Rect.expandToInclude entfernt
    • Überladung für Rect.translate(offset) erstellt und Rect.shift als veraltet markiert
    • (If086a, b/167737376)
  • „AccessibilityScrollState“ zu Semantik-Properties hinzufügen. (Ifeda9)
  • Machen Sie TextRange inline, um die Objekterstellung zu vermeiden. (Id034b)
  • „ParagraphConstraints“ wurde entfernt. Die Breite wird jetzt direkt an „Paragraph“ übergeben. (Ica712)

Version 1.0.0-alpha03

16. September 2020

androidx.compose.foundation:foundation:1.0.0-alpha03, androidx.compose.foundation:foundation-layout:1.0.0-alpha03 und androidx.compose.foundation:foundation-text:1.0.0-alpha03 sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

  • „InnerPadding“ wurde in „PaddingValues“ umbenannt. (I195f1, b/167389171)
  • Die Verwendung von „gravity“ wurde in Layout-APIs konsistent in „align“ oder „alignment“ umbenannt. (I2421a, b/164077038)
  • Dem Stack-Element wurde ein Ausrichtungsparameter hinzugefügt, mit dem die Standardausrichtung für alle untergeordneten Stack-Elemente angegeben werden kann. (Ie80ca, b/164085265)

Fehlerkorrekturen

  • DpConstraints und APIs, die sie verwenden, wurden eingestellt. (I90cdb, b/167389835)
  • Die Parameter minWidth und maxWidth von widthIn wurden in min und max umbenannt. Ähnliches gilt für preferredWidthIn, heightIn und preferredHeightIn. (I0e5e1, b/167389544)
  • „onNode“ und andere globale Methoden wurden in „ComposeTestRule“ hinzugefügt, da die aktuellen globalen Methoden eingestellt werden. (Ieae36)
  • Die Berechnungen für Größe und Position in GestureScope wurden korrigiert. Dies hatte unter anderem zur Folge, dass ungültige Wischgesten generiert wurden (Iaf358, b/166589947).
  • createAndroidComposeRule und AndroidInputDispatcher wurden von androidx.ui.test.android nach androidx.ui.test verschoben (Idef08, b/164060572)

Version 1.0.0-alpha02

2. September 2020

androidx.compose.foundation:foundation:1.0.0-alpha02, androidx.compose.foundation:foundation-layout:1.0.0-alpha02 und androidx.compose.foundation:foundation-text:1.0.0-alpha02 sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Fehlerkorrekturen

  • TestUiDispatcher ist als experimentell gekennzeichnet (Iae99d, b/161247083)
  • ManualFrameClock.hasAwaiters wurde hinzugefügt, um zu prüfen, ob ein Frame von dieser Taktquelle erwartet wird. runWithManualClock als Ersatz für runBlocking beim Ausführen von Tests, die eine ManualFrameClock erfordern. TestUiDispatcher.Main bietet einfachen Zugriff auf den Haupt-UI-Dispatcher in Ihren Tests.

    Beispiel:

    @Test
    fun myTest() = runWithManualClock { clock ->
        // set some compose content
        withContext(TestUiDispatcher.Main) {
            clock.advanceClock(1000L)
        }
        if (clock.hasAwaiters) {
            println("The clock has awaiters")
        } else {
            println("The clock has no more awaiters")
        }
    }
    

    (I0a85b, b/161247083)

Version 1.0.0-alpha01

26. August 2020

androidx.compose.foundation:foundation:1.0.0-alpha01, androidx.compose.foundation:foundation-layout:1.0.0-alpha01 und androidx.compose.foundation:foundation-text:1.0.0-alpha01 sind veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Version 0.1.0-dev

Version 0.1.0-dev17

19. August 2020

androidx.compose.foundation:foundation:0.1.0-dev17, androidx.compose.foundation:foundation-layout:0.1.0-dev17 und androidx.compose.foundation:foundation-text:0.1.0-dev17 sind veröffentlicht. Version 0.1.0-dev17 enthält diese Commits.

API-Änderungen

  • Das Arrangement „spacedBy“ wurde für „Row“ und „Column“ hinzugefügt, um die Positionierung von Layout-Untergeordneten mit einem festen Abstand zu ermöglichen. Das ausgerichtete Arrangement wurde ebenfalls hinzugefügt, um die Positionierung von untergeordneten Layout-Elementen nebeneinander und ausgerichtet in der Zeile/Spalte entsprechend einer Ausrichtung zu ermöglichen. Die bisherigen Methoden „Arrangement.Vertical#arrange“ und „Arrangement.Horizontal#arrange“ wurden eingestellt. Das Schreiben benutzerdefinierter Arrangements wird in Zukunft nicht mehr unterstützt. (I6733d, b/161985975)
  • Der Offset ist jetzt eine Inline-Klasse (Iaec70).
  • „onFocusChanged“-Callbacks aus „TextField“ entfernt. Verwenden Sie stattdessen „Modifier.focusObserver“. (I51089, b/161297615)
  • „Modifier.drawBorder“ wurde eingestellt. Verwenden Sie stattdessen „Modifier.border“. Die Border-Datenklasse wurde durch BorderStroke ersetzt (I4257d, b/158160576).
  • „VerticalScroller“ und „HorizontalScroller“ wurden entfernt. Verwenden Sie stattdessen ScrollableColumn/Row. Modifier.drawBackground wurde entfernt. Modifier.background verwenden (I73b0d, b/163019183)
  • Entfernen Sie die als veraltet markierten fillMax*-Modifikatoren aus LazyItemScope, da es dadurch schwieriger wird, solche Modifikatoren für Elemente hinzuzufügen, die keine direkten untergeordneten Elemente von LazyColumnFor sind (Ifa78d).
  • LazyColumn-/LazyRow-Implementierung als DSL hinzugefügt (I93cc6)
  • „Constraints“ ist jetzt eine Inline-Klasse (I88736)
  • Es ist jetzt möglich, ein Layout mit den Modifikatoren „fillMaxWidth“, „fillMaxHeight“ und „fillMaxSize“ auf einen Bruchteil des verfügbaren Platzes zu skalieren. (I945bb, b/161562591)

Fehlerkorrekturen

  • Der SelectionContainer wurde ein Modifier-Parameter hinzugefügt (I4aada, b/161487952).
  • Lambda „mergePolicy“ zu „SemanticsPropertyKey“ hinzugefügt. Damit kann eine benutzerdefinierte Richtlinie für das Zusammenführen von „mergeAllDescendants“-Semantik definiert werden. Die Standardrichtlinie sieht vor, dass der übergeordnete Wert verwendet wird, sofern er bereits vorhanden ist. Andernfalls wird der untergeordnete Wert verwendet. (Iaf6c4, b/161979921)
  • PlacementScope.placeAbsolute() wurde in PlacementScope.place() umbenannt und das vorherige PlacementScope.place() wurde in PlacementScope.placeRelative() umbenannt. Daher wird die Position in Kontexten mit Leserichtung von rechts nach links nicht mehr automatisch gespiegelt.PlacementScope.place() Wenn dies gewünscht ist, verwenden Sie stattdessen PlacementScope.placeRelative(). (I873ac, b/162916675)
  • Die nicht mehr weitergeführte Komponente „FilledTextField“ wurde entfernt. Verwenden Sie stattdessen „TextField“, um die Material Design-Implementierung des ausgefüllten Textfelds zu erhalten. (I5e889)
  • Der Parameter „backgroundColor“ wurde dem LinearProgressIndicator hinzugefügt und das interne Padding wurde aus dem CircularProgressIndicator entfernt. Es wurde eine neue ProgressIndicatorConstants.DefaultProgressAnimationSpec hinzugefügt, die als Standard-AnimationSpec verwendet werden kann, wenn der Fortschritt zwischen Werten animiert wird (If38b5, b/161809914, b/161804677).
  • Die zusammensetzbare Funktion state { ... } ist jetzt zugunsten expliziter Aufrufe von remember { mutableStateOf(...) } eingestellt. Dadurch wird die gesamte API-Oberfläche und die Anzahl der Konzepte für die Statusverwaltung reduziert und das by mutableStateOf()-Muster für die Delegierung von Klasseneigenschaften wird eingehalten. (Ia5727)
  • RRect wurde in RoundRect umbenannt, um den Namensmustern von Compose besser zu entsprechen. Es wurden ähnliche Funktionskonstruktoren für RRect erstellt und die Funktionskonstruktoren von RRect wurden als veraltet eingestuft (I5d325).
  • „onChildPositioned“ und „OnChildPositionedModifier“ wurden entfernt. Entwickler sollten stattdessen „onPositioned“ und „OnPositionedModifier“ für das untergeordnete Layout verwenden. (I4522e, b/162109766)
  • IntSize ist jetzt eine Inline-Klasse (I2bf42)
  • Halten Sie den leeren Bereich gedrückt, um ihn zu bearbeiten. (Ib1e5b)
  • Die schwebende Symbolleiste wird nach dem Tippen auf den Text ausgeblendet. (If4525)
  • Die schwebende Symbolleiste wird beim Aktualisieren der Auswahl ausgeblendet. (I8444c)
  • Deaktivieren Sie „Bei Unkenntlichmachen“. (I781a2)

Version 0.1.0-dev16

5. August 2020

androidx.compose.foundation:foundation:0.1.0-dev16, androidx.compose.foundation:foundation-layout:0.1.0-dev16 und androidx.compose.foundation:foundation-text:0.1.0-dev16 sind veröffentlicht. Version 0.1.0-dev16 enthält diese Commits.

API-Änderungen

  • LazyItemScope wurde für den Parameter „itemContent“ von Lazy-Listen hinzugefügt. Es bietet Modifikatoren, um die maximale Größe des übergeordneten Elements zu füllen. Dies löst den Anwendungsfall, in dem das Element den Darstellungsbereich füllen soll und der reguläre Modifier.fillMaxSize() nicht funktioniert, da das Element mit unendlichen Einschränkungen gemessen wird. (Ibd3b2, b/162248854)
  • Dialog in die Benutzeroberfläche verschieben (I47fa6)
  • LazyColumnForIndexed/LazyRowForIndexed hinzugefügt – Versionen von LazyColumnFor/LazyRowFor, die sowohl Index als auch Element im „itemCallback“ bereitstellen. Dies ist nützlich, wenn Sie zusätzlich zu einem aktuellen Element einen aktuellen Index benötigen. (I65ff3)
  • Modifier.deternimateProgress wurde in Modifier.progressSemantics umbenannt (I9c0b4).
  • „LazyColumnItems“ wurde in „LazyColumnFor“ umbenannt. „LazyRowItems“ wurde in „LazyRowFor“ umbenannt (I84f84)
  • Fügen Sie einige Markierungen/Anmerkungen hinzu, um Best Practices zu berücksichtigen. (I66b20)
  • Das Paket „foundation.shape.corner“ wurde in „foundation.share“ zusammengeführt (I46491, b/161887429).
  • Der Parameter „crossaxis gravity“ wurde für „LazyRowItems“/„LazyColumnItems“ hinzugefügt. LazyRowItems/LazyColumnItems unterstützen jetzt das Verhalten „wrap content“. (Ib39fc)
  • „ZoomableState“ wurde in „ZoomableController“ umbenannt. Für smoothScale wurde Unterstützung für benutzerdefinierte Kurven hinzugefügt. Die Funktionen enabled und onZoomStarted wurden hinzugefügt (If8b8f)
  • „Material FilledTextField“ wurde in „TextField“ umbenannt und „foundational TextField“ in „BaseTextField“, um die einfachste gewünschte API leichter auffindbar und nutzbar zu machen (Ia6242, b/155482676).
  • Die zuvor verworfene AdapterList wurde entfernt. Verwenden Sie stattdessen LazyColumnItems (I12b9b).
  • Modifier.drawBackground wurde in Modifier.background umbenannt (I13677)
  • Die alte ConstraintLayout-DSL wurde entfernt. ConstraintSet2 wurde in ConstraintSet umbenannt. (If58d1, b/162450908)
  • „Modifier.absoluteOffset()“ und „Modifier.absoluteOffsetPx()“ hinzugefügt. Im Gegensatz zu Offset-Modifizierern werden absolute Offset-Modifizierer im Kontext von rechts nach links nicht automatisch gespiegelt (I3aa21).
  • Row und Column sind jetzt Inline-Funktionen, wodurch der Aufwand für die Verwendung erheblich reduziert wird. (I75c10)

Fehlerkorrekturen

  • Umfassende API-Korrekturen (I077bc)
    1. Nicht verwendete OffsetBase-Schnittstelle entfernen
    2. Offset- und IntOffset-Klassen anpassen, um eine einheitliche API zu erhalten
    3. Benennen Sie „IntOffset.Origin“ in „IntOffset.Zero“ um, um die Konsistenz mit der Offset API zu wahren.
    4. Die nativeCanvas-Methode wurde aus der Canvas-Schnittstelle entfernt, damit Nutzer eigene Canvas-Instanzen erstellen können.
    5. Stub-Klasse „EmptyCanvas“ erstellt, um „DrawScope“ so umzugestalten, dass sie ein Parameter ist, der nicht null sein kann, anstatt „lateinit“, und um sicherzustellen, dass das Feld nicht null sein kann.
    6. ClipOp-Enumerationen wurden in PascalCase umbenannt
    7. Die FilterQuality-Enumerationen wurden in PascalCase umbenannt.
    8. StrokeJoin-Enumerationen in PascalCase umbenannt
    9. Die PointMode-Enumerationen wurden in PascalCase umbenannt.
    10. Die PaintingStyle-Enumerationen wurden in PascalCase umbenannt.
    11. Die PathFillType-Enumerationen wurden in PascalCase umbenannt.
    12. „StrokeCap“-Enums in PascalCase umbenannt
    13. Die DrawCache-Implementierung wurde aktualisiert, sodass keine „lateinit“-Parameter mehr verwendet werden.
    14. DrawScope wurde aktualisiert, sodass die interne Parameter „fillPaint“ und „strokePaint“ nicht mehr lazy delegiert werden.
    15. Das Image-Composable wurde aktualisiert, um die Verwendung von „Box“ zu vermeiden und den Overhead zu verringern.
    16. Die Outline-Klasse wurde aktualisiert und enthält jetzt @Immutable-Annotationen.
    17. PathNode wurde aktualisiert, sodass für jede Pfadanweisung @Immutable-Annotationen vorhanden sind.
    18. Die Vektor-Unterkomposition wurde aktualisiert, um redundante bedingte Gleichheitsprüfungen zu entfernen, da diese bereits von Compose verarbeitet werden.
    19. Verworfene Begleitkonstruktormethoden für „Rect“ zugunsten von Funktionskonstruktoren
    20. Aktualisierte Brush-Klassen und Funktionskonstruktoren mit @Immutable- und @Stable-APIs
    21. Die Enumeration „VertexMode“ wurde in PascalCase aktualisiert.
    22. Die Methode „DrawScope.selectPaint“ wurde aktualisiert, um Strichparameter im Paint-Objekt nur dann bedingt zu überschreiben, wenn sie sich geändert haben.
    23. Die Größe wurde aktualisiert, um die Destrukturierungs-API hinzuzufügen, UnspecifiedSize in Unspecified umzubenennen und nicht verwendete Methoden zu entfernen.
  • Es wurde MonotonicFrameAnimationClock hinzugefügt, mit der Sie eine MonotonicFrameClock als AnimationClockObservable verwenden können, um die Lücke zwischen den neuen auf Coroutinen basierenden Taktgebern und APIs zu schließen, die weiterhin die alten auf Callbacks basierenden Taktgeber verwenden.

    Die MonotonicFrameClock-Entsprechung von ManualAnimationClock ist jetzt ManualFrameClock. (I111c7, b/161247083)

  • SemanticsNodeInteraction.performPartialGesture wurde entfernt. Verwenden Sie stattdessen SemanticsNodeInteraction.performGesture. (Id9b62)

  • SemanticsNodeInteraction.getBoundsInRoot() wurde in SemanticsNodeInteraction.getUnclippedBoundsInRoot() umbenannt (Icafdf, b/161336532)

  • Die APIs für die Unterstützung von Sprachen, die von rechts nach links geschrieben werden, wurden aktualisiert. „LayoutDirectionAmbient“ wurde hinzugefügt. Damit kann die Layoutrichtung gelesen und geändert werden. „Modifier.rtl“ und „Modifier.ltr“ wurden entfernt. (I080b3)

  • „Modifier.plus“ wurde eingestellt. Verwenden Sie stattdessen „Modifier.then“. „Dann“ ist ein stärkeres Signal für die Reihenfolge und verhindert gleichzeitig die Eingabe von Modifier.padding().background() + anotherModifier, was die Kette unterbricht und die Lesbarkeit erschwert (Iedd58, b/161529964).

  • Es wurden isFocused() und isNotFocused() SemanticsMatcher hinzugefügt. (I0b760)

  • „RemeasurementModifier“ wurde hinzugefügt. Damit können Nutzer das Layout synchron neu messen. Im Allgemeinen ist sie nie erforderlich, da die Neuvermessung/Neugestaltung automatisch erfolgt. Wir verwenden sie jedoch in LazyColumnItems während des Scrollens. (I5f331, b/160791058)

  • isSystemInDarkTheme berücksichtigt jetzt immer die systemweite Einstellung für das dunkle Design und ignoriert den Energiesparmodus vor Q gemäß den neuesten Richtlinien. (I0c10c)

  • Die Methode „OnChildPositioned“ wurde eingestellt. Verwenden Sie stattdessen OnPositioned für das untergeordnete Element. (I87f95, b/162109766)

  • AndroidComposeTestRule wurde in createAndroidComposeRule umbenannt. (I70aaf)

  • Aktion für Bedienungshilfen zum Abrufen von TextLayoutResult hinzufügen (I9d6e6)

Version 0.1.0-dev15

22. Juli 2020

androidx.compose.foundation:foundation:0.1.0-dev15, androidx.compose.foundation:foundation-layout:0.1.0-dev15 und androidx.compose.foundation:foundation-text:0.1.0-dev15 sind veröffentlicht. Version 0.1.0-dev15 enthält diese Commits.

Wenn Sie die 0.1.0-dev15-Version von Compose verwenden möchten, müssen Sie Folgendes tun:

Abhängigkeiten aktualisieren

  • Wenn Sie die 0.1.0-dev15-Version von Compose verwenden möchten, müssen Sie Ihre Abhängigkeiten gemäß den neuen Code-Snippets oben unter Abhängigkeiten deklarieren aktualisieren.

API-Änderungen

  • Ähnlich wie beim neuen Parameter in ScrollableColumn/ScrollableRow haben LazyColumnItems/LazyRowItems jetzt auch den Parameter „contentPadding“, mit dem Sie dem Inhalt nach dem Zuschneiden einen Abstand hinzufügen können. Das ist mit einem reinen Modifikatorparameter nicht möglich. Außerdem kann nur vor dem ersten oder nach dem letzten Element ein Abstand eingefügt werden. (Ibc24e)
  • onFocusChange-Callback in Textfeldern in onFocusChanged umbenannt (Ida4a1)
  • „VerticalScroller“ und „HorizontalScroller“ wurden eingestellt. Verwenden Sie ScrollableColumn und ScrollableRow für eine integrierte Lösung mit Spalten-/Zeilenverhalten und ‑parametern oder Modifier.verticalScroll und Modifier.horizontalScroll für Ihr eigenes Element. Ebenso wurde „ScrollerPosition“ zugunsten von „ScrollState“ eingestellt (I400ce, b/157225838, b/149460415, b/154105299).
  • Die APIs „Modifier.draggable“ und „Modifier.scrollable“ wurden überarbeitet. „DragDirection“ wurde zugunsten von „Orientation“ entfernt. Der Status, der für das Scrollen erforderlich ist, wurde vereinfacht. „ScrollableState“ wurde in „ScrollableController“ umbenannt (Iab63c, b/149460415).
  • Für Eigenschaften mit Einzelwertsemantik wird jetzt ein Aufrufstil verwendet. Beispiel: „semantics { hidden = true }“ wird jetzt so geschrieben: semantics { hidden() }. (Ic1afd, b/145951226, b/145955412)
  • Die von RoundedCornerShape und CutCornerShape verwendeten Eckgrößen können jetzt größer als 50 % sein (Id2340, b/160400213).
  • Der Standardparameter „ContentScale“ für die Image-Composable wurde von „Inside“ zu „Fit“ geändert. Dies wurde getan, um das Verhalten so zu skalieren, dass der zugrunde liegende Painter skaliert wird, wenn die Layoutgröße größer als die intrinsische Größe des Painters ist, während das Seitenverhältnis beibehalten wird. Dieses Verhalten entspricht besser den Erwartungen, wenn feste Größen für das Bild angegeben werden, ohne das Standardverhalten zu beeinträchtigen, wenn nur die intrinsische Größe zur Berechnung der Größe des Composables verwendet wird. (I40ae3, b/159838006)
  • Verwenden Sie AnimationSpec anstelle von AnimationBuilder in den APIs der obersten Ebene, um das Konzept der statischen Animationsspezifikation zu verdeutlichen. Verbessern Sie die Übergangs-DSL, indem Sie die Lambda-Anforderung zum Erstellen von AnimationSpecs wie Tween und Spring entfernen. Stattdessen werden Konstruktorparameter direkt verwendet. – Die allgemeine Benutzerfreundlichkeit von AnimationSpec wurde verbessert, indem Konstruktoren anstelle von Buildern verwendet werden. – Die Dauer und Verzögerung für KeyFrames und Tween wurde in „Int“ geändert. Dadurch werden unnötige Typumwandlungen und Methodenüberladungen (zur Unterstützung von „Long“ und „Int“) vermieden. (Ica0b4)
  • Die Schaltfläche wurde entfernt. Modifier.clickable verwenden (I84bdf)
  • LazyRowItems hinzugefügt – horizontal scrollendes Analogon von LazyColumnItems (Ibbcf7)
  • Es wurden untergeordnete zustandslose Animations-APIs eingeführt. Diese APIs (I63bf7)
  • „androidx.ui.foundation.TextFieldValue“ und „androidx.ui.input.EditorValue“ sind veraltet. Die Composables TextField, FilledTextField und CoreTextField, die diesen Typ verwenden, sind ebenfalls veraltet. Verwenden Sie stattdessen androidx.ui.input.TextFieldValue (I4066d, b/155211005).
  • Die Verwendung von „IntPx“ wurde durch „Int“ ersetzt. „IntPxPosition“ wurde durch „IntOffset“ ersetzt. „IntPxSize“ wurde durch „IntSize“ ersetzt. (Ib7b44)
  • androidx.ui.foundation.shape.RectangleShape wurde entfernt; verwenden Sie androidx.ui.graphics.RectangleShape (I94939, b/154507984)
  • Um die Anzahl der Klassen zu reduzieren, die zur Darstellung von Größeninformationen verwendet werden, sollten Sie die Klasse „Size“ anstelle von „PxSize“ verwenden. Dies bietet die Vorteile einer Inline-Klasse, um einen Long-Wert zu nutzen, um zwei Float-Werte zu packen, die Breite und Höhe als Floats darstellen. (Ic0191)
  • Um die Anzahl der Klassen zu reduzieren, die zur Darstellung von Positionsinformationen verwendet werden, wird die Verwendung der Offset-Klasse anstelle von PxPosition standardisiert. Dies bietet die Vorteile einer Inline-Klasse, um einen „long“-Wert zu verwenden, um zwei Gleitkommawerte zu packen, die als Gleitkommazahlen dargestellte x- und y-Offsets darstellen. (I3ad98)
  • „Modifier.zoomable“ für die Pinch-to-Zoom-Funktion hinzugefügt (Id5d63)
  • Die umschaltbare Komponente wurde eingestellt. Verwenden Sie stattdessen Modifier.toggleable (I35220, b/157642842).
  • „MutuallyExclusiveSetItem“ wurde eingestellt. Verwenden Sie stattdessen „Modifier.selectable“. (I02b47, b/157642842)
  • TestTag ist jetzt eingestellt. Verwenden Sie stattdessen „Modifier.testTag“. (If5110, b/157173105)
  • Der Text-Komponente wird der Parameter „fontWeight“ hinzugefügt, der zuvor versehentlich nicht hinzugefügt wurde (I56937).
  • Die Verwendung der Px-Klasse in verschiedenen Compose-Klassen wurde im Rahmen der großen Umstellung ersetzt, um sich bei Pixelparametern nur auf Dp und primitive Typen zu verlassen (I19d02).
  • Die Komponente „VerticalScroller“ bietet jetzt standardmäßig „Column“. HorizontalScroller bietet jetzt standardmäßig Row. (Ieca5d, b/157020670)
  • Die Verwendung der Px-Klasse in verschiedenen Compose-Klassen wurde im Rahmen der großen Umstellung ersetzt, um nur noch Dp und primitive Typen für Pixelparameter zu verwenden (Iede0b).
  • Dem Fundamentpaket wurde „Modifier.indication“ hinzugefügt. Damit können Sie auf Ihren benutzerdefinierten interaktiven Elementen (I8425f, b/155287131) Hinweise zum Drücken, Ziehen oder andere Hinweise anzeigen.
  • VerticalScroller und HorizontalScroller unterstützen jetzt das umgekehrte Scrollen, wenn „isReversed“ für „ScrollerPosition“ festgelegt ist (I953bd).
  • Unterstützung für das Hinzufügen von Composables in das Textlayout. (I1373c)
  • CanvasScope-Implementierungen wurden konsolidiert. Es gibt jetzt nur noch DrawScope und ContentDrawScope. CanvasScope wurde in DrawScope umbenannt. DrawScope wurde aktualisiert, um die Density-Schnittstelle zu implementieren und LayoutDirection bereitzustellen. Die DrawScope-Unterklasse in ContentDrawScope wurde gelöscht. Painter und PainterModifier wurden aktualisiert, um nicht mehr selbst eine RTL-Eigenschaft zu verwalten, da DrawScope diese bereits ohne manuelle Bereitstellung bereitstellt (I1798e).
  • Die eingestellte DrawBackground-API wurde zugunsten der drawBackground-Erweiterungs-APIs für Modifier entfernt. Die Implementierungen von „color“, „brush“ und „paint“ für „drawBackground“ wurden überarbeitet, um die Anzahl der Codepfade zu reduzieren und die Anforderung zu entfernen, dass Modifier als Teil der Komposition erstellt werden müssen. (I0343a)
  • Aktualisierte Compose-APIs auf höherer Ebene, die anstelle von CanvasScope ein Canvas-Objekt bereitstellen. Dadurch müssen Nutzer keine eigenen Paint-Objekte mehr verwalten. Für Nutzer, die weiterhin Zugriff auf ein Canvas benötigen, kann die drawCanvas-Erweiterungsmethode verwendet werden. Sie bietet einen Callback zum Ausgeben von Zeichenbefehlen mit dem zugrunde liegenden Canvas. (I80afd)
  • Die Scrollposition von HorizontalScroller und VerticalScroller wird nicht mithilfe des gespeicherten Instanzstatus wiederhergestellt. (Ia0fae, b/155075048)
  • „FocusManagerAmbient“ wurde entfernt. Verwenden Sie FocusModifier.requestFocus, um den Fokus zu erhalten. (Ic4826)
  • Das Tabellenlayout wurde vorübergehend entfernt. Es wird wieder verfügbar sein, sobald wir eine aktualisierte API bereitstellen. (Id88a7)
  • Die CanvasScope API wurde erstellt, die ein Canvas-Objekt umschließt, um eine zustandslose, deklarative Zeichen-API bereitzustellen. Transformationen sind in ihrem eigenen Empfängerbereich enthalten und Größeninformationen sind auch auf die entsprechenden Inset-Grenzen beschränkt. Der Consumer muss kein eigenes Paint-Zustandsobjekt zum Konfigurieren von Zeichenvorgängen verwalten.

    CanvasScopeSample wurde hinzugefügt und die Demo-App wurde aktualisiert, um eine deklarative Grafikdemo (Ifd86d) zu enthalten.

  • „ColoredRect“ wurde entfernt. User Box mit drawBackground-Modifikator anstelle von (I983c7, b/152753731)

  • Cursorfarben für das TextField anpassen (I6e33f)

  • Die Softwaretastatur kann jetzt mit dem SoftwareKeyboardController, der vom Callback „onTextInputStarted“ bereitgestellt wird, ein- und ausgeblendet werden (I8dc44, b/151860051).

  • TextFieldValue, das mit TextField verwendet wird, kann jetzt die Neuerstellung von Aktivitäten überstehen, wenn es so verwendet wird: var text by savedInstanceState(saver = TextFieldValue.Saver) { TextFieldValue() } (I5c3ce, b/155075724)

  • Fügt Text() häufig verwendete Parameter hinzu. Wenn Sie derzeit einen lokalen Textstil erstellen, um eine kleine Anzahl dieser Parameter wie Text(style = TextStyle(textAlign = TextAlign.Center)) zu übergeben, können Sie die Parameter jetzt direkt angeben: Text(textAlign = TextAlign.Center) (I82768)

  • Der Parameter „focusIdentifier“ von „CoreTextField“/„TextField“ wurde durch „FocusNode“ ersetzt, um die Integration in das Fokus-Subsystem zu ermöglichen. (I7ea48)

  • Aktualisierung des Textfelds: In horizontaler Richtung wird der gesamte verfügbare Platz genutzt, der dem Textfeld zugewiesen ist (Ib08df, b/154638552).

  • Die Klassen „InteractionState“ und „Interaction“ wurden hinzugefügt, um die Entwicklung von Komponenten zu erleichtern, die auf Änderungen des UI-Status wie Drücken und Ziehen reagieren (Icfe25, b/152525426).

  • RectangleShape wurde von androidx.ui.foundation.shape.* nach androidx.ui.graphics.* verschoben. (Ia74d5, b/154507984)

  • Alle Verwendungen von „nullable Color“ in der API wurden durch „non-nullable“ ersetzt und anstelle von „null“ wird „Color.Unset“ verwendet (Iabaa7).

  • Aktualisierung der TextField API: Die Callbacks „onFocus“ und „onBlur“ wurden in einem einzigen Callback „onFocusChange(Boolean)“ mit Parameter zusammengeführt (I66cd3)

  • „ScaleFit“ wurde in „ContentScale“ umbenannt. „ContentScale“ wurde vom Modul „ui-graphics“ in das Modul „ui-core“ verschoben, um sich im selben Modul wie die Alignment API zu befinden. „FillMaxDimension“ wurde in „Crop“ umbenannt. „FillMinDimension“ wurde in „Fit“ umbenannt. „Fit“ wurde in „Inside“ umbenannt, um besser zu den ImageView.ScaleType-Entsprechungen zu passen. Es wurde Dokumentation hinzugefügt, die darauf hinweist, dass die Kombination aus „Crop“ und „Alignment.Center“ dasselbe Ergebnis wie „ImageView.ScaleType.CENTER_CROP“ erzielt und „Fit“ in Kombination mit „Alignment.Center“ dasselbe Ergebnis wie „ImageView.ScaleType.FIT_CENTER“ erzielt. „Inside“ in Kombination mit „Alignment.Center“ erzielt dasselbe Ergebnis wie „ImageView.ScaleType.CENTER_INSIDE“ (I45f09, b/152842521).

  • Entfernt ProvideContentColor. Verwenden Sie stattdessen ContentColorAmbient direkt mit Providers (Iee942).

  • Fügt dem Text einen Farbparameter hinzu, sodass die Farbe des Textformats überschrieben werden kann, ohne dass sie manuell mit dem in einem Design bereitgestellten Format zusammengeführt werden muss. (I41a66)

  • DrawModifier API verbessern:

    • Der Empfängerbereich für draw() wurde zu ContentDrawScope geändert.
    • Alle Parameter für draw() entfernt
    • DrawScope hat dieselbe Benutzeroberfläche wie das frühere CanvasScope.
    • ContentDrawScope hat die Methode drawContent() (Ibaced, b/152919067)
  • „ColoredRect“ wurde eingestellt. Verwenden Sie stattdessen Box(Modifier.preferredSize(width, height).drawBackground(color)). (I499fa, b/152753731)

  • Das System für die Gestaltung von Formen wurde gemäß der Material Design-Spezifikation aktualisiert. Sie können jetzt kleine, mittlere und große Formen für die meisten Komponenten angeben (Ifb4d1).

  • Modifikator plus Operator durch Factory-Erweiterungsfunktionen ersetzt (I225e4)

  • „Draggable“ wurde in den Modifier verschoben (Id9b16, b/151959544)

  • Text wurde von androidx.ui.core in das Paket androidx.ui.foundation verschoben. (I87ce5)

  • enabled-Parameter für Checkbox, Switch und Toggleable hinzufügen (I41c16)

  • „Wellen“ ist jetzt ein Modifikator. Da Clickable noch nicht konvertiert wurde, wird die Verwendung von Clickable(onClick = { ... }, modifier = ripple()) empfohlen (Ie5200, b/151331852, b/150060763).

  • Die VectorPainter API wurde hinzugefügt, um die vorhandene Subcomposition API für Vektorgrafiken zu ersetzen. Das Ergebnis der Unterkomposition ist ein VectorPainter-Objekt anstelle eines DrawModifier. Die bisherigen DrawVector-Composables wurden zugunsten von VectorPainter eingestellt.

    Die Image(Painter) API wurde in PaintBox(Painter) umbenannt. Es wurde ein Vektor-Composable erstellt, das sich wie das Image-Composable verhält, jedoch mit einem VectorAsset anstelle eines ImageAsset (I9af9a, b/149030271).

  • Die zusammensetzbare Funktion „CreatedImage“ übernimmt die Größenanpassung und das Layout und zeichnet ein bestimmtes ImageAsset auf dem Bildschirm. Diese zusammensetzbare Funktion unterstützt auch das Zeichnen einer beliebigen Painter-Instanz unter Berücksichtigung ihrer intrinsischen Größe sowie einer bestimmten festen Größe oder Mindestgröße (Ibcc8f).

  • Die Funktionen „Button“, „FloatingActionButton“ und „Clickable“ haben jetzt einen separaten enabled-Parameter. Einige Parameter für die Schaltfläche wurden umbenannt oder neu angeordnet. (I54b5a)

  • „Image“ wurde in „ImageAsset“ umbenannt, um besser zwischen den Bilddaten und der bevorstehenden Image-Composable-Funktion zu unterscheiden, die zum Layouten und Zeichnen von Inhalten verwendet wird.

    Es wurde eine Erweiterungsmethode für android.graphics.Bitmap, Bitmap.asImageAsset(), erstellt, um eine Instanz von ImageAsset zu erstellen, die sich für die Kombination der traditionellen Android-App-Entwicklung mit dem Compose-Framework eignet. (Id5bbd)

  • Die zusammensetzbare Funktion „DrawImage“ wurde entfernt. Mit ImagePainter können Sie ein Bild in ein vorhandenes Layout einfügen. Mit SimpleImage können Sie ein Bild einfügen, das Platz einnimmt (I595e1, b/149827027).

  • Die Stapelkomponente unterstützt die Richtung von rechts nach links (Ic9e00).

  • Die Komponenten „Icon“, „IconButton“ und „IconToggleButton“ wurden hinzugefügt. „AppBarIcon“ wurde entfernt. Sie können vorhandene Verwendungen von AppBarIcon direkt durch IconButton ersetzen. Die Schaltflächen haben dann den richtigen Berührungszielbereich. Informationen zur Verwendung finden Sie in den Beispielen. Unter „Symbole“ finden Sie die bereitgestellten Material Icons, die Sie direkt mit diesen Komponenten verwenden können. (I96849)

  • Die zusammensetzbare Funktion „DrawShape“ wurde entfernt. Verwenden Sie stattdessen den Modifier „DrawBackground“. (I7ceb2)

  • AdapterList wurde hinzugefügt, eine scrollbare Listenkomponente, die nur die sichtbaren Elemente zusammensetzt und anordnet. Zu den derzeit bekannten Problemen gehört, dass es nur vertikal funktioniert und nicht alle Fälle von Änderungen an untergeordneten Elementen vollständig berücksichtigt. (Ib351b)

  • Es wurde eine scrollbare Komponente hinzugefügt, mit der benutzerdefinierte Scroller/Listen erstellt werden können (I5fd37).

  • Hintergrund wurde in „DrawBackground“ umbenannt und wird standardmäßig gespeichert (Ia0bd3).

  • Parameter für Innenabstand, Rahmen, Form und Hintergrund für Box hinzufügen (I05027, b/148147281)

  • Canvas-Komponente hinzugefügt Diese Composable-Funktion nimmt eine bestimmte Größe ein (vom Nutzer angegeben) und ermöglicht es Ihnen, mit CanvasScope (I0d622) zu zeichnen.

  • Modifikator „Border“ in „DrawBorder“ umbenennen (I8ffcc)

  • Die Box-Komponente wurde hinzugefügt, um Layout- und Zeichenfunktionen zu kombinieren. (I6e2a7)

  • Scroller verhalten sich jetzt wie bei der nativen Android-Wischbewegung. (I922af, b/147493715)

  • DrawBorder wurde durch Border Modifier (Id335a) ersetzt.

  • „Modifier.tag“ wurde in „Modifier.layoutId“ umbenannt, um Verwechslungen mit „Modifier.testTag“ zu vermeiden. (I995f0)

  • Der Prozentparameter beim Erstellen von ConstraintLayout-Richtlinien wurde in „fraction“ umbenannt. (Ida2db)

  • Unterstützung für Ränder von ConstraintLayout-Barrieren hinzugefügt. (I47ffe)

  • Die Unterstützung von RTL in ConstraintLayout wurde korrigiert. Es wurden APIs hinzugefügt, die nicht RTL-fähig sind. (I3b1c7)

  • Es wurde eine neue DSL für ConstraintLayout hinzugefügt. Weitere Informationen finden Sie in den Beispielen. (Icaa9a)

  • Die Annotation „@ExperimentalLayout“ wurde hinzugefügt. ConstraintLayout, FlowRow und FlowColumn sind jetzt damit gekennzeichnet, um darauf hinzuweisen, dass sich ihre APIs ändern werden. (I412a8)

  • Modifier.padding(InnerPadding) wurde hinzugefügt (I94985, b/157133803)

  • Die eingestellten Attribute „RowAlign“ und „ColumnAlign“ in „Row“ und „Column“ wurden entfernt. (If60d4, b/155858731)

  • „LayoutTag()“ wurde entfernt. Verwenden Sie stattdessen „Modifier.tag()“. Die eingestellte Funktion „Modifier.matchParent()“ wurde entfernt. Verwenden Sie stattdessen „Modifier.matchParentSize()“. (If8044)

  • Der Layout-Modifier „offsetPx“ wurde hinzugefügt. Mit ihm lassen sich (dynamische) Offsets in Pixeln definieren. (I5af57)

  • Die zusammensetzbare Funktion „AlignmentLineOffset“ wurde eingestellt. Verwenden Sie stattdessen den Modifier „relativePaddingFrom()“. Die zusammensetzbare Funktion „CenterAlignmentLine“ wurde entfernt. (I60107)

  • Der Layout-Modifier „defaultMinSizeConstraints“ wurde hinzugefügt. Er legt Größenbeschränkungen für das umschlossene Layout nur dann fest, wenn die entsprechenden eingehenden Beschränkungen nicht angegeben sind (0 für Mindestbeschränkungen und unendlich für Maximalbeschränkungen). (I311ea, b/150460257)

  • Der Container wurde entfernt. Verwenden Sie stattdessen Box (Ibbc2b, b/151407926).

  • Die eingestellten LayoutWidth-/Height-/Size-Modifizierer wurden entfernt. (Ib0bc1)

  • Es wurden Standardparameterwerte für den Offset-Modifikator hinzugefügt. (I37f06)

  • Es wurde ein Modifikator für symmetrisches Padding hinzugefügt. (I39840)

  • Der eingestellte Modifikator „LayoutAspectRatio“ wurde entfernt. (I65a74)

  • Nicht mehr verwendete LayoutAlign-Modifikatoren wurden entfernt. (I10877)

  • Ein Fehler in den Breiten- und Höhenmodifikatoren wurde behoben, der dazu führte, dass das umgebrochene Layout ohne Einschränkungen für die gegenüberliegende Achse gemessen wurde. (I210b8, b/154797971)

  • Den Komponenten „Row“ und „Column“ wurden die Parameter „verticalGravity“ und „horizontalGravity“ hinzugefügt. (I7dc5a)

  • Die Attribute „wrapContentWidth“ und „wrapContentHeight“ wurden aktualisiert. Sie erwarten jetzt eine vertikale oder horizontale Ausrichtung anstelle einer beliebigen Ausrichtung. Der Schwerkraftmodifikator wurde aktualisiert, um die vertikale oder horizontale Ausrichtung zu akzeptieren. „Zeile“, „Spalte“ und „Stapel“ wurden aktualisiert, um benutzerdefinierte kontinuierliche Ausrichtungen zu unterstützen. (Ib0728)

  • Die Ausrichtung kann jetzt mit beliebigen Werten instanziiert werden. 1D-Abstimmungen hinzugefügt. (Ia0c05)

  • „EdgeInsets“ wurde in „InnerPadding“ umbenannt. Der Parameter „innerPadding“ von Material-Schaltflächen wurde in „padding“ umbenannt. (I66165)

  • Für alignToSiblings wird jetzt „Measured“ anstelle von „Placeable“ akzeptiert. (I5788d)

  • Es wurden Modifikatoren für die Größenanpassung zu den intrinsischen Messungen hinzugefügt und die entsprechenden Komponenten wurden eingestellt. (I8295d)

  • Unterstützung für das Anpassen von Dimensionen von untergeordneten Elementen von ConstraintLayout hinzugefügt (Idb1a5)

  • Die eingestellten Composables „Wrap“ und „Center“ wurden entfernt. (I29e23)

  • LayoutModifier2 wurde hinzugefügt, eine neue API zum Definieren von Layoutmodifizierern. LayoutModifier (If32ac) wurde eingestellt.

  • Auf RowScope- und ColumnScope-Mitglieder kann jetzt außerhalb von Row und Column zugegriffen werden. (I3a641)

  • Der Container wurde eingestellt. Verwenden Sie stattdessen Box. (I675ce, b/151407926)

  • Der Modifier „LayoutOffset“ wurde hinzugefügt, um die Layoutposition zu versetzen (I0b8a3).

  • Erste Unterstützung für RTL im Compose-Layout (Ia5519)

  • „LayoutAlign“ wurde aktualisiert, sodass der verfügbare Platz nicht mehr ausgefüllt wird (I2b14f).

  • Die AspectRatio-Composable wurde zugunsten des Modifiers entfernt. Gelöschte veraltete FlexColumn-, FlexRow-Composables und Spacing-Modifier (Iec8a7)

  • Modifier „LayoutInflexible“ für „Row“ und „Column“ entfernt (I0d820)

  • Implementieren Sie Ziehpunkte für die Drag-Auswahl, um die Auswahl für das TextField zu ändern. (I27032)

  • Implementiert „LongPressAndDrag“ für die Auswahl von TextFields. (I17919)

Fehlerkorrekturen

  • „FocusModifier“ ist zugunsten von „Modifier.focus“, „Modifier.focusRequester“ und „Modifier.focusObserver“ veraltet. FocusState und FocusDetailedState sind zugunsten von FocusState2 veraltet (I46919, b/160822875, b/160922136).
  • runOnIdleCompose wurde in runOnIdle umbenannt (I83607)
  • Mehrere Test-APIs wurden umbenannt, um sie intuitiver zu gestalten. Alle findXYZ-APIs wurden in onNodeXYZ umbenannt. Alle doXYZ-APIs wurden in performXYZ umbenannt. (I7f164)
  • Entfernt den zuvor verworfenen Modifier.ripple. Bei „clickable“ wird jetzt standardmäßig „ripple“ als Indikator verwendet, wenn Sie in Ihrer Anwendung „MaterialTheme {}“ festgelegt haben. In den meisten Fällen können Sie also einfach „clickable“ verwenden und erhalten den „ripple“-Indikator kostenlos. Wenn Sie die Farbe, Größe oder den begrenzten Parameter für den Ripple anpassen müssen, können Sie manuell eine „RippleIndication“ erstellen und sie als „indication“-Parameter an „clickable“ übergeben. (I663b2, b/155375067)
  • Veraltete APIs zum Testen der Größe wurden entfernt. (Iba0a0)
  • LayoutNode-API als experimentell gekennzeichnet (I4f2e9)
  • Version 1 der Sperrung der Scrollrichtung ist in Compose implementiert. (I1ce7a, b/150289741)
  • Pop-ups, Dialogfelder und Menüs übernehmen jetzt das kontextbezogene MaterialTheme (Ia3665, b/156527485).
  • Der Parameter für die Layoutrichtung wurde aus dem Messblock der Funktion „Layout()“ entfernt. Die Layoutrichtung ist jedoch im Callback über das Messbereichsobjekt (Ic7d9d) verfügbar.
  • „AbsoluteArrangement“ hinzufügen – ermöglicht die Anordnung der untergeordneten Elemente in der Zeile ohne automatische Spiegelung in RTL (I3a1df)
  • Die Anmerkung „@Untracked“ wurde eingestellt. Durch @ComposableContract(tracked=false) ersetzen (Id211e)
  • Vor dieser Änderung hat das Compose-Compiler-Plug-in Aufrufe von Konstruktoren innerhalb einer @Composable-Funktion nicht trivial abgefangen, wenn es einen (I5205a, b/158123804)
  • Die viewModel()-Composable-Funktion wurde hinzugefügt, mit der sich ViewModels ähnlich wie in einer Activity oder einem Fragment erstellen oder abrufen lassen (I5fdd1).
  • Die Klasse „Radius“ wurde in eine Inline-Klasse umgestaltet. Methoden zum Erstellen von Begleitern wurden zugunsten des Funktionskonstruktors mit Standardparameter entfernt, damit der Radius entlang der Y-Achse dem des obligatorischen X-Achsen-Radiusparameters entspricht.

    Die Funktion DrawScope.drawRoundRect wurde aktualisiert, sodass sie einen einzelnen Radius-Parameter anstelle von zwei separaten Gleitkommawerten für den Radius entlang der x- und y-Achse verwendet (I46d1b).

  • Die Verwendung der Px-Klasse in verschiedenen Compose-Klassen wurde im Rahmen der großen Umstellung ersetzt, um für Pixelparameter nur noch Dp und primitive Typen zu verwenden. Die Px-Klasse wurde vollständig gelöscht (I3ff33).

  • Die Verwendung der Px-Klasse in verschiedenen Compose-Klassen wurde im Rahmen der großen Umstellung ersetzt, um sich bei Pixelparametern nur auf Dp und primitive Typen zu verlassen (I086f4).

  • Die Verwendung der Px-Klasse in verschiedenen Compose-Klassen wurde im Rahmen der großen Umstellung ersetzt, um sich bei Pixelparametern nur auf Dp und primitive Typen zu verlassen (Id3434).

  • Die Verwendung der Px-Klasse in verschiedenen Compose-Klassen wurde im Rahmen der großen Refaktorierung ersetzt, um sich nur auf Dp- und primitive Typen für Pixelparameter zu verlassen (I97a5a).

  • Der Cursor des Textfelds blinkt (Id10a7)

  • Für partielle Gesten ist es nicht mehr erforderlich, ein GestureToken (Id7ae5) zu übergeben.

  • Die Verwendung der Px-Klasse in verschiedenen Compose-Klassen wurde im Rahmen der großen Umstellung ersetzt, um sich bei Pixelparametern nur auf Dp und primitive Typen zu verlassen (I57bff).

  • „Modifier.semantics“ wurde wieder eingeführt, um die Verwendung für Komponenten auf hoher Ebene zu ermöglichen. (I4cfdc)

  • Benennen Sie AnnotatedString.Builder.addAnnotationString in addStringAnnotation um. (I5059e)

  • Die Alignment API wurde aktualisiert und Unterstützung für die absolute Ausrichtung wurde hinzugefügt (die im RTL-Kontext nicht automatisch gespiegelt wird) (I38cd3).

  • „Layout“- und „LayoutModifier“-Untergeordnete Elemente können mit einer anderen Layoutrichtung gemessen werden. (Ibd731)

  • Einführung eines zusätzlichen optionalen „rect“-Parameters für ImagePainter zur Unterstützung des Zeichnens eines Unterabschnitts des zugrunde liegenden ImageAsset (I0ea9e)

  • Ein Absturz in AdapterList beim Entfernen von Elementen wurde behoben (Ic64b0, b/153195921).

  • Wir haben geändert, wie wir das erste Layout messen, das Sie in den Block „activity.setContent { }“ einfügen. Bisher musste es den gesamten Aktivitätsbildschirm ausfüllen. Jetzt verhält es sich so, als ob Sie Ihr Layout in einen Stack eingefügt hätten: Es kann kleiner als ein Bildschirm sein und wird oben links auf dem Bildschirm positioniert. Wenn Sie das alte Verhalten beibehalten möchten, können Sie Modifier.fillMaxSize() für Ihr Layout anwenden. (Ie88a7, b/153453714)

  • Das Modul „ui-text-compose“ wurde in „ui-text“ umbenannt. „ui-text“ enthält jetzt die Composables „CoreText“ und „CoreTextField“ (Ib7d47).

  • Das Modul „ui-text“ wurde in „ui-text-core“ umbenannt (I57dec).

  • Die Composables ui-framework/CoreText und CoreTextField wurden unter ui-text-compose verschoben. Möglicherweise möchten Sie „ui-text-compose“ in Ihr Projekt einbinden. (I32042)

  • runOnIdleCompose und runOnUiThread sind jetzt globale Funktionen anstelle von Methoden für ComposeTestRule. (Icbe8f)

  • [Mutable]State-Property-Delegatenoperatoren wurden in Erweiterungen verschoben, um die Optimierungen für Property-Delegaten in Kotlin 1.4 zu unterstützen. Anrufer müssen Importe hinzufügen, um by state { ... } oder by mutableStateOf(...) weiterhin verwenden zu können. (I5312c)

  • Für DrawLayerModifier und drawLayer() ist clipToBounds und clipToOutline jetzt standardmäßig auf „false“ festgelegt. (I0eb8b, b/152810850)

  • „LayoutResult“ wurde in „MeasureResult“ umbenannt. (Id8c68)

  • Eingestellte Center-Composable. Es sollte entweder durch den Modifizierer „LayoutSize.Fill + LayoutAlign.Center“ oder durch eine der Box- oder Stack-Composables mit entsprechenden Modifizierern ersetzt werden (Idf5e0).

  • „LayoutFlexible“ wurde in „LayoutWeight“ umbenannt. Der enge Parameter wurde in „fill“ umbenannt. (If4738)

  • DrawVector wurde von einer regulären zusammensetzbaren Funktion in eine Funktion geändert, die einen Modifier drawVector() zurückgibt, mit dem der Vektor als Hintergrund für ein Layout gezeichnet wird. (I7b8e0)

  • Ersetzen Sie die zusammensetzbare Funktion „Clip“ durch den Modifier „drawClip()“. „DrawClipToBounds“ ist ein praktischer Modifier, wenn Sie nur mit einer rechteckigen Form auf die Ebenengrenzen beschneiden müssen. (If28eb)

  • Die zusammensetzbare Funktion „DrawShadow“ wurde durch den Modifier „drawShadow()“ ersetzt. Schatten werden jetzt als Teil von „LayerModifier“ gezeichnet. (I0317a)

  • androidx.compose.ViewComposer wurde nach androidx.ui.node.UiComposer verschoben. androidx.compose.Emittable wurde entfernt. Sie war redundant mit ComponentNode. androidx.compose.ViewAdapters wurde entfernt. Sie werden nicht mehr unterstützt. Die Funktion „Compose.composeInto“ wurde eingestellt. Verwenden Sie stattdessen setContent oder setViewContent. Die Funktion „Compose.disposeComposition“ wurde eingestellt. Verwenden Sie stattdessen die Methode dispose für das von setContent zurückgegebene Composition. androidx.compose.Compose.subcomposeInto wurde zu androidx.ui.core.subcomposeInto verschoben. ComponentNode#emitInsertAt wurde in ComponentNode#insertAt umbenannt. ComponentNode#emitRemoveAt wurde in ComponentNode#removeAt umbenannt. ComponentNode#emitMode wurde in ComponentNode#move umbenannt (Idef00).

  • Veraltete Wrap-Composable-Funktion. Er kann entweder durch den Modifier „LayoutAlign“ oder durch die zusammensetzbare Funktion „Stack“ (Ib237f) ersetzt werden.

  • Die Layoutrichtung wird jetzt vom übergeordneten Layoutknoten an die untergeordneten Knoten weitergegeben. Modifikator für die Layoutrichtung hinzugefügt. (I3d955)

  • Benennen Sie „Painter.toModifier“ in „Painter.asModifier“ um, da der neu erstellte Modifier einen Verweis auf den ursprünglichen Painter hat, der für mehrere Modifier-Instanzen freigegeben werden kann (I7195b).

  • Unterstützung für die Richtung „Rechts nach links“ im Modifier „LayoutPadding“ (I9e8da)

  • „Density“ und „DensityScope“ wurden in einer Benutzeroberfläche zusammengeführt. Statt ambientDensity() können Sie jetzt DensityAmbient.current verwenden. Anstelle von withDensity(density) nur with(density) (I11cb1)

  • Die ValueHolder-Klasse wurde entfernt. Die Klassen „AnimatedValue“ und „AnimatedFloat“ wurden umstrukturiert, damit das Feld für den Animationswert abstrakt ist und Unterklassen die Aktualisierung des Werts beobachten können.

    • Modellklassen für AnimatedValue, AnimatedFloat usw. hinzugefügt
    • Es wurde eine neue Reihe von einfachen @Composable-APIs zum Animieren zwischen Werten hinzugefügt.
    • (I79530)
  • Funktionsgefährdende Änderungen an der Ambient-API. Weitere Informationen finden Sie im Log und in der Ambient<T>-Dokumentation (I4c7ee, b/143769776).

  • Die von Placeable#get(AlignmentLine) zurückgegebenen Int-Positionen der Ausrichtungslinie sind jetzt nicht mehr null. Wenn die abgefragte Ausrichtungslinie fehlt, wird AlignmentLine.Unspecified zurückgegeben. (I896c5, b/158134875)

  • Ein ConstraintLayout-Fehler wurde behoben, der bei Neuzusammenstellungen zu einem Absturz führte. (Ibee5a, b/158164341)

  • Die WithConstraints-Trailing-Lambda-API wurde geändert. Anstelle von zwei Parametern gibt es jetzt einen Empfängerbereich, der zusätzlich zu Einschränkungen und „layoutDirection“ die Eigenschaften „minWidth“, „maxWidth“, „minHeight“ und „maxHeight“ in Dp bietet (I91b9a, b/149979702).

  • „LayoutModifier2“ wurde in „LayoutModifier“ umbenannt. (Id29f3)

  • Die Funktionen für intrinsische Messungen in Layout und LayoutModifier2 haben jetzt einen IntrinsicMeasureScope-Empfänger, der eine API für intrinsische Abfragen mit implizit weitergegebener Layoutrichtung bereitstellt. (Id9945)

  • „LayoutDirectionAmbient“ ist veraltet. Verwenden Sie „localeLayoutDirection“ für „ConfigurationAmbient“ (I851b1), um die von der Sprache definierte Layoutrichtung zu lesen.

  • „positionInParent“ und „boundsInParent“ für „LayoutCoordinates“ hinzugefügt. (Icacdd, b/152735784)

  • Die zusammensetzbare Funktion „ParentData“ ist veraltet. Sie sollten entweder einen Modifier erstellen, der die ParentDataModifier-Schnittstelle implementiert, oder den LayoutTag-Modifier verwenden, wenn Sie Layout-Untergeordnete nur taggen müssen, um sie im Measure-Block zu erkennen. (I51368, b/150953183)

  • Fügen Sie OnPositionedModifier und OnChildPositionedModifier hinzu, um die zusammensetzbaren Funktionen OnPositioned und OnChildPositioned zu ersetzen. (I2ec8f)

  • Negative Auffüllung in LayoutPadding nicht zulassen. Für negative Positionsabweichungen sollte stattdessen „LayoutOffset“ verwendet werden. (Ifb5b1)

  • WithConstraints hat den Parameter „LayoutDirection“ erhalten (I6d6f7)

  • Das Flag ComposeFlags.COMPOSER_PARAM wurde in true geändert. Dadurch ändert sich die Strategie für die Codegenerierung für das Compose-Plug-in. Auf hoher Ebene führt dies dazu, dass @Composable-Funktionen mit einem zusätzlichen synthetischen Parameter generiert werden, der an nachfolgende @Composable-Aufrufe übergeben wird, damit die Laufzeit die Ausführung richtig verwalten kann. Dies ist eine erhebliche binäre Breaking Change, sollte aber die Quellcodekompatibilität bei allen zulässigen Verwendungen von Compose beibehalten. (I7971c)

  • „LayoutCoordinates“ wurde geändert, sodass „providedAlignmentLines“ ein Set anstelle einer Map ist und „LayoutCoordinates“ stattdessen den Operator „get()“ zum Abrufen eines Werts implementiert. So können Modifikatoren einen oder mehrere Werte des Sets ändern, ohne für jeden Modifikator eine neue Sammlung erstellen zu müssen. (I0245a)

  • „LayoutCoordinates“ hat keine „position“-Eigenschaft mehr. Die Eigenschaft „position“ ist bei LayoutModifiers, Drehung oder Skalierung nicht sinnvoll. Stattdessen sollten Entwickler parentCoordinates und childToLocal() verwenden, um die Transformation von einer LayoutCoordinate in eine andere zu berechnen.

    Bei LayoutCoordinates wird IntPxSize für die size-Property anstelle von PxSize verwendet. Für Layouts werden ganzzahlige Pixelgrößen verwendet. Daher sollten alle Layoutgrößen als Ganzzahlen und nicht als Gleitkommawerte angegeben werden. (I9367b)

  • Verbesserungen der API-Oberfläche von Constraints (I0fd15)

  • TextDirection.Content hinzugefügt (I48f36)

  • Passen Sie das Symbolleistenmenü an, damit die Optionen zum Kopieren, Ausschneiden und Einfügen richtig angezeigt werden. (Id3955)

  • Es wurde eine schwebende Symbolleiste für die Auswahl von Textfeldern hinzugefügt. (Ie8b07)

  • TextDirectionAlgorithm wurde in TextDirection umbenannt (I75ce8)

  • „TextDirection“ wurde in „ResolvedTextDirection“ umbenannt (I3ff38)

  • HapticFeedback für die Auswahl von Textfeldern hinzugefügt. (I58050)

  • Die Methoden „Kopieren“, „Ausschneiden“ und „Einfügen“ werden der TextField-Auswahl hinzugefügt. (Idb70b)

  • „TestTag“ und „Semantics“ wurden gelöscht. Verwenden Sie stattdessen Modifier.testTag und Modifier.semantics (I15ff0, b/158841414).

  • Der Paketname für „Locale“ und „LocaleList“ wurde von „androidx.ui.text“ in „androidx.ui.intl“ geändert (I8132c).

  • API-Änderung: AnnotatedString(builder: Builder) wird in annotatedString(builder: Builder) umbenannt. (Ia6377)

  • API-Änderung: AnnotatedString.Item wird in AnnotatedString.Range umbenannt. (I2d44d)

  • Symbolleiste für textbezogene Vorgänge hinzufügen (I49d53)

  • Es ist jetzt ein neuer LifecycleOwnerAmbient verfügbar. Eine Activity, die Sie mit der Compose-UI verwenden, muss jetzt von androidx.activity.ComponentActivity (oder AppCompatActivity) abgeleitet werden. setContent für android.app.Activity ist jetzt veraltet (Idb25a, b/153141084).

  • Der Paketname „ui-android-text“ (androidx.text) wurde durch „androidx.ui.text.platform“ ersetzt, um den androidx-Richtlinien zu entsprechen. (I42711)