Kamerasucher
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-beta01 | 1.4.0-alpha13 |
viewfinder-core | - | - | 1.5.0-beta01 | 1.4.0-alpha13 |
Sucher | - | - | 1.5.0-beta01 | 1.4.0-alpha13 |
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-beta01" implementation "androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01" implementation "androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01" }
Kotlin
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") }
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.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Version 1.5
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
werden losgelassen. 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
undCameraXViewfinder
.
Neue Funktionen
- Mit
ContentScale
undAlignment
können Sie jetzt im kompositionbasierten Sucher die angezeigte Oberfläche skalieren und innerhalb des Containers platzieren, ähnlich wie beiandroidx.compose.foundation.Image
. (Ibcea3)
API-Änderungen
TransformationInfo
hat jetzt Standardwerte für alle Argumente. So können Sucher ohneTransformationInfo
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 verwendetViewfinderInitScope
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 denenTransformationInfo
generiert werden kann. Dieser Vorgang führt zu derselben Transformation wiepopulateFromCharacteristics
. Diese statischen Methoden werden der KlasseCamera2TransformationInfo
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 inViewfinderView
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 Paketandroidx.camera.viewfinder
in das Unterpaketandroidx.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 vom kompositionsbasierten Sucher verwendet wird. (I907c3) - Der ansichtenbasierte Sucher verwendet jetzt neue
ViewfinderSurfaceRequest
APIs, die die Surface-Antwort nicht mehr intern verarbeiten. AnstattListenableFuture<Surface>
geben dierequestSurfaceSession()
APIs jetztListenableFuture<ViewfinderSurfaceSession>
zurück, was eineAutoCloseable
-Klasse zurückgibt, die sich beim Schließen genauso verhält wie der Aufruf der alten API vonViewfinderSurfaceRequest.markSurfaceSafeToRelease()
. Dadurch wird die Zuständigkeit für die Oberflächenanfrage und die Oberflächenantwort klarer voneinander 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
werden losgelassen. 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
werden losgelassen. 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 diecompileSdk
-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
werden losgelassen. 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 inviewfinder-core
verschoben, damit es für die Funktion „Compose“ 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
werden losgelassen. 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
werden losgelassen. 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
werden losgelassen. 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.