Biometrischen
Letzte Aktualisierung | Stabile Version | Releasekandidat | Beta-Ausgabe | Alpharelease |
---|---|---|---|---|
29. Mai 2024 | 1.1.0 | − | − | 1.4.0-alpha01 |
Abhängigkeiten deklarieren
Zum Hinzufügen einer Abhängigkeit von biometrischen Verfahren 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 Anwendung oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:
Groovig
dependencies { // Java language implementation implementation "androidx.biometric:biometric:1.1.0" // Kotlin implementation "androidx.biometric:biometric-ktx:1.4.0-alpha01" }
Kotlin
dependencies { // Java language implementation implementation("androidx.biometric:biometric:1.1.0") // Kotlin implementation("androidx.biometric:biometric:1.4.0-alpha01") }
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Dein Feedback hilft uns, Jetpack zu verbessern. Lassen Sie uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie eine neue erstellen. Durch Klicken auf die Stern-Schaltfläche können Sie zu einem vorhandenen Problem abstimmen.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Version 1.4
Version 1.4.0-alpha01
29. Mai 2024
androidx.biometric:biometric:1.4.0-alpha01
und androidx.biometric:biometric-ktx:1.4.0-alpha01
werden veröffentlicht. Diese Version wurde in einem internen Zweig entwickelt und ist auf Android 15 Beta 2 ausgerichtet.
Fehlerkorrekturen
- Aktualisiere die Benutzeroberfläche, damit sie den Plattformänderungen in Android 15 entspricht
Version 1.2.0
Version 1.2.0-alpha05
21. September 2022
androidx.biometric:biometric:1.2.0-alpha05
und androidx.biometric:biometric-ktx:1.2.0-alpha05
werden veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.
API-Änderungen
CryptoObject
-Unterstützung fürandroid.security.identity.PresentationSession
in Android 13 hinzugefügt. (C5f1ec, b/197965513)
Fehlerkorrekturen
- Unnötige Ressourcenvarianten wurden entfernt, um die Größe der Bibliothek zu reduzieren. (I3601e, b/220178553)
- Ein Problem für
BiometricPrompt
wurde behoben, das in einem Kontext ohne Aktivität gehostet wurde. (Ife255)
Version 1.2.0-alpha04
17. November 2021
androidx.biometric:biometric:1.2.0-alpha04
und androidx.biometric:biometric-ktx:1.2.0-alpha04
werden veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.
Neue Funktionen
- Verbesserte BiometricPrompt-Unterstützung für Fragmente, die in Kontexten ohne Aktivität gehostet werden (I9312b)
API-Änderungen
- Unterstützung für die Android 12 BiometricManager.Strings API (I12f2d) wurde hinzugefügt.
- Ziel- und Quellkompatibilität von Java 7 zu Java 8 (I16129) geändert
Fehlerkorrekturen
- Es wurde ein Problem in API 29 behoben, bei dem einige Geräte (einschließlich Emulatoren) einen Abbruchfehler erhalten, wenn sie auf PIN/Muster/Passwort zurückgesetzt wurden. Beachte, dass der Nutzer bei einigen Geräten mit API 29 möglicherweise zur Eingabe der Displaysperre aufgefordert wird, auch wenn ein biometrisches Verfahren verfügbar und registriert ist. (b/142740104)
- In API 29 wurde ein Problem behoben, bei dem Geräte ohne biometrische Hardware nicht korrekt auf PIN/Muster/Passwort zurückgesetzt wurden (b/170517889).
Version 1.2.0-alpha03
24. Februar 2021
androidx.biometric:biometric:1.2.0-alpha03
und androidx.biometric:biometric-ktx:1.2.0-alpha03
werden veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.
API-Änderungen
- Es wurden Erweiterungen zum Anhalten von Koroutinen für CredentialAuthPrompt hinzugefügt, ähnlich denen für andere AuthPrompt-Typen. (I9ac70)
Version 1.2.0-alpha02
27. Januar 2021
androidx.biometric:biometric:1.2.0-alpha02
und androidx.biometric:biometric-ktx:1.2.0-alpha02
werden veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
API-Änderungen
- Einige
AuthPrompt
-Felder, die zuvor über einen Builder festgelegt wurden, wurden instartAuthentication(...)
-Methodenargumente umgewandelt. (I18896, b/174098373) - Es wurden Mindestanforderungen an das API-Level für
AuthPrompt
-Typen hinzugefügt, die unter älteren Android-Versionen nur eingeschränkt oder gar nicht unterstützt werden. (I18896) - Für alle
AuthPrompt
-Felder, die über einen Builder festgelegt werden, wurden Getter-Methoden hinzugefügt. (I18896) - Es wurden Kotlin-Erweiterungen zum Anhalten der Koroutine zur biometrischen Authentifizierung über die
AuthPrompt
APIs hinzugefügt. Diese Funktionen geben bei Erfolg direkt denAuthenticationResult
zurück oder geben bei einem Fehler oder Fehler (Ablehnung von Anmeldedaten) eine Ausnahme aus. (Iffc9e)
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem
BiometricManager.canAuthenticate(int)
unter Android 10 (API-Level 29) manchmal den falschen Statuscode für ein Gerät mit einem Fingerabdrucksensor zurückgibt. (I72420, b/176921662) - Es wurde ein Problem behoben, bei dem
BiometricManager.canAuthenticate(int)
für ein Gerät ohne biometrische Hardware und ohne registrierte PIN, Muster oder Passwort unter Android 10 (API-Level 29) und früheren SDK-Versionen den falschen Statuscode zurückgegeben hat. (I79b7d, b/174505824) - Ein Speicherleck wurde behoben, das auftrat, wenn
BiometricPrompt
in einem Fragment gehostet wurde, dessen Lebenszyklus kürzer als die zugehörige Aktivität war. (I70864, b/167014923)
Version 1.2.0-alpha01
2. Dezember 2020
androidx.biometric:biometric:1.2.0-alpha01
und androidx.biometric:biometric-ktx:1.2.0-alpha01
werden veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
Neue Funktionen
- Einführung des Moduls
androidx.biometric:biometric-ktx
, mit dem Kotlin-spezifische APIs und Erweiterungen zusätzlich zuandroidx.biometric:biometric
hinzugefügt werden.
API-Änderungen
- Es wurden neue
AuthPrompt
APIs zum Erstellen einesBiometricPrompt
und zum Durchführen der Authentifizierung hinzugefügt. Für diese APIs muss dieBiometricPrompt
nicht in einem Callback im frühen Lebenszyklus wieonCreate
erstellt werden. (I19022) - Für
Fragment
undFragmentActivity
wurden Kotlin-Erweiterungen für die neuenAuthPrompt
APIs hinzugefügt. (Iaf98c)
Version 1.1.0
Version 1.1.0
27. Januar 2021
androidx.biometric:biometric:1.1.0
wird freigegeben. Version 1.1.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.0.0
- In Android 11 eingeführte abwärtskompatible Unterstützung für neue Funktionen und API-Updates für die biometrische Authentifizierung.
- Erheblich geringere App-Größe der Bibliothek (in einigen Fällen um mehr als 100 KB).
- Verschiedene Quellen von Speicherlecks wurden entfernt, die zuvor durch die Bibliothek verursacht wurden.
- Fehler bei der Klassenüberprüfung wurden behoben, die sich auf die Leistung auf älteren Android-Versionen auswirkten.
- Es wurden verschiedene zusätzliche Verbesserungen an der Stabilität und dem Verhalten der Bibliothek vorgenommen.
Version 1.1.0-rc01
11. November 2020
androidx.biometric:biometric:1.1.0-rc01
wird freigegeben. Version 1.1.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Auf einigen Geräten wurde bei bestimmten Aktionen (Authentifizierung, Abbruch usw.) manchmal ein
NullPointerException
ausgelöst. Dieses Problem wurde behoben. (b/151316421) - Einige Pixel-Geräte meldeten unter Android 10 bei Verwendung von
BiometricManager#canAuthenticate(int)
zur Prüfung auf biometrische Daten der Klasse 3 unter Android 10 den falschen Status. (b/170406186)
Version 1.1.0-beta01
1. Oktober 2020
androidx.biometric:biometric:1.1.0-beta01
wird freigegeben. Version 1.1.0-beta01 enthält diese Commits.
Neue Funktionen
- Die APK-Größe der Bibliothek wurde deutlich reduziert (in einigen Fällen um mehr als 100 KB komprimiert), indem unter Android 8.1 und niedriger Dialogfeldanimationen durch statische Assets ersetzt wurden. (I4844e)
BiometricPrompt
kehrt jetzt unter allen unterstützten Android-Versionen automatisch auf die Authentifizierung der Geräteanmeldedaten zurück (falls zugelassen), wenn die biometrische Authentifizierung gesperrt ist. (b/149579143)
Fehlerkorrekturen
BiometricPrompt
verursachte auf einigen Android 9-Geräten ohne Fingerabdrucksensor einen Absturz. Das Problem wurde behoben. (b/151443237)- Es wurde ein potenzieller
NullPointerException
inFingerprintDialogFragment
behoben. (b/167951429) - Es wurde ein Problem behoben, bei dem für einen reflektiven Methodenaufruf in
BiometricManager
der falscheCryptoObject
-Typ verwendet wurde. (b/165824669) - Wenn
BiometricPrompt
kurz nach dem Schließen noch einmal angezeigt wurde, wurde die neue Aufforderung auf einigen Android 10-Geräten automatisch geschlossen. Das Problem wurde behoben. (b/157783075) - Speicherlecks im Zusammenhang mit der Verwendung von
FingerprintManagerCompat
wurden behoben. (b/165840273) - Probleme behoben, bei denen die Benutzeroberfläche des Dialogfelds für den Fingerabdruck auf einigen Android 9-Geräten ausgeblendet oder falsch angezeigt wurde. (b/154868505, b/148350291)
Version 1.1.0-alpha02
19. August 2020
androidx.biometric:biometric:1.1.0-alpha02
wird freigegeben. Version 1.1.0-alpha02 enthält diese Commits.
Neue Funktionen
BiometricManager#canAuthenticate()
kann jetztBIOMETRIC_STATUS_UNKNOWN
zurückgeben, um anzugeben, dass sich der Nutzer noch authentifizieren kann, oderBIOMETRIC_ERROR_UNSUPPORTED
, um anzuzeigen, dass eine bestimmte Authentifizierungskombination vom Gerät nicht unterstützt wird.BiometricPrompt#authenticate()
kann jetzt nur unter Android 11 (API-Level 30) und höher zur Authentifizierung von Geräteanmeldedaten mit einer verknüpftenCryptoObject
verwendet werden.
API-Änderungen
- Die Angabe eines expliziten
Executor
beim Erstellen einer Instanz vonBiometricPrompt
ist jetzt optional. (I6bb8a) - In Android 11 wurde die Methode
BiometricManager#canAuthenticate(int)
hinzugefügt. (Ia3f1c) BiometricPrompt
wurde aktualisiert, um Unterstützung fürBiometricManager.Authenticators
-Konstanten aus Android 11 hinzuzufügen. (I39bd8)- In Android 11 wurde die Methode
BiometricPrompt.AuthenticationResult#getAuthenticationType()
hinzugefügt. (Icfad5) - Der
BiometricPrompt.ERROR_SECURITY_UPDATE_REQUIRED
-Fehlercode aus Android 11 wurde hinzugefügt. (I6610b) BiometricPrompt.CryptoObject
wurde aktualisiert, umIdentityCredential
nur unter Android 11 (API-Level 30) und höher zu unterstützen. (I1d9f6)
Fehlerkorrekturen
- Speicherlecks, die von LeakCanary in
BiometricFragment
undBiometricViewModel
gemeldet wurden, wurden behoben. (b/144919472) - Es wurde sichergestellt, dass
BiometricViewModel
nicht mehrMutableLiveData#setValue()
aus einem Hintergrundthread aufruft. (b/159983244) - Ein Problem wurde behoben, bei dem
BiometricPrompt
die temporäre Sperrung auf einigen API-Ebenen nicht richtig verarbeitete. 9acfce9. - Es wurde ein Problem behoben, bei dem
BiometricPrompt
für ein Gerät, das auf einigen API-Levels nicht mit Anmeldedaten für die Displaysperre geschützt war, den falschen Fehlercode zurückgibt. (b/148626482) - Ein Problem wurde behoben, bei dem
BiometricManager
undBiometricPrompt
für ein Gerät ohne Keyguard-Implementierung auf einigen API-Levels die falschen Fehlercodes zurückgeben. (891c6e0)
Version 1.1.0-alpha01
24. Juni 2020
androidx.biometric:biometric:1.1.0-alpha01
wird freigegeben. Version 1.1.0-alpha01 enthält diese Commits.
Neue Funktionen
- Die Implementierung der internen Bibliothek wurde überarbeitet, um mögliche Quellen von Speicherlecks und anderes unbeabsichtigtes Verhalten zu beheben:
- Interne Fragmente teilen jetzt Daten und speichern sie mithilfe eines
ViewModel
, das an den Aktivitätslebenszyklus der Clientanwendung gebunden ist. - Die Authentifizierung von Geräteanmeldedaten vor Android 10 (API-Level 29) löst keine transparente Aktivität in der Clientanwendung mehr aus.
- Interne Fragmente teilen jetzt Daten und speichern sie mithilfe eines
Fehlerkorrekturen
- Die Warnungen zur Einstellung von
FingerprintManagerCompat
im Zusammenhang mit der Verwendung vonFingerprintManagerCompat
wurden behoben. (b/142967618) - Die Methode für SDK-gesteuerte Plattformmethoden wurde geändert, um Probleme bei der Klassenbestätigung bei älteren Android-Versionen zu vermeiden. (94beb4b)
- Gradle-Abhängigkeiten, die nicht Teil der öffentlichen API sind, werden nicht mehr von der Bibliothek exportiert. (f289d9e)
Version 1.0.1
Version 1.0.1
18. Dezember 2019
androidx.biometric:biometric:1.0.1
wird freigegeben. Version 1.0.1 enthält diese Commits.
Fehlerkorrekturen
- Die bestehende Behelfslösung für den Fingerabdruck-Fallback für die kryptobasierte Authentifizierung wurde auf bekannte betroffene Anbieter ausgeweitet und gleichzeitig auf API 28 beschränkt (b/143361271).
- Auf bestimmten Geräten wurde das Dialogfeld für biometrische Daten unter einem System-Overlay angezeigt (b/143230260). Dieses Problem wurde behoben.
- Mehrere Probleme mit
setDeviceCredentialAllowed(true)
(b/143091227, b/143097321, b/143653944) behoben - Ein Problem wurde auf bestimmten Android-Versionen behoben, bei dem
onAuthenticationSuccess
nicht immer aufgerufen wurde, nachdem der Nutzer seine Geräteanmeldedaten bestätigt hat (b/145232806). - Ein Problem wurde auf bestimmten Android-Versionen behoben, bei dem
onAuthenticationError
nicht immer aufgerufen wurde, wenn die Aufforderung beim Drehen geschlossen wurde (b/145230042). - In bestimmten Android-Versionen wurde die Aufforderung nach Erhalt bestimmter Fehlercodes nicht geschlossen (b/143683687). Dieses Problem wurde behoben.
- Potenzielles
NullPointerException
inBiometricFragment
(b/142599311) korrigiert
Version 1.0.0
Version 1.0.0
7. November 2019
androidx.biometric:biometric:1.0.0
wurde ohne Änderungen seit 1.0.0-rc02
veröffentlicht. Version 1.0.0 enthält diese Commits.
Hauptfunktionen von Version 1.0.0
- Kompatibilitätsversion der
BiometricPrompt
undBiometricManager
APIs, implementiert in Android 10, mit vollständiger Unterstützung von Funktionen bis Android 6.0 (API 23) - Integrierte Lebenszyklusverwaltung für
BiometricPrompt
innerhalb einerFragment
oderFragmentActivity
- Spezielle Behandlung für Geräte, die bei der kryptobasierten Authentifizierung fälschlicherweise schwache biometrische Daten zeigen
Version 1.0.0-rc02
23. Oktober 2019
androidx.biometric:biometric:1.0.0-rc02
wird freigegeben. Version 1.0.0-rc02 enthält diese Commits.
Fehlerkorrekturen
- Es wurde eine Problemumgehung für bestimmte Geräte hinzugefügt, die bekanntermaßen fälschlicherweise eine schwache biometrische Authentifizierung liefern, wenn die kryptobasierte Authentifizierung in den API-Versionen 28 und 29 aufgerufen wird (b/142150327).
Version 1.0.0-rc01
9. Oktober 2019
androidx.biometric:biometric:1.0.0-rc01
wird freigegeben. Version 1.0.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Ein möglicher Absturz von
FingerprintDialogFragment
beim Schließen während der Drehung des Bildschirms wurde behoben (b/141356362). - Ein Problem wurde behoben, bei dem der Empfang eines Nullwerts (
AuthenticationResult
) von der Framework API zu einem Absturz führen konnte (b/138862251). - Behebung von Abstürzen, die durch das Schließen von
BiometricPrompt
nachonSaveInstanceState()
verursacht wurden (b/138825362, b/140447194)
Version 1.0.0-beta02
18. September 2019
androidx.biometric:biometric:1.0.0-beta02
wird freigegeben. Version 1.0.0-beta02 enthält diese Commits.
Fehlerkorrekturen
- Probleme bei der Unterstützung von Geräteanmeldedaten in Version
1.0.0-beta01
behoben - Java 8-Abhängigkeiten wurden entfernt und auf Java 7 umgestellt (b/140508526).
FingerprintHelperFragment
gibtERROR_HW_NOT_PRESENT
jetzt korrekt aus, wenn keine Hardware für Fingerabdruck erkannt wird (b/140427586).
Version 1.0.0-beta01
29. August 2019
androidx.biometric:biometric:1.0.0-beta01
wird freigegeben. Version 1.0.0-beta01 enthält diese Commits.
Neue Funktionen
Wir haben einen zweiten Konstruktor für BiometricPrompt eingeführt, der das Hosten in einem Fragment ermöglicht (im Gegensatz zum vorhandenen Konstruktor, für den eine FragmentActivity erforderlich ist).
Außerdem freuen wir uns, die folgenden Funktionen von Android 10 in die AndroidX Biometric-Bibliothek aufnehmen zu können:
BiometricManager#canAuthenticate
BiometricPrompt.PromptInfo#setConfirmationRequired
BiometricPrompt.PromptInfo#setDeviceCredentialAllowed
Unter Android 10 ruft die Bibliothek die entsprechenden Methoden aus der Plattform-API auf. Auf älteren API-Ebenen emuliert die Bibliothek das Verhalten.
API-Änderungen
- Fragmentspezifischer Konstruktor für biometrische Aufforderung hinzugefügt (b/131980596)
- Weitere Informationen finden Sie oben im Abschnitt „Neue Funktionen“.
Fehlerkorrekturen
- Unterstützung für BiometricPrompt-Geräteanmeldedaten für L+ hinzufügen
- BiometricPrompt korrigiert, öffentliche Fehlerkonstanten zu verwenden (b/137788194)
NullPointerException
inBiometricPrompt.onAttach()
korrigieren (b/136103103)- Das Verhalten wurde geändert, sodass BiometricPrompt nicht durch ein Berührungsereignis außerhalb des Prompts abgebrochen werden konnte (b/135684487)
- Der Absturz von onAuthenticationError wurde behoben, wenn in Kotlin ein Null-Fehlerwert zurückgegeben wurde (b/128350861).
- FingerprintDialogFragment kann jetzt angepasst werden (b/127878106)
- FingerprintDialog ist jetzt scrollbar (b/126367887)
- Es wurde ein Fehler behoben, bei dem beim Drehen des biometrischen Dialogfelds ein
IllegalStateException
(b/124153656), (b/123811924) ausgelöst wurde. - Uneinheitliches Verhalten auf API-Level 23 bis 27 wurde behoben. (b/124066957)
- Ein Problem wurde behoben, bei dem über das Dialogfeld zur Anmeldung per Fingerabdruck in TalkBack falschen Text gelesen wurde. (b/123572331)
Version 1.0.0-alpha04
3. April 2019
androidx.biometric:biometric:1.0.0-alpha04
wird freigegeben. Die in dieser Version enthaltenen Commits finden Sie hier.
Fehlerkorrekturen
- Korrigierte biometrische Fragmente werden nicht in allen Fällen bereinigt. (b/121117380)
- Korrigierter
BiometricPrompt
lässt nur eine Instanz vonBiometricPrompt.AuthenticationCallback
zu (b/123857949) - Der Fehler
BiometricPrompt
wurde behoben, der zwischen System- und kompatibler Version inkonsistent war. (b/123572326) - Callback
onAuthenticationError()
mit@NotNull errString
löst zur LaufzeitNullPointerException
aus (b/123167217). - Behebung von Abstürzen der
androidx.BiometricPrompt
-Schaltfläche „Abbrechen“ (b/122054485) - Problem behoben: Titel/Beschreibung von
androidx.biometric.PromptInfo
unter Android P (b/122856773) nicht geändert
Version 1.0.0-alpha03
17. Dezember 2018
Fehlerkorrekturen
- Probleme mit Fragmenten wurden behoben
- Auf Geräten O und älter werden Sperrfehler sofort zurückgegeben, um mit P und höher konsistent zu sein.