camera viewfinder

This table lists all the artifacts in the androidx.camera-viewfinder group.

Declaring dependencies

To add a dependency on camera-viewfinder, 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 {
    // Use to implement camera viewfinders
    
    implementation "androidx.camera.viewfinder:viewfinder-view:1.5.0-beta01"
    implementation "androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01"
    implementation "androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01"

}

dependencies {
    // Use to implement camera viewfinders
    implementation("androidx.camera.viewfinder:viewfinder-view:1.5.0-beta01")
    implementation("androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01")
    implementation("androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01")


}

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.5

Version 1.5.0-beta01

May 7, 2025

androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01, and androidx.camera.viewfinder:viewfinder-view:1.5.0-beta01 are released. Version 1.5.0-beta01 contains these commits.

• This is the first official beta release of the view-based and compose-based viewfinders that are flexible enough to be used with Camera2. If you’re looking for a View or composable to use with CameraX, see PreviewView and CameraXViewfinder.

New Features

• ContentScale and Alignment can now be used in the compose-based viewfinder to scale and place the displayed surface within its container, similar to how androidx.compose.foundation.Image behaves. (Ibcea3)

API Changes

• TransformationInfo now has default values for all args. This will allow Viewfinders to be created without any TransformationInfo, which will default to a source rotation of 0, no source mirroring, and no crop rect. (I2b1b2)
• Composable Viewfinder now takes a trailing lambda to receive a Surface session, similar to AndroidExternalSurface. The provided lambda uses ViewfinderInitScope as a receiver, which allows installing a callback to receive new Surface sessions. These surface sessions automatically release resources held by the Viewfinder when they go out of scope. (Ib2b0d)
• ViewfinderSurfaceRequest.Builder.populateFromCharacteristics has now been removed and is now replaced with an equivalent set of static APIs that can be used to generate TransformationInfo which will produce the same transformation as populateFromCharacteristics. These static methods are added to the Camera2TransformationInfo class. (Idc6af)
• ViewfinderSurfaceRequest no longer includes async APIs for retrieving the surface. It is now an immutable data type. APIs for retrieving the Surface are now moved to the viewfinder. (I30127)
• CameraViewfinder has been renamed to ViewfinderView so that the naming aligns with the naming of the Viewfinder composable and to indicate that it can be used with more than just camera sources. (Id9e6b)
• Classes from viewfinder-view have been moved to the androidx.camera.viewfinder.view subpackage from the androidx.camera.viewfinder package. (I6cb44)
• New APIs are added to view-based Viewfinder that allow setting the source rotation, mirroring, and crop rectangle. This TransformationInfo class is the same class used by the compose-based Viewfinder. (I907c3)
• The view-based Viewfinder now uses new ViewfinderSurfaceRequest APIs which no longer internally handle the Surface response. Instead of returning ListenableFuture<Surface>, the requestSurfaceSession() APIs now return ListenableFuture<ViewfinderSurfaceSession> which returns an AutoCloseable class that when closed behaves the same way as calling the old API of ViewfinderSurfaceRequest.markSurfaceSafeToRelease(). This provides a clearer separation of responsibilities between the surface request and surface response. (I19041)

Version 1.4

Version 1.4.0-alpha13

February 26, 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha13, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha13, and androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha13 are released. Version 1.4.0-alpha13 contains these commits.

Version 1.4.0-alpha12

January 15, 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha12, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha12, and androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha12 are released. Version 1.4.0-alpha12 contains these commits.

New Features

• Upgraded compileSdk as 35 for using Android 15 related API. Apps using CameraX libraries will also need to upgrade their compileSdk config setting. (Ic80cd)
• 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). (I7bcd7, b/326456246)

Version 1.4.0-alpha11

December 11, 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11, and androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11 are released. Version 1.4.0-alpha11 contains these commits.

API Changes

• viewfinder-core classes have been moved into packages that are consistent with the library they belong to. (I431c6)
• CameraViewfinder.ScaleType has been moved to viewfinder-core so it can be reused with compose (I87ef1)
• Deprecated CameraViewfinder classes are removed. Please use the new APIs which provide equivalent functionality. (I6e59a)

Version 1.4.0-alpha10

October 30, 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10, and androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10 are released. Version 1.4.0-alpha10 contains these commits.

Version 1.4.0-alpha09

October 2, 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09, and androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09 are released. Version 1.4.0-alpha09 contains these commits.

Version 1.4.0-alpha08

September 4, 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08, and androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08 are released. Version 1.4.0-alpha08 contains these commits.

New Features

With the update to 1.4.0-alpha08, the CameraX Viewfinder artifact has been moved to its own library group. This change is necessary to improve the modularity and maintainability of the CameraX library.

If you were previously depending on androidx.camera:camera-viewfinder, androidx.camera:camera-viewfinder-compose or androidx.camera:camera-viewfinder-core, you will need to transition your dependencies to the following:

• androidx.camera:camera-viewfinder -> androidx.camera.viewfinder:viewfinder-view
• androidx.camera:camera-viewfinder-compose -> androidx.camera.viewfinder:viewfinder-compose
• androidx.camera:camera-viewfinder-core -> androidx.camera.viewfinder:viewfinder-core

No code changes should be needed to make this transition. The old Viewfinder maven coordinates will no longer receive updates.

Additionally, if you are using Compose with CameraX, a new Compose-first library is now available in alpha: androidx.camera:camera-compose. This provides the CameraXViewfinder composable, which is a compose-idiomatic Viewfinder that adapts CameraX’s SurfaceRequest to Compose, similar to how PreviewView works for views.