相机取景器

  
适用于相机的独立可组合项和基于 View 的取景器”

下表列出了 androidx.camera-viewfinder 组中的所有工件。

制品 稳定版 候选版 Beta 版 Alpha 版
viewfinder-compose - - - 1.4.0-alpha11
viewfinder-core - - - 1.4.0-alpha11
viewfinder-view - - - 1.4.0-alpha11
此库的最后更新时间：2024 年 12 月 11 日

声明依赖项

如需添加 camera-viewfinder 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    // Use to implement camera viewfinders
    
    implementation "androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10"
    implementation "androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10"
    implementation "androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10"

}

Kotlin

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


}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 1.4

版本 1.4.0-alpha11

2024 年 12 月 11 日

发布了 androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11、androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11 和 androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11。版本 1.4.0-alpha11 包含这些提交内容。

API 变更

  • viewfinder-core 类已移至与其所属库一致的软件包中。(I431c6)
  • CameraViewfinder.ScaleType 已移至 viewfinder-core，因此可以与 Compose 一起重复使用 (I87ef1)
  • 移除了已废弃的 CameraViewfinder 类。请使用提供等效功能的新 API。(I6e59a)

版本 1.4.0-alpha10

2024 年 10 月 30 日

发布了 androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10、androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10 和 androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10。版本 1.4.0-alpha10 包含这些提交内容。

版本 1.4.0-alpha09

2024 年 10 月 2 日

发布了 androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09、androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09 和 androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09。版本 1.4.0-alpha09 包含这些提交内容。

版本 1.4.0-alpha08

2024 年 9 月 4 日

发布了 androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08、androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08 和 androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08。版本 1.4.0-alpha08 包含这些提交内容。

新功能

更新到 1.4.0-alpha08 后，CameraX 取景器工件已移至自己的库组。为了提高 CameraX 库的模块化程度和可维护性，此项更改是必要的。

如果您之前依赖于 androidx.camera:camera-viewfinder、androidx.camera:camera-viewfinder-compose 或 androidx.camera:camera-viewfinder-core，则需要将依赖项转换为以下依赖项：

  • 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

进行此转换应该不需要进行任何代码更改。旧版 Viewfinder Maven 坐标将不再收到更新。

此外，如果您将 Compose 与 CameraX 搭配使用，现在可以使用一个以 Compose 为先的全新库：androidx.camera:camera-compose（alpha 版）。这提供了 CameraXViewfinder 可组合项，这是一个符合 Compose 惯例的取景器，可将 CameraX 的 SurfaceRequest 适应 Compose，类似于 PreviewView 对 View 的运作方式。