Biometrischen

Authentifizierung mit biometrischen Verfahren oder Geräteanmeldedaten und kryptografische Vorgänge
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alpharelease
21. September 2022 1.1.0 - - 1.2.0-alpha05

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.2.0-alpha05"
}

Kotlin

dependencies {
    // Java language implementation
    implementation("androidx.biometric:biometric:1.1.0")

    // Kotlin
    implementation("androidx.biometric:biometric:1.2.0-alpha05")
}

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.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

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ür android.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

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 in startAuthentication(...)-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 den AuthenticationResult 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 zu androidx.biometric:biometric hinzugefügt werden.

API-Änderungen

  • Es wurden neue AuthPrompt APIs zum Erstellen eines BiometricPrompt und zum Durchführen der Authentifizierung hinzugefügt. Für diese APIs muss die BiometricPrompt nicht in einem Callback im frühen Lebenszyklus wie onCreate erstellt werden. (I19022)
  • Für Fragment und FragmentActivity wurden Kotlin-Erweiterungen für die neuen AuthPrompt 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 in FingerprintDialogFragment behoben. (b/167951429)
  • Es wurde ein Problem behoben, bei dem für einen reflektiven Methodenaufruf in BiometricManager der falsche CryptoObject-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 jetzt BIOMETRIC_STATUS_UNKNOWN zurückgeben, um anzugeben, dass sich der Nutzer noch authentifizieren kann, oder BIOMETRIC_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üpften CryptoObject verwendet werden.

API-Änderungen

Fehlerkorrekturen

  • Speicherlecks, die von LeakCanary in BiometricFragment und BiometricViewModel gemeldet wurden, wurden behoben. (b/144919472)
  • Es wurde sichergestellt, dass BiometricViewModel nicht mehr MutableLiveData#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 und BiometricPrompt 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.

Fehlerkorrekturen

  • Die Warnungen zur Einstellung von FingerprintManagerCompat im Zusammenhang mit der Verwendung von FingerprintManagerCompat 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 in BiometricFragment (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 und BiometricManager APIs, implementiert in Android 10, mit vollständiger Unterstützung von Funktionen bis Android 6.0 (API 23)
  • Integrierte Lebenszyklusverwaltung für BiometricPrompt innerhalb einer Fragment oder FragmentActivity
  • 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 nach onSaveInstanceState() 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 gibt ERROR_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:

  1. BiometricManager#canAuthenticate
  2. BiometricPrompt.PromptInfo#setConfirmationRequired
  3. 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 in BiometricPrompt.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 von BiometricPrompt.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 Laufzeit NullPointerException 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.