September 10, 2025

Important changes since 1.10.0:

  • Added MediaCapabilities API to PickVisualMediaRequest to let applications specify its media capabilities, such as supported HDR Types.
  • Activity is now compiled with API 36.

Bug Fixes

  • Fixed perfettoSdkTracing=true (e.g. when tracing Compose in a microbenchmark) would kill the target process if it was already running, and a StartupMode wasn't specified. Ib2c1f

Important changes since 1.4.0:

  • High-speed and Slow-motion Recording: Easily integrate high-speed (120/240 fps) and slow-motion video recording with minimal code. Refer to Recorder#getHighSpeedVideoCapabilities(CameraInfo) and HighSpeedVideoSessionConfig for details.
  • SessionConfig and FeatureGroup API: The new SessionConfig API allows you to configure the camera session and enable multiple features together safely, including HLG (HDR), UltraHDR, 60 FPS, and Preview stabilization. You can also set a preferable feature group with priority, letting CameraX determine the optimal supported combination. See SessionConfig.Builder#setPreferredFeatureGroup, SessionConfig.Builder#setRequiredFeatureGroup, and CameraInfo#isFeatureGroupSupported(SessionConfig) for more information.
  • Deterministic Frame Rate API: Address previous limitations with setTargetFrameRate by using CameraInfo.getSupportedFrameRateRanges(sessionConfig) to query and SessionConfig.setExpectedFrameRateRange to set precise and supported frame rates.
  • Camera Extensions: UltraHDR format is now supported with Extensions. Check ImageCapture.getImageCaptureCapabilities(cameraInfo).getSupportedOutputFormats() and enable it in ImageCapture.Builder.setOutputFormat. Zoom ratio and preview stabilization capabilities are now reflected when Extensions are enabled.
  • Torch Strength: Adjust torch strength using CameraControl.setTorchStrengthLevel.
  • Low Light Boost Mode: You can enable the low light boost mode(CONTROL_AE_MODE_ON_LOW_LIGHT_BOOST_BRIGHTNESS_PRIORITY) by the following APIs: Refer to CameraInfo#isLowLightBoostSupported, CameraInfo#getLowLightBoostState, and CameraControl#enableLowLightBoostAsync.
  • Video Capture: VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGE is now triggered for insufficient storage during recording. PendingRecording.withAudioEnabled(boolean initialMuted) allows controlling the initial mute state for audio recording.
  • Image Capture: Support for DNG (RAW) and JPEG + DNG (RAW) formats in ImageCapture. Check ImageCaptureCapabilities(CameraInfo).getSupportedOutputFormats() for RAW support. Use overloaded takePicture APIs with multiple OutputFileOptions for RAW+DNG capture.
  • Image Analysis: Support for NV21 format in ImageAnalysis. Enable it with ImageAnalysis.Builder.setOutputImageFormat(OUTPUT_IMAGE_FORMAT_NV21).

Important changes since 1.4.0:

This is the first stable release of the Camera Viewfinder library, providing robust, lifecycle-aware, and easy-to-use View and Compose-based APIs. These components are designed to serve as a camera viewfinder and can be integrated directly with Camera2.

This release also establishes the foundation for the new androidx.camera:camera-compose artifact, which introduces CameraXViewfinder, a Compose-idiomatic viewfinder that integrates seamlessly with CameraX SurfaceRequests, similar to how PreviewView works for View-based layouts. Some of the most important changes include:

  • Artifact Relocation: To improve modularity, the Viewfinder artifacts have been moved to their own library group. Developers previously using androidx.camera:camera-viewfinder* dependencies should migrate to androidx.camera.viewfinder:viewfinder-*.
  • API Stabilization and Refinements: The API surface has been polished for this stable release. This includes renaming CameraViewfinder to ViewfinderView to better reflect its versatility, reorganizing packages for clarity, and making ViewfinderSurfaceRequest an immutable data type for more predictable state management.
  • Compose API Updates: The Compose Viewfinder API now supports ContentScale and Alignment for fine-grained control over how the camera stream is displayed within its container, mirroring the behavior of the standard androidx.compose.foundation.Image composable.
  • Surface Lifecycle Management: ViewfinderSurfaceSession is now kept alive across configuration changes and lifecycle events on API 29+. This change is designed to reduce dropped frames and provide a smoother user experience.
  • Implementation Mode Defaults: The Viewfinder now defaults to an intelligent ImplementationMode that automatically selects the best underlying implementation. It prioritizes the high-performance SurfaceView (EXTERNAL mode) and gracefully falls back to the more compatible TextureView (EMBEDDED mode) on older API levels or devices with known compatibility issues. This behavior can still be overridden for full developer control.

Bug Fixes

  • The composable Viewfinder now works correctly within Compose's Pager and with movableContentOf(), ensuring the surface is properly reset and managed in complex UI scenarios. I0d9be I79432
  • Fixed an issue on Android 10 and 11 where the SurfaceView-based Viewfinder could appear stretched when transformations were applied. Icc77c

API Changes

  • Removes ComposeFoundationFlags.isNonComposedClickableEnabled I0dfc0 b/406228525
  • 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
  • Marked ScrollState.value as @FrequentlyChangingValue property. I4723d
  • Introduced LazyLayoutKeyIndexMap and a factory for a default implementation. I4fd0c b/415038029

Bug Fixes

  • Column and Row now correctly pass the item's actual size to Modifier.align, resolving an issue where custom Modifier.align implementation received an incorrect 0 value. I8194f b/439716351

New Features

  • Added Text composable overloads accepting a ColorProducer lambda that enables efficient color changes without triggering a full recomposition. I9ff25 b/407055128

API Changes

  • Rename Scrim() to LevitatedPaneScrim() and hide properties of Levitated and Reflowed classes. I090e1 b/427953101
  • Hide calculatePosture() API as internal Ie7227 b/424442112
  • Expose PaneScaffoldHorizontalOrder as a sealed public API Ia4ebe
  • Mark window size and posture related APIs as experimental. I4ee96

Bug Fixes

  • Fixed keyboard navigation order so that focus goes from the fab button to the first item at the top. Icaaa1 b/422762939
  • Improve Navigation Drawer keyboard a11y: drawer is no longer focusable when dismissed, it can be closed via esc key, and its content receives focus when opened. Idb995 b/422793544 b/422793651 b/422797424
  • Time picker's clock face now responds to keyboard navigation/input. I9d5d9 b/425710631
  • Use new initial anchor when pane expansion anchor list changes I91cd1 b/438829477

API Changes

  • Introduces group key based Compose stack traces that work in minified apps. The proguard mapping for these traces will be generated by Compose compiler Gradle plugin starting from Kotlin 2.3.0. These stack traces are disabled by default, use ComposeStackTraceMode.GroupKeys to enable them. Ifbcb5
  • Add interface: IdentifiableRecomposeScope for tooling Idd5e0 b/434194620
  • Prevented unnecessary invalidations from occurring in compositions involving CompositionLocalContexts I3fa21 b/412750209

Bug Fixes

  • Clarified in documentation and in tooling that keys passed to retain are also retained. Avoid passing keys to retain that will lead to a memory leak. Ib553b b/177562901
  • Fixed and issue when a paused composition's resume() is called on a different thread, the state of the pending notifications could get confused when the main thread tries to recompose the pausable composition for the next frame. Ie5f17 b/442649894
  • Log exceptions captured in composition. I47d78 b/432799675 b/436878515 b/359623674 b/400436355

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

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

Important changes since 1.2.0:

  • The hiltViewModel() APIs for Compose have been moved to a new artifact (androidx.hilt:hilt-lifecycle-viewmodel-compose) and package (androidx.hilt.lifecycle.viewmodel.compose) such that they can be used without transitively depending on androidx.navigation.

Bug Fixes

  • Prevent crash when a predictive back event is delivered mid-frame after the handler was disabled in a NavHost transition. I5667c b/384186542

API Changes

  • The DecoratedNavEntryProvider has been replaced with rememberDecoratedNavEntries that creates and return NavEntries decorated with the list of provided decorators I0fe1c b/441328236
  • NavBackStack is now generic over the NavKey type. This allows apps and libraries to define custom key types for their back stacks, rather than being restricted to NavKey. I4d190 Iad2f4 b/420443609
  • NavBackStack is now @kotlinx.serialization.Serializable, making it possible to save and restore navigation state across process death and configuration changes without extra boilerplate. I2c3cf b/420443609
  • RememberNavBackStack has been moved to commonMain to ensure it is provided on all platform targets. Id69e7 b/420443609

Bug Fixes

  • NavDisplay now correctly moves each individual NavEntry to the correct Lifecycle.State. I30aac b/440145700
  • Fixed an issue where NavDisplay would ignore any nested NavigationEventDispatcherOwner set via the NavigationEvent library's LocalNavigationEventDispatcherOwner. I6224a

Dependency Changes

New Features

  • Introduce a lambda-based NavigationEventHandler API that replaces the Flow-based handler. Handle back and forward gestures with simple callbacks instead of collecting flows, reducing boilerplate and avoiding cancellation issues. Provide NavigationBackHandler and NavigationForwardHandler as targeted convenience APIs. Remove the Flow-based NavigationEventHandler; migrate to the new callbacks. I23bac b/436248277
  • Allow passive listeners to access the full navigation back stack through combined back info. Enable UIs to render previews and nested navigation history instead of being limited to the top-most callback. I7a510 b/436248277
  • Introduce an explicit back/current/forward model to clarify navigation state and support forward navigation with nested handlers. Ib86da b/420443609
  • Add onForward* methods and isForwardEnabled to NavigationEventCallback. Ic100f b/436248290
  • Add forward navigation support to NavigationEventInput. I5734b

API Changes

  • Enable testing of forward navigation events with TestNavigationEventCallback. Use isForwardEnabled and onForward* hooks. I21fb5 b/420443609
  • Rename onEvent* callbacks to onBack* in NavEvent. I228b3 b/436248290
  • Convert SwipeEdge to an inline class. Id5e01
  • Make the navigationevent library interoperable with Java. All public APIs are now fully accessible from Java code, enabling seamless integration into mixed-language or Java-only projects. (Ibc944,I5465f, I9fb1e, b/440532890b/443040294)
  • Clarify API roles by renaming NavigationEventCallback to NavigationEventHandler. This change better reflects the class's purpose of handling multi-stage navigation gestures. The corresponding addCallback method is now addHandler. I2492a b/443040331

Bug Fixes

  • Prevent back fallback from running on forward navigation. I74814 b/436248290
  • Add support for predictive forward navigation. NavigationEvent APIs now handle both back and forward gestures, enabling consistent animations for both navigation directions. Idc98c b/436248290
  • Prevent an IllegalStateException crash during recomposition when a child NavigationEventDispatcherOwner is removed. Iff50c b/412629020
  • Passive listeners can now access the full navigation back stack through combined back info, enabling UIs to render previews and nested navigation history instead of being limited to the top-most callback. I7a510 b/436248277

API Changes

  • Added a new PagingState API closestItemAroundPosition to retrieve the loaded item that is closest to the target position and matches the input predicate. This can be used to generate item-based refresh keys where the ideal anchorable item is around but not at the exact target position. I96e5c b/440187139

Important changes since 2.7.0:

  • Added a new artifact androidx.room:room-sqlite-wrapper which contains APIs to get a SupportSQLiteDatabase wrapper from a RoomDatabase with a configured SQLiteDriver. To get the wrapper use the new extension function RoomDatabase.getSupportWrapper(). This is a compatibility artifact to maintain usages of SupportSQLiteDatabase, usually obtained from roomDatabase.openHelper.writableDatabase, even if the Room database is configured with a SQLiteDriver. This wrapper is useful for incremental migration of codebases who wish to adopt SQLiteDriver APIs but have extensive usages of the SupportSQLite APIs yet they want to take advantage of the BundledSQLiteDriver. Checkout the migration guide for more information.
  • Added support for KMP targets Watch OS and Tv OS.
  • Updated the library’s Android minSDK from API 21 to API 23

Important changes since 2.5.0:

  • Support loading SQLite extensions by adding the addExtension function to BundledSQLiteDriver, which can be used to register extensions that SQLite should dynamically load for connections opened with that particular driver.
  • Added support for KMP targets Watch OS and Tv OS.
  • Updated the library’s Android minSDK from API 21 to API 23.

Bug Fixes

  • Fix HorizontalPagerScaffold usage of its modifier parameter so that HorizontalPager does not lose the page indicator if adding a Modifier.fillMaxSize() I07ae1 b/441682601
  • Align ScrollIndicator direction with content layout direction by default. I0da0f b/441489028
  • Fixed ScrollAway issue when used with TransformingLazyColumn. TimeText was not scrolling correctly after navigating to another screen and back. Ic0ef1 b/433549148
  • Corrected TransformingLazyColumn reporting of SCROLL_BACKWARDS and SCROLL_FORWARDS semantics for edge cases at the top/bottom of the screen. I5c28d b/405205994
  • Fix a bug in SwipeDismissableNavHost that in-progress transitions were not marked as completed after swiping back on API 36. Ife72e b/441089689
  • Update the default OpenOnPhoneMaxSweepAngle to 200 degrees to prevent some translations of ‘Check your phone’ being truncated. Ib2e4c b/428243902

API Changes

  • Added non-clickable variants for Card, TitleCard, OutlinedCard and AppCard I509bb b/406690146
  • Removed the interactionSource parameter from new non-clickable card APIs. If0c7a b/440323280
  • Added a new MinutesSeconds type to the TimePicker component, which displays only minute and second columns, omitting the hour column Ia9e94 b/438004664

Bug Fixes

  • Fix HorizontalPagerScaffold usage of its modifier parameter so that HorizontalPager does not lose the page indicator if adding a Modifier.fillMaxSize() I07ae1 b/441682601
  • Align ScrollIndicator direction with content layout direction by default. I0da0f b/441489028
  • Fixed ScrollAway issue when used with TransformingLazyColumn. TimeText was not scrolling correctly after navigating to another screen and back. Ic0ef1 b/433549148
  • Corrected TransformingLazyColumn reporting of SCROLL_BACKWARDS and SCROLL_FORWARDS semantics for edge cases at the top/bottom of the screen. I5c28d b/405205994
  • Fix a bug in SwipeDismissableNavHost that in-progress transitions were not marked as completed after swiping back on API 36. Ife72e b/441089689
  • Update the default OpenOnPhoneMaxSweepAngle to 200 degrees to prevent some translations of ‘Check your phone’ being truncated. Ib2e4c b/428243902

Bug Fixes

  • Prevent WearApiVersionHelper from throwing on older devices when checking newer APIs.

Important changes since 1.1.0:

  • Exposed physical button location constants.
  • Added WearableRemoteInputExtender for setting Wear-specific extras on android.app.RemoteInput (for example, enabling Emoji input)

Important changes since 1.0.0:

  • Added a content description field to Ongoing Activities, which is used by accessibility services.
  • Added RequiresPermission annotations to APIs that require POST_NOTIFICATIONS permission on SDK 33 and above.