Kamerasucher

  
Eigenständiger, zusammensetzbarer und ansichtsbasierter Sucher für Kameras“

In dieser Tabelle sind alle Artefakte in der Gruppe androidx.camera-viewfinder aufgeführt.

Artefakt Stabile Version Releasekandidat Beta-Ausgabe Alphaversion
viewfinder-compose - - 1.5.0-beta02 1.4.0-alpha13
viewfinder-core - - 1.5.0-beta02 1.4.0-alpha13
Sucher - - 1.5.0-beta02 1.4.0-alpha13
Diese Bibliothek wurde zuletzt am 4. Juni 2025 aktualisiert.

Abhängigkeiten deklarieren

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

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

Cool

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

}

Kotlin

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


}

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

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.5

Version 1.5.0-beta02

4. Juni 2025

androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta02, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta02 und androidx.camera.viewfinder:viewfinder-view:1.5.0-beta02 sind freigegeben. Version 1.5.0-beta02 enthält diese Commits.

Version 1.5.0-beta01

7. Mai 2025

androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01 und androidx.camera.viewfinder:viewfinder-view:1.5.0-beta01 sind freigegeben. Version 1.5.0-beta01 enthält diese Commits.

  • Dies ist die erste offizielle Betaversion der ansichts- und kompositionsbasierten Sucher, die flexibel genug sind, um mit Camera2 verwendet zu werden. Informationen zu einer Ansicht oder einem Composeable, das Sie mit CameraX verwenden können, finden Sie unter PreviewView und CameraXViewfinder.

Neue Funktionen

  • Mit ContentScale und Alignment können Sie jetzt im kompositionbasierten Sucher die angezeigte Oberfläche im Container skalieren und platzieren, ähnlich wie bei androidx.compose.foundation.Image. (Ibcea3)

API-Änderungen

  • TransformationInfo hat jetzt Standardwerte für alle Argumente. So können Sucher ohne TransformationInfo erstellt werden. Standardmäßig ist dann eine Quellendrehung von 0, keine Quellenspiegelung und kein Zuschneiderechteck festgelegt. (I2b1b2)
  • Der zusammensetzbare Sucher nimmt jetzt ein abschließendes Lambda an, um eine Surface-Sitzung zu empfangen, ähnlich wie bei AndroidExternalSurface. Das bereitgestellte Lambda verwendet ViewfinderInitScope als Empfänger, wodurch ein Callback installiert werden kann, um neue Surface-Sitzungen zu empfangen. Diese Oberflächensitzungen geben automatisch Ressourcen frei, die vom Sucher gehalten werden, wenn sie nicht mehr benötigt werden. (Ib2b0d)
  • ViewfinderSurfaceRequest.Builder.populateFromCharacteristics wurde entfernt und durch eine entsprechende Reihe von Static APIs ersetzt, mit denen TransformationInfo generiert werden kann. Dieser Vorgang führt zu derselben Transformation wie populateFromCharacteristics. Diese statischen Methoden werden der Klasse Camera2TransformationInfo hinzugefügt. (Idc6af)
  • ViewfinderSurfaceRequest enthält keine asynchronen APIs mehr zum Abrufen der Oberfläche. Es ist jetzt ein unveränderlicher Datentyp. APIs zum Abrufen der Oberfläche wurden jetzt in den Sucher verschoben. (I30127)
  • CameraViewfinder wurde in ViewfinderView umbenannt, damit die Benennung mit der des Kompositionselements „Sucher“ übereinstimmt und darauf hinweist, dass es nicht nur mit Kameraquellen verwendet werden kann. (Id9e6b)
  • Klassen aus viewfinder-view wurden aus dem Paket androidx.camera.viewfinder in das Unterpaket androidx.camera.viewfinder.view verschoben. (I6cb44)
  • Dem ansichtsbasierten Sucher wurden neue APIs hinzugefügt, mit denen sich die Drehung, Spiegelung und das Zuschneide-Rechteck der Quelle festlegen lassen. Diese TransformationInfo-Klasse ist dieselbe Klasse, die auch vom kompositionsbasierten Sucher verwendet wird. (I907c3)
  • Der ansichtenbasierte Sucher verwendet jetzt neue ViewfinderSurfaceRequest APIs, die die Surface-Antwort nicht mehr intern verarbeiten. Anstatt ListenableFuture<Surface> geben die requestSurfaceSession() APIs jetzt ListenableFuture<ViewfinderSurfaceSession> zurück, was eine AutoCloseable-Klasse zurückgibt, die sich beim Schließen genauso verhält wie der Aufruf der alten API von ViewfinderSurfaceRequest.markSurfaceSafeToRelease(). Dadurch wird die Zuständigkeit für die Oberflächenanfrage und die Oberflächenantwort klarer getrennt. (I19041)

Version 1.4

Version 1.4.0-alpha13

26. Februar 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha13, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha13 und androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha13 sind freigegeben. Version 1.4.0-alpha13 enthält diese Commits.

Version 1.4.0-alpha12

15. Januar 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha12, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha12 und androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha12 sind freigegeben. Version 1.4.0-alpha12 enthält diese Commits.

Neue Funktionen

  • compileSdk auf 35 aktualisiert, da die API für Android 15 verwendet wird. Bei Apps, die CameraX-Bibliotheken verwenden, muss auch die compileSdk-Konfigurationseinstellung aktualisiert werden. (Ic80cd)
  • Diese Bibliothek verwendet jetzt JSpecify-Null-Anmerkungen, die sich auf den Typ beziehen. Kotlin-Entwickler sollten das folgende Compilerargument verwenden, um die korrekte Verwendung zu erzwingen: -Xjspecify-annotations=strict (dies ist die Standardeinstellung ab Version 2.1.0 des Kotlin-Compilers). (I7bcd7, b/326456246)

Version 1.4.0-alpha11

11. Dezember 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11 und androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11 sind freigegeben. Version 1.4.0-alpha11 enthält diese Commits.

API-Änderungen

  • viewfinder-core Klassen wurden in Pakete verschoben, die der Bibliothek entsprechen, zu der sie gehören. (I431c6)
  • CameraViewfinder.ScaleType wurde in viewfinder-core verschoben, damit es für das Erstellen von E-Mails wiederverwendet werden kann (I87ef1)
  • Die eingestellten CameraViewfinder-Klassen werden entfernt. Verwenden Sie stattdessen die neuen APIs, die eine entsprechende Funktionalität bieten. (I6e59a)

Version 1.4.0-alpha10

30. Oktober 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10 und androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10 sind freigegeben. Version 1.4.0-alpha10 enthält diese Commits.

Version 1.4.0-alpha09

2. Oktober 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09 und androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09 sind freigegeben. Version 1.4.0-alpha09 enthält diese Commits.

Version 1.4.0-alpha08

4. September 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08 und androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08 sind freigegeben. Version 1.4.0-alpha08 enthält diese Commits.

Neue Funktionen

Mit dem Update auf 1.4.0-alpha08 wurde das CameraX-Sucher-Artefakt in eine eigene Bibliotheksgruppe verschoben. Diese Änderung ist erforderlich, um die Modularität und Wartbarkeit der CameraX-Bibliothek zu verbessern.

Wenn Sie bisher auf androidx.camera:camera-viewfinder, androidx.camera:camera-viewfinder-compose oder androidx.camera:camera-viewfinder-core angewiesen waren, müssen Sie Ihre Abhängigkeiten auf Folgendes umstellen:

  • 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

Für diese Umstellung sollten keine Codeänderungen erforderlich sein. Die alten Maven-Koordinaten von Viewfinder werden nicht mehr aktualisiert.

Wenn Sie Compose mit CameraX verwenden, ist jetzt eine neue Compose-Bibliothek in Alpha verfügbar: androidx.camera:camera-compose. Dadurch wird das CameraXViewfinder-komposit verfügbar, ein Sucher, der für Compose konzipiert ist und die SurfaceRequest von CameraX an Compose anpasst, ähnlich wie PreviewView für Ansichten funktioniert.