Compose UI

Structure

Compose is combination of 7 Maven Group Ids within androidx. Each Group contains a targeted subset of functionality, each with its own set of release notes.

This table explains the groups and links to each set of release notes.

Declaring dependencies

To add a dependency on Compose, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

dependencies {
    implementation "androidx.compose.ui:ui:1.9.4"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation("androidx.compose.ui:ui:1.9.4")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

For more information about dependencies, see Add build dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

Version 1.10

Version 1.10.0-beta01

October 22, 2025

androidx.compose.ui:ui-*:1.10.0-beta01 is released. Version 1.10.0-beta01 contains these commits.

API Changes

• Adds an optimization for focus change dispatching. This can be disabled with isOptimizedFocusEventDispatchEnabled = false (I919fb, b/449228515)
• Updates all indirect touch APIs to use the name indirect pointer APIs to match pointer input APIs. (I238ce, b/451607214)
• TextDirection, TextAlign, Hyphens, FontSynthesis valueOf functions now throw IllegalArgumentException when they receive an unknown value. (I07c67)
• Update CompositionDataTree.makeTree to pass default values instead of wrapper function. (Id64a6, b/445229688)
• The test rule APIs createComposeRule, createAndroidComposeRule and createEmptyComposeRule which accept the effectContext parameter are stable and the parameter defaults to EmptyCoroutineContext. (If400c, b/450540702)
• UnplacedStateAwareModifierNode was renamed to UnplacedAwareModifierNode (I6a551, b/449719932)
• Undo the Content Capture Optimization (Ic000b, b/442364065)
• Added ComposeUiFlags.isRectManagerOffsetUsageFromLayoutCoordinatesEnabled feature flag. It enabled performance optimization where coordinates requests like LayoutCoordinates.positionInRoot() are using the cached offsets we already have in RectManager, instead of traversing the whole tree on each call. (Ieaadc)

Bug Fixes

• PlaceholderSpan now correctly uses non-linear font scaling for sizing (Id2ead, b/324462728)
• Use ViewCompat to perform haptic feedback constants supported at the platform level, relying on its fallback support for newer constants. (Ib5a00)

Version 1.10.0-alpha05

October 08, 2025

androidx.compose.ui:ui-*:1.10.0-alpha05 is released. Version 1.10.0-alpha05 contains these commits.

Bug Fixes

• Fixed a bug where nested Popups were incorrectly positioned at the screen's top; they now correctly anchor to their parent Popup. (Id4603, b/191279752)
• Fixed problem with focus wrapping with other Views in the hierarchy. (I95223, b/446028624)
• Fixes fields with inline parameters missing from inspector in lambdas generated by Kotlin 2.2.20 (I9855d, b/447110005)
• Fixes name shadowing of autofill resources between UI and foundation modules (I5da5a)

External Contribution

• UiModes object is renamed to AndroidUiModes to reflect that its constants are lifted from Android API. (Ia0a77)

Version 1.10.0-alpha04

September 24, 2025

androidx.compose.ui:ui-*:1.10.0-alpha04 is released. Version 1.10.0-alpha04 contains these commits.

API Changes

• The Compose test rule variant that accepts a CoroutineContext parameter has been promoted to stable. The experimental annotation has been removed, and developers no longer need to opt-in to use this API. (I74e6e)
• ComposeUiFlags.isRectTrackingEnabled was removed. This logic is not always enabled. (Id78df)
• Deprecated inline overload of Updater#set as they were boxing provided value too many times (Id679e)
• Mark onAutofillText semantic property as deprecated. (I6f81c)
• UnplacedStateAwareModifierNode was introduced. It provides a callback called when the previously placed layout is not placed anymore. (I8fdd8, b/309776096)
• Corrected documentation of RetainObserver.onRetained and added RetainObserver.onUnused, which mirrors RememberObserver.onAbandoned. (Ia6fc5)
• Added onVisibilityChangedNode(), which is producing a Modifier.Node, used by Modifier.onVisibilityChanged() via delegation, which allows to expand on top of this functionality in your custom Modifier.Node. (I70d84, b/443001320)

Bug Fixes

• Fixed an issue where inline content failed to render when positioned on the final line of multi-line ellipsized text, despite the placeholder preceding the ellipsized region. (I76aaf, b/441829208)

Version 1.10.0-alpha03

September 10, 2025

androidx.compose.ui:ui-*:1.10.0-alpha03 is released. Version 1.10.0-alpha03 contains these commits.

API Changes

• Renames DelegatableNode.invalidateLayoutForSubtree to DelegatableNode.invalidateMeasurementForSubtree. (I94257, b/430106107)
• Removes redundant isInHiddenAccessibilitySubtree matcher. (I4476c, b/443792965)
• Introduces group key based Compose stack traces that are enabled by default for all minified apps. The proguard mapping for these traces will be generated by Compose compiler Gradle plugin starting from Kotlin 2.3.0. (Ifbcb5)
• Modifier.skipToLookaheadSize now uses a default enabled lambda that only enables the size skipping when shared transition is active, same as Modifier.skipToLookaheadPosition. (Ibe0f5, b/432485585)
• ComposeUiFlags.isOutOfFrameDeactivationEnabled is removed and this functionality is now always enabled. (I421ed)
• Move factory functions for creating FillableData instances to companion object. Instead of calling FillableData(value), use the new factory methods: FillableData.createFrom(value). (I2e200, b/441719650)
• Introduce BeyondBoundsLayoutModifierNode a new Modifier node to perform beyond bound layout for focus search. (I39be1, b/416133658)
• FocusTargetModifierNode.requestFocus() sends focus to one of its children when it is not itself focusable. This is now consistent with FocusRequester.requestFocus() and FocusRequesterModifierNode.requestFocus(). If you do not need this behavior, set the ComposeUiFlags.isRequestFocusOnNonFocusableFocusTargetEnabled flag to false in your app. (Icca5c, b/436863604)
• Provide DP-based window size in WindowInfo (I9322b, b/424442112)
• Removed flag isNestedScrollDispatcherNodeFixEnabled. (If451a)
• Add support for date values in autofill in the FillableData API. val dateMillisValue: Long added to retrieve date information, and a corresponding FillableData(dateMillisValue: Long) constructor added to create date-based FillableData instances. (Id072a)

External Contribution

• UiModes object is introduced to declare constants that are used for UiMode annotation (I03cb8)

Version 1.10.0-alpha02

August 27, 2025

androidx.compose.ui:ui-*:1.10.0-alpha02 is released. Version 1.10.0-alpha02 contains these commits.

API Changes

• Update FillableData to support non-text components such as toggles and lists, including boolean and integer values inside FillableData and factory constructors to create boolean and list instances of FillableData that translate to the platform’s AutofillValue. The relevant semantic property and action also are added. (Ia8105, Icc5cf)
• In non-touch mode, the view system assigns initial/default focus to one of the focusable items on the screen. This feature is added to Compose and can be enabled by enabling ComposeUiFlags.isInitialFocusOnFocusableAvailable. (Ib9178)
• Removed flag isPointerInteropFilterDispatchingFixEnabled. (Iaa589)
• Removed flag isNestedScrollInteropPostFlingFixEnabled. (I2a756)
• Add in isHiddenFromAccessibility() and isInHiddenAccessibilitySubtree() semantics matchers. (I9f5a1)
• Added runCurrent() to MainTestClock to run all due tasks on the underlying scheduler. This is to support running tests on a StandardTestDispatcher, where tasks are added to the scheduler rather than executed immediately when they have a delay of 0ms. A test can be setup to use a StandardTestDispatcher by creating a ComposeTestRule and passing a StandardTestDispatcher to it. By default, tests are run on an UnconfinedTestDispatcher, in which case runCurrent() will never have to be called.
• Added support for running tests on a StandardTestDispatcher. Historically, the test framework was (and still is) set up using an UnconfinedTestDispatcher, which differs from a production environment in subtle ways. You can now change this setup by creating your own StandardTestDispatcher and adding it to the effectContext when creating your ComposeTestRule (or when calling runComposeUiTest ). (I334d0, b/254115946)
• Update code for creating a tree of nodes from SlotTree. (I997d3)

Bug Fixes

• Compose UI now installs lifecycle-aware RetainScopes on Android. The default behavior will now persist retain-ed values across configuration changes. (Id4a09, b/177562901)

External Contribution

• Adds the ability for VelocityTracker to calculate the velocity of a pointer based on tracked pointer events using platform-specific behavior. (I621e8)

Version 1.10.0-alpha01

August 13, 2025

androidx.compose.ui:ui-*:1.10.0-alpha01 is released. Version 1.10.0-alpha01 contains these commits.

API Changes

• Pointer downs with a mouse or touchpad in a ComposeView will now clear focus automatically if the pointer down doesn't occur in the bounds of the focused node. This results in a "tap-to-clear focus" UX that is more expected than current behavior when using pointer input devices. This behavior can be opt-ed out of with a new AbstractComposeView.isClearFocusOnPointerDownEnabled API. (I6322b, b/282963174)
• Introduce FillableData interface to support various autofill component types, in addition to Text. (If9bd2)
• New API to allow dynamically enable and disable shared elements that also allows accounting for whether there is already an ongoing shared element transition. New API to set up an alternative target bounds when the target shared element is disposed during the transition. New API to obtain the LayoutCoordinates of a LookaheadScope. (I18dd4, b/409819304, b/395670637)
• Introduce flag isNestedScrollInteropIntegerPropagationEnabled to control the experiment of dispatching correct integers to nested scroll interop. (If8316)
• Added requestFocusForChildInRootBounds() to DelegatableNode to move focus to a child that overlaps with the given rect. (I001ef)
• Removed flags isOnScrollChangedCallbackEnabled, isAdjustPointerInputChangeOffsetForVelocityTrackerEnabled, isFlingContinuationAtBoundsEnabled, isAutomaticNestedPrefetchEnabled, DragGesturePickUpEnabled, isPointerInteropFilterDispatchingFixEnabled, isNestedScrollInteropPostFlingFixEnabled, isNestedScrollDispatcherNodeFixEnabled (I36c18)
• Added @CheckResult annotation on the SemanticsNode finder and selector functions to enforce usage of returned values. (I6f86e, b/201652748)
• Improve the performance of the content capture process (I3c7c0)
• Introduce CompositionLocal that can be used to modify the brush of Autofill's successful filling highlight. (I52329)
• Introduced new Interpolatable interface which allows for automatic interpolation between different types, assuming one type knows how to convert from the other. This interface is leveraged in several compose types like Brush and Shape, but can be utilized externally as well. (I58eab)
• Now Scrollable supports 2 dimensional mouse wheel scroll events better. A new test API landed to help test use cases in MouseInjectionScope. We also introduced a new overload for scroll methods in MouseInjectionScope and a flag to control the new behavior called isMouseWheel1DAxisLockingEnabled (I136df)
• Add DeviceConfigurationOverrides for keyboard type & state, navigation type and state, touchscreen state, and UI mode type (I282f0)
• Added a new LineHeightStyle.Mode called Tight. This mode helps enforce smaller line heights even when they may possibly cut taller glyphs. (Id3849)
• BaselineShift now has an Unspecified value to prevent boxing BaselineShift, Hyphens, LineBreak, TextAlign, and TextDirection now have isSpecified helper functions Hyphens, TextAlign, TextDecoration, and TextDirection now have valueOf() and value methods enabling efficient serialization/deserialization. (I8d44c)
• Added a new getDisplayName method interface to allow custom display names for preview parameter instances. (I19bdf, b/241699422)
• When Dp values are compared with Unspecified using less-than or greater-than, it now always returns false. Using Dp.compareTo(Unspecified) always returns 0. Setting the flag ComposeUiUnitFlags.isDpCompareToChanged to false will return Dp.compareTo() to is former behavior, where comparing Unspecified with less-than and greater-than don't always return false, and compareTo() with Unspecified matches the behavior of Float.compareTo(). (Ifa88b, b/429221319)

Bug Fixes

• Moving the default minSdk from API 21 to API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
• Fixes an issue that prevented the creation of new AndroidComposeViews while a transition is ongoing. (I2e23e, b/340894487, b/287484338)
• Fixes a color bug when using a vector drawable that uses one color and the fillColor is neither fully opaque nor fully transparent. (I3b041, b/328677973)
• Fixes an issue where icons loaded via painterResource with theme-specific colors didn't update on theme changes. (I85ea0, b/424416571)
• Introduce onFillData and fillableData semantics (I45d9e)
• Platform-specific state encoding is now always enabled in StateRestorationTester. This aligns test behavior with real application state restoration, such as Parcelization on Android. (I38211, b/408154192, b/382294247)
• Fixes occasional crashes when requesting focus. (57b31a11, b/431111149)

Version 1.9

Version 1.9.4

October 22, 2025

androidx.compose.ui:ui-*:1.9.4 is released. Version 1.9.4 contains these commits.

Bug Fixes

• Fixed an issue where inline text content was disappearing if it was on the last line of a multi-line ellipsized text even though the inline content wasn’t in the ellipsized region. (I76aaf, b/441829208)
• Fixed an issue where onLayoutRectChanged modifier callbacks were not always being called when debounceMillis is not zero. (72aba47, b/445324854)

Version 1.9.3

October 08, 2025

androidx.compose.ui:ui-*:1.9.3 is released. Version 1.9.3 contains these commits.

Bug Fixes

• Fixed a bug where onVisibilityChanged/onFirstVisible/onLayoutRectChanged modifiers were not receiving callbacks if the layout being moved has over 170 descendants. (4f2fdd, b/445356774)

Version 1.9.2

September 24, 2025

androidx.compose.ui:ui-*:1.9.2 is released. Version 1.9.2 contains these commits.

Bug Fixes

• Modifier.onVisibilityChanged() now correctly fires when a node is detached or reused. (Ic5ce20)
• Modifier.onVisibilityChanged() and onLayoutRectChanged() now properly handles parent layouts using placeWithLayer() to place children. (Ia05ac9)
• For Modifier.onVisibilityChanged() and onLayoutRectChanged(), properly notify in corner cases like removing a layer/layer modifier or updating layer properties. (Ia05ac)

Version 1.9.1

September 10, 2025

androidx.compose.ui:ui-*:1.9.1 is released. Version 1.9.1 contains these commits.

Bug Fixes

• Fixes a color bug when using a vector drawable that uses one color and the fillColor is neither fully opaque nor fully transparent. (I3b041, b/328677973)

Version 1.9.0

August 13, 2025

androidx.compose.ui:ui-*:1.9.0 is released. Version 1.9.0 contains these commits.

Important changes since 1.8.0

• Important changes in version 1.9.0 are covered in this blogpost
• Lint checks shipped with Compose now require a minimum AGP version of 8.8.2. If you are unable to upgrade AGP, you can instead upgrade Lint on its own by using android.experimental.lint.version=8.8.2 (or a newer version) in your gradle.properties. To run Compose lint checks inside the IDE, Android Studio Ladybug or newer is required.
• Breaking change: the graphicsLayer modifier nodes now implements SemanticsModifierNode. This can result in new SemanticsNodes added to the semantics tree and, therefore, lead to test failures in tests that make assumptions about the semantics tree structure. For example, tests that use onChild, onParent, onSibling, and other similar methods to make assertions can fail if a new node is added between the current and target nodes. The preferred way to fix these failures is to add a testTag to the target node directly. Another approach is to use a looser matcher, such as onNode(hasAnyAncestor(hasText("ancestor")) and hasText("target")). (I638b5)

Version 1.9.0-rc01

July 30, 2025

androidx.compose.ui:ui-*:1.9.0-rc01 is released. Version 1.9.0-rc01 contains these commits.

Bug Fixes

• Fixes an issue where icons loaded via painterResource with theme-specific colors didn't update on system theme changes. (I85ea0, b/424416571)
• Fixes errors on APIs 21(Lollipop) and 28(Pie) where important graphics methods were renamed while being optimized. (Iebf99, b/425120571, b/420462749)
• Ensure that newly inserted onLayoutRectChanged modifiers get called back initially. (l9aa91), (lb348a)
• Fix for an offset cache being incorrectly invalidated, causing onLayoutRectChanged modifiers to be called with wrong coordinates (ibd4cd), (lddc57)
• Fix for rotated/skewed layouts receiving incorrect coordinates by onLayoutRectChanged modifiers (lddc57, b/426750475)

External Contribution

• Fixed an issue where dragAndDropSource items in LazyList disappear when scrolled. Thanks Victor Rendina! (dc3bcd3, b/425894792)

Version 1.9.0-beta03

July 16, 2025

androidx.compose.ui:ui-*:1.9.0-beta03 is released. Version 1.9.0-beta03 contains these commits.

Bug Fixes

• Fixes an issue where uniformly blurred inner shadows were not moving correctly with an offset.

Version 1.9.0-beta02

July 2, 2025

androidx.compose.ui:ui-*:1.9.0-beta02 is released. Version 1.9.0-beta02 contains these commits.

API Changes

• Changes companion object to experimental to match class. (I8452a)
• Removed isTrackFocusEnabled experimental flag (I003fd)

Bug Fixes

• When no WindowInsets enchroach on the content of the ComposeView, WindowInsetsRulers values are not provided. (I71221)

Version 1.9.0-beta01

June 18, 2025

androidx.compose.ui:ui-*:1.9.0-beta01 is released. Version 1.9.0-beta01 contains these commits.

Breaking Changes

• The graphicsLayer modifier nodes now implements SemanticsModifierNode. This can result in new SemanticsNodes added to the semantics tree and, therefore, lead to test failures in tests that make assumptions about the semantics tree structure. For example, tests that use onChild, onParent, onSibling, and other similar methods to make assertions can fail if a new node is added between the current and target nodes. The preferred way to fix these failures is to add a testTag to the target node directly. Another approach is to use a looser matcher, such as onNode(hasAnyAncestor(hasText("ancestor")) and hasText("target")). (I638b5)

API Changes

• Changed ShadowContext to be a sealed interface (I3ce40)
• Adds a cross module way to create an Indirect Touch Event (for testing) (I22e4c)
• MakesIndirectTouchEvent.nativeEvent experimental. (I6fda5)
• Revises API surface based on API council feedback. (Ibf378)
• Remove FrameRateCategory.NoPreference constant. Rename Modifier.requestedFrameRate to Modifier.preferredFrameRate. (I2f976)
• WindowInsetsRulers: changed rulersIgnoringVisibility to maximum. Changed getDisplayCutoutBounds() to be an extension function of PlacementScope. WindowInsetsAnimationProperties has been changed to WindowInsetsAnimation and the getAnimationProperties() has been changed to getAnimation(). (I3816f)
• Changed class ShadowParams to Shadow (I11cca)
• Change the package for frame rate API from androidx.compose.ui.ui to androidx.compose.ui (I8994e)
• Changed InsetsRulers to be in common code with the name WindowInsetsRulers. Simplified the API so all insets are WindowInsetsRulers. Extracted non-rulers animation properties to an AnimationProperties class. WindowInsetsRulers.innermostOf() can be used to merge multiple WindowInsetsRulers. (I2f0c6, b/415012444)
• Added a tooling API for parsing source information added by Compose compiler. (Iceaf9, b/408492167)

Bug Fixes

• Flag for isGetFocusedRectReturnEmptyEnabled has been removed now that the feature has been fully verified. (Ife722)
• Fixes a bug in performScrollToNode, which in some cases was not reaching the target node. With this fix, it should always reach the target node in those cases. A side effect of this change is that the exact scroll position at the end of the action may now be different, which affects screenshot tests and tests that make assumptions about the exact scroll position. (I2c8a1)

Version 1.9.0-alpha04

June 4, 2025

androidx.compose.ui:ui-*:1.9.0-alpha04 is released. Version 1.9.0-alpha04 contains these commits.

API Changes

• Added modifier APIs for customizable shadows. (I2058d, b/160665122)
• Add a SemanticsModifierNode.isImportantForBounds property that determines whether the node should be taken into account when computing bounds. The property is true by default and can be set to false to indicate that the node should not be taken into account for bounds. (I7ebec)
• Add a SemanticsPropertyKey factory function for declaring Android-specific semantics properties that are made available as accessibility extras exposed via AccessibilityNodeInfo.getExtras. (I2ed51)
• Removed usages of ComposeUiFlags.isRemoveFocusedViewFixEnabled and deprecated the flag. (I50328)
• Introduce new customizable shadow framework. This includes DropShadowPainter and InnerShadowPainter as well as the DropShadow/InnerShadow dependencies. Shadow infrastructure is shared such that the same generated shadows can be shared at multiple callsites without having to re-generate the shadows n-times. (I24f7a, b/160665122)
• Introduce CompositeShader and CompositeShaderBrush which creates a composited result between two shaders. Also add ShaderBrush#transform to set a transformation matrix for the shader. (I2621a, b/160665122)

Bug Fixes

• Fixed a bug in NestedScrollInteropConnection where fling methods were being in the wrong order with respect to views. (I56ad4)
• Previously, dialogs that drew full screen were not drawing within the display cutout region. This bug is fixed so that dialogs with decorFitsSystemWindows = false and usePlatformDefaultWidth = false can take the display cutout region. (I9e975)
• Fixed a bug where TalkBack’s green focus indicator was not drawn after being turned on while the Compose app is in the background. (Ifd12a)

Version 1.9.0-alpha03

May 20, 2025

androidx.compose.ui:ui-*:1.9.0-alpha03 is released. Version 1.9.0-alpha03 contains these commits.

API Changes

• Flag ComposeUiFlags.isGetFocusedRectReturnEmptyEnabled makes it so that when nothing is focusable in a ComposeView, it sets the rect to an Empty value. This prevents a focus search from choosing the View to focus on. This is especially important for when an IME has a NEXT option where it might try to focus on the ComposeView and requestFocus() fails. (Ibd0e2, b/369256395)
• Introduce flag isNestedScrollDispatcherNodeFixEnabled. (I0d24a)
• Rename DialogProperties' dialogContentTitle to windowTitle (Ibd27b)
• Modifier.onFirstVisible and Modifier.onVisibilityChanged modifiers were introduced, which are high level modifiers built on top of Modifier.onLayoutRectChanged. These modifiers are built specifically to handle a lot of common application requirements such as logging impressions, auto playing videos, etc. These have been built with performance in mind so that they can be used in critical list-based scenarios without risk of sacrificing scroll performance. In addition to these modifier APIs, additional APIs to RelativeLayoutBounds have been added in order to support these use cases, as well as make it easier for developers to easily create similar custom modifiers that suit their use case exactly. (I759b8)
• Change setDiagnosticStackTraceEnabled to experimental to account for future development of this feature. (I11db3)
• Introduce Modifier.scrollable2D, Scrollable2DState and companion APIs for state creation. Also introduced common scroll extension functions. (Ic61c8, b/214410040)
• Compose 64-bit color values are not directly comparable to Android ColorLongs because the color space IDs are out of order for some color spaces. To convert to and from Android color spaces, two new APIs are added: toColorLong() and fromColorLong(). (I36899)
• Introduced ViewConfiguration.minimumFlingVelocity to allow lower bound fling velocity control. (I11aab)

Version 1.9.0-alpha02

May 7, 2025

androidx.compose.ui:ui-*:1.9.0-alpha02 is released. Version 1.9.0-alpha02 contains these commits.

API Changes

• Add in dialogContentTitle to DialogProperties, which sets the content window title. bf9d670

Bug Fixes

• Window Insets Rulers have been disabled temporarily while internal tests are fixed. 8d1402
• Fixed how pointer input changes are added to the VelocityTracker in DragGestureNode, this can be controlled with the new flag isAdjustPointerInputChangeOffsetForVelocityTrackerEnabled.254ddb

Version 1.9.0-alpha01

April 23, 2025

androidx.compose.ui:ui-*:1.9.0-alpha01 is released. Version 1.9.0-alpha01 contains these commits.

Behavior Changes

• Lint checks shipped with Compose now require a minimum AGP version of 8.8.2. If you are unable to upgrade AGP, you can instead upgrade Lint on its own by using android.experimental.lint.version=8.8.2 (or a newer version) in your gradle.properties. To run Compose lint checks inside the IDE, Android Studio Ladybug or newer is required.

API Changes

• Removes Flag to enable trace statements for hit path tracker (debug). (I1b2a1)
• Changed InnerRectRulers and OuterRectRules to be methods instead. Removed name parameter from RectRulers public API. DerivedRulers is now a constructor option for Vertical and Horizontal Rulers. MergedHorizontalRulers and MergedVerticalRulers have been replaced with minOf and maxOf methods to generate instances. (Iee89f, b/408192133)
• Deprecate androidx.compose.ui.LocalSavedStateRegistryOwner in favor of androidx.savedstate.compose.LocalSavedStateRegistryOwner. (I5439f, b/377946781)
• Add a Modifier.keepScreenOn to set the display to not sleep while present (Ib5af4, b/408284174)
• Add a new semantics property Shape, which may be set when the shape of the UI element is different from its bounding rectangle, e.g., rounded corner rectangle. (I1376f)
• Fix issue with pointer event dispatching in AndroidViews and added flag isPointerInteropFilterDispatchingFixEnabled to protect changes. (I0e272, b/372055500, b/408002332)
• FocusRestorer no longer pins the previously focused item. Users should use a key to ensure that the previously focused item has the same composition hash, so that focus is successfully restored. (I4203b, b/330696779)
• Allow Compose to trigger ViewTreeObserver.OnScrollChanged. This behavior is introduced under the flag isOnScrollChangedCallbackEnabled. We also introduced an extension function of DelegatableNode dispatchOnScrollChanged. (I34b9d, b/238109286)
• currentCompositeKeyHash is now deprecated. Use currentCompositeKeyHashCode instead. The replacement API encodes the same hash with more bits, which exponentially reduces the chance of two random unrelated groups in the composition hierarchy from having the same hash key. (I4cb6a, b/177562901)
• Projects released with Kotlin 2.0 require KGP 2.0.0 or newer to be consumed (Idb6b5)
• Added lint check support for FocusRequester to make sure it is remembered inside composition (I6bf91)
• Added the ability to set preferred frame rate or frame rate category on the Composable should be rendered at (Ie5201)
• Expose native MotionEvent on Android. (I17286)
• Add getChecked() + setChecked(int), deprecate isChecked + setChecked(boolean) (Iaac9d)
• The graphicsLayer modifier now accepts a blendMode and a colorFilter (Iab0e6)
• Added LocalResources composition local to query Resources. Calling LocalResources.current will recompose when the configuration changes, so calls to APIs such as stringResource() will return updated values. (I50c13, b/274786917)
• Expose experimental API for Composables to handle indirect touch events (Icff57)
• This release improves the reporting of unhandled exceptions thrown during the layout and draw phases of your composable content. Previously, an uncaught exception here would crash the test runner and prematurely end the test suite. These exceptions can now be reported more gracefully without ending the test suite. (I9928b, b/314128080)
• Deprecated the experimental GlobalAssertions API. Its intended use was to run accessibility checks, see enableAccessibilityChecks() for that purpose instead. (I50aa5)
• SemanticsNodeInteraction.performTextInputSelection is no longer experimental and now supports an additional relativeToOriginal parameter which allows you to apply the selection to either the original untransformed text or the transformed text. (I3a905, b/261561038, b/277018945)
• Introduce API for creating custom bullet lists through AnnotatedString (I1d066, b/383269496, b/139326648)
• Deprecate runWithTimingDisabled in favor of runWithMeasurementDisabled, which more clearly describes the behavior - all metrics are paused. Additionally, expose the MicrobenchmarkScope superclass since redeclaring the runWithMeasurementDisabled function to open access isn't possible, since it's inline. (I9e23b, b/389149423, b/149979716)
• Updated ui-tooling Devices API to include newer devices. (Ia2ac1)
• Add Tablet Portrait in the collection of Preview Screen sizes to help the developer to consider bigger windows (Ia1976)
• Introduce trace value API for marking/logging trace with values at a given point in time. Trace values show in Prefetto as a new lane that can be seen through the timeline of a trace. On Android they're implemented using Trace.setCounter. (Idcf48)

Bug Fixes

• Fix dispatching of remember observers in pausable composition to avoid dispatching remembered/forgotten in the same apply (I570b2, b/404645679, b/407931790)
• android:dialogTheme can now be set to control dialog properties when decorFitsSystemWindows is false (I7922f, b/246909281)
• Fixed bug where any motion event caught outside of a dialog could dismiss the dialog. (Ia78fd)
• Compose lint checks now require a minimum AGP version of 8.8.2 from command line, and at least Android Studio Ladybug for IDE support. If you are using an older version of AGP, you can set android.experimental.lint.version=8.8.2 in gradle.properties to upgrade the Lint version, without affecting AGP. (I6f2a8)
• Added a new semantics property InputText that captures a textfield's value before output transformation is applied. (Iae46a, b/395911609, b/176949051)
• Moved enableAccessibilityChecks() API that turns on the Accessibility Checks for Android to separate packages which are compose:ui:ui-test-accessibility if you're not using the TestRule and compose:ui:ui-test-junit4-accessibility when calling on TestRule (I3c318, b/391560768)
• Added support for compose stack traces in LaunchedEffect and rememberCoroutineScope (I705c0, b/354163858)

External Contribution

• Changing the experimental runComposeUiTest function to accept a suspend block. Also added a deprecated fun runComposeUiTest for binary compatibility (I3b88c, b/361577328)

Version 1.8

Version 1.8.3

June 18, 2025

androidx.compose.ui:ui-*:1.8.3 is released. Version 1.8.3 contains these commits.

Bug Fixes

• Flag for isGetFocusedRectReturnEmptyEnabled has been removed now that the feature has been fully verified. (Ife722)
• Flag ComposeUiFlags.isGetFocusedRectReturnEmptyEnabled makes it so that when nothing is focusable in a ComposeView, it sets the rect to an Empty value. This prevents a focus search from choosing the View to focus on. This is especially important for when an IME has a NEXT option where it might try to focus on the ComposeViewand requestFocus() fails. (Ibd0e2, b/369256395)

Version 1.8.2

May 20, 2025

androidx.compose.ui:ui-*:1.8.2 is released. Version 1.8.2 contains these commits.

Bug Fixes

• Fixes NPE when dialog is being removed during active event stream on dialog (6a7e7f)
• Fix onLayoutRectChange not updating per throttled timeline when draw-only updates occur. (03b82d)

Version 1.8.1

May 7, 2025

androidx.compose.ui:ui-*:1.8.1 is released. Version 1.8.1 contains these commits.

Bug Fixes

• Fix some issues with onLayoutRectChanged and LazyLayout d791b11
• Skip remeasure requests for precomposed items. This bug affected the lazy layouts scrolling performance as the prefetch was not working efficiently in some cases, the measurement was happening within the frame. 742087a

Version 1.8.0

April 23, 2025

androidx.compose.ui:ui-*:1.8.0 is released. Version 1.8.0 contains these commits.

Important changes since 1.7.0

• Compose 1.8 contains newly added support for semantic autofill. Ensure that the versions of UI and Foundation that you use are version 1.8 or higher, as autofill for text components needs the latest versions of both modules. For API usage and examples, please refer to the autofill documentation for more details, here.
• Compose 1.8 supports additional types of haptic feedback: Confirm, ContextClick, GestureEnd, GestureThresholdActivate, Reject, SegmentFrequentTick, SegmentTick, ToggleOn, ToggleOff, VirtualKey. This is accessible via LocalHapticFeedback and on Android, this is available by default when the Vibrator API indicates that haptics are supported.
• Multiple Focus APIs are now stable, including Modifier.focusRestorer() and onEnter and onExit FocusProperties (I6e667). You can now specify a FocusDirection when you call requestFocus. We have added a requestFocus(FocusDirection) API to both focusRequester and FocusTargetModifierNode to allow focusing with a specific direction. (I5d9ec][https://android-review.googlesource.com/#/q/I5d9eca3a2cd283c1b84ad6b77d929ef9a49ce4cc], b/245755256)

Version 1.8.0-rc03

April 9, 2025

androidx.compose.ui:ui-*:1.8.0-rc03 is released. Version 1.8.0-rc03 contains these commits.

Bug Fixes

• Disables some focus interop fixes that caused a regression. (b9d998, b/369256395, b/378570682, b/376142752, b388590015/, b/389994198, b/391378895)

Version 1.8.0-rc02

March 26, 2025

androidx.compose.ui:ui-*:1.8.0-rc02 is released. Version 1.8.0-rc02 contains these commits.

Bug Fixes

• Fixed an issue where focused views embedded in the Compose hierarchy would cause re-entrant composition when the focused view was removed from a lazylist. (765562)

Version 1.8.0-rc01

March 12, 2025

androidx.compose.ui:ui-*:1.8.0-rc01 is released. Version 1.8.0-rc01 contains these commits.

Bug Fixes

• Fixes crash when a focused AndroidView is removed with the soft keyboard active. (Ic725a)
• Fixes a few issues in the new focus state handling implementation. (b/395895685)
• Fixes an issue blocking Autofill when using LaunchedEffect to request focus on a text field. (b/392539099)

Version 1.8.0-beta03

February 26, 2025

androidx.compose.ui:ui-*:1.8.0-beta03 is released. Version 1.8.0-beta03 contains these commits.

API Changes

• Moved enableAccessibilityChecks() API that turns on the Accessibility Checks for Android to separate packages which are compose:ui:ui-test-accessibility if you're not using the TestRule and compose:ui:ui-test-junit4-accessibility when calling on TestRule (I547ef, b/391560768)
• Added a new semantics property InputText that captures a textfield's value before output transformation is applied. (Iae46a)

Bug Fixes

• Fixed an issue which caused autofill services to save the output transformed text instead of the input text. (Iae46a, b/395911609, b/176949051)

Version 1.8.0-beta02

February 12, 2025

androidx.compose.ui:ui-*:1.8.0-beta02 is released. Version 1.8.0-beta02 contains these commits.

New Features

• Added a lint check to warn against calls to Configuration#screenWidth/heightDp - LocalWindowInfo.current.containerSize can be used instead to retrieve the current window size.

Version 1.8.0-beta01

January 29, 2025

androidx.compose.ui:ui-*:1.8.0-beta01 is released. Version 1.8.0-beta01 contains these commits.

API Changes

• ContextualFlowRow and ContextualFlowColumn have been marked as deprecated. This experimental component was introduced in 1.7 and had not yet been stabilized, and the implementation has been deemed undesirable. In the future, a component solving the use cases this component was meant to solve may be provided.
  • FlowRow and FlowColumn have experimental overloads that were introduced in 1.7 that include an overflow parameter. The use of this parameter has been deprecated, and the overloads without this parameter can be used instead. The default "overflow" behavior for these overloads will be "Clip", as it was since its introduction.
  • Many use cases for ContextualFlowRow can be accomplished using FlowRow, but we acknowledge that is not true in full generality. ContextualFlowRow is completely implementable in user-space, and one can attempt to copy its implementation and adapt if desired. In the future, we hope to solve these use cases in a different way. (Ibafec)
• SemanticsNodeInteraction.semanticsId() has been removed. Use SemanticsNodeInteraction.fetchSemanticsNode().id instead. (Ie397a)
• The old autofill APIs are deprecated. Use the new semantics based API instead. (I943ff)
• Rewrite requestAutofill API to exist outside of autofill manager. (Id1929)

Bug Fixes

• Fixed focus issue where requestFocus() with a nonsensical previouslyFocusedRect parameter (related to the focus direction) would skip past a ComposeView. (Ifdc2f, b/388590015)
• Fixed an occasional NPE when using GraphicsLayer.record { this@ContentDrawScope.drawContent() }. If you are recording drawContent() in this way, make sure to use the GraphicsLayer#record extension function inside DrawScope, and not the member function on GraphicsLayer. (I75fc0, b/389046242)
• Fix text layout with ellipsis sometimes translating incorrectly during animations, see b/389707025 for more info (Ie55b1, b/389707025)

Version 1.8.0-alpha08

January 15, 2025

androidx.compose.ui:ui-*:1.8.0-alpha08 is released. Version 1.8.0-alpha08 contains these commits.

API Changes

• Making AutofillManager an abstract class. (I0a3b0)
• Fixed several focus-related issues, including crashes when IME tries to focus on ComposeView without focusable items, focus change within child AndroidViews, and focus request leaving an AndroidView. (Ia03c3, b/369256395, b/378570682, b/376142752)
• Change FocusEnterExitScope.cancelFocus() to cancelFocusChange() (I89959)
• You may now calculate Composable occlusions with RectInfo.calculateOcclusions().
• Added extension function on DelegatableNode to register a listener for global layout changes. (I68b59)

Bug Fixes

• The activity that is used as the host for the composable under test when using ComposeContentTestRule.setContent now uses the theme Theme.Material.Light.NoActionBar, to avoid the ActionBar from overlapping with test content when targeting SDK 35. To opt out of this behavior, you can remove the dependency on ui-test-manifest and add an activity entry in your test app's AndroidManifest.xml for ComponentActivity with the theme of your choice. (I7ae1b, b/383368165)
• Resource fonts with the same variation settings will now avoid over-caching causing the incorrect variation settings to be applied. (If3dff, b/372044241)
• AnnotatedString.fromHtml now supports <ul>/<li> tags. (I7c2fe, b/299662276, b/139326648)

External Contribution

• Added a new Clipboard interface and a composition local for it. (I80809)

Version 1.8.0-alpha07

December 11, 2024

androidx.compose.ui:ui-*:1.8.0-alpha07 is released. Version 1.8.0-alpha07 contains these commits.

API Changes

• Exposed owner from LayoutNode for tools. (I26f7f)
• Has LocalAutofillHighlightColor composition local use a Color type. (I0e05b)
• Keep deprecated UrlAnnotation and its methods marked as experimental. (Ic0021)

Bug Fixes

• Fixed IndexOutOfBoundsException crash when using LinkAnnotation inside the BasicText or Text composable (be7605, b/374115892)
• Fixed issue where filled text fields with custom shape didn't clip the indicator line. (I4f87f, b/380704151)
• Fixed missing backgrounds with long screenshots. (I4d57a)
• This library now uses JSpecify nullness annotations, which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage: -Xjspecify-annotations=strict (this is the default starting with version 2.1.0 of the Kotlin compiler). (Idfef8, b/326456246)
• Update Compose support for wide gamut and HDR colors when running on Android Q+. (Icd8be, b/379135036)
• Resource fonts that fail to load will now silently fall back to the default font, instead of the prior behavior of throwing an exception in measure. (Ib6a49)
• Fix focus lost when AndroidView is detached and attached. (I53446)
• Accept requestFocus() from beyond bound layout action. (Ia8461)

External Contribution

• Add BringIntoViewResponderModifierNode to UI, which provides a new way to implement Bring Into View functionality as well as allows implementing in on a platform level. (Ia6dd8)

Version 1.8.0-alpha06

November 13, 2024

androidx.compose.ui:ui-*:1.8.0-alpha06 is released. Version 1.8.0-alpha06 contains these commits.

API Changes

• Adds stylusHoverIcon modifier. (Iff20a, b/331289114)
• Changes Autofill manager to be an interface. (I84914, b/376080755)
• Adds requestFocus(FocusDirection) to both focusRequester and FocusTargetModifierNode to allow focusing with a specific direction. (I5d9ec, b/245755256)
• FocusProperties.enter and FocusProperties.exit have been replaced with onEnter and onExit, using a receiver scope instead of FocusDirection parameter. (I6e667)
• Adding autofill support in text toolbar. (Ie6a4c)
• API changes to Modifier.focusRestorer() (I99c03):
  • parameter name changed to 'fallback'
  • parameter is now a FocusRequester and not a lambda
  • parameter is now non-NULL with Default as the default value
• Removing @Experimental annotation from autofill manager interface. The feature is still WIP targeting this release but we do not want to introduce @Expemiental API (Id8398)
• LocalHapticFeedback now provides a default HapticFeedback implementation when the Vibrator API indicates that haptics are supported. The following have been added to the HapticFeedbackType - Confirm, ContextClick, GestureEnd, GestureThresholdActivate, Reject, SegmentFrequentTick, SegmentTick, ToggleOn, ToggleOff, VirtualKey. Wear Compose long-clickable components such as Button, IconButton, TextButton, and Card now perform the LONG_PRESS haptic when a long-click handler has been supplied. (I5083d)
• Removes OverscrollConfiguration and LocalOverscrollConfiguration, and adds rememberPlatformOverscrollFactory to create an instance of / customize parameters of the default overscroll implementation. To disable overscroll, instead of LocalOverscrollConfiguration provides null, use LocalOverscrollFactory provides null. To change the glow color / padding, instead of LocalOverscrollConfiguration provides OverscrollConfiguration(myColor, myPadding), use LocalOverscrollFactory provides rememberPlatformOverscrollFactory(myColor, myPadding). (Ie71f9, b/255554340, b/234451516)
• Removed the experimental GlobalAssertions API. It's intended use was to run accessibility checks, see enableAccessibilityChecks() for that purpose instead. (I59322)

Version 1.8.0-alpha05

October 30, 2024

androidx.compose.ui:ui-*:1.8.0-alpha05 is released. Version 1.8.0-alpha05 contains these commits.

New Features

Autofill is exposed behind a feature flag in this release. We are working on improving performance, and are looking for early feedback on the APIs. The APIs are expected to evolve prior to stable based on feedback.

• To enable Autofill, set ComposeUiFlags.isSemanticAutofillEnabled to true in onCreate and use the latest Compose Snapshot.
• This version of Autofill supports saving credentials manually, through Suggest Strong Password, and through navigation. It also supports filling when an autofillable field receives focus or when Autofill is triggered via the text toolbar on text components. The component will become highlighted to indicate when autofill has completed.

API Changes

• Modify Autofill interface to follow expect/actual structure. (I22dce)
• Introduce CompositionLocal that can be used to modify the hue of Autofill's successful filling highlight. (I32092)
• Added Modifier.onRectChanged API which is an API that allows one to subscribe to the root/window/screen-relative position and size of a LayoutNode. The API solves many use cases that the existing onGloballyPositioned modifier does, however it does so with much less overhead and the API comes with facilities to debounce and throttle the callback per what one's use case demands. (Id28c7, b/372765423, b/372757007, b/372994338)
• Expands Autofill manager to include commit() and cancel() APIs that help users save newly entered credentials. (I2da00)
• Introduces new AutofillManager interface that can be used to fine-tune users' Autofill journey and a isSemanticAutofillEnabled flag to turn on this new version of Autofill. (I9d484)
• Added Modifier.onRectChanged API which is an API that allows one to subscribe to the root/window/screen-relative position and size of a LayoutNode. The API solves many use cases that the existing onGloballyPositioned modifier does, however it does so with much less overhead and the API comes with facilities to debounce and throttle the callback per what one's use case demands. (I3c8fa)
• Add in semantic properties and data types for extended Autofill support. (I52c7d)
• All methods in AnnotatedString builder are non-experimental now (Ia89c8, b/261561823)

Bug Fixes

• Views embedded in compose can now receive rotary events if they are focused (I4d53a, b/320510084)
• Fixed an issue where various resource types wouldn't update on configuration changes (Ia9b99, b/352336694)
• Addressed an issue that prevented TextField from functioning correctly when using the POBox Japanese Keyboard on certain older Sony devices. (Ia9b99, b/373743376)
• Fixed problem with dialogs showing at bottom of the screen instead of centering (Ia2ec, b/373093006)
• Targeting API 35+ no longer forces dialogs to have decorFitsSystemWindows set to false. (Ibc94, b/364492593)
• Fix crash when layers are moved between windows (e.g. dialog and main content) (I675ba, b/330955281)

Version 1.8.0-alpha04

October 16, 2024

androidx.compose.ui:ui-*:1.8.0-alpha04 is released. Version 1.8.0-alpha04 contains these commits.

API Changes

• Adds DelegatableNode#onDensityChange and DelegatableNode#onLayoutDirectionChange callbacks to allow updating node state when these change (I04f3e, b/340662451)
• Adds WindowInfo#containerSize to provide the current window's content container size. This can be retrieved using LocalWindowInfo. (Idc38c, b/369334429, b/360343819)
• Introduce a fix for nested scrollables that are removed from the node tree during an ongoing fling. Now these nodes will cancel the fling and correctly send the onPostFling event with the remaining velocity. We're also introducing the flag NewNestedScrollFlingDispatchingEnabled to control the behavior in case of regressions. The flag will be removed before beta. (I05c37, b/371168883)
• Introduced PointerInputModifierNode#touchBoundsExpansion, which can be used to enlarge the touch bounds of a single pointer input modifier. (Iccf02, b/335339283)
• Adds WindowInfo#containerSize to provide the current window's content container size. This can be retrieved using LocalWindowInfo. (I27767, b/369334429, b/360343819)
• Remove readOnly from TextFields' to pin to stable foundation version. (I3aaba)
• Paragraph and ParagraphIntrinsics now takes a list of all annotations applied to the AnnotatedString, previously it only had a list of SpanStyles (I12f80)

Bug Fixes

• Updated how paragraphs are treated in AnnotatedString. Before you could only create non-overlapping paragraphs. Now the AnnotatedString allows fully-overlapping paragraphs which will be merged together, and nested paragraphs in which case the outer paragraph will be split on bounds of the inner one, and the inner paragraph's style will be merged with the outer paragraph's style (Ic9554)
• Fix crash in AnnotatedString with a zero-length LinkAnnotation. (89aac6)

Version 1.8.0-alpha03

October 2, 2024

androidx.compose.ui:ui-*:1.8.0-alpha03 is released. Version 1.8.0-alpha03 contains these commits.

API Changes

• Kotlin version update to 1.9 (I1a14c)
• Introduced a new Semantics Role called Carousel to emulate the list behavior in Pagers for a11y services. (Id354b, b/354109776, b/239672673)
• Rename invisibleToUser() to hideFromAccessibility. Its function remains the same. See documentation for more details. (Ib43a3)

Bug Fixes

• Updating docs for SensitiveContent modifier (Ib0442)
• Fixed issue where certain generic outline clips would be ignored in combination with elevation shadows on some Android versions
• Fixed issue where empty clips would be applied when a generic outline clips was specified on certain Android versions.
• Fixed exception thrown when the IME is active on an external View and the Next action is used to enter focus on the ComposeView. The clearFocus() behavior aligns with View behavior on API < 28, where clearFocus() can cause the default View to be focused.
• Fixed an issue where placement happened on detached nodes in LazyList by separating the management of subcomposition for different layout passes.
• Fixed a problem where the Software Keyboard flickers when focus switches from a TextField to an EditText or any other View based editor.
• Nested Scroll nodes will now dispatch onPostFling events correctly after they get detached.
• General performance improvements

Version 1.8.0-alpha02

September 18, 2024

androidx.compose.ui:ui-*:1.8.0-alpha02 is released. Version 1.8.0-alpha02 contains these commits.

API Changes

• TextOverflow.StartEllipsis and TextOverflow.MiddleEllipsis are now available which allows to place ellipsis at the start or middle of the line of the single line text. (I38913, b/185418980)

Bug Fixes

• Fix Dalog dismissOnClickoutside (39a3d, b/364508685)
• Don't clip shadows of dialog content (e8e2f, b/363027803)
• Fix errant behavior when focus search moves between Compose and a View (58377, b/350534714)

External Contribution

• The AlignmentLines Map now accepts VerticalAlignmentLine or HorizontalAlignmentLine concrete types. (I02912)
• New common ByteArray.decodeToImageBitmap(): ImageBitmap method. (I83c21)

Version 1.8.0-alpha01

September 4, 2024

androidx.compose.ui:ui-*:1.8.0-alpha01 is released. Version 1.8.0-alpha01 contains these commits.

Version 1.7

Version 1.7.8

February 12, 2025

androidx.compose.ui:ui-*:1.7.8 is released. Version 1.7.8 contains these commits.

Version 1.7.7

January 29, 2025

androidx.compose.ui:ui-*:1.7.7 is released. Version 1.7.7 contains these commits.

Bug Fixes

• Fixed IndexOutOfBoundsException when passing an AnnotatedString with the LinkAnnotation to the Text composable. (Ic96d2)
• Fixed a timeout issue in tests in some rare cases when LinkAnnotation is used in the AnnotatedString. (I04a03)

Version 1.7.6

December 11, 2024

androidx.compose.ui:ui-*:1.7.6 is released. Version 1.7.6 contains these commits.

Bug Fixes

• We previously used to throw an error whenever we encountered a key event when we encountered a key event when the focus system had pending invalidations. We now log an error instead (I7ea0, b/346370327).
• Removed experimental annotation from SemanticsPropertyReceiver.invisibleToUser(). This will be deprecated in 1.8 to be replaced with SemanticsPropertyReceiver.hideFromAccessibility(). (I448f0, b/376479686)
• Fixed an issue that prevented TextField from functioning correctly when using the POBox Japanese Keyboard on certain older Sony devices. (I94e0e, b/373743376)
• Fixed an accessibility issue where BasicText’s inlineContent was not announced by TalkBack. (I67bcb, b/376479686)

Version 1.7.5

October 30, 2024

androidx.compose.ui:ui-*:1.7.5 is released. Version 1.7.5 contains these commits.

Bug Fixes

• Fixed issues where elevation and clipping with custom outlines would not render properly.
• Fixes a text crash that happens with a zero-width LinkAnnotation. (Ic1e2e)
• Fixes an announcement in Talkback of the button when it's built as a clickable Text composable. (I1f588)

Version 1.7.4

October 16, 2024

androidx.compose.ui:ui-*:1.7.4 is released. Version 1.7.4 contains these commits.

Version 1.7.3

October 2, 2024

androidx.compose.ui:ui-*:1.7.3 is released. Version 1.7.3 contains these commits.

Bug Fixes

• Fixed issue where specifying a generic outline clip would lead to an empty clip boundary on certain Android versions.
• Fixed exception thrown when the IME is active on an external View and the Next action is used to enter focus on the ComposeView. The clearFocus() behavior aligns with View behavior on API < 28, where clearFocus() can cause the default View to be focused.
• Fixed an issue where an incorrect placeOrder was used for lookahead invalidation, therefore fixing an edge case where lookahead placement was skipped.

Version 1.7.2

September 18, 2024

androidx.compose.ui:ui-*:1.7.2 is released. Version 1.7.2 contains these commits.

Bug Fixes

• Improved performance of accessibility node info and semantics events by removing verbose tracing. (I89156, b/362530618)
• ComposeView will no longer crash when passed exceptionally large measurement size (da5db, b/347036173)
• Fixed an accessibility screenreader issue where LiveRegion announcements on buttons were not made. (f66fa7, b/348590026)

Version 1.7.1

September 10, 2024

• No changes to Android artifacts. -desktop artifacts were removed and -jvmStubs and -linuxx64Stubs artifacts were added. None of these targets are meant to be used, they are placeholders to help Jetbrains Compose efforts.

Version 1.7.0

September 4, 2024

androidx.compose.ui:ui-*:1.7.0 is released.

Important changes since 1.6.0

Important changes in version 1.7.0 are covered in this blogpost.

Version 1.7.0-rc01

August 21, 2024

androidx.compose.ui:ui-*:1.7.0-rc01 is released. Version 1.7.0-rc01 contains these commits.

Notable changes

• ui:ui module now forces requirement of a minimum version of foundation:foundation to be at least 1.7.0-rc01 or newer. This is enforced to remedy a behaviour incompatibility between ui and foundation in regards to NestedScrollSource changes that happened early during 1.7.0-alpha01.

Version 1.7.0-beta07

August 7, 2024

androidx.compose.ui:ui-*:1.7.0-beta07 is released. Version 1.7.0-beta07 contains these commits.

Bug Fixes

• Text input related SemanticsNodeInteraction functions performTextReplacement, performTextInput, and performTextClearance is now going to throw assertion errors when they are called on read only TextFields. (I4ae8f)

Version 1.7.0-beta06

July 24, 2024

androidx.compose.ui:ui-*:1.7.0-beta06 is released. Version 1.7.0-beta06 contains these commits.

Version 1.7.0-beta05

July 10, 2024

androidx.compose.ui:ui-*:1.7.0-beta05 is released. Version 1.7.0-beta05 contains these commits.

Bug Fixes

• Fixed a bug where changing the software keyboard would cause TextField to not accept input from the new keyboard until the focus is lost and regained.
• Fixed an issue where attempts to persist layer contents would cause unintended side effects when rendering with SurfaceView content.

Version 1.7.0-beta04

June 26, 2024

androidx.compose.ui:ui-*:1.7.0-beta04 is released. Version 1.7.0-beta04 contains these commits.

Bug Fixes

• Avoid crashes when measuring very large text lines (e.g. 10k characters) (8157ab)
• Disable software rendering support for the GraphicsLayer API. (35ddd8)
• Fix for a crash in layer persistence logic. (70b13e)
• Reusing layer objects optimization was reverted, as it caused rendering issues. (70b13e)

Version 1.7.0-beta03

June 12, 2024

androidx.compose.ui:ui-*:1.7.0-beta03 is released. Version 1.7.0-beta03 contains these commits.

Version 1.7.0-beta02

May 29, 2024

androidx.compose.ui:ui-*:1.7.0-beta02 is released. Version 1.7.0-beta02 contains these commits.

API Changes

• Renamed SemanticsProperties.Editable to IsEditable and changes SemanticsPropertyReceiver.editable to a val isEditable. The property is now a boolean and always specified by text fields. (I8acd8)
• Rename accessibility benchmark parameter. (I3d440)
• Updated API for styling the links: TextLinkStyles is now part of the LinkAnnotation constructor and the AnnotatedString.fromHtml method (I90b2b). Also removed the TextDefaults from material (I5477b)

Bug Fixes

• Renamed LayoutCoordinates.introducesFrameOfReference to LayoutCoordinates.introducesMotionFrameOfReference to better reflect its purpose. Renamed related function to calculate coordinates based on that flag. (I3a330)

Version 1.7.0-beta01

May 14, 2024

androidx.compose.ui:ui-*:1.7.0-beta01 is released. Version 1.7.0-beta01 contains these commits.

API Changes

• Renamed performCustomAccessibilityActionLabelled to performCustomAccessibilityActionWithLabel and performCustomAccessibilityActionWhere to performCustomAccessibilityActionWithLabelMatching. (I5387f)
• AnnotatedString.hasEqualsAnnotations is now hasEqualAnnotations (I685c0)
• Updated the API for getting Material themed links in text. Specifically, removed the methods from the TextDefaults for constructing themed LinkAnnotations and parse HTML with themed links. Instead, added a TextLinkStyles class that allows to style the links as a parameter to the Text composable. (I31b93)

Bug Fixes

• Fixes additional use cases when dynamically adding pointer input modifiers during events 63e1504

Version 1.7.0-alpha08

May 1, 2024

androidx.compose.ui:ui-*:1.7.0-alpha08 is released. Version 1.7.0-alpha08 contains these commits.

API Changes

• Adds support for mutable shape implementations. Shape#createOutline is now observed inside graphics layers, so reading state values inside will cause invalidations when the state changes, allowing for more performant shape animations. (Id1629, b/326070216)
• Renamed isPositionedByParentWithDirectManipulation to introducesFrameOfReference. Note that it now has the reverse effect, meaning that by default, most LayoutCoordinates introduce a frame of reference, and, only when placed under direct manipulation the property will be false. To query position with only those that introduce a frame of reference, use positionInLocalFrameOfReference(...). Or positionInLocalLookaheadFrameOfReference from a LookaheadScope. (Ifc5f7)
• LookaheadScope APIs have been made stable (I21507)
• Change action lambda for getScrollViewportLength as per API council feedback. (Ibc74a)
• Updated GraphicsLayer outline APIs to consume float parameters instead of int. Removed UnsetOffset/UnsetSize IntSize sentinel values in favor of already existing Unspecified constants on float based Offset and Size inline classes (I2fb03, b/333863462)
• When injecting mouse input during tests, MouseInjectionScope.click(), MouseInjectionScope.doubleClick(), MouseInjectionScope.tripleClick(), MouseInjectionScope.longClick() now accept a button: MouseButton parameter to make them more universally applicable. The default value is MouseButton.Primary for all methods. (I31a23, b/190493367, b/261439695)
• Renamed onClicked to onClick inside LinkInteractionListener. (Iaa35c)
• Rename TextInclusionStrategy.isInside to isIncluded. Make Paragraph/MultiParagraph#getRangeForRect() return type non nullable. (I51f26)

Bug Fixes

• Fixed long screenshot capture for scrolling containers with reverseScrolling=true. (I7c59c)

External Contribution

• Added support for prefetching items in nested LazyLists (e.g. a LazyColumn that renders nested LazyRows). This change is expected to reduce frame drops during scrolling for these LazyLists. The implementation default is to prefetch the first 2 nested items, however this behavior can be controlled by the new LazyLayoutPrefetchStrategy(nestedPrefetchItemCount) and LazyListPrefetchStrategy#onNestedPrefetch APIs. (I51952)

Version 1.7.0-alpha07

April 17, 2024

androidx.compose.ui:ui-*:1.7.0-alpha07 is released. Version 1.7.0-alpha07 contains these commits.

API Changes

• ClickableText is marked as deprecated. To add links to the text, create an AnnotatedString with a LinkAnnotation corresponding to your link and pass this AnnotatedString to the Text composable. (I34d4b, b/323346994)
• Introduce ViewConfiguration.HandwritingGestureLineMargin for handwriting gestures. Support JoinOrSplit gesture for BasicTextField (Ie6e13, b/325660505)
• FocusProperties.enter and FocusProperties.exit are no longer experimental. FocusDirection.Enter and FocusDirection.Exit are no longer experimental. FocusRequester.Cancel is no longer experimental (I461a1, b/261564106)
• When querying Layout coordinates, you may now use the excludeDirectManipulationOffset argument to exclude the offset set by parent Layouts that placed their children using Placeable.PlacementScope.withDirectManipulationPlacement. Likewise, a Layout that changes the position of its children frequently may now place them using withDirectManipulationPlacement (such as Scroll, implemented by default). This helps approachLayout based animations to be more intuitive, having now the opportunity to differentiate what offset to animate, and what to apply directly when deciding to animate their approach. (I60ec7)
• The feature flag for long screenshots has been removed. (I28648, b/329128246)
• LazyColumn will now render sticky headers correctly in long screenshots. (I8d239, b/329296635)
• NestedScroll sources Drag and Fling are being replaced by UserInput and SideEffect to accommodate for the extended definition of these sources that now include animations (Side Effect) and Mouse Wheel and Keyboard (UserInput). (I40579)
• ApproachLayoutModifierNode and Modifier.approachLayout are now stable, with new isMeasurementApproachInProgress() and isPlacementApproachInProgress() to replace the old isMeasurementApproachComplete() and isPlacementApproachComplete() respectively.
• Removed deprecated intermediateLayout modifier. (I3e91c)
• Rename GraphicsLayer#buildLayer to record to mirror the begin/endRecording methods of Displaylist backed APIs like RenderNode and Picture.
• Updated rememberGraphicsLayer to leverage rememberObserver. (I312c1, b/288494724, b/330758155)
• UrlAnnotation is deprecated, use LinkAnnotation.Url instead. If you're using Material theming, then use TextDefaults object to create the annotation with Material theming applied to it (I8d180, b/323346545)
• Text links got pressed state styling option in addition to normal styling, hovered and focused (I5f864, b/139312671)
• String.parseAsHtml renamed to AnnotatedString.Companion.fromHtml. (I43dcd)
• Added styling arguments (linkStyle, focusedLinkStyle, hoveredLinkStyle) and a link interaction listener to the parseAsHtml method. When parsing the HTML-tagged string with <a> tags, the method will construct a LinkAnnotation.Url for each such tag and pass the styling objects and link interaction listener to each annotation. (I7c977)
• LinkAnnotation now takes the state-based styling arguments and a LinkInteractionListener. Add this annotation to the AnnotatedString to get a hyperlink. By passing focusedState and/or hoveredState you can define the visual configuration for links when they are focused and/or hovered. (I81ce4, b/139312671)
• ImeOptions.hintLocales is no longer nullable. If you want to pass an empty Locale list, please use LocaleList.Empty. (Ic5bc4)

Bug Fixes

• Gracefully handles bad/corrupt historical input event data (ignores bad offset data).
• Fixes unexpected pointer events when a pointer input modifier is added dynamically before another pointer input modifier during an active pointer input event stream (for example, between a hover enter and hover exit [mouse/stylus]).

Version 1.7.0-alpha06

April 3, 2024

androidx.compose.ui:ui-*:1.7.0-alpha06 is released. Version 1.7.0-alpha06 contains these commits.

New Features

• Added parseAsHtml method for styled strings: it allows to convert a string marked with HTML tags into AnnotatedString. Note that not all tags are supported, for example you won't be able to display bullet lists yet. (I84d3d, I30626, b/139326648)
• Implemented experimental support for long screenshots in Compose scroll containers using the official Android API (ScrollCaptureCallback). This feature is experimental and may not currently handle all cases correctly. For that reason it is currently disabled by default. To opt-in, set the ComposeFeatureFlag_LongScreenshotsEnabled flag to true. (I2b055, b/329296471)

API Changes

• fun ClipEntry.getMetadata() is changed to val ClipEntry.clipMetadata. (I50155)
• Removed ClipboardManager.getClipMetadata and ClipboardManager.hasClip functions. Please use clipEntry.getMetadata() to read the current clip entry's metadata. Also check ClipboardManager.getClip's result if it's null or not to understand whether Clipboard has a current clip. (I50498)
• Now you can pass GraphicsLayer objects into placeable.placeWithLayer() functions (I1b22f)
• ClipboardManager.setClip now accepts null to be able to clear the Clipboard. (I7d2e9)
• Added resource ids for assist with hiding Views used as implementation details within build tooling (I99531)
• Added GraphicsLayer#toImageBitmap suspend method to support rendering contents of a bitmap into a GraphicsLayer. This is a hardware accelerated rendering operation on API level 22+ (inclusive) which supports over 99% of all Android devices. On Android API level 21 this falls back onto software rendering. (I9e114)
• Helper method to convert an Android RectF to ComposeRect (I39925, b/325660505)
• All KeyboardOptions parameters now have an unspecified value by default. Added KeyboardOptions.merge method.
• Renamed KeyboardOptions.autoCorrect to autoCorrectEnabled and made it nullable, where null indicates no value was specified. (Ia8ba0, b/295951492)
• BasicTextField(state) variant and BasicSecureTextField now use KeyboardActionHandler instead of KeyboardActions to process actions taken by the software keyboard. (I58dda)

Version 1.7.0-alpha05

March 20, 2024

androidx.compose.ui:ui-*:1.7.0-alpha05 is released. Version 1.7.0-alpha05 contains these commits.

New Features

• Introduce new GraphicsLayer API to record drawing commands in a display list as well as additional properties that affect the rendering of the display list. This provides an isolation boundary to divide a complex scene into smaller pieces that can be updated individually of one another without recreating the entire scene. Transformations made to a GraphicsLayer can be done without re-recording the display list. Unlike Modifier.graphicsLayer, GraphicsLayer allows for rendering of Composable content elsewhere and is useful in animated use cases where content is expected to be rendered in different scenes.

API Changes

• GraphicsLayer.draw(Canvas) is not a public api anymore. Please use the DrawScope.drawLayer(GraphicsLayer) extension function instead to draw the layer. (I7a7c0)
• Split restrictedConstraints() to two methods: fitPrioritizingWidth() and fitPrioritizingHeight() (I6d7fd)
• Introduced HardwareCanvas stub for Android L usage (I1c3b5, b/288494724)
• Update Compose framework to expose a GraphicsContext composition local alongside updating Owner, DelegateableNode and drawWithCache Modifier implementations to expose access to the GraphicsContext for scoped access that will automatically cleanup GraphicsLayer instances when Modifiers are torn down. (I64a2f, b/288494724)
• Introduced InterceptPlatformTextInput for helping write low-level IME-related tests and other low-level IME use cases. PlatformTextInputTestOverride has been deprecated. (I862ed, b/322680547)
• GraphicsLayer.setOutline(Outline) extension function was added. (Ib81f4)
• Introduce GraphicsContext function constructor to create a factory to create GraphicsLayer instances (Ib98d6, b/288494724)
• Exposed GraphicsLayer API to provide developer defined flexibility in capturing drawing commands that can be used to draw elsewhere and also apply different visual effects to the end result. (I80245, b/288494724)
• Introduce the Paragraph#getRangeForRect which returns a range of text covered by a given rectangle area. (Iee516, b/325660505)
• Removed experimental override of BasicText with onLinkClicked argument. A replacement API for hyperlinks support will follow in the future. (I107d5)

Bug Fixes

• Added GraphicsLayer expect/actual API definition to support capturing and replaying of drawing commands with optional compositing visual effects and transforms. Introduce GraphicsContext interface to contain graphics dependencies including creation and management of GraphicsLayer instances. (I4a8d6, b/288494724)
• Fixed an interop issue with 1D focus search where focus would get stuck inside a ComposeView that was embedded among other views. (I08fd4)

External Contribution

• LocalLifecycleOwner moved from Compose UI to lifecycle-runtime-compose so that its Compose-based helper APIs can be used outside of Compose UI. Thanks Jake Wharton for the contribution. (I6c41b, b/328263448)
• Consistently expose bias float properties on all bias-based alignment subtypes. (I69f0f, b/328088992)

Version 1.7.0-alpha04

March 6, 2024

androidx.compose.ui:ui-*:1.7.0-alpha04 is released. Version 1.7.0-alpha04 contains these commits.

API Changes

• Support stylus handwriting feature for BasicTextField2 on devices after Android U. (I002e4)
• In this CL we are adding the GetScrollViewportLength semantic action so we can pipe up information about the components being scrolled in compose to the a11y system. This CL also applies the usage of said property in Foundation Scrollable Lists. (Ic5fa2)
• FocusRequester.createRefs is now stable (I4d92c, b/261436820)
• Introduced DelegatableNode.requireView() to allow modifier nodes to get the current Android View without reading a composition local. (I40768)
• New API Path.reverse() to reverse a path's direction (I36348)
• Added hintLocales to KeyboardOptions to provide TextFields with the ability to hint IMEs with specific locales to preset a preferred language.
• Expose platformLocale property from Locale that returns the underlying platform object, e.g. java.util.Locale. (I921c6)

Version 1.7.0-alpha03

February 21, 2024

androidx.compose.ui:ui-*:1.7.0-alpha03 is released. Version 1.7.0-alpha03 contains these commits.

API Changes

• Introducing ContextualFlowRow and Enhanced FlowRow/Column with MaxLines and Overflow. We are excited to announce enhancements to the experimental FlowRow and FlowColumn, now featuring maxLines and overflow support, alongside the debut of ContextualFlowRow and ContextualFlowColumn. This update is designed to provide performance optimal components, where ContextualFlow* is perfect for a large number of items making use of a small maxLines config and dynamic +N see more buttons, and FlowRow and FlowColumn is perfect for a small number of items, less than 100 items. Important: To maintain existing behavior in FlowRow or FlowColumn where all items are composed regardless of if they fit the cross axis max, set overflow to FlowRowOverflow.Visible or FlowColumnOverflow.Visible during initialization. Explore ContextualFlowRowSample and FlowRowSample for examples of these new features in action. (Ib9135, b/293577082)
• Add maxTextLength semantics property that should be set on text fields that filter the maximum allowed number of characters. (I24d9f, b/170648072)
• The Modifier.inspectable wrapper has been deprecated. This API will create more invalidations of your modifier than necessary, so its use is now discouraged. Developers are encouraged to implement the inspectableProperties() method on ModifierNodeElement if they would like to expose modifier properties to tooling. (Ib3236)
• New constructor for PopupProperties which allows for full control over WindowManager.LayoutParams flags. (Ibb33e, b/312485503)
• Introduced DelegatableNode.requireLayoutCoordinates() as a way to get a Modifier.Node's current LayoutCoordinates without needing to override onPlaced and store the coordinates in a property yourself. (Ia8657)
• Introduced DelegatableNode.currentLayoutCoordinates as a way to get a Modifier.Node's current LayoutCoordinates without needing to override onPlaced and store the coordinates in a property yourself. (Iaebaa)
• BasicTextField2 and related APIs under androidx.compose.foundation.text2 package are moved to androidx.compose.foundation.text. (I9f635)
• Added a new ApproachLayoutModifierNode API to support creating custom approach logic in an explicit Modifier Node. Also added a new experimental DeferredTargetAnimation API for animations whose target is unknown at instantiation. (I60745)
• New Path APIs to query the direction of a Path and to extract contours from a Path. (I63d04)
• Added PathHitTest and Path.contains(Offset) to check if a Path contains a specific point. (I3b218)
• The TextLayoutResult now exposes the getLineBaseline(lineIndex) method. This allows to read the baseline of an arbitrary line of the text in addition to existing convenience properties firstBaseline and lastBaseline. (Ide4e8, b/237428541)
• Added method to compare only the annotations of two AnnotatedStrings. (I32659)

Bug Fixes

• Fixed a backwards compatibility issue with SemanticsPropertyReceiver.performImeAction and SemanticsActions.PerformImeAction. (Id0528, b/322269946)

Version 1.7.0-alpha02

February 7, 2024

androidx.compose.ui:ui-*:1.7.0-alpha02 is released. Version 1.7.0-alpha02 contains these commits.

API Changes

• Fixed a binary compatibility issue with SemanticsPropertyReceiver.performImeAction. (I65865, b/322269946)
• PopupProperties constructor that takes a usePlatformDefaultWidth parameter is no longer experimental. (I8f8d2)
• Added an overload of ComposeTestRule.waitUntil that takes a string description of the condition to include in the timeout message. (I9413e)
• New semantics API unset() to remove semantics properties that are added in the same modifier chain. New semantics property isOpaque. (I8c583, b/317966058, b/246056649)
• Removed originalEventPosition from copy method in public API of PointerInputChange. (I7bead)

Bug Fixes

• Fixed an a11y bug allowing non-tabs and non-radiobuttons to be clickable when selected. (I2181c)
• VelocityTracker will now have the fix for adding points on by default. The fix can still be turned off by setting VelocityTrackerAddPointsFix to false if there's any issues. (Ib3877, b/269487059)
• Fixed backwards binary incompatibility in TextStyle and ParagraphStyle. (I179f0, b/320819734)

External Contribution

• Added a new DialogProperties constructor without platform-specific parameters. (I45829)
• Added a new PopupProperties constructor without platform-specific parameters. (I9a038)

Version 1.7.0-alpha01

January 24, 2024

androidx.compose.ui:ui-*:1.7.0-alpha01 is released. Version 1.7.0-alpha01 contains these commits.

API Changes

• Expanded ClipboardManager by adding ClipEntry and ClipMetadata to support arbitrary content such as images.
• Adds DeviceConfigurationOverride API to ui-test to allow locally overriding the behavior of content under test, such as to specify an available size, locale, layout direction, font scale, or theme.

Version 1.6

Version 1.6.8

June 12, 2024

androidx.compose.ui:ui-*:1.6.8 is released. Version 1.6.8 contains these commits.

Bug Fixes

• Fixed inconsistencies in font scaling when the font scale is less than the lowest defined table. In this case, we now interpolate between the linear 1x scale and the lowest defined table, so that the font size is monotonically increasing as scales increase. (Icbae3)

Version 1.6.7

May 1, 2024

androidx.compose.ui:ui-*:1.6.7 is released. Version 1.6.7 contains these commits.

Version 1.6.6

April 17, 2024

androidx.compose.ui:ui-*:1.6.6 is released. Version 1.6.6 contains these commits.

Bug Fixes

• Fixes a rare BasicTextField crash.

Version 1.6.5

April 3, 2024

androidx.compose.ui:ui-*:1.6.5 is released. Version 1.6.5 contains these commits.

Version 1.6.4

March 20, 2024

androidx.compose.ui:ui-*:1.6.4 is released. Version 1.6.4 contains these commits.

Version 1.6.3

March 6, 2024

androidx.compose.ui:ui-*:1.6.3 is released. Version 1.6.3 contains these commits.

Version 1.6.2

February 21, 2024

androidx.compose.ui:ui-*:1.6.2 is released. Version 1.6.2 contains these commits.

Version 1.6.1

February 7, 2024 androidx.compose.ui:ui-*:1.6.1 is released. Version 1.6.1 contains these commits.

Bug Fixes

• Fixed a backwards compatibility issue with SemanticsPropertyReceiver.performImeAction and SemanticsActions.PerformImeAction. (Ie0bb2, b/322269946)
• Layouts now issue an error while measuring when one returns an abnormally large size. This kind of error normally happens when the measurement uses maximum constraints directly without checking for Constraints.Infinity. The check will help developers find problems with the layout having the wrong size rather than in a layout that contains it. (I339a9)

Version 1.6.0

January 24, 2024

androidx.compose.ui:ui-*:1.6.0 is released. Version 1.6.0 contains these commits.

Version 1.6.0-rc01

January 10, 2024

androidx.compose.ui:ui-*:1.6.0-rc01 is released. Version 1.6.0-rc01 contains these commits.

Bug Fixes

• Optimized vector graphics implementation to improve performance by minimizing additional recompositions.

Version 1.6.0-beta03

December 13, 2023

androidx.compose.ui:ui-*:1.6.0-beta03 is released. Version 1.6.0-beta03 contains these commits.

New Features

• It is now possible for a LayoutCoordinates to be detached without the node being detached. Guard against that in the compose Layout Inspector (If693)

Bug Fixes

• PlatformImeOptions is now a concrete class instead of an interface. (If40a4)
• Fixed extra downstream recompositions caused by LocalSoftwareKeyboardController and LocalTextInputService being provided new values every time a root recomposed. (I42190, b/310510985)

Version 1.6.0-beta02

November 29, 2023

androidx.compose.ui:ui-*:1.6.0-beta02 is released. Version 1.6.0-beta02 contains these commits.

Version 1.6.0-beta01

November 15, 2023

androidx.compose.ui:ui-*:1.6.0-beta01 is released. Version 1.6.0-beta01 contains these commits.

API Changes

• The DragAndDropTarget modifier now takes in the receiving DragAndDropTarget explicitly and has a lambda to opt into a drag and drop session. There are now two factory functions for a DragAndDropModifierNode. One for receiving transfers and one for transferring data (I69481)
• Updated maximumFlingVelocity to be represented as Float. Updated documentation to be more clear about the maximumFlingVelocity unity. (I8adc7)
• onDragAndDropStart in the DragAndDropModifierNode factory has been renamed to acceptDragAndDropTransfer.acceptsDragAndDropTransfer has been added to the dragAndDropTarget Modifier to accept from a drag and drop session. This lambda returns a viable DragAndDropTarget if interested in a drag and drop session. Other lambdas for processing drag events have been replaced by this. a DragAndDropTarget factory function has been added to receive from drag and drop sessions (Iebf3a)

• Removed DragAndDropInfo as a type DragAndDropModifierNode.drag now takes parameters for the transferData, decoration size and drag decoration DrawScope lambda

  DragAndDropTarget has methods for particular drag and drop events instead of being a single abstract method

  onDragAndDropEvent in the factory function for a DragAndDropModifierNode has been renamed to onDragAndDropStart to better communicate that the DragAndDropTarget provided is valid for a given drag and drop session only

  The DragAndDropEventType has been removed (I645b1)

• Renamed PlatformTextInputModifierNode.runTextInputSession to establishTextInputSession. (I03cd0)

• Improves traversable node api names to make them more understandable. (Ia4474)

• Replace OriginalText by TextSubstitution. (Ifa5a8)

• Renamed PlatformTextInputModifierNode.textInputSession to runTextInputSession. (Ie9c6b)

• The children of SubcomposeLayout (and layouts like LazyColumn based on it) which are retained to be reused in future are considered deactivated. New assertIsDeactivated() test API was introduced to test such nodes. The rests of the test apis will filter out deactivated nodes by default. (I2ef84, b/187188981)

• Removed FocusDirection.In and FocusDirection.Out use FocusDirection.Enter and FocusDirection.Exit instead (I2f660)

• Material SwipeToReveal APIs (for Cards and Chips) now rely on a slot based API (as recommended by Compose) instead of data class based instances to create those slots. This is a breaking change, please see the demo and sample code for examples on how to use the new API. (Ia8943)

• FontStyle(int) constructor is deprecated, use FontStyle.Normal or FontStyle.Italic instead. (I66610)

• Renamed FontScalable interface to FontScaling (Ie804a)

Bug Fixes

• SoftwareKeyboardController.show() will no longer show the software keyboard if no text editor is focused. (I2165a, b/301477279)
• Hardware key Up events for keys that haven't received a Down event in the same Compose View will now be ignored. (Ib37b4, b/305518328)
• Add renderer support for Sweep Gradient in ArcLine. (I4d5bb)
• Implement equals and hashcode for PageSize.Fixed. (Ie3ede, b/300134276)
• Fix binary compatibility issue with Window Inset change (Iee695)
• Remove material core layer for Material3 Chip/Button as the microbenchmarks show better performance without it. (I55555)
• TestDispatchers passed as the effectContext to Compose tests will now be used to create the test and frame clocks. (Ia7178)

Version 1.6.0-alpha08

October 18, 2023

androidx.compose.ui:ui-*:1.6.0-alpha08 is released. Version 1.6.0-alpha08 contains these commits.

API Changes

• Modifier.dragAndDrawSource has had the onDrawDragShadow lambda renamed to drawDragDecoration and DragAndDropInfo has had the size parameter renamed to dragDecorationSize. (Id0e30, b/303904810)
• Introduce SemanticsNodeInteraction.isDisplayed() and SemanticsNodeInteraction.isNotDisplayed() to check if a matched node is visible or not without also asserting on it. (I2c196, b/302100809)
• Introduced a special Unspecified value for TextAlign, TextDirection, Hyphens and LineBreak fields of the ParagraphTextStyle to replace null. Because these classes are inline classes, by replacing nullable with the Unspecified, we avoid primitive type boxing. Constructors, getters and other methods in TextStyle and Paragraph style were updated to accept the mentioned parameters as non-null types. (I4197e, b/299490814)
• Add GoogleFont overload for reading a GoogleFont from XML. (If8f59)
• Made LoremIpsum PreviewParameterProvider an open class. (I41bf5, b/266918816, b/300116360)

Bug Fixes

• FontFamilyResolver now uses Dispatchers.Main for cache management coroutines. (Ie8dd9)
• AndroidViewBinding now synchronously removes Fragment instances inflated by including a FragmentContainerView in your layout as part of its onRelease by using commitNow (instead of the commit it was using previously), thus fixing issues with Live Edit's method with replacing the composition upon changes. (I58fbf)

Version 1.6.0-alpha07

October 4, 2023

androidx.compose.ui:ui-*:1.6.0-alpha07 is released. Version 1.6.0-alpha07 contains these commits.

API Changes

• Introduced PlatformTextInputMethodTestOverride for writing tests for custom text editors. (Id159b)
• Adds dragAndDropSource Modifier for starting drag and drop sessions, and dragAndDropTarget Modifier for receiving from drag and drop sessions. (Ib7828, b/286038936)
• Added ColorList and ColorSet collections that avoid allocations. (I744bd)
• Added DisableNonLinearFontScalingInCompose temporary flag to disable non-linear font scaling. Set DisableNonLinearFontScalingInCompose = true in your tests if you need time to clean them up. This flag will be removed in Compose 1.6.0-beta01. (Ic9486)

Bug Fixes

• Optimized XML vector drawables parsing. (Ibb015)

Version 1.6.0-alpha06

September 20, 2023

androidx.compose.ui:ui-*:1.6.0-alpha06 is released. Version 1.6.0-alpha06 contains these commits.

API Changes

• Additional optimizations to Material icons. (I3e08d)
• Adds ability to traverse up/down modifier tree to find similar nodes. (I2d234)
• Added onRestoreFailed() callback to the focusRestorer() modifier (Ie1d43)
• Added androidx annotations to various graphics APIs to specify ColorInt, FloatRange, IntRange, Size and more. (Id65c8, b/290950582)
• Add showSystemUi=true to PreviewScreenSizes definition (Ib61d3)

Behavior Changes

• Compose now uses non-linear font scaling for better readability and accessibility. When font scale > 100% in system settings, small text will increase in size normally, but already-large text will only increase a little bit. Also, line heights defined in SP will automatically adjust to stay proportional to the 100% scale intended height. See the Font Scaling Best Practices for more info. (I11518)

Version 1.6.0-alpha05

September 6, 2023

androidx.compose.ui:ui-*:1.6.0-alpha05 is released. Version 1.6.0-alpha05 contains these commits.

API Changes

• Enable content capture in AndroidComposeViewAccessibilityDelegateCompat. (Ib2969)
• Fling velocities in View components like ScrollView and RecyclerView are capped at ViewConfiguration.ScaledMaximumFlingVelocity. Compose now contains its own version of maximumFlingVelocity which now applies to Draggable. (Ibf974)
• Adds initial scaffolding to support platform drag and drop APIs. (If84ce)
• Add deviceId into RotaryScrollEvent (Iba3bf)
• Updated ui-tooling Devices API to include newer devices (Ib25b4)

Version 1.6.0-alpha04

August 23, 2023

androidx.compose.ui:ui-*:1.6.0-alpha04 is released. Version 1.6.0-alpha04 contains these commits.

API Changes

• Added a method to deactivate ReusableComposition, removing observations but keeping nodes in place. The deactivated composition can be activated again by calling setContent. (Ib7f31)
• Add ReusableComposition interface for managing lifecycle and reuse of subcompositions. (I812d1, b/252846775)
• Modifier.focusGroup has been promoted to stable APIs. (I7ffa3)
• Added androidx annotations to various graphics APIs to specify ColorInt, FloatRange, IntRange, Size and more. (I70487, b/290950582)
• Updated ColorFilter API to have concrete subclass types for improved inspectability of parameters. (I5fe29)
• Introduce wear-tooling-preview library to list valid wear devices that can be used for UI previews (Ib036e)
• Created the FontScalable interface to handle the font scaling part of the Density interface. (I2cf3f)

Version 1.6.0-alpha03

August 9, 2023

androidx.compose.ui:ui-*:1.6.0-alpha03 is released. Version 1.6.0-alpha03 contains these commits.

API Changes

• New type of enter/exit transition that scales the content based on the size of the animating container during enter & exit animation. LookaheadScope Composable fun and interface are now stable. (Ifb2ce)
• Added support for configuring privateImeOptions (Idb772)

Bug Fixes

• PopupPositionProvider.calculatePosition will now automatically update the popup's position when state read in the calculation is changed. (I676a1, b/292257547)
• Fixed text fields showing keyboard and being editable when readOnly is true. Also fixed the keyboard not showing when readOnly is changed from true to false while focused. (I34a19, b/246909589)
• Expanded application of global assertions in UI testing. (I1f90d)

Version 1.6.0-alpha02

July 26, 2023

androidx.compose.ui:ui-*:1.6.0-alpha02 is released. Version 1.6.0-alpha02 contains these commits.

API Changes

• Added a service locator interface that can be implemented by implementors of Composition that allows an implementation of Composition that delegates to another composition delegate service lookups to the original Composition. This should not be called directy and is used to enable creating experimental APIs in the runtime that can be found from wrapped versions of the composer such as the UI module does. (I296b9)
• Completely redesigned PlatformTextInput* API. (I6c93a, b/274661182, b/267235947, b/277380808)
• SoftwareKeyboardController and LocalSoftwareKeyboardController are no longer experimental. LocalSoftwareKeyboardController is also now a proper CompositionLocal. (I4c364)
• LookaheadLayout and LookaheadLayoutScope have been deprecated for a few releases and are now removed. The replacement APIs are LookaheadScope that can work with any Layout. (I12ac3)
• Added SemanticsNodeInteraction.requestFocus as a more convenient and discoverable way to request focus in tests. (Ie8722)
• Add experimental APIs for registering global assertions, for use by testing frameworks in the future. (I12d77)

Bug Fixes

• AndroidView's update callback's first invocation will now be defered until the view is attached, instead of running when the composition that introduces the AndroidView is applied. This fixes a bug where the update callback wouldn't be invalidated if a state it read was changed immediately by an effect. (Ie9438, b/291094055)

Version 1.6.0-alpha01

June 21, 2023

androidx.compose.ui:ui-*:1.6.0-alpha01 is released. Version 1.6.0-alpha01 contains these commits.

New Features

• Support lookahead in LazyList. This allows LazyList in the lookahead pass to bypass any animation (e.g. item placement animation, AnimatedVisibility, etc) and to calculate the lookahead size and position for all children. After the lookahead pass, children of LazyList could animate independently to the reality as seen in the lookahead pass.

Behavior Change: includeFontPadding is now false by default in Compose

includeFontPadding is now false by default (21d806) in Compose.

includeFontPadding is a legacy attribute that controls whether or not to include extra padding on top of the first line and last line of the text to accommodate any characters that may extend above or below the text baselines.

Updating this Compose version will modify how all texts render in your UI by removing the extra padding on top of the first line and last line of every text you display.

Depending on your UI requirements and the font metrics you’re using, the changes should be minimal. However you might encounter blockers such as: - Broken screenshot tests. Fix the UI if required, and regenerate the golden images. - Text is slightly misaligned. Remove any custom negative paddings or add padding if required.

You can opt-in to includeFontPadding by using PlatformTextStyle for each text:

Text(
 text = myText,
 style = TextStyle(
   lineHeight = 2.5.em,
   platformStyle = PlatformTextStyle(
     includeFontPadding = true/false
   )
   /* … */
  )
)

You can opt-in to includeFontPadding for all your texts by configuring your Material styles. Note that parameter names will vary between M2 and M3.

val Typography = Typography(
   body1 = TextStyle(
       fontFamily =    /* … */,
       fontSize =    /* … */,
       platformStyle = PlatformTextStyle(
           includeFontPadding = false
       )
   /* … */
   )
)

MaterialTheme(
   typography = Typography,
   /* … */
)

You can find more about Compose includeFontPadding in developer documentation and this blog post.

If you experience issues/bugs connected with this change, file a bug using the issue tracker.

API Changes

• Support InputConnection#requestCursorUpdates (I0c69b)
• Added FocusRequester.saveFocusedChild and FocusRequester.restoreFocusedChild (Ic557e, b/272302679, b/275157318)
• Add ResourceResolutionException type to wrap throwables thrown when attempting to load bitmap assets with a description of the asset path that failed to load. (I19f44, b/230166331, b/278424788)
• Optimized accessibility for performance and memory allocations. (Iede48)
• Added semantics properties and actions to support text translation. (I4a6bc)
• New property in IntrinsincMeasureScope and its implementations (e.g. MeasureScope) to indicate whether the current measure pass is a lookahead pass. (I7a812)
• Updated DrawScope api to introduce the ability to retarget rendering into a different canvas with alternative density/layoutdirection and size.
• Updated DrawContext to support configuration of density and layout direction as well as making the canvas configurable. (Ie1f9b, b/225408150)
• Added Paragraph#fillBoundingBoxes to calculate character bounding boxes. (If30ee)
• Added a set of common MultiPreviews (Ia5a27)

Bug Fixes

• Added FocusTargetModifierNode interface that can be used to create a custom FocusTarget. (I9790e)
• Renamed the fallback* parameters on the TextMeasurer constructor to default*. (I940a5)
• Renamed SemanticsPropertyReceiver.performImeAction to onImeAction and SemanticsActions.PerformImeAction to OnImeAction. (I8e841)
• Adds Wheel to differentiate a mouse scroll from a drag in nested scrolling (specifically, in NestedScrollConnection). (Ie57e4)
• Added asComposePaint API to replace toComposePaint as the returned object wraps the original android.graphics.Paint (I22b4c)
• Deprecate SemanticsProperties.imeAction and replace with a new parameter to SemanticsActions.performImeAction. (I4a587)
• Added support for selection by mouse. Touch based selection will expand by word, and shrink by character. (Ic0c6c, b/180639271)
• Paragraph methods that used to throw AssertionError for out of bounds offsets now throw IllegalArgumentException as MultiParagraph does. (I549d3, b/243338896)

Version 1.5

Version 1.5.4

October 18, 2023

androidx.compose.ui:ui-*:1.5.4 is released. Version 1.5.4 contains these commits.

Version 1.5.3

October 4, 2023

androidx.compose.ui:ui-*:1.5.3 is released. Version 1.5.3 contains these commits.

Bug Fixes

• (b/301209788) TextField would sometimes incorrectly apply previous commands when focusing and inputting Korean input, leading to lost characters.

Version 1.5.2

September 27, 2023

androidx.compose.ui:ui-*:1.5.2 is released. Version 1.5.2 contains these commits.

Bug Fixes

• Added workaround for crashes when accessibility scroll API was accessed from background thread.
• Fix unattached nodes being added to the semantics tree.

Version 1.5.1

September 6, 2023

androidx.compose.ui:ui-*:1.5.1 is released. Version 1.5.1 contains these commits.

Bug Fixes

• Fixed text fields showing keyboard and being editable when readOnly is true. Also fixed the keyboard not showing when readOnly is changed from true to false while focused. (I34a19, b/246909589)

Version 1.5.0

August 9, 2023

androidx.compose.ui:ui-*:1.5.0 is released. Version 1.5.0 contains these commits.

Version 1.5.0-rc01

July 26, 2023

androidx.compose.ui:ui-*:1.5.0-rc01 is released. Version 1.5.0-rc01 contains these commits.

Bug Fixes

• Fixed crash happening when SubcomposeLayout is used inside movableContentOf().

Version 1.5.0-beta03

June 28, 2023

androidx.compose.ui:ui-*:1.5.0-beta03 is released. Version 1.5.0-beta03 contains these commits.

Bug Fixes

• Added FocusTargetModifierNode interface that can be used to create a custom FocusTarget. (Ifb1d6)
• Fixed an issue with Dialog and Popup composables that could result in the child window not resizing as expected when usePlatformDefaultWidth=true. (I112ee)

Version 1.5.0-beta02

June 7, 2023

androidx.compose.ui:ui-*:1.5.0-beta02 is released. Version 1.5.0-beta02 contains these commits.

API Changes

• Added asComposePaint API to enable consumption of an android.graphics.Paint instance to be used in Compose

Bug Fixes

• Added asComposePaint API to replace toComposePaint as the returned object wraps the original android.graphics.Paint (I22b4c)

Version 1.5.0-beta01

May 24, 2023

androidx.compose.ui:ui-*:1.5.0-beta01 is released. Version 1.5.0-beta01 contains these commits.

API Changes

• Removed allocations in recomposition, color animations, and AndroidComposeView (Ib2bfa)
• Adds helper fun CacheDrawModifierNode() to allow delegation (Icf8f9)
• Introducing isLookingAhead property, accessible from MeasureScope, to observe lookahead results and influence main pass if desired. (Ibf4c3)
• New semantics property traversalIndex, a float used to reorder nodes in TalkBack traversal (lower values come before). (I9a81b, b/186443263)
• Renaming the Semantics property isContainer to isTraversalGroup (I121f6)
• ColorProducer now has an operator fun invoke instead of produce (I4a9a2)
• Add Path transform API to apply translation/scale/rotation transformations to path objects. (I23434, b/233772232)
• ColorProducer's method is called produce. (I78bde)
• Rename toFrameworkColorSpace to toAndroidColorSpace (I4f547)
• Rename ColorLambda to ColorProducer. (I73b1a)
• Introduce APIs to convert between Android and Compose colorspace types. (Ie7db4, b/279979665)
• Added a color parameter to BasicText to allow efficiently animating or setting text color. (Iffd88, b/246961787)
• Renamed TextRange.constrain to TextRange.coerceIn. (I31be2)
• Added optimized TextStyle.merge(...) with full parameter list. (Iad234, b/246961787)
• Stabilized many Text APIs that include Brush, DrawStyle, TextMotion, DrawScope.drawText, Paragraph.paint(Brush), MultiParagraph.paint(Brush). (I2f740, b/261581564, b/261581931, b/261561245)
• PlatformTextStyle.includeFontPadding is undeprecated. Our original intent was to remove the field, however the feedback shows that developers need this configuration option. Therefore removing deprecation from the field (I98e96, b/277703184)
• Added public TextRange.constrain method. (I97912)
• UrlAnnotations in AnnotatedStrings can now be opened via accessibility services like TalkBack. (If4d82, b/253292081)
• Added the InsertTextAtCursor semantics action for text fields. (I11ed5)
• LineHeightStyle.Alignment(topRatio) constructor is promoted to stable API. (I79c32, b/261565383)
• TextMeasurer and related APIs are no longer experimental. (I74647, b/261581753)
• Added the PerformImeAction semantics action to invoke the IME action on text editor nodes. (Ic606f, b/269633506)
• PlatformTextInput APIs are no longer experimental for Android. (I668eb)
• value parameter name for Enum.valueOf changed (Ia9b89)
• more thrown exceptions from enum valueOf (I818fe)
• Introduced new low-level PlatformTextInputAdapter API for building custom text input implementations that talk directly to platform APIs. (I58df4)
• Added BlendMode parameter to DrawScope.drawText, Paragraph.paint, and MultiParagraph.paint methods to support different blending algorithms when drawing text on Canvas. (I57508)
• Rename Font.MaximumAsyncTimeout to Font.MaximumAsyncTimeoutMillis. Rename only. (I07af5)
• Updated DPI values of @Preview reference devices (Id6151, b/254528382)
• Add brush, alpha parameters to BasicText to allow efficiently animating or setting text brush.
• Define box-free lambda types for Float, Double, Long, Int, Short in :ui:ui-unit (I6f18d, b/246961787)

Bug Fixes

• Removed multiple allocations in pointer velocity tracking (I26bae)
• Reduced allocations in layout and pointer input management (I5333a)
• Optimize Vector memory usage and first-frames rendering (I2f3c6)
• Removed allocations when drawing lines and points with Canvas (I9f535)
• Add docs for AndroidFont.fontVariationSettings (I7d9e2)

External Contribution

• Improved performance and reduce allocations in Vector APIs (I906cb)

Version 1.5.0-alpha04

May 10, 2023

androidx.compose.ui:ui-*:1.5.0-alpha04 is released. Version 1.5.0-alpha04 contains these commits.

New Features

• Modifier.Node Delegation Improvements Added an enhanced ability to delegate to other Modifier.Node instances from a DelegatingNode. This can be done with the delegate and undelegate APIs. Prior to this change, every API from the delegating node needed to be delegated explicitly to the delegated node. After this change, node interfaces will get delegated implicitly unless the DelegatingNode is explicitly overriding them. (67352bc)

API Changes

• Introduce NestedScrollModifierNode, a NestedScroll Modifier.Node that can be delegated to. (I69513)
• Added onReset and onRelease parameters to the AndroidViewBinding composable, mirroring the AndroidView composable and enabling support for View reuse with ViewBinding. (I00b1e, b/276802519)
• Updated Compose Path API to support rewind operations to support usecases of frequent Path manipulation with faster re-use. (I7b797)
• Added optimized TextStyle.merge(...) with full parameter list. (Iad234, b/246961787)
• Stabilized many Text APIs that include Brush, DrawStyle, TextMotion, DrawScope.drawText, Paragraph.paint(Brush), MultiParagraph.paint(Brush). (I2f740, b/261581564, b/261581931, b/261561245)
• PlatformTextStyle.includeFontPadding is undeprecated. Our original intent was to remove the field, however the feedback shows that developers need this configuration option. Therefore removing deprecation from the field (I98e96, b/277703184)

Bug Fixes

• Fixed regression where keyboard wasn't showing for text fields inside dialogs not created by the Dialog composable. (I82551, b/262140644)

Version 1.5.0-alpha03

April 19, 2023

androidx.compose.ui:ui-*:1.5.0-alpha03 is released. Version 1.5.0-alpha03 contains these commits.

New Features

• New default behavior for SubcomposeLayout in LookaheadScope: SubcomposeLayouts that don’t have conditional slots (e.g. TabRow, Scaffold, BoxWithConstraints, etc) now work nicely with lookahead animations.

API Changes

• New default intermediateMeasurePolicy that reuses measure policy from lookahead pass allows SubcomposeLayout subtypes without conditional slots such as Scaffold, TabRow, and BoxWithConstraints to work with lookahead by default. (Id84c8)
• The recomposer created for an Android window will now only block calls to withFrameNanos instead of all composition when it receives an ON_STOP notification. This means windows associated with stopped activites will continue to recompose for data changes but the animations, or any other caller of withFrameNanos, will block. (Id9e7f, b/240975572)
• Changes motionEventSpy to stable. (Ic5ec4, b/261560988)
• Added public TextRange.constrain method. (I97912)
• PlatformTextStyle.includeFontPadding is no longer deprecated to encourage developers to use this compatibility API to switch and test setting includeFontPadding false. (I98e96, b/277703184)

Version 1.5.0-alpha02

April 5, 2023

androidx.compose.ui:ui-*:1.5.0-alpha02 is released. Version 1.5.0-alpha02 contains these commits.

API Changes

• New SubcomposeLayout API that takes an additional intermediate measure policy for handling measure/layout logic during lookahead-based animations. (I017d3)
• PointerInput is now lazy and uses Modifier.Node for better performance (read about the minor behavior change). (15dab9)
• Changes experimental APIs to stable with Key events. (I9c7d8, b/261566839, b/261567368)
• Changes experimental APIs to stable in PointerInputChange. (I1b543, b/261560988, b/261565762, b/261565749)
• Adds a way to instantiate a SuspendingPointerInputModifierNode for more complex Modifier.Node implementations. (Ic4933)
• UrlAnnotations in AnnotatedStrings can now be opened via accessibility services like TalkBack. (If4d82, b/253292081)
• Added an API to intercept hardware keys before they are sent to the soft keyboard (I4f4c6, b/186800395)
• Added the InsertTextAtCursor semantics action for text fields. (I11ed5)
• Text-related test actions (e.g. performTextInput) will now request focus directly, using the semantics action, instead of clicking on the field. (I6ed05)

Bug Fixes

• Text test actions now require text fields to be enabled. (Iab328)

Version 1.5.0-alpha01

March 22, 2023

androidx.compose.ui:ui-*:1.5.0-alpha01 is released. Version 1.5.0-alpha01 contains these commits.

API Changes

• Modifier.intermediateLayout now doesn't require an explicit LookaheadScope. The measure block in intermediateLayout has IntermediateMeasureScope as receiver, which provides convenient CoroutineScope, LookaheadScope and MeasureScope.(Ibe2e5)
• LookaheadLayout has been replaced by LookaheadScope, which is no longer a Layout. This allows chid content in a LookaheadScope to be directly controlled by parent's MeasurePolicy. (Ibe2e5)
• Adds Modifier.Node#coroutineScope to allow Modifier.Nodes to launch coroutines. (I76ef9)
• Allow Modifier.Nodes to read CompositionLocals by implementing the CompositionLocalConsumerModifierNode interface. (Ib44df)
• Propagation of @Deprecated class to property. (I882d1)

Version 1.4

Version 1.4.3

May 3, 2023

androidx.compose.ui:ui-*:1.4.3 is released. Version 1.4.3 contains these commits.

Bug Fixes

• Fixed an issue where AndroidView may not be laid out correctly when used with certain Modifiers. (I4dc77, b/274797771)
• Fixed a bug in 2D Focus Search that affected DropDown Menus (b/276811828)
• Fixed a bug in custom focus enter/exit properties that only ran the enter/exit block the first time the lambda was invoked (b/277234245)
• Fixed a regression in the focus system that caused a crash while reading focusProperties. (b/271324781, b/274897776)

Version 1.4.2

April 19, 2023

androidx.compose.ui:ui-*:1.4.2 is released. Version 1.4.2 contains these commits.

Bug Fixes

• Fixed an issue where AndroidView would not reuse its modifiers correctly, potentially resulting in unexpected behavior and crashes. (Ib67ee, b/275919849)
• Fixed regression where keyboard wasn't showing for text fields inside dialogs not created by the Dialog composable (I82551, b/262140644)

Version 1.4.1

April 5, 2023

androidx.compose.ui:ui-*:1.4.1 is released. Version 1.4.1 contains these commits.

Bug Fixes

• Fixes an issue with ParentDataModifier not affecting AndroidView (b/274797771)

Version 1.4.0

March 22, 2023

androidx.compose.ui:ui-*:1.4.0 is released. Version 1.4.0 contains these commits.

Important changes since 1.3.0

• Added a new PinnableContainer API that allows lazy list items to be pinned, so that they are not disposed when they are scrolled out of bounds. For example, Modifier.focusable() uses this mechanism to pin the currently focused item. (Ib8881, b/259274257, b/195049010)
• The focus system is rewritten using the new experimental Modifier.Node APIs. (I7f4d7, b/247708726, b/255352203, b/253043481, b/247716483, b/254529934, b/251840112, b/251859987, b/257141589)
• Added in IsContainer semantics property on Surfaces. This property will be used in a later change that determines traversal order based on the semantic meaning of elements such as surfaces. (I63379)
• Added a new accessibility role DropdownList. This can be used to replicate TalkBack's behavior when focusing android.widget.Spinner. (I177e5, b/236159001)
• You can now use PlatformTextStyle(emojiSupportMatch) to optionally disable emoji support processing for a single Paragraph. (Ia7100, b/139326806)
• Android Compose UI tests will now run layout passes for each frame when executing frames to get to idle (e.g. via waitForIdle). This may affect tests that assert on individual frames of layout animations. (I8ea08, b/222093277)
• Added experimental TextMotion to TextStyle to define Text either to be Static(default) or Animated. Use TextMotion.Animated if Text is going to be scaled, translated, or rotated via animation. (I24dd7)

Version 1.4.0-rc01

March 8, 2023

androidx.compose.ui:ui-*:1.4.0-rc01 is released. Version 1.4.0-rc01 contains these commits.

API Changes

• Added an overload of AndroidView composable function, which accepts the onReset param. It allows View instances to be reused when their node in the composition is discarded and reused in a compatible way. This is especially useful for LazyRows and LazyColumns of Views. (I3f10d, b/230099236)
• Introduced new low-level PlatformTextInputAdapter API for building custom text input implementations that talk directly to platform APIs. (I58df4)

Bug Fixes

• BasicTextField's SetText semantics action will now update the text buffer using the same code path as IME updates and the testing functions (e.g. performTextReplacement).
• Text testing functions performTextClearance, performTextReplacement, and performTextSelection now use SemanticsActions. (I0807d, b/269633168, b/269624358)

Version 1.4.0-beta02

February 22, 2023

androidx.compose.ui:ui-*:1.4.0-beta02 is released. Version 1.4.0-beta02 contains these commits.

API Changes

• Removed the modifierElementOf() API. Please extend from ModifierNodeElement directly instead. (I2256b)
• Added a new Modifier.Node.onReset() callback allowing you to reset some local state to properly handle the case when the Layout will be reused (for example as an item of LazyColumn). Fixed FocusTargetModifierNode to properly reset the focused state. (I65495, b/265201972)
• Added BlendMode parameter to DrawScope.drawText, Paragraph.paint, and MultiParagraph.paint methods to support different blending algorithms when drawing text on Canvas. (I57508)

Bug Fixes

• Accessibility focus order algorithm improved, for example top/bottom bars are more often read first/last respectively (74e9c5)

Version 1.4.0-beta01

February 8, 2023

androidx.compose.ui:ui-*:1.4.0-beta01 is released. Version 1.4.0-beta01 contains these commits.

API Changes

• PinnableContainer.PinnedHandle.unpin() was renamed to release() (I4667a)
• Added waitUntilNodeCount, waitUntilAtLeastOneExists, waitUntilExactlyOneExists and waitUntilDoesNotExist as experimental API to ComposeTestRule, extending the waitUntil API to accept any matcher and any count of nodes. See ComposeTestRule for further documentation. (Ifa1b9, b/226934294)
• Rename Font.MaximumAsyncTimeout to Font.MaximumAsyncTimeoutMillis. (I07af5)
• Removed GoogleFont.Provider.AllFontsListUri and linked to it in ktdoc instead. (I16f29)

Bug Fixes

• Add docs for AndroidFont.fontVariationSettings (I7d9e2)

Version 1.4.0-alpha05

January 25, 2023

androidx.compose.ui:ui-*:1.4.0-alpha05 is released. Version 1.4.0-alpha05 contains these commits.

API Changes

• Introduced new experimental overloads for the runComposeUiTest function and create*ComposeRule functions that accept CoroutineContext parameters. The context will be used for the test composition and any LaunchedEffect and rememberCoroutineScope() calls in the composition. (I10614, b/265177763)
• Add a new API to track 1 dimensional velocity (If5a82)
• FocusRequester is now marked as @Stable. (I580ee)
• Remove an experimental annotation from the DialogProperties constructor that takes a usePlatformDefaultWidth parameter. (Ic4048)
• Added function to calculation position and tangent at a distance on a path - with PathMeasure.getPosition() and PathMeasure.getTangent() (I3b47c)
• Removed accidentally exposed public setter on PlatformParagraphStyle. (I07f47)
• More type/nullability of inline/deprecated-hidden functions (I24f91)
• Add AnnotatedString.hasStringAnnotations to query for annotations with zero-allocations. (I94dfe, b/246960758)
• Added a new overload for TextMeasurer.measure function which takes in a String as text. (I47b2d, b/242705342)
• LineBreak and Hyphens APIs in TextStyle are graduated to stable. (Ic1e1d)

External Contribution

• notifyFocusedRect methods in TextInputSession and TextInputService are not deprecated again. (I23a04, b/262648050)

Version 1.4.0-alpha04

January 11, 2023

androidx.compose.ui:ui-*:1.4.0-alpha04 is released. Version 1.4.0-alpha04 contains these commits.

New Features

• Added a new PinnableContainer API that allows lazy list items to be pinned, so that they are not disposed when they are scrolled out of bounds. For example, Modifier.focusable() uses this mechanism to pin the currently focused item. (Ib8881, b/259274257, b/195049010)
• The focus system is rewritten using the new experimental Modifier.Node APIs. (I7f4d7, b/247708726, b/255352203, b/253043481, b/247716483, b/254529934, b/251840112, b/251859987, b/257141589)
• Added in IsContainer semantics property on Surfaces. This property will be used in a later change that determines traversal order based on the semantic meaning of elements such as surfaces. (I63379)
• Added new accessibility role DropdownList. This can be used to replicate TalkBack's behavior when focusing android.widget.Spinner. (I177e5, b/236159001)
• You can now use PlatformTextStyle(emojiSupportMatch) to optionally disable emoji support processing for a single Paragraph. (Ia7100, b/139326806)
• Android Compose UI tests will now run layout passes for each frame when executing frames to get to idle (e.g. via waitForIdle). This may affect tests that assert on individual frames of layout animations. (I8ea08, b/222093277)
• Added experimental TextMotion to TextStyle to define Text either to be Static(default) or Animated. Use TextMotion.Animated if Text is going to be scaled, translated, or rotated via animation. (I24dd7)

API Changes

• Replaced maxSize: IntSize argument in drawText with size: Size to be inline with other DrawScope functions. size is set to Size.Unspecified by default which should not change the previous default behavior. (Icd27d)
• Removed deprecated experimental font constructor. (I8a724, b/261435386)
• The ui tooling data class Group now has a field, isInline, that indicates if the group is for a call to an inline composable function. If isInline is true then the call is to an inline composable function. However, the value might be false for calls to inline composable functions that are from modules that are compiled with a version of the compose compiler plugin that doesn't generate the inline function information. (Idb846)
• Graduated a number of previously experimental APIs to stable
• Rotary Scroll Event API is now stable (I42ad3, b/261561229)
• FontVariation API is now stable (I8779f, b/241016309)
• All Font() constructors are now stable API (I5948b, b/261435386)
• DeviceFontFamilyName is now stable (I8b640, b/261435386)
• AndroidFont constructor with variationSettings is now a stable API, and can be used to create new types of font descriptors. (I5adcc, b/261565807)
• createFontFamilyResolver API is now stable. This can be used to catch uncaught exceptions during async font loading. (Ibb481, b/261435386)
• Font.loadingStrategy API is now stable. (I5937c, b/261435386)
• GoogleFont API is now stable. (Ic90b0, b/261435386)
• TextUnit(float, TextUnitType) is now stable API. (I90c84, b/261561612)
• pluralStringResource is now stable API. (I09849, b/261439703)

Version 1.4.0-alpha03

December 7, 2022

androidx.compose.ui:ui-*:1.4.0-alpha03 is released. Version 1.4.0-alpha03 contains these commits.

API Changes

• Removing ExperimentalComposeUiApi from PointerIcon (I23af8)
• Introduce Page accessibility actions: PageUp, PageDown, PageLeft, PageRight. Note that these are only available from API 29. (Ida4ab)
• Updated rememberNestedScrollConnection parameter view from root view to host view. (Ia5200)
• Added an Modifier API to query ancestors scroll info. (I2ba9d, b/203141462)
• Used in Clickable to correctly delay press interactions, when gestures could become scroll events.
• Fixed Clickables not correctly delaying ripples, when used inside an Scrollable ViewGroup.
• Updated Drawers and Sheets to correctly delay presses in case gestures can become scroll events.
• Renamed CompositingStrategy.Always to Offscreen to indicate that the graphicsLayer will always be rendered into an intermediate buffer (I47dc1)
• Layout overload with multiple content slots is now stable (I10566, b/248294649)
• Added experimental new APIs PerfettoTrace.record {} and PerfettoTraceRule to capture Perfetto traces (also known as System Traces) as part of a test, to inspect test behavior and performance. (I3ba16)
• In UI tests using a Compose rule, continuations resumed during withFrameNanos callbacks will not be dispatched until after all frame callbacks have finished running. This matches the behavior of compose when running normally. However, tests that rely on the old behavior may fail. This should only affect code that calls withFrameNanos or withFrameMillis directly, and has logic outside of callback passed to those functions that may need to be moved inside the callbacks. See the animation test changes in this CL for examples.
• Added optional onPerformTraversals: (Long) -> Unit parameter to TestMonotonicFrameClock constructor and factory function to run code after withFrameNanos callbacks but before resuming callers' coroutines. (Idb413, b/254115946, b/222093277, b/255802670)
• Added EmojiCompat to Compose (Ibf6f9, b/139326806)
• Added new wallpaper parameter to @Preview for dynamic colour support (I9f512)

Bug Fixes

• Snapshot apply notifications are now sent after the Recomposer finishes applying changes. (Iad6c0, b/222093277)
• Introduced changes in captureToImage to allow for capturing multi window screenshots. This is useful for screenshot tests that use compose PopUps. (I169c5)

Dependency Updates

• Compose UI and Compose Material now depend on Lifecycle 2.5.1. (I05ab0, b/258038814)

Version 1.4.0-alpha02

November 9, 2022

androidx.compose.ui:ui-*:1.4.0-alpha02 is released. Version 1.4.0-alpha02 contains these commits.

API Changes

• Updated GraphicsLayerScope to expose the current size of the graphicsLayer. This is useful for computing graphicsLayer transformations as a function of the Composable size. (If8c43,b/181387080)
• Introduced CompositingStrategy to determine when to leverage an offscreen compositing layer for rendering of graphicsLayer content. Auto maintains the default behavior which internally leverages a layer if alpha is applied or a RenderEffect/Overscroll. Always will always introduce an offscreen buffer where ModulateAlpha will avoid leveraging an offscreen buffer and instead will modulate each of the recorded drawing instructions within the graphicsLayer. ModulateAlpha usage will still leverage an offscreen buffer for RenderEffect/Overscroll usages (I25e82, b/256382834)
• invalidateSubtree() was added to Modifier.Node to allow invalidating entire hierarchies for layout and drawing. (I4bd90)
• Promote rememberNestedScrollInteropConnection to stable. Introduced the ability to pass a root view to rememberNestedScrollInteropConnection. This can help the custom view better react to scrolling constraints, specially in non-standard views (e.g. ModalBottomSheetDialog). (I9e107)
• Added ObserverNode interface that can be used by Modifier.Node implementations that need to be notified when a value that they had previously read has changed (I5728b, b/247716483)
• Added a new constructor to Paint that accepts a native android.graphics.Paint. Also added an extension function toComposePaint() that converts an existing native Paint object to Compose Paint. (Ica91b)
• Add new FontFamily.Resolver.resolveAsTypeface for use on Android. (I8950b)
• Add ToolingState to allow tooling to change internal states of Composable (Ie6614)
• Refactor tooling to have better support for new added animations (I8677b)
• Added minLines parameter into material and material3 Text, TextField and OutlinedTextField which allows setting the minimum height of the component in terms of number of lines (I4af1d)

Version 1.4.0-alpha01

October 24, 2022

androidx.compose.ui:ui-*:1.4.0-alpha01 is released. Version 1.4.0-alpha01 contains these commits.

API Changes

• A new method, awaitEachGesture(), for gesture detectors was added. It operates similar to forEachGesture(), but the loop over gestures operates entirely within the AwaitPointerEventScope so events can't be lost between iterations.
• forEachGesture() has been deprecated in favor of awaitEachGesture() because it allows events to be lost between gestures. (Iffc3f, b/251260206)
• Deprecating recycling of acccessibility objects in androidx. We've found performance changes to be negligible in even the oldest supported versions. (I0a961)
• Added DrawStyle as an Experimental attribute to TextStyle and SpanStyle to enable drawing outlined text. (If24b8, b/155421273)
• AnnotatedString.Builder now implements kotlin.text.Appendable. (I1a061, b/231030444)
• AnnotatedString.Builder now has an append(AnnotatedString, start: Int, end: Int) method to append a substring of an AnnotatedString and the intersecting styles.
• Added DrawStyle parameter to Paragraph and MultiParagraph paint functions that enables drawing outlined text. (Ic8102, b/155421273)

External Contribution

• Thanks for vighnesh for adding TV Devices to Previews (Ie15cd)

Version 1.3

Version 1.3.3

January 11, 2023

androidx.compose.ui:ui-*:1.3.3 is released. Version 1.3.3 contains these commits.

Bug Fixes

• Fix for a crash sometimes happening on Android 9 when Activity is saving the state of the Compose View. (I0b755, b/260322832)

Version 1.3.2

December 7, 2022

androidx.compose.ui:ui-*:1.3.2 is released. Version 1.3.2 contains these commits.

Bug Fixes

• Updated to use Profobuf 3.21.8, which avoids a security alert in protobuf-javalite:3.19.4 (CVE-2022-3171) (b/255545055)

Version 1.3.1

November 9, 2022

androidx.compose.ui:ui-*:1.3.1 is released. Version 1.3.1 contains these commits.

Version 1.3.0

October 24, 2022

androidx.compose.ui:ui-*:1.3.0 is released. Version 1.3.0 contains these commits.

Important changes since 1.2.0

• New experimental API suite LookaheadLayout (enabling previously impossible animation behaviors)
• New experimental API suite Modifier.Node (higher-performance alternative to Modifier.composed)
• Improved window insets support.
• Focus support for D-Pads and hardware keyboard in LazyLists.
• Maximum supported elevation in dialogs and popups has been reduced to 8dp (behavior breaking change for some customized design systems – rationale in beta01 release notes)
• Many minor, nonbreaking API improvements
• Many bugfixes and performance improvements

Version 1.3.0-rc01

October 5, 2022

androidx.compose.ui:ui-*:1.3.0-rc01 is released. Version 1.3.0-rc01 contains these commits.

API Changes

• Added new experimental API Hyphens to support automatic hyphenation in Text (Iaa869)

Bug Fixes

• DeviceFontFamilyName fonts will not configure wght and ital variation settings by default, instead using platform setting for loaded Typeface. (Ia7a6d, b/246989332)
• Fixed LazyColumn memory leak - onModifierLocalsUpdated was not being called with the default value when modifiers were reused (b/230168389)

Version 1.3.0-beta03

September 21, 2022

androidx.compose.ui:ui-*:1.3.0-beta03 is released. Version 1.3.0-beta03 contains these commits.

API Changes

• Add options to customize line breaking in Text. (I86907)
• Changed size:IntSize argument with constraints: Constraints in TextMeasurer.measure method to support minimum width constraints. (I37530, b/242707525)

Bug Fixes

• AndroidX Activity's BackHandler API now works within a Dialog composable. (I35342)

Version 1.3.0-beta02

September 7, 2022

androidx.compose.ui:ui-*:1.3.0-beta02 is released. Version 1.3.0-beta02 contains these commits.

API Changes

• Added an experimental overload for Layout which accepts a list of multiple composable content lambdas, which allows to threat measurables put into different content lambdas differently (Ic1b4e)

Changes to experimental Focus APIs:

• FocusDirection.In and FocusDirection.Out are deprecated and replaced by FocusDirection.Enter and FocusDirection.Exit. (Ia4262, b/183746982)
• Added two new focus properties enter and exit to specify a custom behavior for FocusManager.moveFocus(Enter) and FocusManager.moveFocus(Exit). (I5f3f9, b/183746982)
• You can now use FocusRequester.Cancel to cancel a focus move. FocusRequester.Cancel can be used in any of the following focus properties: up, down, left, right, next, previous, start, end, enter and exit. (Ib300f)

Version 1.3.0-beta01

August 24, 2022

androidx.compose.ui:ui-*:1.3.0-beta01 is released. Version 1.3.0-beta01 contains these commits.

Modifier Node Refactor

The layer which handles Modifier/Modifier.Element instances and coordinates their behavior on LayoutNodes has been majorly refactored. As it stands this was a refactor which did not affect the public API of any of the many modifiers in Compose, and can be viewed as an implementation-only change. Despite that, this is an important change for various reasons. (Ie4313)

Change Summary

The added experimental Modifier.Node APIs provide an abstraction that allows for state to be maintained on an instance that will be retained with the lifecycle of the layout node, and will be allocated per-layout-node and per-usage of the corresponding Modifier.Element that produced it.

Broadly speaking, this abstraction provides an alternative mechanism to produce stateful modifiers without relying on the mechanics of the Modifier.composed API.

Risk

This change is strictly binary compatible with prior releases, and is intended to be backwards compatible in terms of observable behavior as much as practical and reasonable. That said, there are few subsystems of compose this refactor did not touch, and it is likely that behavior has changed in ways that were not covered by our tests and have not yet been found and fixed.

Please upgrade to this release with caution. If you believe this has broken something for you, please let us know.

Experimental APIs

Various experimental APIs have been added, all relating to the new concept of a "Modifier Node". Modifier.Node’s are created as a result of

• fun modifierElementOf(…): Modifier
• abstract class ModifierNodeElement
• abstract class Modifier.Node
• abstract class DelegatingNode
• interface LayoutModifierNode
• interface DrawModifierNode
• interface SemanticsNode
• interface PointerInputNode
• interface ModifierLocalNode
• interface ParentDataModifierNode
• interface LayoutAwareModifierNode
• interface GlobalPositionAwareModifierNode
• interface IntermediateLayoutModifierNode

Behavior breaking change

Maximum supported elevation in dialogs and popups has been reduced to 8dp.

The maximum supported elevation for Compose dialogs and popups has been reduced from 30dp to 8dp. This change affects both material and ui custom dialogs and popups. This change is made to mitigate an accessibility bug on Android versions below S, and to ensure that accessibility services within those windows are able to interact with the content inside the dialog or popup.

You will only be impacted by this change if you are creating a custom dialog or popup implementation with an elevation set to levels higher than 8dp. Consider lowering the elevation of your dialog or popup. If you need to opt-out from this new behavior, consider forking your own dialog or popup with the desired elevation set. This is not recommended, as accessibility might be negatively impacted and it is on the developer to ensure the bottom part of the dialog or popup is interactable and readable by accessibility services.

API Changes

• Fixed an issue where painterResource wouldn't update on configuration changes (I58e73, b/228862715)
• rememberTextMeasurer no longer takes FontFamily.Resolver, Density, or LayoutDirection parameters. Please use the TextMeasurer constructor to provide custom values for these parameters. (Ia1da3)
• Added DialogProperties.decorFitsSystemWindows property to allow Dialogs to support WindowInsets. (I57742, b/229378542)
• Moved font constructors back to original kotlin file to retain binary compatibility. No change from last stable release. (Ieb2f3)
• Removed unnecessary operator from several equals definitions - this has no effect. (I6c309)
• FontVariation.Setting is a sealed interface, to allow future clamping APIs. (I11021, b/143703328)
• Add CompositionGroup.findParameters to SlotTree.kt. This allows tools to retrieve parameters for a CompositionGroup without having to parse the entire slot table. (I124fe)

Version 1.3.0-alpha03

August 10, 2022

androidx.compose.ui:ui-*:1.3.0-alpha03 is released. Version 1.3.0-alpha03 contains these commits.

API Changes

• LayoutCoordinates.findRootCoordinates() is now public (I7fa37, b/204723384)
• Added experimental API to get the LayoutCoordinates in the PlacementScope. This lets developers know where the current layout is to place children relative to its position. (I5482b, b/238632578)
• Added LayoutCoordinates.transformFrom to get the Matrix transformation from one LayoutCoordinates to another. (Ic5ab1, b/238632578)
• Deprecated SemanticsModifier.id and moved the semantics id to LayoutInfo.semanticsId instead. (Iac808, b/203559524)
• Resource Fonts now support setting font variation settings (API 26+). (I900dd, b/143703328)
• Variable font support in DeviceFontFamilyNameFont (Ic1279, b/143703328)
• Font constructors now accept a list of FontVariation.Setting for configuring variable fonts on O+ devices. (I11a9d, b/143703328)
• Add FontVariation API for defining and using variable fonts. (I3c40c, b/143703328)
• LineHeightStyle.Alignment constructor is now public (experimental) (I4bbbe, b/235876330)
• Paragraph is now expect|actual and defined for Android and Desktop. (Id387e, b/239962983)
• Interface Paragraph is now sealed interface Paragarph. There is no use case for subclassing paragraph, and we recommend reaching out if this change impacts you. (If5247, b/239962983)
• Removed experimental annotation from PlatformTextStyle and LineHeightStyle. (I64bef)
• Deprecate TextInputService.show|hideSoftwareKeyboard. Please use SoftwareKeyboardController instead in app code and TextInputSession in IME-management code. (I14e4c, b/183448615)
• Add new API for existing animation types (I26179)

Bug Fixes

• Added @RequiresPermission to APIs that require granting the POST_NOTIFICATIONS permission on SDK 33 and above. (Ie542e, b/238790278)

Version 1.3.0-alpha02

July 27, 2022

androidx.compose.ui:ui-*:1.3.0-alpha02 is released. Version 1.3.0-alpha02 contains these commits.

API Changes

• Added a new property PointerInputChange#pressure to retrieve the pressure. (I45a5e, b/205164819)
• Added rememberTextMeasurer to easily create and remember TextMeasurer instances in composition. (I8d66e)
• Rect, RoundRect, and MutableRect now support the Kotlin in syntax for calling the contains function. (Ie42b0, b/238642990)
• Remove unnecessary functions from KeyInjectionScope, as they can be easily implemented with simpler parts of the API. The functions that have been removed include pressKeys, keysDown and keysUp. (I81d77)
• Refactored constant and parameter names in KeyInjectionScope to include the suffix 'Millis' where the units of said constants and parameters are milliseconds. (Iabef5)
• Added toStringForLog() method to EditCommand to help troubleshoot text editing issues. (I53354, b/228862731)
• Added drawText extension function on DrawScope to provide a way to draw multi-styled text on composables and modifiers that operate on a DrawScope like Canvas and drawBehind. (I16a62, b/190787898)
• Introduce a new experimental API called TextMeasurer that enables arbitrary text layout computation that creates identical results to BasicText, independent from Compose runtime. (I17101)
• Add mapTree to SlotTree.kt. This allows tools to inspect the SlotTree without making an in memory copy first like asTree does. For the Layout Inspector this gives a performance improvement of about a factor 10. (I5e113)
• Changed Compose Preview to be stored in binary output files, in order to allow developers to write and reuse MultiPreview annotations from libraries. (I85699, b/233511976)

Bug Fixes

• When adding InputEventChange events to Velocity Tracker we will consider now deltas instead of positions, this will guarantee the velocity is correctly calculated for all cases even if the target element moves (Icea9d, b/216582726, b/223440806, b/227709803)
• Fix NPE caused by AnnotatedString.toUpperCase when annotations are present. (I0aca2, b/210899140)

Version 1.3.0-alpha01

June 29, 2022

androidx.compose.ui:ui-*:1.3.0-alpha01 is released. Version 1.3.0-alpha01 contains these commits.

API Changes

• New LookaheadLayout that supports a lookahead pass before the actual measure/layout. This allows a pre-calculation of the layout when it changes, while permitting the post-lookahead measure/layout to use the pre-calculated size/position to animate the size and positions towards the target. SubcomposeLayouts are not yet supported, but will be in an upcoming release. (I477f5)
• Add optional alpha parameter to Brush flavor of TextStyle and SpanStyle to modify opacity of the whole Text. (Ic2fac, b/234117635)
• Introduced the UrlAnnotation annotation type and associated methods to support TalkBack link support in AnnotatedStrings. (I1c754, b/231495122)
• Moving utility functionality to runtime (I4f729)

Bug Fixes

• TextLayoutResult.getLineForOffset does not throw. (Idc5d6, b/235876324)

External Contribution

• Added a new API WindowInfo.keyboardModifiers to observe its state within composable functions or via snapshotFlow (Icdb8a)

Version 1.2

Version 1.2.1

August 10, 2022

androidx.compose.ui:ui-*:1.2.1 is released. Version 1.2.1 contains these commits.

Bug Fixes

• Fixed nullpointer in the inspector (b/237987764)
• Fixed class cast exception during remember in the inspector (b/235526153)

Version 1.2.0

July 27, 2022

androidx.compose.ui:ui-*:1.2.0 is released. Version 1.2.0 contains these commits.

Important changes since 1.1.0

• Improvements in focus traversal:

  • Focus-driven-scrolling of Lazy lists now works, using the new BeyondBoundsLayout core API
  • New behavior customization APIs in FocusOrder and FocusProperties
  • Improved behavior with physical keyboard or TV remote

• New APIs for:

  • Window insets
  • Core primitives for gesture-driven, infinite and layout animations
  • GraphicsLayer capabilities, including RenderEffect

• Many bugfixes and performance improvements

Version 1.2.0-rc03

June 29, 2022

androidx.compose.ui:ui-*:1.2.0-rc03 is released. Version 1.2.0-rc03 contains these commits.

• No changes since 1.2.0-rc02.

Version 1.2.0-rc02

June 22, 2022

androidx.compose.ui:ui-*:1.2.0-rc02 is released. Version 1.2.0-rc02 contains these commits.

Version 1.2.0-rc01

June 15, 2022

androidx.compose.ui:ui-*:1.2.0-rc01 is released. Version 1.2.0-rc01 contains these commits.

API Changes

• Interfaces in compose libraries are now built using jdk8 default interface methods (I5bcf1)
• Added higher-order functions to KeyInjectionScope for injecting key presses while other keys are held down or toggled on. These functions include withKeysDown, withKeysToggled etc. Also added properties for checking if a particular meta key is down, for example, isCtrlDown to check if either control key is depressed. Refer to KeyInjectionScope for documentation on each function. (I9f6cd, b/229831515)
• An experimental OverscrollEffect has been introduced to allow for custom overscroll effects, alongside the Modifier.scrollable overloads that accept it.
• Experimental LocalOverScrollConfiguration has been moved from foundation.gesture to foundation package and renamed to LocalOverscrollConfiguration (If19fb, b/204650733)
• Rename runComposeUiTestWithoutActivity {} to runEmptyComposeUiTest {}, which aligns it with createEmptyComposeRule() (I6fed7)

Version 1.2.0-beta03

June 1, 2022

androidx.compose.ui:ui-*:1.2.0-beta03 is released. Version 1.2.0-beta03 contains these commits.

API Changes

• Added pressKeyTimes as well as isCapsLockOn and friends to KeyInjectionScope. Additionally, the API now supports mouse and keyboard combined injection patterns such as clicking a mouse button with a meta key held down. (I4c8da, b/229831515)
• Added experimental support for injecting key events. Use performKeyInput to send key events, or send them through the key property of MultiModalInjectionScope during a multi modal input gesture with performMultiModalInput. See KeyInjectionScope for documentation of the API. (Ic5000, b/229831515)
• Add new GoogleFont.Provider.AllFontsListUri for retrieving the canonical internet source of Google Fonts supported by Android.
• Improve error messages rethrown when GoogleFonts fail to load in compose. (I0416c)

Bug Fixes

• When adding InputEventChange events to Velocity Tracker we will consider now deltas instead of positions, this will guarantee the velocity is correctly calculated for all cases even if the target element moves (I51ec3, b/216582726, b/223440806, b/227709803)
• The Show Layout Bounds setting will now be applied for composables immediately after toggling it from the quick settings tile, without having to leave and re-enter the activity. (I843d5, b/225937688)
• Accessibility string lookup does not trigger font loading. Previously, it would attempt to load fonts for StyleSpans, which lead to crashes if FontFamily.Resolver had been overwritten. (I4609d)
• Pressing the forward delete key when the cursor is at the end of a text field will no longer crash.
• DeleteSurroundingTextCommand and DeleteSurroundingTextInCodePointsCommand now require their constructor arguments to be non-negative. (Ica8e6, b/199919707)

Version 1.2.0-beta02

May 18, 2022

androidx.compose.ui:ui-*:1.2.0-beta02 is released. Version 1.2.0-beta02 contains these commits.

API Changes

• Reusing functionality in other preview types (I19f39)

Bug Fixes

• ViewCompositionStrategy.DisposeOnDetachedFromWindowIfNotInPoolingContainer has been renamed to DisposeOnDetachedFromWindowOrReleasedFromPool to better reflect that when disposals do occur, rather than simply when they do not occur. (If15ca)

Version 1.2.0-beta01

May 11, 2022

androidx.compose.ui:ui-*:1.2.0-beta01 is released. Version 1.2.0-beta01 contains these commits.

New Features

• This is the first beta release of 1.2!

API Changes

• Added experimental BeyondBoundsInterval that can be used by custom implementations of LazyList when they layout items beyond visible bounds (Ifabfb, b/184670295)
• Keyed versions of Modifier.composed are now stable API (Ie65e4, b/229988420)
• Simplified the rememberNestedScrollConnection API to use composition locals to acquire the current view information (I67ca7)
• The @ComposableTarget annotation and annotations marked by @ComposableTargetMarker can now be used at the file scope using the @file prefix. Using a target annotation at the file scope will cause the compiler to assume all composable functions in the file are intended to be target the associated applier. For example, using @file:UiComposable declares that all @Composable functions target the Compose UI applier. A function that needs to target another applier must explicitly supply the target marker annotation for the desired applier. (I40804)

• Introduced new experimental, platform independent, test API: an interface ComposeUiTest and a fun runComposeUiTest(block: ComposeUiTest.() -> Unit), that can be used to run Compose Ui tests without the need for a TestRule. To run a test without a ComposeTestRule, pass the test as a lambda to runComposeUiTest, and use the methods and members in the receiver scope ComposeUiTest, which are the same ones as in ComposeContentTestRule.

  The Android specific interface AndroidComposeUiTest and fun runAndroidComposeUiTest(block: AndroidComposeUiTest.() -> Unit) are added to provide access to the underlying Activity, similar to AndroidComposeTestRule. For even more control, you can instantiate a class AndroidComposeUiTestEnvironment yourself.

  The Desktop implementation is the class DesktopComposeUiTest, but no Desktop specific run functions are offered at the moment.

  Migrating a test from a ComposeTestRule to ComposeUiTest can be done like this (Android example). From:

  @RunWith(AndroidJUnit4::class)
  class MyTest {
      @get:Rule val rule = createComposeRule()
      @Test
      fun test() {
          rule.setContent {
              Text("Hello Compose!")
          }
          rule.onNodeWithText("Hello Compose!").assertExists()
      }
  }
  

  To:

  @RunWith(AndroidJUnit4::class)
  class MyTest {
      @Test
      @OptIn(ExperimentalTestApi::class)
      fun test() = runComposeUiTest {
          setContent {
              Text("Hello Compose!")
          }
          onNodeWithText("Hello Compose!").assertExists()
      }
  }
  

• For now, ComposeContentTestRule and ComposeTestRule don't extend from ComposeUiTest, which means extension functions on ComposeUiTest can't be called yet on the TestRule interface. When ComposeUiTest graduates to stable API, ComposeContentTestRule and ComposeTestRule will be changed to extend from ComposeUiTest. (Ib4e90)

• LineHeightBehavior is renamed as LineHeightStyle

• LineVerticalAlignment is renamed as LineHeightStyle.Alignment

• Renames LineHeightTrim is renamed as LineHeightStyle.Trim

• Default constructor values from LineHeightStyle is removed (I582bf, b/181155707)

• Added Brush to TextStyle and SpanStyle to provide a way to draw text with gradient coloring. (I53869, b/187839528)

• trimFirstLineTop, trimLastLineBottom attributes of LineHeightBehavior changed into a single enum: LineHeightTrim. LineHeightTrim have values of 4 states defined by two booleans: FirstLineTop, LastLineBottom, Both and None (Ifc6a5, b/181155707)

• Added LineHeightBehavior to the TextStyle and ParagraphStyle. LineHeightBehavior controls whether line height is applied to the top of the first line and to the bottom of the last line. It also defines the alignment of line in the space provided by TextStyle(lineHeight).

  For example it is possible to get a behavior similar to what CSS defines via LineHeightBehavior(alignment = LineVerticalAlignment.Center, trimFirstLineTop=false, trimLastLineBottom = false).

• trimFirstLineTop, trimLastLineBottom configurations works correctly only when includeFontPadding is false. (I97332, b/181155707)

• PlatformParagraphStyle.lerp and PlatformSpanStyle.lerp functions are changed to be top level functions (I9a268)

Bug Fixes

• PointerInputChange::copy documentation now correctly states that it is a shallow copy. (I182f5)
• Support ellipsis when height is limited and doesn't fit all text lines (Ie528c, b/168720622)
• Turned on default includeFontPadding. It is possible to turn off the includeFontPadding using TextStyle.platformTextStyle attribute. In the near future we will change the default behavior however until that time this allows us to better integrate line height improvements (aosp/2058653) and solve TextField clipping issues. (I01423, b/171394808)

External Contribution

• MouseInjectionScope.scroll(delta = someDelta) is now inverted on Android if we scroll vertically (if someDelta is positive, it will scroll downward) (Ifb697, b/224992993)

Version 1.2.0-alpha08

April 20, 2022

androidx.compose.ui:ui-*:1.2.0-alpha08 is released. Version 1.2.0-alpha08 contains these commits.

API Changes

• The pluralStringResource functions were marked as experimental in order to allow evolution to support better internationalization in the future. (If24e4)
• Paragraph and MultiParagraph are now accepting Constraints parameter. Passing Constraints.maxHeight is a no-op at the moment but will allow to do some calculation in the future, like ellipsizing based on the height. (I6afee, b/168720622)
• SubcomposeSlotReusePolicy.getSlotsToRetain() now accepts a custom MutableSet-like class which doesn't allow adding new items in it. (Icd314)
• PointerIcon is now a @Stable interface (I9dafe)
• Partial consumption (down OR position) has been deprecated in PointerInputChange. You can use consume() to consume the change completely. You can use isConsumed to determine whether or not someone else has previously consumed the change.
• PointerInputChange::copy() now always makes a shallow copy. It means that copies of PointerInputChange will be consumed once one of the copies is consumed. If you want to create an unbound PointerInputChange, use constructor instead. (Ie6be4, b/225669674)
• Enable Nested Scroll interop between Compose and View in the direction Compose > View. This means that a compose parent will be able to receive nested scroll deltas from a nested scroll view. (If7949, b/174348612)
• New SemanticsProperty testTagsAsResourceId, which can be used to make Compose conform with UIAutomator tests designed for the View system. (I39c20)
• Display all available weights for systems fonts on Android when using FontFamily.SansSerif. This will use fallback font names like sans-serif-medium internally on API 21-28. This is a behavior change as previously only weights 400 and 700 were supported on API 21-28. (I380fe, b/156048036, b/226441992)
• Paragraph and Multiparagraph instructors reordered positional arguments to before optional arguments. (Idafaa)
• AndroidFont now takes typefaceLoader as a constructor parameter. (I2c971)

Version 1.2.0-alpha07

April 6, 2022

androidx.compose.ui:ui-*:1.2.0-alpha07 is released. Version 1.2.0-alpha07 contains these commits.

API Changes

• New function Snapshot.withoutReadObservation { ... } was added. It allows users to run the passed lambda without subscribing to the changes of the state values read during this block. You could find it useful in use cases when you want to benefit from the snapshot based thread safe write/reads, but want to be able to read the value without causing unnecessary recomposition or remeasure. (I9f365, b/214054486)
• The consumeWindowInsets extension property of ComposeView allows developers to disable consumption of Android WindowInsets. This allows separate ComposeViews in the hierarchy to each apply WindowInsets without interfering with each other. (I0ef08, b/220943142)
• Added KeyboardType.Decimal as an alternative to Keyboard.Number for specifically including decimal separator in IME. (Iec4c8, b/209835363)
• PointerEventType.Scroll and PointerEvent.scrollDelta are stable APIs now (I574c5, b/225669674)
• Enable Nested Scroll interop between View and Compose for cooperating View classes. This means compose is now able to dispatch scroll deltas to a (cooperating) View parent. (I5d1ac, b/174348612)
• Updated FontFamily.Resolver to integrate System-wide bold text accessibility setting (I6c1e7)
• Font(AssetManager, String, ...) is deprecated, replaced with Font(String, AssetManager, ...). This is an experimental API. (I1c7a4)
• Add new font descriptor Font(DeviceFontFamilyName) to optionally lookup system-installed fonts during font fallback chains. (I30468, b/219754572)
• Added temporary compatibility configuration for includeFontPadding in TextStyle/ParagraphStyle. includeFontPadding can be changed via TextStyle(platformStyle = PlatformTextStyle(includeFontPadding = true/false)). This is a temporary configuration option to enable migration and will be removed. (If47be, b/171394808)
• Add GoogleFont.Provider.isAvailableOnDevice extension for debugging help. (I64e31)
• Add GoogleFont.Provider constructor for use with @ArrayRes (Ic5ee1, b/225984280)
• Compose GoogleFont is now called Font(GoogleFont), API remains stable otherwise. (I125f2)

Bug Fixes

• Added lint check to material/Scaffold to ensure that the inner padding is being used (Ifb111)

Version 1.2.0-alpha06

March 23, 2022

androidx.compose.ui:ui-*:1.2.0-alpha06 is released. Version 1.2.0-alpha06 contains these commits.

API Changes

• Added RequestFocus semantics action to request focus on the focusable target. (I17b71)
• Updated parsing of vector drawables to support auto mirroring to flip the content of a VectorPainter if the current layout direction is RTL. (I79cd9, b/185760237)

• Updated shadow/ambient colors to be trailing parameters of Modifier.graphicsLayer for API compatibility (I3f864, b/160665122)

• Added default implementations to shadow/ambient color on GraphicsLayerScope to ensure non-breaking API changes

• Added event time to RSB events (Ief8ae)

• FocusOrder has now been merged into FocusProperties and focusProperties() now has all the capabilities of focusOrder(). FocusOrder and focusOrder() have been deprecated. focusOrder() that accepts a focusRequester should be replaced with a focusRequester() modifier in combination with focusProperties(). This allows the modifiers to have a stronger separation of concerns. (I601b7)

• Upgrading both RecyclerView and Compose will now result in much better scrolling performance for RecyclerViews with Compose views as children.

• Add ViewCompositionStrategy.Default as a means of retrieving the built-in default strategy

• Add ViewCompositionStrategy.DisposeOnDetachedFromWindowIfNotInPoolingContainer, which is the new default strategy and properly handles pooling containers such as RecyclerView. (If7282)

• Added support for annotating annotations classes with @Preview as a first step for adding the Multipreview feature. Such annotations could be used to annotate Composable methods or other annotation classes, which could then be considered as indirectly annotated with the given @Preview. (I12eff)

• Reference devices added to the Devices list for @Preview (I071c9)

Bug Fixes

• Updated Vector graphics APIs to use the proper composable annotation @VectorComposable instead of @UiComposable (I942bc)
• Remove crossinline from AnnotatedString.Builder.withStyle (If84d5)

External Contribution

• compose-ui: Add ambientShadowColor and spotShadowColor properties to GraphicsLayerScope (I1ba1a, b/160665122)
• Plural resources are now supported via the pluralStringResource functions. (Ib2f23, b/191375123)

Version 1.2.0-alpha05

March 9, 2022

androidx.compose.ui:ui-*:1.2.0-alpha05 is released. Version 1.2.0-alpha05 contains these commits.

API Changes

• TextToolbar now takes lambda arguments instead of ActionCallback. (Ib2eb9, b/197950089)
• Updated nullability in core and appcompat to match Tiramisu DP2 (I0cbb7)
• Measured interface now exposes parentData property (I3313f)
• Modifier.onPlaced and the OnPlacedModifier interface are now stable. (Ib5482)
• Hooray! Compose animation now supports 'Animator duration scale' setting from Developer Options. (I5a4fc, b/161675988)
• Added a BeyondBoundsLayout modifier local (If8b51, b/184670295)
• Text: includeFontPadding is now turned off by default. The clipping issues as a result of includeFontPadding=false is handled and no clipping should occur for tall scripts. (I31c84, b/171394808)

Bug Fixes

• ComposeContentTestRule.setContent will now throw an IllegalStateException if you try to set content when there already is content. (I888a5, b/199631334)
• Fix crash caused by clipboard content while reading from clipboard on Android. (I06020, b/197769306)
• Improve RSB scrolling samples. (I6a596)

External Contribution

• Updated to use Kotlinx coroutines 1.6.0 (I3366d)

Version 1.2.0-alpha04

February 23, 2022

androidx.compose.ui:ui-*:1.2.0-alpha04 is released. Version 1.2.0-alpha04 contains these commits.

API Changes

• Added ComposableTarget, ComposableTargetMarker and ComposableOpenTarget that allows compile time reporting of when a composable function is called targeting an applier it was not designed to use.

  In most cases the annotations can be inferred by the compose compiler plugin so using these annotation directly should be rare . The cases that cannot be inferred include creating and using a custom applier, abstract composable functions (such as interface methods), fields or global variables that are composable lambdas (local variables and parameters are inferred), or when using ComposeNode or a related composable functions.

  For custom appliers the composable functions that calls ComposeNode or ReusableComposeNode need to add a ComposableTarget annotation for the function and any composable lambda parameter types. It is recommended, however, to create an annotation that is annotated with ComposableTargetMarker and then the marked annotation be used instead of ComposableTarget directly. A composable annotation marked with ComposableTargetMarker is equivalent to a ComposbleTarget with the fully qualified name of the attribute class as the applier parameter. For an example of using ComposableTargetMarker see anroidx.compose.ui.UiComposable. (I38f11)

• Font(resId, ...) now takes loadingStrategy on stable API. (Ief3d2)

• FontLoadingStrategy is now stable API. (I1ee35, b/174162090)

• Support async font loading in Text (I77057, b/214587005)

• Add bridge API for converting custom Font.ResourceLoader into FontFamily.Resolver. (Ia0060)

Bug Fixes

• Provided FontFamily.Resolver are passed to subcompositions such as Popup.
• Provided Font.ResourceLoader are passed to subcompositions such as Popup. (I48fa5)

Version 1.2.0-alpha03

February 9, 2022

androidx.compose.ui:ui-*:1.2.0-alpha03 is released. Version 1.2.0-alpha03 contains these commits.

API Changes

• notifyFocusedRect methods in TextInputSession and TextInputService are now deprecated and won't be called. Use BringIntoViewRequester instead. (Ia4302, b/192043120, b/216842427, b/178211874)
• Introduced destroyDisplayListData method on RenderNode stub class (I1e659, b/216660268)
• Added a new api which allows to premeasure children of SubcomposeLayout you precomposed. (I857ea)

• Added movableContentOf which converts a composable lambda into a lambda that moves it state, and corresponding nodes, to any new location it is called. When the previous call leaves the composition the state is temporarily preserved and if a new call to the lambda enters the composition then the state, and associated nodes, are moved to the location of the new call. If no new call is added the state is removed permanently and remember observers are notified.

  If a movableContentOf lambda is called multiple times in the same composition, new state and nodes are created for each call and, as calls leave the composition and new calls enter, the state is moved from the first leaving calls to the entering calls in the order they are called. All state not claimed by new calls is removed permanently. (Ib4850)

• FontFamilyResolver is now available via LocalFontFamilyResolver.current

• Added createFontFamilyResolver(context) and createFontFamilyResolver(context, coroutineScope) to create new FontFamily resolvers outside of compose usage.

• Paragraph and MultiParagraph now take FontFamily.Resolver

• TextLayoutResult.layoutInput.fontFamilyResolver now contains the resolver used for this layout, deprecated TextLayoutResult.layoutInput.resourceLoader as it is no longer used. (Id5a45, b/174162090)

• Support for async and optional font loading, with fallback behavior. This path is used by Text and TextField, and exposed through FontFamilyResolver

• Support for preloading fonts via FontFamilyResolver.preload

• FontFamilyResolver.setAsyncLoadContext allows setting the global coroutine context used for loading async fonts. (I87fe8, b/174162090)

• Added AndroidFont, a new low-level API for providing new types of font resource descriptors on Android. For example, loading fonts from an app-specific backend, optionally locating pre-installed fonts on-device, or loading a font from a resource not provided by the current Font factories.

• Expanded Font.ResourceLoaded API to support optional and async font loading. It is not recommended that application developers use this API directly. To add new types of fonts see AndroidFont.

• Font.AndroidResourceLoader extension function allows construction of a Font.ResourceLoader when outside of composition.

• Added loadingStrategy parameter to resource-based fonts, to allow async loading when resource font references downloadable fonts XML. (Ie5aea, b/174162090)

• Typeface(FontFamily) constructor is deprecated. This was previously used to preload fonts, which may take up to 10 seconds for downloadable fonts. With downloadable fonts, this call may block for 10 seconds. Instead use FontFamilyResolver.preload.

• fontResource(FontFamily): Typeface is deprecated. This was previously used to preload fonts, which may take up to 10 seconds for downloadable fonts. Instead use FontFamilyResolver.preload (If8e7c, b/174162090)

• SubcomposeLayoutState constructor accepting maxSlotsToRetainForReuse is now deprecated. Instead there is a new constructor accepting SubcomposeSlotReusePolicy - a new interface allowing more granular control on what slots should be retained for the future reuse. (I52c4d)

• Exposes HSV and HSL function in Color as non-experimental API. The Oklab color space is now public API. (I08fb6, b/180731008)

• Deprecated AndroidComposeTestRule.AndroidComposeStatement, which was not meant to be in public API and didn't do anything for you anyway. (Ibc46b)

• Internal generated kt class rename (Ia0b9e, b/174162090)

• Removed FontLoadingStrategy.values (I42a9d, b/174162090)

• Global font loader is now called FontFamilyResolver. (I4f773, b/174162090)

• Use new font loading system for desktop. (I9ce5c, b/174162090)

• FontFamily.Resolver.resolve returns State<Any> (I4406c, b/174162090)

Bug Fixes

• TextFields will now be kept above the keyboard when they are focused and the keyboard is shown, when the soft input mode is ADJUST_PAN. (I8eaeb, b/190539358, b/192043120)
• Desktop uses composition local for FontFamily.Resolver
• Desktop FontLoader is deprecated
• New createFontFamilyResolver factory on Desktop (I6bbbb, b/174162090)
• The soft keyboard input type no longer flickers when changing focus between text fields. (I1bf50, b/187746439)

Version 1.2.0-alpha02

January 26, 2022

androidx.compose.ui:ui-*:1.2.0-alpha02 is released. Version 1.2.0-alpha02 contains these commits.

API Changes

• Added Modifier.onRotaryScrollEvent() and Modifier.onPreRotaryScrollEvent() for wear devices with a rotating side button (I18bf5, b/210748686)
• Add experimental View.createLifecycleAwareRecomposer extension (I0cde6)

External Contribution

• PointerEvent.scrollDelta.y is now inverted on Android (now it returns 1 instead of -1 if we tilt mouse wheel to the right) (Ia9811)

Version 1.2.0-alpha01

January 12, 2022

androidx.compose.ui:ui-*:1.2.0-alpha01 is released. Version 1.2.0-alpha01 contains these commits.

API Changes

• Deprecated FontFamily.canLoadSynchronously. This property has no semantic meaning. (Ica5ef)
• Added identity field to CompositionData for generating invariant ids in the Layout Inspector. (Ic116e)
• Added Wear OS device ids to Preview devices list (I93232)

Dependency Updates

• Now depends on Kotlin 1.6.10.

Version 1.1

Version 1.1.1

February 23, 2022

androidx.compose.ui:ui-*:1.1.1 is released. Version 1.1.1 contains these commits.

Bug Fixes

• Fix NullPointerException at androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList (aosp/1947059, b/206677462)
• Fix crash caused by clipboard content while reading from clipboard on Android. (I06020, b/197769306)
• Fixed RTL in LazyVerticalGrid (aosp/1931080, b/207510535)

Version 1.1.0

February 9, 2022

androidx.compose.ui:ui-*:1.1.0 is released. Version 1.1.0 contains these commits.

Important changes since 1.0.0

• Stable support for the Android 12 Overscroll effect
• Improvements to touch target sizing
  • Note that, with respect to Compose 1.0, Material components will expand their layout space to meet Material accessibility guidelines for touch target size. For instance, Button touch target will expand to a minimum size of 48x48dp, even if you set the Button's size to be smaller. This aligns Compose Material to the same behavior of Material Design Components, providing consistent behavior if you mix Views and Compose. This change also ensures that when you create your UI using Compose Material components, minimum requirements for touch target accessibility will be met.
• Stable Support for Navigation Rail
• Graduates a number of previously experimental APIs to stable
• Support for newer versions of Kotlin

Version 1.1.0-rc03

January 26, 2022

androidx.compose.ui:ui-*:1.1.0-rc03 is released. Version 1.1.0-rc03 contains these commits.

Bug Fixes

• Updated to support Compose Material 1.1.0-rc03

Version 1.1.0-rc01

December 15, 2021

androidx.compose.ui:ui-*:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.

Bug Fixes

• Fixed a bug that caused missing accessibility scroll actions (I7cbfb)
• SemanticsNodeInteraction.captureToImage() will now also work if HardwareRenderer.isDrawingEnabled() is false, by enabling it for the duration of the call (Idf3d0)

Version 1.1.0-beta04

December 1, 2021

androidx.compose.ui:ui-*:1.1.0-beta04 is released. Version 1.1.0-beta04 contains these commits.

New Features

• Updated to be compatible with Kotlin 1.6.0

API Changes

• Cleaned up nullability in androidx.core.view (I7078a, b/204917439)
• Experimental APIs were added that allow users to consume PointerInputchange as a whole or check whether it was consumed or not. (I2e59d)
• Adds support for mouse scroll wheel events in the UI layer. (Ia14eb, b/198214718)
• Add experimental Modifier.composed overloads that accept keys to compare for equality and qualify for skipping optimizations. (Ice799, b/205851704)
• ComposeNotIdleException now extends from Exception instead of directly from Throwable. Note that this means that catch clauses that were catching Exception might now catch ComposeNotIdleExceptions, where they wouldn't do that previously. (I9c217)

Bug Fixes

• Fix text handles not moving when IME visibility changes. (I25f2e)

Version 1.1.0-beta03

November 17, 2021

androidx.compose.ui:ui-*:1.1.0-beta03 is released. Version 1.1.0-beta03 contains these commits.

API Changes

• Added new modifier Modifier.onPlaced to allow placement change to be observed. Additional changes to child modifier's offset can therefore be made based on the observed placement change. (I558fd)
• Removed InjectionScope.flush() and InjectionScope.dispose(). Flushing of all events and disposing of the scope now happens at the end of the called perform*Input() method like before. (I2bed8)
• Removed MultiModalInjectionScope.Touch and MultiModalInjectionScope.Mouse. In order to inject touch and mouse events for multi-modal gestures, you can now use MultiModalInjectionScope.touch() and MultiModalInjectionScope.mouse(), both of which accept a lambda that has the receiver scope of that modality. (Idde18)

Bug Fixes

• The default value for durationMillis in TouchInjectionScope.swipeWithVelocity is now calculated such that the swipe is feasible. (I19deb)

Version 1.1.0-beta02

November 3, 2021

androidx.compose.ui:ui-*:1.1.0-beta02 is released. Version 1.1.0-beta02 contains these commits.

API Changes

• Added experimental BringIntoView API that lets you send a request to parents so that they scroll to bring an item into view (Ib918d, b/195353459)
• New animation APIs for supporting tooling. Specifically, they allow tooling to inspect the animations & their configurations in a Transitions. (I4116e)

External Contribution

• Added Modifier.pointerHoverIcon (I95f01)

Version 1.1.0-beta01

October 27, 2021

androidx.compose.ui:ui-*:1.1.0-beta01 is released. Version 1.1.0-beta01 contains these commits.

API Changes

• Added experimental BringIntoView API that lets you send a request to parents so that they scroll to bring an item into view (Ib918d, b/195353459)
• New animation APIs for supporting tooling. Specifically, they allow tooling to inspect the animations & their configurations in a Transitions. (I4116e)

Version 1.1.0-alpha06

October 13, 2021

androidx.compose.ui:ui-*:1.1.0-alpha06 is released. Version 1.1.0-alpha06 contains these commits.

API Changes

• Remove ExperimentalComposeUiApi from ViewRootForInspector and LayoutInfo.ownerViewId (I5c2e3)
• A child-less overload for Layout was added, with improved efficiency (Ib0d9a)
• Removed InternalCompilerApi from Composer methods that are required to be called cross-module (I1aa0b)
• SemanticsNodeInteraction.performSemanticsAction now returns the SemanticsNodeInteraction on which the function was called. (I9e5db)
• Added LocalInputModeManager CompositionLocal to detect TouchMode/NonTouchMode. (I6a83c, b/175899786)
• Added viewConfiguration: ViewConfiguration to LayoutInfo to allow consumers get the correct value for things like long press timeout. (I76ca6)
  • Added viewConfiguration: ViewConfiguration to InjectionScope to allow tests to adjust input injection based on things like long press timeout or touch slop.
  • Changed default duration of long press and double tap for both touch and mouse input to be based on the values in InjectionScope.viewConfiguration.
• Implementation of ExposedDropdownMenu based on ExposedDropdownMenuBox with TextField and DropdownMenu inside (If60b2)
• dismissOnOutsideClick was added to PopupProperties, replacing dismissOnClickOutside which was deprecated. The new property receives the click position and the anchor bounds, providing finer control over whether onDismissRequest should be invoked or not. For example, this can be useful to prevent anchor dismissal for touches on the anchor.
  • updateAndroidWindowManagerFlags was added to PopupProperties, offering low-level control over the flags passed by the popup to the Android WindowManager. The parameter of the lambda will be the flags calculated from the PopupProperties values that result in WindowManager flags: e.g. focusable. The result of the lambda will be the final flags which will be passed to the Android WindowManager. By default, updateAndroidWindowManagerFlags will leave the flags calculated from parameters unchanged. This API should be used with caution, only in cases where the popup has very specific behavior requirements. (I6e9f9)
• Recomposer.state has been deprecated and replaced by Recomposer.currentState to change its type to a StateFlow (Ic2ab3, b/197773820)
• Added flush() and dispose() to InjectionScope. Use them when you want to flush all queued up events immediately and when you want to dispose of the scope, respectively. (Ifb73a)
• Added performScrollToNode(matcher: SemanticsMatcher) that scrolls a scrollable container to the content that is matched by the given matcher. (Ic1cb8)
• InjectionScope now implements Density, allowing you to easily convert between px and dp in performTouchInput and friends. (I8fe1f)

Bug Fixes

• AndroidView now propagates LocalLifecycleOwner and LocalSavedStateRegistryOwner to its view via ViewTreeLifecycleOwner and ViewTreeSavedStateRegistryOwner. (I38f96, b/179708470)
• Fix WearOS SwipeToDismissBox sometimes not handling swipes. (I9387e)
• The default time between injected input events has been changed from 10ms to 16ms. This potentially changes the outcome of tests that perform input gestures, like a specific swipe. (I829fd)

Version 1.1.0-alpha05

September 29, 2021

androidx.compose.ui:ui-*:1.1.0-alpha05 is released. Version 1.1.0-alpha05 contains these commits.

API Changes

• Added support for inter-modifier communication (Id5467, b/198826874)
• Added experimental historical pointers to PointerEventChange. (Ic1fd8, b/197553056, b/199921305)
• Added density: Density and layoutDirection: LayoutDirection to LayoutInfo. This allows consumers of LayoutInfo to interpret the dimensions and position exposed in LayoutInfo properly. (I002f1)
• Added experimental support for injecting mouse events. Use performMouseInput to start sending mouse events, or send mouse events through the Mouse property of MultiModalInjectionScope during a multi modal input gesture with performMultiModalInput. See MouseInjectionScope for documentation of the available API. (Iaa4a8, b/190493367)

Bug Fixes

• Fixed accessibility support for scrollables (both lazy and non-lazy) with respect to scrolling (I6cdb0)
• Improved TouchInjectionScope.swipeWithVelocity. It now accepts a wider range of input variables and will suggest changes to the input if a swipe can't be created (I40fbe, b/182477143)

Version 1.1.0-alpha04

September 15, 2021

androidx.compose.ui:ui-*:1.1.0-alpha04 is released. Version 1.1.0-alpha04 contains these commits.

API Changes

• PointerEvent now has a PointerEventType to support hover events. (I091fa)
• Allow children to accept pointer input outside of parent's pointer input bounds. Parents may intercept those calls with a property PointerInputScope.alwaysInterceptChildEvents (I9eae3, b/192479655)
• Deprecated performGesture and GestureScope, which have been replaced by performTouchInput and TouchInjectionScope. (Ia5f3f, b/190493367)
• Added touchBoundsInRoot to SemanticsNode that includes the minimum touch target size so that developers can ensure that touch targets meet accessibility minimums. (I2e14b, b/197751214)
• Redo implementation of inspectable (I927bc, b/191017532)
• Changed parameter name of inspectable to match composed (I3a482, b/191017532)

• Introduced performTouchInput and TouchInjectionScope as a replacement for performTouchInput and TouchInjectionScope, paving the way for other modalities (like mouse).

  TouchInjectionScope has the same methods as GestureScope, with the exception of movePointerTo and movePointerBy, which have been renamed to updatePointerTo and updatePointerBy. All other methods are the same.

  The behavior of TouchInjectionScope is almost identical to GestureScope, with two small details:

  1. When sending a down event while pointers had been moved without sending a move event (in other words, updatePointerTo() has been used, but not move(), and then down() is called), the previous implementation would advance the event time and send a move event before sending the down event. The new implementation still sends the move event, but doesn't advance the event time in this specific scenario.
  2. When sending an up event while pointers had been moved without sending a move event (similar as above), the previous implementation would advance the event time and send a move event before sending the up event. The new implementation does neither: the new positions of the pointers will only be reflected through the up event.

  Finally, TouchInjectionScope introduces a new method currentPosition(pointerId: Int) to get the current position of the given pointer. (If1191, b/190493367)

Bug Fixes

• Allow clip to extend touch target bounds beyond the clip region for minimum touch target purposes. (I43e10, b/171509422)
• Support for stretch overscroll has been added on Android 12 devices. (Iccf3c, b/171682480)

Version 1.1.0-alpha03

September 1, 2021

androidx.compose.ui:ui-*:1.1.0-alpha03 is released. Version 1.1.0-alpha03 contains these commits.

New Features

• Updated Compose 1.1.0-alpha03 to depend on Kotlin 1.5.30. (I74545)

API Changes

• Added Modifier.inspectable for wrapping other modifiers. (I1909b, b/191017532)
• Added BlurredEdgeTreatment API to simplify blur use cases into more commonly used combinations of clip flags and TileModes. Most use cases involve either letting blurred content render outside the original content bounds and blurring regions outside these bounds with transparent black, or clipping content to content bounds sampling the closest edge for blur kernels that extend beyond content bounds. (I6b4b7, b/166927547)
• Added support for RenderEffect in compose desktop. Introduced OffsetEffect as well as the blur modifier as a simple way to introduce blur visual effects to a portion of the composition hierarchy. (I0f6aa, b/166927547)
• Introduced RenderEffect API that can be optionally configured on a Modifier.graphicsLayer to alter the contents of the layer itself. This can be used to blur contents of a composable and child composables within a composition hierarchy. (I47c4d, b/166927547)
• AwaitPointerEventScope now has withTimeout() and withTimeoutOrNull() (I507f0, b/179239764, b/182397793)
• Added minimum touch target size to ViewConfiguration for use in semantics and pointer input to ensure accessibility. (Ie861c)
• Add TileMode.Decal support which is useful in defining edge behavior for blur based RenderEffects. (I7e8ed, b/166927547)
• performScrollToIndex, performScrollToKey, hasScrollToIndexAction and hasScrollToKeyAction are now stable API (I142ae, b/178483889)
• Added test method to get the clipped bounds. (I6b28e)

Bug Fixes

• Removed isBounded method from BlurredEdgeTreatment in favor of explicitly checking if the shape parameter is null. (I85d68)

Version 1.1.0-alpha02

August 18, 2021

androidx.compose.ui:ui-*:1.1.0-alpha02 is released. Version 1.1.0-alpha02 contains these commits.

API Changes

• PointerEvent now has support for reading mouse button state and keyboard modifier state. (I6310c, b/180075467)
• Injected gestures now use the MainTestClock's time as the source of truth for time. The current time for injected events in performGesture will be initialized to the current time of the MainTestClock. (Ifb364, b/192064452)
• Added DpRect(DpOffset, DpSize) constructor (I2cf16, b/194219828)
• Added DpSize class (I7abb1, b/194219828)

Bug Fixes

• Updated Vector graphics xml parsing to support ColorStateLists as root color tint properties on VectorDrawables. (I86915, b/195668138)

Version 1.1.0-alpha01

August 4, 2021

androidx.compose.ui:ui-*:1.1.0-alpha01 is released. Version 1.1.0-alpha01 contains these commits.

API Changes

• RelocationRequester.bringIntoView now accepts a rectangle as a parameter which enables us to bring a part of a composable into view (Ice2c5, b/194330245)
• AnimatedImageVector and the related APIs are now in the new androidx.compose.animation:animation-graphics module. (I60873)
• Added experimental modifier to handle relocation requests. (I65a97, b/178211874)

• Introduced BrushPainter API to support drawing of an arbitrary Brush within a Painter, similar to ColorPainter

  Updated Brush API to have an intrinsic size parameter that is queried within BrushPainter (Ia2752, b/189466433)

• Updated DrawScope#drawImage method that consumes source and destination rects to consume an optional FilterQuality parameter. This is useful for pixel art that is intended to be pixelated when scaled up for pixel based art. Updated BitmapPainter + Image composable to also consume an optional FilterQuality parameter (Ie4fb0, b/180311607)

• Added GestureScope.advanceEventTime method to give more control over the timing of events in a gesture (Ibf3e2)

Bug Fixes

• In order to better support chaining of draw modifiers, make sure the Modifier.paint implementation calls drawsContent. Previously Modifier.paint was expected to a leaf node in the chain of Modifiers, however, by doing so it prevents it from being configured on a composable container (ex. box) or adding additional decorations on top such as Modifier.paint().border(). By having Modifier.paint call drawContent after drawing the contents of the given painter, we have better behavior consistency in behavior with the modifier pattern. (Ibb2a7, b/178201337, b/186213275)
• Dialogs now follow the platform sizing behaviour. Set usePlatformDefaultWidth to false to override this behaviour. (Iffaed, b/192682388)
• Moved InfiniteAnimationPolicy to :compose:ui (I5eb09, b/160602714)
• Scrolling via semantics actions for lazy lists and regular scrolling components is now animated (Id9066, b/190742024)

Version 1.0

Version 1.0.5

November 3, 2021

androidx.compose.ui:ui-*:1.0.5 is released. Version 1.0.5 contains these commits.

Bug Fixes

• Fixed a crash tracking derivedStateOf instances. (aosp/1792247)

Version 1.0.4

October 13, 2021

androidx.compose.ui:ui-*:1.0.4 is released. Version 1.0.4 contains these commits.

Dependency Updates

• Updated to depend on Kotlin 1.5.31

Version 1.0.3

September 29, 2021

androidx.compose.ui:ui-*:1.0.3 is released. Version 1.0.3 contains these commits.

Dependency Updates

• Updated to depend on Kotlin 1.5.30

Version 1.0.2

September 1, 2021

androidx.compose.ui:ui-*:1.0.2 is released. Version 1.0.2 contains these commits.

Updated to support the Compose 1.0.2 release. Compose 1.0.2 is still compatible with Kotlin 1.5.21.

Version 1.0.1

August 4, 2021

androidx.compose.ui:ui-*:1.0.1 is released. Version 1.0.1 contains these commits.

Dependency Updates

• Updated to depend on Kotlin 1.5.21.

Version 1.0.0

July 28, 2021

androidx.compose.ui:ui-*:1.0.0 is released. Version 1.0.0 contains these commits.

Major features of 1.0.0

This is the first stable release of Compose. Please see the official Compose Release blog for more details!

Known Issues

• If you are using Android Studio Bumblebee Canary 4 or AGP 7.1.0-alpha04/7.1.0-alpha05, you may hit the following crash:

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

  To fix, temporarily increase your minSdkVersion to 24+ in your build.gradle file. This issue will be fixed in the next version of Android Studio Bumblebee and AGP 7.1. (b/194289155)

Version 1.0.0-rc02

July 14, 2021

androidx.compose.ui:ui-*:1.0.0-rc02 is released. Version 1.0.0-rc02 contains these commits.

Bug Fixes

• Dialogs now follow the platform sizing behaviour. Set usePlatformDefaultWidth to false to override this behaviour. (Iffaed, b/192682388)

Version 1.0.0-rc01

July 1, 2021

androidx.compose.ui:ui-*:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

New Features

• Split ui-tooling module into ui-tooling and ui-tooling-preview (Iefa28, b/190649014)

API Changes

• Removed deprecated experimental FocusManager#moveFocusIn and FocusManager#moveFocusOut (I227d7, b/170154986, b/186567354, b/168510304)
• Canvas now supports a contentDescription parameter for accessibility. (Ib547c)
• useDefaultMaxWidth in PopupProperties was renamed to usePlatformDefaultWidth. (I05710)
• Dialogs are now able to use the entire screen width. (I83929, b/190810877)
• Added experimental support for HSV and HSL color representations. (Id7cf8, b/180731008)

Behavior Changes

• Compose @Preview now provides a LocalActivityResultRegistryOwner that allows you to preview Composables that use APIs like rememberLauncherForActivityResult() that depend on that owner existing. (Ib13d1, b/185693006)
• Compose @Preview now provides a LocalOnBackPressedDispatcherOwner that allows you to preview Composables that use APIs like BackHandler that depend on that owner existing. (Ia1c05, b/185693006)

Bug Fixes

• Moved InfiniteAnimationPolicy to androidx.compose.ui:ui (I5eb09, b/160602714)
• AnimatedImageVector was temporarily removed in order to change the module structure. (I41906, b/160602714)

Version 1.0.0-beta09

June 16, 2021

androidx.compose.ui:ui-*:1.0.0-beta09 is released. Version 1.0.0-beta09 contains these commits.

API Changes

• Change enum Role and LiveRegionMode into inline classes with private constructor (Id1890)
• KeyboardCapitalization is converted into an inline class. (Id5a1c)
• Change HapticFeedbackType to inline class. (I255ec)
• Modifier.pointerInteropFilter is @ExperimentalComposeUiApi. (Iede6c)
• TextAlign, FontSynthesis and TextDirection are now inline classes. (I212fe)
• TextOverflow is changed to an inline class. (I433af)
• FontStyle is now an inline class. (I9e48b)

Bug Fixes

• Key constants are @ExperimentalComposeUiApi for now. Consuming code can declare private constants prior to stabilization. (Ia5d48)
• Compose tests can now be run on Robolectric. The following limitations have so far been identified:
  • There is no native bitmap, so ImageBitmap() leads to a NullPointerException.
  • There is no drawing, so captureToImage() will indefinitely await the next draw pass (i.e. it deadlocks).
  • There is no font loaded, so any text will be measured incorrectly. All characters have a fixed height of around 20px and width of 1px.
  • ComposeTestRule.waitUntil {} does not run the main thread while it’s waiting, making it effectively the same as ComposeTestRule.mainClock.advanceTimeUntil {} More limitations are expected to be identified in the future. (I284fa)

Added Profile Rules

This release adds profile rules to the following compose modules (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

What are profile rules?

• Profile rules for a library are specified in a text file baseline-prof.txt located in the src/main or equivalent directory. The file specifies a rule per line, where a rule in this case is a pattern for matching to methods or classes in the library. The syntax for these rules is a superset of the human-readable ART profile format that is used when using adb shell profman --dump-classes-and-methods .... These rules take one of two forms to target either methods or classes.

• A method rule will have the following pattern:

  <FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
  

• And a class rule will have the following pattern:

  <CLASS_DESCRIPTOR>
  

• Here <FLAGS> is one or more of the characters H, S, and P to indicate whether or not this method should be flagged as "Hot", "Startup", or "Post Startup".

• The <CLASS_DESCRIPTOR> is the descriptor for the class that the targeted method belongs to. For example, the class androidx.compose.runtime.SlotTable would have a descriptor of Landroidx/compose/runtime/SlotTable;.

• The <METHOD_SIGNATURE> is the signature of the method, and includes the name, parameter types, and return types of the method. For example, the method fun isPlaced(): Boolean on LayoutNode has the signature isPlaced()Z.

• These patterns can have wildcards (**, *, and ?) in order to have a single rule encompass multiple methods or classes.

What do the rules do?

• A method that has the flag H indicates that this method is a "hot" method, and should be compiled ahead of time.

• A method that has the flag S indicates that it is a method which is called at startup, and should be compiled ahead of time to avoid the cost of compilation and interpreting the method at startup time.

• A method that has the flag P indicates that it is a method which is called after startup.

• A class that is present in this file indicates that it is used during startup and should be pre-allocated in the heap to avoid the cost of class loading.

How does this work?

• Libraries can define these rules which will be packaged in AAR artifacts. When an app is then built which includes these artifacts, these rules are merged together and the merged rules are used to build a compact binary ART profile that is specific to the app. ART can then leverage this profile when the app is installed on devices in order to ahead-of-time compile a specific subset of the application to improve the performance of the application, especially the first run. Note that this will have no effect on debuggable applications.

Version 1.0.0-beta08

June 2, 2021

androidx.compose.ui:ui-*:1.0.0-beta08 is released. Version 1.0.0-beta08 contains these commits.

API Changes

• NestedScrollSource enum is replaced by an inline class. (Ie321b, b/187055290)
• FocusManager.clearFocus(forcedClear = true) is renamed to FocusManager.clearFocus(force = true) (Ia0c41)
• Refactored enum usages to inline classes to avoid issues with exhaustive when statements when new enum values are added. (I2b5eb)
• Remove @ExperimentalComposeUiApi from PopupProperties. (I01fa6)
• PointerType was changed from an enum to an inline class (If5058)
• ContentDescription and Text semantics properties are no longer single values but lists. This enables to merge them as they are instead of concatenations. Also provided better testing APIs to utilize these changes (Ica6bf, b/184825850)
• Modifier.focusModifier() is deprecated and replaced by Modifier.focusTarget() (I6c860)
• Modifier.onSizeChanged() and Modifier.onGloballyPositioned() are not inlined functions anymore (I727f6, b/186109675)
• KeyboardType enum is replaced by an inline class. (I73045, b/187055290)
• Replaced FocusState enum with a FocusState interface (Iccc1a, b/187055290)
• ImeAction enum is replaced by an inline class. (I18be5, b/187055290)
• PlaceholderVerticalAlign is converted into an inline class. (If6290)
• TextUnitType is an inline class now. (I4cba9)
• AnnotatedString.withAnnotation functions are now ExperimentalTextApi instead of ExperimentalComposeApi. (I0cd0a)
  • TextUnit constructor with TextUnitType is now ExperimentalTextApi instead of ExperimentalComposeApi.

Bug Fixes

• Fixed the bug introduced in beta07 where LazyColumn/Row items were displayed partially after the scroll (I8c9ac, b/188566058)
• Now detectDragGesures, detectVerticalGestures, and detectHorizontalGestures will consume the position change automatically, no need to call change.consumePositionChange in the onDrag callbacks (I42fc4, b/185096350, b/187320697)
• LayoutModifiers providing alignment lines was fixed. A bug causing the parent not being remeasured when the alignment lines of the children were changing was fixed. (I4401f, b/174315652)
• Modifier.onGloballyPositioned() was changed to report the coordinates of this modifier in the modifier chain, not the layout coordinates after applying all the modifiers. This means that now the ordering of modifiers is affecting what coordinates would be reported. (Ieb67d, b/177926591)

Version 1.0.0-beta07

May 18, 2021

androidx.compose.ui:ui-*:1.0.0-beta07 is released. Version 1.0.0-beta07 contains these commits.

API Changes

• Added ViewRootForInspector interface for use in inspector (Ib70df)
• SubcomposeLayoutState now supports setting count of reusable slots. The layout will keep up to this count slots active instead of disposing them in order to reuse the slot next time we need a new one (Ieb981)
• KeyEventType enum is replaced by an inline class. (Id670a, b/187055290)
• FocusDirection enum is replaced by an inline class. (Ib6d03, b/187055290, b/184086802)
• Introduces ability to hoist the SubcomposeLayout state which allows you to precompose the content into a requires slotId which would make the next measure pass faster as once we try to subcompose with the given slotId next time there will be no composition needed. (I42580, b/184940225)
• Added Clip Selection Handle (Iff80d, b/183408447)
• Removed unused APIs related to LayoutInspector support. (I2ac78)

Bug Fixes

• LazyColumn/Row will now keep up to 2 previously visible items active (not disposed) even when they are scrolled out already. This allows the component to reuse the active subcompositions when we will need to compose a new item which improves the scrolling performance. (Ie5555)
• TextGeomerticTransform and TextDecoration on AnnotatedString will be applied as given. (I61900, b/184760917)

Version 1.0.0-beta06

May 5, 2021

androidx.compose.ui:ui-*:1.0.0-beta06 is released. Version 1.0.0-beta06 contains these commits.

API Changes

• Solve Conflict with Navigation Gesture (I1145e)
• @ComposeCompilerApi no longer @RequiresOptIn (Iab690)
• Added CollectionInfo and CollectionItemInfo accessibility APIs that allows to mark collection and its items for accessibility services (Id54ef, b/180479017)
• Added SemanticsActions.ScrollToIndex to scroll a list with indexed items to the item with a certain index, and SemanticsProperties.IndexForKey to get the index of an item in a list with keyed items. Both actions are implemented by LazyList.
  • Added SemanticsNodeInteraction.performScrollToIndex that scrolls a list to the given index, and SemanticsNodeInteraction.performScrollToKey that scrolls a list to the item with the given key. (I4fe63, b/178483889, b/161584524)
• Added ownerViewId to GraphicLayerInfo (I19f62)
• Added Font() overloads to load fonts from assets, File and FileDescriptor (I5d382)
• Added accessibility API error that allows to mark a node that contains invalid input (I12997, b/180584804, b/182142737)
• Added Font() overloads to load fonts from assets, File and FileDescriptor (I43007)
• AnnotatedString save support to TextFieldValue.Saver. Added addTtsAnnotation and withAnnotation utility functions to AnnotatedString.Builder (I8cbdc, b/178446304)
• Added TextUnit constructor function TextUnit(value: Float, type: TextUnitType) (I7ecce, b/178446304)

Version 1.0.0-beta05

April 21, 2021

androidx.compose.ui:ui-*:1.0.0-beta05 is released. Version 1.0.0-beta05 contains these commits.

API Changes

• Added experimental FocusManager.moveFocus(In) and FocusManager.moveFocus(Out) (Ic5534, b/183746743)
• Added experimental performTextInputSelection API (I2dcbb, b/178510628)
• InputEventCallback interface is deprecated. It was not possible to use the interface in any public API; and there was no usage of it in the code. (I34a02, b/184003208)
• Deprecated TextLayoutResult/createTextLayoutResult function. It is an unused public function which was added for testing. The function does not do anything usable for Compose text APIs. The function is now deprecated and will be removed later. (I80413)

Bug Fixes

• Fixed ACTION_SCROLL_FORWARD, ACTION_SCROLL_BACKWARD, accessibilityActionScrollLeft, accessibilityActionScrollUp, accessibilityActionScrollRight and accessibilityActionScrollDown accessibility scroll actions. Instead of scrolling to the end of the scrollable, it will now scroll by one screen in the given direction. (Ieccb0)
• The AndroidManifest files from ui-test-manifest and ui-tooling-data are now compatible with Android 12 (I6f9de, b/184718994)

Version 1.0.0-beta04

April 7, 2021

androidx.compose.ui:ui-*:1.0.0-beta04 is released. Version 1.0.0-beta04 contains these commits.

API Changes

• Rename hideSoftwareKeyboard and showSoftwareKeyboard on SoftwareKeyboardController to hide() and show() respectively.
  • Provide the full CompositionLocal interface for LocalSoftwareKeyboardController, allowing it to be set (especially useful in tests) (I579a6)
• LiveRegion accessibility API is added. If node is marked as a live region, the accessibility services will automatically notify the user about its changes (Idcf6f, b/172590946)
• TextOverflow.Visible is introduced. (Ic8f89)

Bug Fixes

• Fixed the issue when items of LazyColumn/LazyRow located on the edges were incorrectly positioned after fast fling (Ie4d13, b/183877420)
• AndroidViewBinding now properly removes fragments inflated via FragmentContainerView when the AndroidViewBinding is removed from the compose hierarchy. (Ib0248, b/179915946)
• AndroidViewBinding now correctly nests fragments inflated via FragmentContainerView when your ComposeView is within a Fragment, fixing issues with saving and restoring the state of those fragments. (I70eb0, b/179915946)
• Compose ViewBinding now depends on Fragment 1.3.2 and now consistently shows fragments inflated via FragmentContainerView after configuration changes. (I0743d, b/179915946)

Version 1.0.0-beta03

March 24, 2021

androidx.compose.ui:ui-*:1.0.0-beta03 is released. Version 1.0.0-beta03 contains these commits.

API Changes

• Deferred check for ViewTree dependencies of ComposeView (I8dbbf, b/182466548)
• Added optional startX/endX and startY/endY parameters to swipeUp/swipeDown/swipeLeft/swipeRight functions in GestureScope. (I49e2d, b/182063305)

Version 1.0.0-beta02

March 10, 2021

androidx.compose.ui:ui-*:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits.

API Changes

• 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)
• Removed the following SemanticsMatchers:
  • hasWidth(width, tolerance)
  • hasHeight(height, tolerance)
  • hasLeftPosition(left, tolerance)
  • hasTopPosition(top, tolerance)
  • hasRightPosition(right, tolerance)
  • hasBottomPosition(bottom, tolerance) (If16bd)
• Marked the following SemanticsMatchers as @ExperimentalTestApi:
  • hasWidth(width, tolerance)
  • hasHeight(height, tolerance)
  • hasLeftPosition(left, tolerance)
  • hasTopPosition(top, tolerance)
  • hasRightPosition(right, tolerance)
  • hasBottomPosition(bottom, tolerance) (Ia600c)
• Added the following SemanticsMatchers:
  • hasWidth(width, tolerance)
  • hasHeight(height, tolerance)
  • hasLeftPosition(left, tolerance)
  • hasTopPosition(top, tolerance)
  • hasRightPosition(right, tolerance)
  • hasBottomPosition(bottom, tolerance) (I2f502)

Bug Fixes

• Enforce restrictions on public usage of experimental APIs (I6aa29, b/174531520)
• androidx.compose.ui:ui no longer depends on AppCompat or Fragment. If you are using a ComposeView in your application, and you are using Fragment and/or AppCompat, make sure that you are using AppCompat 1.3+ / Fragment 1.3+ - these versions are needed to correctly set lifecycle and saved state owners required for ComposeView. (I1d6fa, b/161814404)
• Fix for broken rememberSaveable { mutableStateOf(0) } when used inside a destination of navigation-compose. (I1312b, b/180042685, b/180701630)
• Added new LocalSoftwareKeyboardController composition local API to replace previous SoftwareKeyboardController interface on TextField. (I658b6, b/168778053)
• Fixed rare NoSuchElementException in ComposeRootRegistry's tearDownRegistry() (Iddce1)

Version 1.0.0-beta01

February 24, 2021

androidx.compose.ui:ui-*:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

This is the first release of Compose 1.0.0 Beta.

API Changes

• onStart callback has been added to detectDragGestures (I67269, b/179995594)
• Modifiers for sizing to intrinsics are no longer experimental. (I15744)
• MeasureBlocks was renamed to MeasurePolicy which became a fun interface. Layout APIs were updated / simplified to use MeasurePolicy. (Icab48, b/167662468, b/156751158)
• InteractionState has been replaced with [Mutable]InteractionSource
  • Interfaces are responsible for emitting / collecting Interaction events.
  • Instead of passing interactionState = remember { InteractionState() } to components such as Button and Modifier.clickable(), use interactionSource = remember { MutableInteractionSource() }.
  • Instead of: Interaction.Pressed in interactionState you should instead use the extension functions on InteractionSource, such as InteractionSource.collectIsPressedAsState().
  • For complex use cases you can use InteractionSource.interactions to observe the stream of Interactions. See the InteractionSource documentation and samples for more information.
  • (I85965, b/152525426, b/171913923, b/171710801, b/174852378)
• Add AccessibilityMananger interface and LocalAccessibilityMananger in CompositionLocals (I53520)
• Removed deprecated LayoutCoordinates methods, use function instead of the property for positionInParent and boundsInParent (I580ed, b/169874631, b/175142755)
• Typealiases replaced by underlying types:
  • ColorStop is now Pair<Float, Color>
  • SpanStyleRange is now `AnnotatedString.Range
  • ParagraphStyleRange is now AnnotatedString.Range<ParagraphStyle>
  • StringAnnotation is now AnnotatedString.Range<String>
  • (I8dd1a)
• Created new TextInputSession for input sessions from low level text components such as CoreTextField. (I8817f, b/177662148)
• Placeable now exposes measuredSize, representing the size which the child layout actually measured to. This size might not respect the measurement constraints. (Ib2729, b/172560206, b/172338608)
• Add selectionGroup modifier that allows to mark collection of Tabs or RadioButtons for accessibility purposes (Ie5c29)

• The defaultFactory for compositionLocalOf and staticCompositionLocalOf is now required instead of optional.

  This changes removes a potential type error for non-nullable types where no default factory was provided. Previously this would provide a null reference for a non-nullable type.

  For nullable types consider supplying { null } as the default factory.

  We do not recommend using locals with non-nullable types unless a sensible default can be provided. If no sensible default exists, the defaultFactory lambda should throw an exception. However throwing an exception means that consumers of the local will have an implicit dependency on it being provided that is not enforced by the type system. (Ifbd2a)

• Deprecated methods from ui modules were removed (I646f6)

• Size modifiers were renamed. Modifier.width/height/size were renamed to requiredWidth/requiredHeight/requiredSize. Modifier.preferredWidth/preferredHeight/preferredSize were renamed to width/height/size. (I5b414)

• Modifier.tapGestureFilter has been removed. Use Modifier.pointerInput { detectTapGestures(...) } instead. (I266ed, b/175294473)

• partial consumption was removed from pointer input system. The recommended way of coordinating partial consumtion is Modifier.nestedScroll. (Ie9c9b)

• Orientation has been moved to foundation package. VelocirtTracker moved from ui.gesture to ui.input.pointer. (Iff4a8, b/175294473)

• imageResource and vectorResource are now extension functions on ImageBitmap and ImageVector companions respectively. load{Image,Vector,Font}Resource functions have been deleted. (I89130)

• AnimationClockObservable and subclasses have been removed. AnimatedFloat has been removed. (Icde52, b/177457083)

• Providers has been renamed to CompositionLocalProvider

  • The Composition constructor no longer accepts a key parameter, and has been deprecated.
  • currentCompositeKeyHash has been turned into a composable top level property instead of a composable top level function.
  • CompositionData and CompositionGroup have been moved to the androidx.compose.runtime.tooling namespace
  • ComposableLambda has been made an interface instead of a concrete class, and no longer has type parameters.
  • ComposableLambdaN has been made an interface instead of a concrete class, and no longer has type parameters.
  • The snapshotFlow function has been moved to the androidx.compose.runtime namespace
  • the merge method of SnapshotMutationPolicy is no longer experimental
  • The @TestOnly top level clearRoots function has been removed. It is no longer necessary.
  • keySourceInfoOf and resetSourceInfo functions have been removed. They are no longer necessary.
  • Composer.collectKeySourceInformation has been removed. It is no longer necessary.
  • isJoinedKey, joinedKeyLeft, and joinedKeyRight methods have been removed. They are no longer necessary.
  • Various top level APIs have been moved and reorganized into different files. Due to Kotlin’s file class semantics, this will break binary compatibility but not source compatibility, so should not be an issue for most users.
  • (I99b7d, b/177245490)

• ComponentActivity.setContent() was removed from compose:ui. Use the one from androidx.activity:activity-compose:1.3.0-alpha01. viewModel() and LocalViewModelStoreOwner were removed from compose:ui. Use the ones from androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01 (I6f36b)

• Modifier.scrollable has been reworked. Now it uses Scrollable interface instead of ScrollableController class (I4f5a5, b/174485541, b/175294473)

• CustomEvens support from PointerInputModifier has been removed (I02707, b/175294473)

• SnapshotStateObserver is not Experimental anymore (Id2e6a)

• Deleted some previously deprecated APIs (Ice5da, b/178633932)

• longPressGestureFilter and doubleClickGestureFilter have been removed. use Modifier.pointerInput with helper functions e.g detectTapGestures (I2fedf, b/175294473)

• Removed String.format API refactored usages in various toString methods to not leverage String.format internally. (Id1290)

• Removed dp assertions (I798d2)

• Removed androidx.compose.runtime:runtime-dispatch (I55feb)

• Text actions now check focus automatically (I13777, b/179648629)

• Removed runBlockingWithManualClock (I15cdc, b/179664814)

• Scroll position in Modifier.verticalScroll()/horizontalScroll() is represented with Ints now (I81298)

• FlingConfig has been renamed to FlingBehavior now allows for customization of suspend animation rather than predefined Decays. (I02b86, b/175294473)

• Added a helper function that is helpful to set the same action for all ImeAction callbacks (I63447, b/179226323)

• Removed SoftwareKeyboardController callback from all text fields to be replaced by a new API shortly. (Iae869, b/168778053)

• FontSpan and FontWeigthStyleSpan are no longer used and removed. (Ie5b56, b/177423444)

• Made the following Material API changes:

  • Added contentPadding parameter to Top/BottomAppBar to allow customizing the default padding.
  • Reordered parameters in BackdropScaffold to follow API guidelines for required parameters being before optional parameters.
  • Moved icon parameter in BottomNavigationItem to be after selected and onClick.
  • Renamed alwaysShowLabels parameter in BottomNavigationItem to alwaysShowLabel.
  • Renamed bodyContent parameters in a few components to just content.
  • Reordered parameters in ButtonDefaults.buttonColors(). Please note that because the type of the parameters have not changed, this will not cause an error in your code - please ensure you are either using named parameters or update the ordering manually, otherwise your code will not work the same as previously.
  • Added secondaryVariant parameter to darkColors(). This color is typically the same as secondary in dark theme, but adding for consistency and further customization.
  • Removed ElevationDefaults and animateElevation() from the public API surface since they were not commonly used / useful.
  • Renamed onValueChangeEnd in Slider to onValueChangeFinished and made it nullable.
  • Renamed text parameter in Snackbar to content for consistency.
  • Added contentPadding parameter to DropdownMenuItem to allow customizing the default padding and made content be an extension on RowScope.
  • Renamed ModalDrawerLayout to ModalDrawer.
  • Renamed BottomDrawerLayout to BottomDrawer.
  • (I1cc66)

Bug Fixes

• Added API to use AnimatedVectorDrawable resources in Compose. Use animatedVectorResource to load an <animated-vector> XML as an AnimatedImageVector and animate it with painterFor (I8ea91)
• Added new LocalSoftwareKeyboardController composition local API to replace previous SoftwareKeyboardController interface on TextField. (I658b6, b/168778053)

Version 1.0.0-alpha12

February 10, 2021

androidx.compose.ui:ui-*:1.0.0-alpha12 is released. Version 1.0.0-alpha12 contains these commits.

API Changes

• Support for ViewGroups was removed from UiApplier. The Deprecated emitView composables were removed. (Ifb214)
• Modifier.pointerInput now requires remember keys to indicate when the pointer input detection coroutine should restart for new dependencies. (I849cd)
• CompositionReference renamed to CompositionContext (I53fcb)
• Bounds has been renamed to DpRect (I4b32a)
• Testing update: hasText() will check for both input and label/hint/placeholder texts in the text field (Iab803)
• viewModel() composable and LocalViewModelStoreOwner were moved to androidx.lifecycle.viewmodel.compose. You will now need to add a separate dependency androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01 in order to use it. (I7a374)
• Allow nullable action in AccessibilityAction, change action label in AccessibilityAction and CustomAccessibilityAction from CharSequence to String (I0dc82)
• In order to better match naming conventions with ImageBitmap and ImageVector, ImagePainter has been renamed to BitmapPainter to parallel VectorPainter. (Iba381, b/174565889)
• Better substring test APIs with substring now as an argument (Icbe78)
• Added an Modifier.focusOrder() that accepts a FocusRequester without specifying a custom focus order a lambda. This is useful when we only need to specify a reference but not a custom focus order for a composable (I4f52a, b/179180978)
• ComponentActivity.setContent has moved to androidx.activity.compose.setContent in the androidx.activity:activity-compose module. (Icf416)
• Destructuring and copy() methods have been removed from several classes where they were rarely used. (I26702, b/178659281)
• Moved Popup to be platform specific. AndroidPopupProperties has been renamed to PopupProperties, and isFocusable has been moved to a focusable parameter in PopupProperties (Ieeea5)
• Moved Dialog to be platform specific. Renamed AndroidDialogProperties to DialogProperties. (I4ef69, b/179138130)
• Made LayoutNode internal (I8a7b1, b/175103944)
• Constraints.enforce was replaced with Constraints.constrain. (I8b8ea)
• loadFontResource is deprecated. Use fontResource instead. imageResource, loadImageResource, vectorResource, and loadVectorResource are deprecated. Use painterResource instead. (I6b809)
• For performance reasons, ScrollAxisRange semantics now takes lambdas returning Floats instead of direct Float values. (If4a35, b/178657186)
• Added EditableText semantics to mark editable input text of the text field for accessibility and corresponding test methods to check the semantics (I8e07a)
• Made OwnerLayer/OwnerScope/OwnerSnapshotObserver internal (I4ffaf, b/175103944)
• toIntPx() was renamed to roundToPx(). (I9b7e4, b/173502290)
• IntBounds was renamed to IntRect and the API was improved. (I1f6ff)
• Snapshot API was updated to be more consistent with API guideline as well as hiding internal implementation classes from the public API. (Id9e32)
• Added expand and collapse semantics actions. Added expand and halfExpand in ModalBottomSheetState (Ib5064)
• Modifier.dragGestureFilter has been deprecated. Use Modifier.pointerInput { detectDragGestures (...)} instead. Alternatively, use Modifier.draggable for one axis drags (I0ba93, b/175294473)
• Renamed Ambients to match the Ambient -> CompositionLocal rename. Ambients used to be named AmbientFoo, now CompositionLocals are named LocalFoo. (I2d55d)
• The deprecated BaseTextField is now removed. Use BasicTextField instead. (I71368)
• Selection was moved to foundation. (I7892b)
• Similarly to how we previously removed state { 0 } composable and now promote usage like remember { mutableStateOf(0) } we are going to remove savedInstanceState { 0 } composable. You should use rememberSaveable { mutableStateOf(0) } instead and it will save and restore automatically if the type used inside the MutableState can be stored in the Bundle. If previously you were passing a custom saver object now you need to use a new overload of rememberSaveable which has stateSaver parameter. The usage will look like this: val holder = rememberSaveable(stateSaver = HolderSaver) { mutableStateOf(Holder(0)) } (Ib4c26, b/177338004)
• Added password semantics for accessibility (I231ce)
• Added ProgressBarRangeInfo.Indeterminate to mark indeterminate progress bars for accessibility (I6fe05)
• emptyContent() and (@Composable () -> Unit).orEmpty() utilities have been deprecated as they no longer have any positive performance impact or value (I0484d)
• snapshotFlow and withMutableSnapshot are no longer experimental (I6a45f)
• Recomposers can now be closed. Closed recomposers will continue recomposition until composition child coroutines complete. Recomposer.shutDown renamed to cancel to contrast with close. (Ib6d76)
• UiSavedStateRegistry was renamed to SaveableStateRegistry, AmbientUiSavedStateRegistry was renamed to AmbientSaveableStateRegistry and both moved to androidx.compose.runtime.saveable package. (I30224)
• Artefact androidx:compose:runtime:runtime-saved-instance-state was renamed to androidx:compose:runtime:runtime-saveable (I6dcac)
• Many longstanding deprecated APIs in the ui package are deleted. (I2f2dc)
• The compose:runtime-dispatch artifact is now deprecated. MonotonicFrameClock can now be found in compose:runtime and AndroidUiDispatcher can be found in compose:ui. (Ib5c36)
• Outline.* classes are not data classes anymore (I4879e, b/178001427)
• Removed view.captureToImage() without any replacement. (I7fcd2)
• Introduced ColorMatrix API used to modify rgb values of source content Refactored ColorFilter API to be an interface and match the implementation of PathEffect. (Ica1e8)
• Add layoutDirection param to Shape's createOutline. This allows to create layout direction aware shapes. (I57c20, b/152756983)
• onImeActionPerformed is deprecated. use KeyboardActions instead (If0bbd, b/179071523)
• Introduced an InfiniteAnimationPolicy coroutine context element that will be applied in infinite animations. By default no policy is installed, except when running tests with ComposeTestRule. (I50ec4, b/151940543)
• canDrag has been removed from the Modifier.scrollable. (Id66e7, b/175294473)
• Renamed LayoutCoordinates.parentCoordinates to LayoutCoordinates.parentLayoutCoordinates to allow for a new parentCoordinates property. The parentCoordinates property now offers the parent modifier's LayoutCoordintes. This will make for more complete use cases for onSizeChanged() and onGloballyPositioned() (Idfbfd, b/177926591)
• tapGestureFilter, doubleTapGestureFilter, longPressGestureFilter and pressIndicaitonGestureFilter have been deprecated. Use Modifier.clickable or Modifier.pointerInput with detectTapGestures function instead. (I6baf9, b/175294473)
• SaveableStateRegistry's unregisterProvider was removed. Instead registerProvider() now returns SaveableStateRegistry.Entry object which you can use to unregister (Ic4274, b/178583739)
• rememberSavedInstanceState() was renamed to rememberSaveable() and moved to androidx.compose.runtime.saveable package. (I1366e, b/177338004)
• Removed CoreText and CoreTextField from public API
  • Removed deprecated SelectionContainer overload
  • (I99c19)
• Tests in which Compose is used in hierarchies that are added/removed directly to the WindowManager are now more stable. (Ie81ed, b/175765614)
• Removed Recomposer.current(). [Abstract]ComposeView now default to lazily created, window-scoped Recomposers driven by the ViewTreeLifecycleOwner for the window. Recomposition and withFrameNanos-based animation ticks are paused while the host Lifecycle is stopped. (I38e11)
• Recomposer.runningRecomposers now offers a global StateFlow of read-only RecomposerInfo for observing ongoing composition state in the process. Prefer this API to Recomposer.current(), which is now deprecated. (If8ebe)
• Saver, listSaver(), mapSaver(), autoSaver was moved from androidx.compose.runtime.savedinstancestate to androidx.compose.runtime.saveable (I77fe6)
• EditCommands accept AnnotatedString. However this is an API only change and multi-style text editing is not implemented yet. (I4c3ea)
• Uptime and Duration have been removed. (Ib9bf4, b/177420019)
• CompositionData.asTree() and related APIs moved to separate ui-tooling-data module and marked as experimental (Ic95b8)
• Parameters on RounderCornerShape, CutCornerShape and CornerBasedShape were renamed from left/right to start/end in order to support the shape's auto mirroring in the rtl direction. AbsoluteRounderCornerShape and AbsoluteCutCornerShape were introduced for the cases when auto-mirroring is not desired. (I61040, b/152756983)

• The API the Compose compiler plugin targets has been refactored to use an interface instead of a concrete class. The interface also no longer uses a type parameter.

  This is an internal change that should not effect source code compatibility but is a binary breaking change. (I3b922, b/169406779)

• Remove unintentionally public StringBuilder.deleteAt function (Id6ed9)

Bug Fixes

• ComposeViews placed in view hierarchies that are children of another composition now host child compositions of their ancestors (I92883)
• Updated compose's imageFromResource API to reuse the resource drawable cache when loading ImageBitmap objects. (If3627, b/178751994)

Version 1.0.0-alpha11

January 28, 2021

androidx.compose.ui:ui-*:1.0.0-alpha11 is released. Version 1.0.0-alpha11 contains these commits.

API Changes

• WithConstraints was reworked as BoxWithConstraints and moved to foundation.layout. (I9420b, b/173387208)
• Key.DPadUp is deprecated. Use Key.DirectionUp instead. (Iab335, b/177954892)
• Owner interface from now on internal. (If8e35)
• Added FocusManager.moveFocus() API to move focus programmatically. (I045cb, b/177681839)
• Changes PopupPositionProvider to use window-relative coordinates, not global coordinates. Renames parentGlobalBounds to anchorBounds, and changes windowGlobalBounds to be windowSize: IntSize (I2994a)
• Duration and Uptime will be replace with Long milliseconds, and this step removes the dependency of pointer input on those classes. (Ia33b2, b/175142755, b/177420019)
• AmbientSavedStateRegistryOwner was added similarly to already existing AmbientLifecycleOwner and AmbientViewModelStoreOwner (I9a3e8, b/176756365)
• Updated vector graphics API to support parsing of tinting applied to the root of vector graphics. (Id9d53, b/177210509)
• Added toolType to PointerInputChange to differentiate devices (Iac787, b/175142755)
• AmbientWindowManager is renamed to AmbientWindowInfo (I2686a, b/177084714, b/177084983)
• Deprecated global coordinates methods and made new window-based coordinates methods. (Iee284)
• Added Modifier.toolingGraphicsLayer which adds a graphics layer modifier when inspection is turned on. (I315df)
• FocusRequester.createRefs is now marked as experimental as it might change. (I2d898, b/177000821)
• SemanticsPropertyReceiver.hidden was renamed to invisibleToUser and marked @ExperimentalComposeUiApi. AccessibilityRangeInfo was renamed to ProgressBarRangeInfo. stateDescriptionRange was renamed to progressBarRangeInfo. AccessibilityScrollState was renamed to ScrollAxisRange. horizontalAccessibilityScrollState was renamed to horizontalScrollAxisRange. verticalAccessibilityScrollState was renamed to verticalScrollAxisRange. (Id3148)
• Removed PointerInputData and modified PointerInputChange to give it all of PointerInputData's fields. Made PointerInputEvent and PointerInputEventData internal because they aren't used in any public API. (Ifff97, b/175142755)
• Updated GraphicsLayerScope implement density to support conversions of dp into raw pixels. (Ied528, b/176819695)
• Updated matrix API to follow row major ordering and provide index constants to assist with conversions between different matrix representations to match framework conversion logic between SkMatrix and Matrix4 internally. (I432e6)
• Removed experimental monotonicFrameAnimationClockOf methods (Ib753f, b/170708374)
• Move String.fintPrecedingBreak and String.fingFollowingBreak to InternalTextApi. (I657c4)
• androidx.compose.ui.util.isSurrogatePair has been removed from public API. (Ia9494)
• Renamed TransformedText.transformedText to TransformedText.text
  • TransformedText is no longer a data class (Ie672a)
• Removed data class from the following classes:
  • InlineTextContent
  • LocaleList (I605c7)
• The following classes are not data classes anymore:
  • AnnotatedString
  • ParagraphStyle
  • SpanStyle
  • TextStyle
  • FontWeight
  • TextDecoration
  • TextGeometricTransform
  • TextIndex
  • TextLayoutResult
  • TextLayoutInput (Iaff99)
• Changed VisualTransformation to be a functional interface (I3bba4)
• Added a function reference parameter type (I5e1bd)
• Add transformed bounds to InspectorNode (Ice42f)

Bug Fixes

• onCommit, onDispose, and onActive have been deprecated in favor of SideEffect and DisposableEffect APIs (If760e)

• Changes to factory functions for Font/FontFamily/Typeface

  • Added factory functions that start with capital letter
  • Deprecated previous factory functions with lowercase first letters
  • New factory functions return the FontFamily instead of subclasses
  • Hid constructors of the subclasses, so that they can only be constructed via factory functions.
  • Renamed Font.asFontFamily to Font.toFontFamily (I42aa7)

• Introduced ComposeContentTestRule, which extends ComposeTestRule and defines setContent, which has been removed from ComposeTestRule. Added a factory method createEmptyComposeRule() that returns a ComposeTestRule and does not launch an Activity for you. Use this when you want to launch your Activity during your test, e.g. using ActivityScenario.launch (I9d782, b/174472899)

• animateAsState is now animateFooAsState, where Foo is the type of the variable being animated. e.g. Float, Dp, Offset, etc (Ie7e25)

• Content description parameter has been added to the Image and Icon. It is used to provide description to the accessibility services (I2ac4c)

• Remove displaySize as it should be avoided. Typically it is better to use size of onRoot() or window size at least. (I62db4)

• OnSizeChanged was reporting the size of the layout's contents. It now reports the size at its position within the modifier chain. (I36b78, b/177562900)

• The emit() API and all overloads have been deprecated and renamed to ComposeNode. The APIs are identical, just a different name in order to follow the naming conventions of Compose (I4137b)

• TextFieldValue accepts AnnotatedString. However this is an API only change and multi-style text editing is not implemented yet.

  • Removed initial from EditingBuffer constructor parameters. (I326d5)

• invalidate and compositionReference() are now deprecated in favor of currentRecomposeScope and rememberCompositionReference respectively. (I583a8)

• AnnotatedString is changed to extend from kotlin.CharSequence. Therefore length and subSequence are now instance functions, and extension functions are removed. (Iaf429)

• RememberObserver replaces CompositionLifecycleObserver and CompositionLifecycleObserver is now deprecated.

  RememberObserver is a replacement for CompositionLifecycleObserver with modified semantics and renamed methods. Changing to the new API can be done mechanically for objects that are only remembered once which is, and continues to be, the recommended practice. However, if a reference was remembered more than once in a composition onRemembered is called for each reference where onEnter is only called once. onEnter was called multiple time if the object was used in subcompositions, such as WithConstraints and Scaffold making the single onEnter call guarantee unreliable and it was removed for RememberObserver.

  RememberObserver adds onAbandoned which is called if the RememberObserver instance is returned from the callback passed to remember but was not remembered in the composition state and, therefore, will never have onRemembered called. This can occur if an exception terminates composition before completing or the composition is discarded because the state is was producing a composition for is no longer current or otherwise is no longer needed. If the instance of RememberObserver following the single reference recommendation above is tracking an external resource both onForgotten and onAbandoned each indicate that the resource is no longer needed. If the object is tracking work started or resources allocated in onRemembered, onAbandoned can be ignored as it will not be called if onRemembered is called. (I02c36)

• Deprecated arithmetic operations between 2 or more TextUnits. Deprecated TextUnit.Sp and TextUnit.Em functions in preference to the extension functions such as Int.sp and Int.em. (I48369)

• Resources in libraries with no explicitly declared public resources (ex. via public.xml) are now private by default. (Ia1dcc, b/170882230)

• ScrollableColumn/Row were deprecated. Using ScrollableColumn is less efficient compared to LazyColumn when you have a large scrolling content because with LazyColumn we can only compose/measure/draw visible elements. To prevent users from going the inefficient way we decided to deprecate ScrollableColumn and ScrollableRow and promote usages of LazyColumn and LazyRow instead. Users can still decide they don't need the lazy behaviour and use the modifiers directly like this: Column(Modifier.verticalScroll(rememberScrollState())) (Ib976b, b/170468083)

• New items(count: Int) factory method for scope of LazyColumn/LazyRow/LazyVerticalGrid. items(items: List) and itemsIndexed(items: List) are now extension functions so you have to manually import them when used. New extension overloads for Arrays: items(items: Array) and itemsIndexed(Array) (I803fc, b/175562574)

• Please use ImeAction.None instead of ImeAction.NoAction

  • Please use ImeAction.Default instead of ImeAction.Unspecified (Ie1bcc)

• Leverage TestCoroutineDispatcher in testing (I532b6)

• Renamed TextInputService.onStateUpdated as updateState (Id4853)

• TransitionDefinition-based Transition has been deprecated (I0ac57)

• TextUnitType.Inherit is removed. Please use TextUnitType.Unspecified instead. (I9ff64)

Version 1.0.0-alpha10

January 13, 2021

androidx.compose.ui:ui-*:1.0.0-alpha10 is released. Version 1.0.0-alpha10 contains these commits.

Breaking Change

• Restructuring of the internal compiler API allows batching changes to the nodes generated as a result of composition into the "apply changes" phase of composition, after all @Composable functions have completed.

  This is a behavioral breaking change that might affect application code as nodes are no longer available from internal and experimental APIs until after changes have been applied. This can usually be worked around by surrounding code with such dependencies in a SideEffect composable to defer execution of the code until after the nodes have been created and initialized. (I018da)

API Changes

• Added Modifier.focusOrder() that can be used to specify a custom focus traversal order (I90cf5, b/175899543, b/170155556, b/170155429)
• Removed deprecated focusObserver use onFocusChanged or onFocusEvent instead (I3ecb9, b/175156387)
• EditOperations API Changes
  • Renamed EditOperation as EditCommand
  • Added Command suffix for EditOperation concrete implementations
  • EditCommand's are no longer data classes
  • Renamed EditOperation.process function to applyTo
  • Renamed InputEventListener to InputEventCallback
  • (I0a366)
• Removed unused PxSquared, PxCubed, PxInverse. Changed Size.center() to be a property. (I973f7)
• ui-test module will now be able to configure the creation of Recomposers for UIs under test (Ibebd8)
• Modified Velocity to have component parts and mathematical operations. (Ib0447)
• Renamed @ExperimentalTesting to @ExperimentalTestApi to be consistent with similar experimental api annotations (Ia4502, b/171464963)
• Renamed Color.useOrElse() to Color.takeOrElse() (Ifdcf5)
• Removed unused DpInverse, DpSquared, and DpCubed classes. (I4d62b)
• Constraints#satisfiedBy was renamed to isSatisfiedBy. (I9cf5c)
• Add a callback to notify Owner when layoutnode bounds change. (I72fd1)
• Added isSpecified, isUnspecified, and useOrElse for inline classes with an Unspecified constant. (I93f7b, b/174310811)

• Expand [Abstract]ComposeView APIs to allow recycling Compose-based views, disposing their composition to recreate again later. Add APIs for installing and discovering window-scoped Recomposers and CompositionReferences for creating child compositions.

  Add ViewCompositionStrategy for configuring the composition disposal strategy of [Abstract]ComposeViews; default behavior is dispose on window detach. (I860ab)

• Removed Any.identityHashCode() public api (I025d7)

• Removed toStringAsFixed API in favor of using String.format instead directly. (Iaba6b)

• Add Toggle to foundation Strings.kt (I4a5b7, b/172366489)

• Moved nativeClass to ui module and made it internal. Updated usages of nativeClass in equals implementations to use 'is MyClass' instead. (I4f734)

• Modifier.focus() and Modifier.focusRequester() are deprecated. Use Modifier.focusModifier() and Modifier.focusReference() instead. (I75a48, b/175160751, b/175160532, b/175077829)

• Introduced SelectionRegistrar.notifySelectableChange to notify Selectable updates to SelectionManager. (I6ff30, b/173215242)

• Introduced Outline.bounds property to obtain the bounding rect for various outline implementations. (I16e74, b/175093504)

• Deprecated TestUiDispatcher. Use Dispatchers.Main instead (Ic171f, b/175385255)

• ImeOptions and KeyboardOptions are no more a data class (I3c898, b/168684531)

• VisualTransformation API Changes

  • Renamed OffsetMap to OffsetMapping
  • Renamed OffsetMapping.identityOffsetMap to OffsetMapping.Identity
  • PasswordTransformation is no longer data-class
  • Moved OffsetMapping to its own file
  • (I0bdf3)

• Renamed Position to DpOffset and removed getDistance() (Ib2dfd)

• Changed fun Dp.isFinite() to a val Dp.isFinite (I50e00)

Bug Fixes

• Recomposer now exposes a Flow of its current state, allowing monitoring its activity and the activity of associated effects. (Ifb2b9)
• The native keyEvent can now be accessed through keyEvent.nativeKeyEvent (I87c57, b/173086397)
• animate() is now replaced with animateAsState(), which returns a State<T> instead of T. This allows better performance, as the invalidation scope can be narrowed down to where the State value is read. (Ib179e)
• Add Semantics role API and add Role as a parameter to clickable, selectable and toggleable SemanticsModifier. Changed Modifier.progressSemantics so that Slider can also use it. (I216cd)
• New coroutine-based API Animatable that ensures mutual exclusiveness among its animations.
  • New DecayAnimationSpec to support multi-dimensional decay animation
  • (I820f2, b/168014930)

Version 1.0.0-alpha09

December 16, 2020

androidx.compose.ui:ui-*:1.0.0-alpha09 is released. Version 1.0.0-alpha09 contains these commits.

API Changes

• Deprecated KeyEvent.Alt is now removed. Use KeyEvent.isAltPressed instead. (Idd695)
• Modifier.keyInputFilter and Modifier.previewKeyInputFilter are deprecated use Modifier.onKeyEvent and Modifier.onPreviewKeyEvent instead (Idbf1b, b/175156384)
• Modifier.focusObserver is deprecated. Use Modifier.onFocusChanged or Modifier.onFocusEvent instead (I30f17, b/168511863, b/168511484)
• For suspending pointer input APIs, renamed HandlePointerInputScope to AwaitPointerEventScope and handlePointerInput() to awaitPointerEventScope(). (Idf0a1, b/175142755)
• Autofill API is now experimental API and requires opt-in (I0a1ec)
• Adding destructuring declarations to create FocuSRequester instances (I35d84, b/174817008)
• accessibilityLabel has been renamed to contentDescription. accessibilityValue has been renamed to stateDescription. (I250f2)
• Custom events were removed from suspending pointer input API (Ia54d5, b/175142755)
• Introduced several new functions in SelectionRegistrar and also renamed onPositionChange to notifyPositionChange. (Ifbaf7)
• More members of LayoutNode we marked as internal (I443c6)
• LayoutInfo was introduced to be used by tooling and testing (I9b190)
• AndroidOwner made internal (Ibcad0, b/170296980)
• Removed ExperimentalPointerInput annotation (Ia7a24)
• Nested scroll system added. Refer to Modifier.nestedScroll for more details (I36e15, b/162408885)
• subcomposeInto(LayoutNode) was made internal (Id724a)

• The Applier interface has changed to simplify building trees bottom-up instead of top-down.

  The insert() method has been renamed to insertTopDown().

  A new method, insertBottomUp(), was added.

  An applier either inserts nodes into the tree it is editing using insertTopDown() or insertBottomUp() depending on which performs better.

  Some trees, such as LayoutNode and View, are much more efficient to build bottom-up than top-down. Prior to this change, a stack of inserts was required to implement bottom-up which needed to be copied to every applier which needed bottom-up construction for performance. With this change an Applier overrides insertBottomUp() to build a tree bottom-up and insertTopDown() to build the tree top-down. (Icbdc2)

• Added dismissOnBackPress and dismissOnClickOutside properties to AndroidDialogProperties. These allow configuring when the dialog's onDismissRequest lambda will be invoked. (If5e17)

• Added painterResource API to handle opaquely loading Painter objects from either rasterized asset formats (like PNGs) or VectorDrawables. Consumers no longer have to determine the type of asset in advance and can call this method to get a Painter object to use in Image composables or painter modifiers. (I2c703, b/173818471)

• Added Modifier.clearAndSetSemantics to clear descendants' semantics and set new ones. (I277ca)

• Moved ContentDrawScope to ui-graphics module to be with DrawScope. (Iee043, b/173832789)

• Introduced PathEffect graphics API to provide different patterns to stroked shapes. Deprecated usage of NativePathEffect in favor of expect/actual implementation of PathEffect. (I5e976, b/171072166)

• Added IdlingResource interfaces to Compose, as a Compose supported variant of Espresso's idling resources. They can be registered and unregistered through the ComposeTestRule (I433f3)

• Removed global (un)registration of ComposeIdlingResource and global (un)registration of clocks into ComposeIdlingResource (I32660)

Bug Fixes

• Lambdas in offset modifiers now return IntOffset rather than Float. (Ic9ee5, b/174137212, b/174146755)

• Removed SlotTable, SlotReader and SlotWriter from the public API. These were marked as InternalComposeAPI previously. Now they are internal to the compose module.

  CompositionData and CompositionGroup were added as a replacement for the ui-tooling API to use to extract composition information. These are public but are not intended for use outside the ui-tooling API as they provide the raw information the ui-tooling API interprets (I31a9c)

• Refactored ShaderBrush to lazily create a shader instance when sizing information of the drawing environment is available. This is useful to define gradients that occupy the full drawing bounds of a composable at composition time, without having to implement custom DrawModifier implementations.

  Deprecated gradient function constructor APIs in favor of factory methods on a Gradient object. (I511fc, b/173066799)

• Deprecate LazyColumnFor, LazyRowFor, LazyColumnForIndexed and LazyRowForIndexed. Use LazyColumn and LazyRow instead (I5b48c)

• Deprecated BuildCompat.isAtLeastR (Idb37e)

• Added buildAnnotatedString factory function in order to build an AnnotatedString. Deprecated annotatedString builder function. (Idfe0b)

• Removed extension methods on Float and Double to convert values to radians. Moved to be a private function within the implementation PathParser which was the only place where it was used (I25f52)

Version 1.0.0-alpha08

December 2, 2020

androidx.compose.ui:ui-*:1.0.0-alpha08 is released. Version 1.0.0-alpha08 contains these commits.

API Changes

• Add semantics action Dismiss (I2b706)
• Moved DrawModifier APIs from the androidx.compose.ui package to the androidx.compose.ui.draw package. Created DrawModifierDeprecated.kt file to include typealiases/helper methods to assist with the migration from the deprecated to the current APIs. (Id6044, b/173834241)
• Renamed Modifier.drawLayer to Modifier.graphicsLayer Also updated related classes to GraphicsLayer as per API feedback. (I0bd29, b/173834241)
• New methods placeable.placeWithLayer() and placeable.placeRelativeWithLayer() were added which allows custom layouts and layout modifiers to place a child with introducing a graphics layer for their drawing. Having that we can first optimize redrawings, so when we need to move a child we don't have to redraw its content, second we can apply draw transformations for a child (Ibd8f6, b/170296989, b/171493718, b/173030831)
• <T> was removed from SubcomposeLayout declaration. You can use it without specifying a type now. (Ib60c8)
• Added Modifier.scale/rotate APIs as conveniences for drawLayer.
  • Renamed Modifier.drawOpacity to Modifier.alpha
  • Renamed Modifier.drawShadow to Modifier.shadow (I264ca, b/173208140)
• Made PointerInputData's uptime and position fields non-nullable. (Id468a)
• MaterialTheme now sets the correct colors for selection handles and selection background. Non-Material apps can manually use AmbientTextSelectionColors to customize the colors used for selection. (I1e6f4, b/139320372, b/139320907)
• Added WindowManager.isWindowFocused to check if the host window is in focus, and a WindowFocusObserver that provides an onWindowFocusChanged callback. (I53b2a, b/170932874)
• Updated TransformOrigin API to have destructuring syntax to return pivotFractionX and pivotFractionY as component1 and component2 (If43c4, b/173586560)
• Added lint check for composable lambda parameter naming and position, to check for consistency with Compose guidelines. Also migrated some APIs using children as the name for their trailing lambda to content, according to the lint check and guidance. (Iec48e)
• Added API to check if Alt, Ctrl, Meta or Shift modifier keys were pressed when a keyevent was dispatched. (I50ed9)
• Added a new Modifier.drawLayer() overload. It takes a lambda block on a new GraphicsLayerScope where you define the layer parameters in a way which allows to skip recomposition and relayout when the state change happens. DrawLayerModifier is now internal in preparation to migrating its logic into placeable.placeWithLayer() method of LayoutModifier (I15e9f, b/173030831)
• Deprecated Ambients named with Ambient as their suffix, and replaced them with new properties prefixed with Ambient, following other Ambients and Compose API guidelines. (I33440)
• Moved androidx.compose.ui.text.Typeface to androidx.compose.ui.text.font.Typeface (Ic2b81)
• Semantics argument mergeAllDescendants was renamed to mergeDescendants. (Ib6250)
• New drag gesture detector suspending pointer input API, including orientation locking. (Icef25)
• Renamed VectorAsset to ImageVector Moved and renamed VectorAsset to Builder to be an inner class of ImageVector as per API guidelines. Added typealias of VectorAssetBuilder to link to ImageVector.Builder for compat. (Icfdc8)
• Renamed ImageAsset and related methods to ImageBitmap. (Ia2d99)
• Add zIndex param for the PlacementScope's place() so Modifier.zIndex() now works as a LayoutModifier and any custom layout can set zIndexes for their children right in the placement block (I711f7, b/171493718)
• Moved foundation semantics properties to ui (I6f05c)
• Deprecate place(Offset) and placeRelative(Offset). Use overloads with int offsets instead (I4c5e7)
• Previously Deprecated APIs were removed: Modifier.onPositioned was removed, use Modifier.onGloballyPositioned. Modifier.onDraw was removed, use Modifier.onDrawBehind. Modifier.plus was removed, use Modifier.then. Color.Unset was removed, use Color.Unspecified. PxBounds class was removed, use Rect instead. (Ie9d02, b/172562222)
• The Alignment interface was updated and made functional. (I46a07, b/172311734)
• Gesture detector for tap, double-tap, long press, and press indication were added using the new suspending pointer input. A few utilities were added as well, making it easier for developers to write their own gesture detectors. (I00807)
• id was renamed to layoutId for LayoutIdParentData. Measurable.id was renamed to Measurable.layoutId. (Iadbcb, b/172449643)
• New multitouch gesture detector, including helpers for detecting rotation, zoom, and panning. (Ic459d)
• Introduced SweepGradientShader and SweepGradientBrush APIs. (Ia22c1)
• Time control in tests (TestAnimationClock and its usages) is now experimental (I6ef86, b/171378521)

• Add coroutine-based scrolling APIs:

  Adds LazyListState.snapToItem and LazyListState.smoothScrollBy, as well as lower-level APIs for scroll control. These APIs provide a suspend interface to control scrolling that waits until the scroll is finished before returning. (Ie5642)

• Modifier.focusable has need added in foundation. Use this to add focusable behavior to a component, with correct semantics and accessibility. (I41eb9, b/152525426, b/162865824)

• Provide default implementations of methods and properties in AnimationClockTestRule that can be delegated to its clock (I7ea3d, b/173399709)

• AndroidComposeTestRule can now accept custom activity launchers (Ib8288, b/153623653, b/154135019)

• TextLayoutResult.getLineVisibleEnd is deprecated. As a replacement TextLayoutResult.getLineEnd now has a new parameter visibleEnd. (I73282)

• Updated TextFieldValue API

  • made TextFieldValue.composition readonly
  • removed exception thrown for invalid selection range (I4a675, b/172239032)

• Support TtsAnnotation for text to speech engine. (I54cc6)

• New APIs for running animations in coroutines (Ied662)

Bug Fixes

• The alignment parameter of Box was renamed to contentAlignment. (I2c957)
• offsetPx modifiers were renamed to offset. They are now taking lambda parameters instead of State. (Ic3021, b/173594846)
• Added resetInput parameter to TextInputService#onStateUpdated (I3e8f5, b/172239032, b/171860947)
• Added lint check for Modifier parameters in Composable functions. This lint check checks the naming, return type, default value, and order of the parameter for consistency with Compose guidelines. (If493b)
• Temporarily added option to let the TestAnimationClock be driven by the MonotonicFrameClock (I1403b, b/173402197)
• Added Android Typeface wrapper. You can load an Android Typeface via typeface function i.e. typeface(Typeface.DEFAULT). Also renamed typefaceFromFontFamily() to typeface() (I52ab7)
• Added lint check to check that Modifier factory functions are defined as extensions on Modifier, so they can be fluently chained together. (I07981)
• Remove old ui-test module and its stubs (I3a7cb)
• Recomposer no longer accepts an EmbeddingContext; required scheduling dependencies are obtained from the effectCoroutineContext. FrameManager is deprecated; platform integrations should initialize their own global snapshot handling. (I02369)
• Pass style information to accessibility node. (If5e8d)
• TextUnit.Inherit is renamed to TextUnit.Unspecified for consistency with other units. (Ifce19)

Compose UI Version 1.0.0-alpha07

November 11, 2020

androidx.compose.ui:ui-*:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

API Changes

• Introduced ScaleFactor inline class to represent scale factors for the horizontal and vertical axes independent of one another in order to support non-uniform scaling use cases.
  • Added computeScaleFactor method to ContentScale
  • Added ContentScale.FillBounds to perform non-uniform scaling to stretch the src bounds to fully occupy the destination.
  • Added operator methods to compute ScaleFactor parameters with Size parameters.
  • (Ic96a6, b/172291582)
• The BiasAlignment and BiasAbsoluteAlignment factories for creating Alignments were added. (Iac836, b/169406772)
• Allow a developer to forcefully clear focus. (I90372)
• A bug causing elevation not being drawn for Views inside Compose was fixed. (If7782)
• Created onDrawBehind API within ContentDrawScope to match naming convention with Modifier.drawBehind. (I4fc3a, b/171955269)
• Add support for camera distance to complement 3d transformations rotationX/rotationY on layer APIs. (I40213, b/171492100)
• Added SelectionContainer without the callback (Ibfadb)
• ExperimentalSubcomposeLayoutApi annotation was removed. SubcomposeLayout can now be used without adding @OptIn (I708ad)
• FirstBaseline and LastBaseline were moved to androidx.compose.ui.layout package (Ied2e7)
• Removed opacity from drawShadow() modifier as it was confusing. (I82c62, b/171624638)
• MeasureResult was moved out of MeasureScope. (Ibf96d, b/171184002)
• Several layout related symbols were moved from androidx.compose.ui to androidx.compose.layout.ui. (I0fa98, b/170475424)
• Removed Deprecated FocusState2 (I686cb, b/168686446)
• ZIndexModifier is now internal (I1808b, b/171493718)
• Updated return type of lerp method on Size parameters to return a non-null Size to avoid unnecessary boxing. (Ib0044)
• Added TestMonotonicFrameClock for testing code that relies on Compose's MonotonicFrameClock for awaiting composition frame events using kotlinx-coroutines-test's runBlockingTest (I4402f)
• Removed GestureScope.localToGlobal (I15299, b/171462785)
• Added onAllNodesWithSubstring finder (I81dd7, b/171462889)
• androidx.ui.test module deprecated. Please migrate to androidx.compose.ui.test and androidx.compose.ui.test.junit4 (I452e8)

Bug Fixes

• captureToBitmap moved to captureToImage. (I86385)
• foundation.Text has been deprecated and replaced with material.Text. For a basic, unopinionated text API that does not consume values from a theme, see androidx.compose.foundation.BasicText. (If64cb)
• Update TextFields to accept KeyboardOptions (Ida7f3)
• Rename KeyboardOptions as ImeOptions (I82f36)
• Moved KeyboardType and ImeAction into KeyboardOptions (I910ce)
• provideDefault was added as an alternative for providing ambients, and it can be used to specify ambient values that will only be set when there is no ambient value already provided. (Id6635, b/171024925)
• BaseTextField has been deprecated. Use BasicTextField instead. (I896eb)
• Introduce ui-test-junit4 module (Ib91f8)
• relativePaddingFrom was renamed to paddingFrom. The paddingFromBaseline modifier was added, as convenience for specifying distances from layout bounds to text baselines. (I0440a, b/170633813)
• LaunchedTask was renamed to LaunchedEffect for consistency with the SideEffect and DisposableEffect APIs. LaunchedEffect with no subject params is not permitted in order to encourage best practices. (Ifd3d4)
• Introduced resources composable that recomposes when the configuration updates. (I6387c, b/167352819)
• Recomposer now requires a CoroutineContext at construction (Ic4610)
• Sum zIndex values when multiple Modifier.zIndex() applied. Previously the first one was winning. (Ic514c, b/170623936)
• Changes to the internal SlotTable implementation which should not affect the public API. (If9828)
• Added Keyboard auto correct IME Option (I57b8d)
• androidx.ui.test moved to androidx.compose.ui.test (I9ffdb)
• Removed KeyboardOptions.toImeOptions from public API. (Ic2e45)

External Contribution

• Disabled publication of internal artifact androidx.compose.ui:ui-text-android (Ib93fa)

Version 1.0.0-alpha06

October 28, 2020

androidx.compose.ui:ui-*:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

API Changes

• Recomposer is now a CompositionReference and a valid composition parent. Explicit Recomposer is now required in fewer places. (I4036f)
• Deprecate VectorPainter in favor of rememberVectorPainter to better indicate that the composable API internally leverages 'remember' to persist data across compositions. (Ifda43)
• Updated Modifier.drawWithCache API to expose ContentDrawScope as a receiver scope instead of DrawScope in order to provide implementations the ability to re-order drawing commands. This is useful for blending/ tinting use cases in which content pixels must be rendered first in order for the corresponding blend mode algorithm to be applied properly. (Ie7ec8)
• Move SimpleContainer into PopupTestUtils.kt (I78c57)
• ConsumedData is no longer a data class. See https://android-review.googlesource.com/c/platform/frameworks/support/+/1455219 for details (I1737f)
• Fix Rtl Handle Position. (I6e1e0)
• Refactored DrawScope and ContentDrawScope to be interfaces instead of abstract classes
  • Created CanvasDrawScope implementation of DrawScope
  • Refactored implementations of DrawScope to use CanvasScope instead
  • Created DrawContext to wrap dependencies for DrawScope
  • Removed deprecated methods on DrawScope (I56f5e)
• Breaking change: removed the return value from PointerInputFilter.onPointerEvent(...) given that the only value that should be able to be changed in pointer events is consumption data. Instead of returning data from PointerInputFilter.onPointerEvent(...), now you can just mutate the consumption data of the PointerEvents passed in. (I6acd0)
• MeasureScope and IntrinsicMeasureScope were made interfaces. (I1a087, b/170461665)
• The merge function for AlignmentLine was hidden. (I9da1a, b/170612900, b/170611568)
• Add ability to specify inspector info in composed modifier (Idee08, b/163494569)
• Added SelectAll option into selection menu (Ief02b)
• Updated DrawTransform.rotate to take a default pivot parameter of center to match the documentation.
  • Updated DrawScope.rotateRad to consume an Offset for the pivot point to match other transformation methods.
  • Deprecated DrawScope.rotateRad overload that consumed floats for the x and y coordinate of the pivot.
  • (Iffcbb, b/170434992)

Bug Fixes

• API lint check for MissingGetterMatchingBuilder is enabled for androidx (I4bbea, b/138602561)
• Add test. (I6b8ae)
• Enable transitions in ComposeTestRule; remove option to enable the blinking cursor from ComposeTestRule. (If0de3)
• Added KeyboardCapitalization IME Option (I8ac38)
• Added single line keyboard option to CoreTextField (I72e6d)
• Move SimpleContainer into PopupTestUtils.kt (I65c3e)
• Renamed Radius API to CornerRadius to better express how it is used throughout Compose. Updated documentation to indicate that negative corner radii are clamped to zero. (I130c7, b/168762961)
• Improved Android interop by continuing to send MotionEvents to child Android Views that return false for onTouchEvent for all actions except ACTION_DOWN (I94c5a, b/170320973)
• Box was made an inline function. (Ibce0c, b/155056091)

External Contribution

• Support different locales for AnnotatedString.capitalize and AnnotatedString.decapitalize (I4aa7f)

Version 1.0.0-alpha05

October 14, 2020

androidx.compose.ui:ui-*:1.0.0-alpha05 is released. Version 1.0.0-alpha05 contains these commits.

API Changes

• Add a DSL for specifying inspector information (Ic9a22)
• Move LongPress into Text. (Iff2bc)
• Experimental Modifier.pointerInput suspending input modifier (Ia77d2)
• Added Copy/Paste/Cut accessibility actions (I6db4f)
• Public constructor for AndroidOwner was removed (Iacaef)
• Popups and dialogs now inherit FLAG_SECURE from parent Window. Also added option to configure this explicitly (I64966, b/143778148, b/143778149)

• Consumption data is now mutable. Also calls to extension functions that do consumption now no longer return a new PointerInputChange, but instead mutate the provided PointerInputChange.

  This is the first step in a 2 step process to make PointerEvent data mutable such that other pointer data cannot be edited by user code. The second step will be to remove the List<PointerInputChange> return type from PointerInputFilter.onPointerEvent(...). (Id067e)

• Disable Selection in Text, and a Demo. (Ie7e97)

• Made onGloballyPositioned an inline function (I15830)

• OnPositionedModifier is renamed to OnGloballyPositionedModifier and onPositioned() is renamed to onGloballyPositioned(). (I587e8, b/169083903)

• The hasPendingMeasureOrLayout property was added to Owner, telling whether the Owner has any pending layout work. (I3d9f8, b/169038599)

• Added API to programmatically clear focus (Ie1dc2, b/161487952)

• Removed PointerInputFilter.onPointerInput(...). PointerInputFilter.onPointerEvent(...) should be used in its place. (I6f04a)

• Changes to Size

  • Removed Size.getFlipped
  • Removed Size.rem
  • Removed Size.truncDiv (Ief44d, b/169790720)

• As part of the standardization of sentinel values for inline classes, rename Color.Unset to Color.Unspecified for consistency with other inline classes (I97611, b/169797763)

• TextOverflow.None is introduced. When overflow is None, Text won't handle overflow anymore, and it will report its actual size to LayoutNode. (I175c9, b/158830170)

• The scope parameter within AnnotatedString.Builder.addStringAnnotation is renamed to tag for API consistency. (I7c8cb)

Bug Fixes

• The scrolling performance of LazyColumn/Row is improved by doing less work in subcomposition on every scroll. The new hasInvalidations() method was added for Composition class. hasPendingChanges() method from Recomposer was renamed to hasInvalidations() (Ib2f32, b/168293643, b/167972292, b/165028371)
• Updated Size.Unspecified parameters to be Float.NaN instead of Float.POSITIVE_INFINITY. Updated Painter implementations to check against Size.Unspecified as well as non-finite Sizes. (I95a7e)
• The order of place() calls in custom Layouts now defines the drawing order for the children (Ibc9f6)
• Support AnnotatedString to SpannableString conversion for accessibility. (Ief907)
• Added stubs for android classes that are on older platforms to avoid use of reflection when possible. (Ia1790)
• Fixed bug: If the software keyboard showing caused the app to translate, pointer input coordinates would become incorrect. (Ic4cec, b/163077821)

Version 1.0.0-alpha04

October 1, 2020

androidx.compose.ui:ui-*:1.0.0-alpha04 is released. Version 1.0.0-alpha04 contains these commits.

API Changes

• Added OwnerScope to allow collection of layout and drawing observation scopes once they are no longer valid. (Ic4cf8)
• Added OnRemeasuredModifier and onSizeChanged() to receive a callback when content layout has been remeasured and the size has changed, respectively. (I657cf, b/154108792)
• Add long click semantics action (I6281b, b/156468846)
• Made FocusManager private. (I7872f)

• Updated implementation to create a dedicated DrawCacheModifier implementation instead of adding optional properties on DrawModifier.

  Updated documentation for various methods (Ibd166)

• Make TextRange inline to avoid object creation. (Id034b)

• PlacementScope#parentWidth and PlacementScope#parentLayoutDirection can no longer be read from the placement block of a custom layout. (Icc1ae, b/168295623)

• add AccessibilityScrollState to semantics properties. (Ifeda9)

• Introduced Modifier.drawWithCache to support creating a drawing object that conditionally recreates dependencies that depend on size/state information (I376dc)

• ParagraphConstraints is removed. Width is directly passed to Paragraph now. (Ica712)

Bug Fixes

• Updated many Graphics APIs
  • Updated scale and rotation transformation APIs to consume a single Offset parameter to represent the pivot coordinate instead of separate float parameters for the x/y coordinates in DrawScope and DrawTransform
  • Removed Rect.expandToInclude and Rect.join methods
  • Updated Radius documentation to say oval in addition to elliptical
  • Added documentation to indicate the public constructor for the inline Radius class is not to be called directly but instead Radius objects should be instantiated through their function constructors
  • Removed RoundRect APIs to query topRight, bottomRight, bottomCenter, etc.
  • Deprecated Rect.shift in favor of Rect.translate
  • Removed RoundRect.grow and Rect.shrink APIs
  • Renamed RoundRect.outerRect to Rect.boundingRect
  • Removed RoundRect.middleRect/tallMiddleRect/wideMiddleRect and Rect.isStadium methods
  • Renamed RoundRect.longestSide to RoundRect.maxDimension
  • Renamed RoundRect.shortestSide to RoundRect.minDimension
  • Changed RoundRect.center to be a property instead of a function
  • Updated RoundRect constructor to consume Radius properties instead of individual parameters for x/y radius values
  • Removed Size APIs that assumed it was a Rectangle with origin at 0,0
  • Added a destructing API to Radius
  • Migrated various RoundRect extension functions to be properties instead
  • (I8f5c7, b/168762961)
• foundation.Box was deprecated. Please use foundation.layout.Box instead. (Ie5950, b/167680279)
• Stack was renamed to Box. The previously existing Box will be deprecated in favor of the new Box in compose.foundation.layout. The behavior of the new Box is to stack children one on top of another when it has multiple children - this is different from the previous Box, which was behaving similar to a Column. (I94893, b/167680279)
• Box decoration parameters have been deprecated. If you want to have decorations/padding on your box, use Modifiers instead (Modifier.background, Modifier.border, Modifier.padding) (Ibae92, b/167680279)
• Updated many Graphics APIs
  • Updated DrawScope APIs with scoped transformation methods to indicate that the transformation is only applied within the callback and removed after the callback is invoked
  • Updated clipPath documentation to refer to Path instead of rounded rectangle
  • Fixed spacing in documentation for right parameter in clipPath
  • Renamed DrawScope.drawCanvas to drawIntoCanvas and removed size parameter
  • Renamed dx/dy parameters in inset method to horizontal and vertical
  • Added inset overload that provides the same inset value to all 4 bounds
  • Removed documentation on inset method indicating that inset would be applied to all 4 sides
  • Updated documentation for Rect class
  • Updated comments on Rect parameters to match kdoc style
  • Removed Rect.join and Rect.expandToInclude
  • Created overload for Rect.translate(offset) and deprecated Rect.shift
  • (If086a, b/167737376)
• Annotated rootAnimationClockFactory, transitionsEnabled, blinkingCursorEnabled and textInputServiceFactory with @VisibleForTesting, make them internal API and hide their kdoc (I554eb, b/168308412)
• Remove SelectionContainer from the Top to disable default selection and avoid unexpected behavior. One can specifically use a SelectionContainer to wrap the content that needs to be selectable instead. (I8dfe0, b/158459594)

Version 1.0.0-alpha03

September 16, 2020

androidx.compose.ui:ui-*:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

API Changes

• Remove scroll forward/backward semantics actions. Added steps in AccessibilityRangeInfo. (Ia47b0)
• Removed onInvalidate() from Owner -- OwnedLayer handles invalidation. (Ica72b, b/162061312)

• Removed operator methods on Size API that consume Offset parameters. The result of these operations is unclear and the type of result is unexpected for these. Ex. should size - offset return an offset or a size result with the difference?

  Also removed deprecated methods on Size class. (Iec902, b/166514214)

Bug Fixes

• Fix for items of LazyColumn being incorrectly drawn sometimes, this was also causing crashes in some conditions. (Ibcf17, b/163066980, b/165921895)
• DpConstraints and APIs using it were deprecated. (I90cdb, b/167389835)
• Moved createAndroidComposeRule and AndroidInputDispatcher from androidx.ui.test.android to androidx.ui.test (Idef08, b/164060572)
• Usages of gravity were consistently renamed to align or alignment in layout APIs. (I2421a, b/164077038)
• Added onNode and other global methods on ComposeTestRule as the current global ones are going to be deprecated. (Ieae36)

Version 1.0.0-alpha02

September 2, 2020

androidx.compose.ui:ui-*:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

API Changes

• remove callback to notify Owner when layoutnode bounds change. (If654e, b/166106882)
• Added support for filltype parameters on vector graphics paths to support cutouts of shapes according to evenOdd or NonZero path fill rules. (I43dd2)
• Uptime and Velocity are now inline classes (I48f4a)
• Duration is now an inline class (I565eb)
• Add a callback to notify Owner when layoutnode bounds change. (Ic40b3)

• Fixed issue where Rect function constructor with Offset and radius would create the Rect in the order of left, right, top, bottom instead of left, top, right, bottom.

  Removed deprecated companion methods on Rect in favor of function constructors.

  Added tests to verify methods in Rect.kt (I08460, b/165822356)

Bug Fixes

• Added MutableRect, a rectangle that can be modified. (I71bd2, b/160140398)
• Matrix4 was replaced with Matrix. All other parts of vectormath package have been removed. (Ibd665, b/160140398)

• The calling convention for composable functions has changed. This is a binary breaking change. All libraries must be recompiled to work with this version of the compose compiler plugin.

  This change does not create a source level breaking change as the only APIs that have changed are compiler APIs that have an explicit opt in. (I7afd2, b/158123185)

• Fixed crash that could occur when dispatch to a PointerInputFilter could cause the PointerInputFilter to be synchronously removed. (I58f25)

Version 1.0.0-alpha01

August 26, 2020

androidx.compose.ui:ui-*:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

Version 0.1.0-dev

Version 0.1.0-dev17

August 19, 2020

androidx.compose.ui:ui-*:0.1.0-dev17 is released. Version 0.1.0-dev17 contains these commits.

API Changes

• emitView was deprecated. Use AndroidView instead if possible for emitting Views inside Compose. Note that composing Views and ViewGroups directly will not be supported in the future unless these are leaves in the composition tree, case when this can be achieved using AndroidView. (I29b1e, b/163871221)
• FocusState2 is deprecated and replaced by FocusState (Ia8b79, b/160822876, b/160923332)
• The deprecated AndroidView overloads were removed. (I946b9, b/163802393)
• Custom emits can now declare that one or more of its setters can be skipped and recomposed independently of the emit. (Ibbd13)

• Changed Vector classes to no longer be data classes as the same object instance is used for composition.

  Added mutableStateOf flag for VectorPainter to conditionally re-draw if contents of the vector change.

  Refactored VectorComponent instance to be part of VectorPainter as it is re-used across compositions.

  Updated GroupComponent and PathComponent to have their name fields be mutable (Ieae45, b/151378808)

• Removed onChildPositioned and OnChildPositionedModifier. Developers should use onPositioned and OnPositionedModifier on the child layout instead. (I4522e, b/162109766)

• Offset has become an inline class (Iaec70)

• Added a modifier param to SelectionContainer (I4aada, b/161487952)

• Removed deprecated FocusModifier (I0b4ba, b/160922116, b/160821157, b/162441435, b/160822875, b/160921940)

• Added mergePolicy lambda to SemanticsPropertyKey. This can be used to define a custom policy for mergeAllDescendants semantics merging. The default policy is to use the parent value if already present, otherwise the child value. (Iaf6c4, b/161979921)

• Constraints is now an inline class (I88736)

• Added FocusManager that moves common focus logic out of AndroidComposeView (I528ef, b/161487952, b/162206799)

• Updated PointerEventPass names for Alpha release. (Ifda6f)

• IntOffset is now an inline class (Iac0bf)

• IntSize is now an inline class (I2bf42)

• PlacementScope.placeAbsolute() was renamed to PlacementScope.place(), and the previous PlacementScope.place() was renamed to PlacementScope.placeRelative(). As a result, the PlacementScope.place() method will not automatically mirror the position in right-to-left contexts anymore. If this is desired, use PlacementScope.placeRelative() instead. (I873ac, b/162916675)

• AlertDialog now uses FlowRow for buttons (I00ec1, b/161809319, b/143682374)

• Made some test utilities non public because they are not where they belong. Will be made public in the future. (I32ab1)

• Refactored organization of pointer input code. (Ie3f45)

• Deprecated PxBounds in favor of Rect. Updated all usages of PxBounds with rect and added proper deprecate/replace with annotations to assist with the migration. (I37038, b/162627058)

• Removed Deprecated KeyEvent2. Use KeyEvent instead. (Ied2d0, b/162097587)

• KeyEvent has a unicode property that can be used to get the unicode character generated by the specified key and meta key state combination (If3afc)

• Made the DelayUp custom event and related classes an opt in API as it is very likely going to be changed. (I56d6f)

• Removed 2 PointerEventPasses that are no longer needed. (I3dd9d)

• Add parameter color, shadow and TextDecoration to Paragraph.paint This function is useful to avoid unnecessary Paragraph recreation. (I81689)