Biometrischen

Authentifizieren Sie sich mit biometrischen oder Geräteanmeldedaten und führen Sie kryptografische Vorgänge aus.
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alpha-Release
7. August 2024 1.1.0 - - 1.4.0-alpha02

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von biometrischen Daten hinzufügen möchten, müssen Sie das Maven-Repository von Google zu Ihrem Projekt arbeiten. Maven-Repository von Google lesen .

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

Groovig

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

    // Kotlin
    implementation "androidx.biometric:biometric-ktx:1.4.0-alpha02"
}

Kotlin

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

    // Kotlin
    implementation("androidx.biometric:biometric:1.4.0-alpha02")
}

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

Feedback

Dein Feedback hilft uns, Jetpack zu verbessern. Teilen Sie uns mit, wenn Sie neue Ausgaben entdecken oder zur Verbesserung dieser Bibliothek. In der bestehende Probleme in dieser Bibliothek, bevor Sie eine neue erstellen. So können Sie zu einem vorhandenen Problem abstimmen: indem Sie auf die Sternschaltfläche klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung. .

Version 1.4

Version 1.4.0-alpha02

7. August 2024

androidx.biometric:biometric:1.4.0-alpha02 und androidx.biometric:biometric-ktx:1.4.0-alpha02 wurden veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.

Neue Funktionen

  • Mit PromptContentView können Entwickler die Ansicht für benutzerdefinierte Inhalte als zusätzliche Option zur Nur-Beschreibungs-Textansicht anzeigen lassen
  • Das App-Logo in der biometrischen Aufforderung wird über das App-Symbol automatisch hinzugefügt.

API-Änderungen

  • APIs hinzufügen, um benutzerdefinierte Inhaltsansichten zu unterstützen
    • BiometricPrompt.PromptInfo.Builder#setContentView
    • BiometricPrompt.PromptInfo#getContentView
    • PromptContentView-Schnittstelle
    • PromptVerticalListContentView Klasse
    • Klasse PromptContentViewWithMoreOptionsButton (nur für privilegierte Apps)
  • Grafik: APIs zur Unterstützung hinzufügen (nur für privilegierte Apps)
    • BiometricPrompt.PromptInfo.Builder#setLogoBitmap
    • BiometricPrompt.PromptInfo.Builder#setLogoRes
    • BiometricPrompt.PromptInfo.Builder#setLogoDescription
    • BiometricPrompt.PromptInfo#getLogoBitmap
    • BiometricPrompt.PromptInfo#getLogoRes
    • BiometricPrompt.PromptInfo#getLogoDescription 58c35c6

Fehlerkorrekturen

  • compileSdk auf 35 5dc41be aktualisieren

Version 1.4.0-alpha01

29. Mai 2024

androidx.biometric:biometric:1.4.0-alpha01 und androidx.biometric:biometric-ktx:1.4.0-alpha01 wurden veröffentlicht. Diese Version wurde in einem internen Branch entwickelt und ist auf Android 15 Beta 2 ausgerichtet.

Fehlerkorrekturen

  • Die Benutzeroberfläche wurde aktualisiert, damit sie mit Plattformänderungen in Android 15 konsistent ist.

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 wurden 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 Bibliotheksgröße zu reduzieren. (I3601e, b/220178553)
  • Das Problem für BiometricPrompt, das in Kontexten ohne Aktivität gehostet wurde, wurde behoben. (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 wurden 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

  • In API 29 wurde ein Problem behoben, bei dem auf einigen Geräten (einschließlich Emulatoren) ein Abbruchfehler angezeigt wurde, wenn auf PIN/Muster/Passwort zurückgegriffen wurde. Bei einigen Geräten mit API 29 kann dies dazu führen, dass der Nutzer zur 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 oder 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 wurden veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.

API-Änderungen

  • Das Sperren von Koroutineerweiterungen für „CredentialAuthPrompt“ wurde hinzugefügt ähnlich wie bei anderen 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 wurden 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 umbenannt. (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 keine Unterstützung bieten. (I18896)
  • Getter-Methoden für alle AuthPrompt-Felder hinzugefügt, die über einen Builder festgelegt werden. (I18896)
  • Es wurde das Sperren von Kotlin-Koroutinen-Erweiterungen für die biometrische Authentifizierung über die AuthPrompt APIs hinzugefügt. Diese Funktionen geben das AuthenticationResult im Erfolgsfall direkt zurück oder lösen im Falle eines Fehlers oder Misserfolgs eine Ausnahme (Ablehnung von Anmeldedaten) aus. (Iffc9e)

Fehlerkorrekturen

  • Bei Android 10 (API-Level 29) gab BiometricManager.canAuthenticate(int) bei Geräten mit Fingerabdrucksensor unter Android 10 (API-Level 29) manchmal den falschen Statuscode zurück. Dieses Problem wurde behoben. (I72420, b/176921662)
  • Bei Android 10 (API-Level 29) und früheren SDK-Versionen gab BiometricManager.canAuthenticate(int) für ein Gerät ohne biometrische Hardware und ohne registrierte PIN, Muster oder Passwort den falschen Statuscode zurück. Dieses Problem wurde behoben. (I79b7d, b/174505824)
  • Ein Speicherleck wurde behoben, das auftreten konnte, wenn BiometricPrompt in einem Fragment mit einer kürzeren Lebensdauer als die zugehörige Aktivität gehostet wurde. (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 wurden veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Einführung des Moduls androidx.biometric:biometric-ktx, das Kotlin-spezifische APIs und Erweiterungen zusätzlich zu androidx.biometric:biometric hinzufügt.

API-Änderungen

  • Es wurden neue AuthPrompt APIs zum Erstellen einer BiometricPrompt und zur Durchführung der Authentifizierung hinzugefügt. Für diese APIs muss die BiometricPrompt nicht in einem frühen Lebenszyklus-Callback wie onCreate erstellt werden. (I19022)
  • Kotlin-Erweiterungen für Fragment und FragmentActivity wurden 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 wurde veröffentlicht. Version 1.1.0 enthält diese Commits.

Große Änderungen seit Version 1.0.0

  • Abwärtskompatible Unterstützung für neue Funktionen und API-Updates zur biometrischen Authentifizierung, die mit Android 11 eingeführt wurden.
  • Die App-Größe der Bibliothek wurde deutlich reduziert (in einigen Fällen um mehr als 100 KB).
  • Es wurden verschiedene Quellen von Speicherlecks entfernt, die zuvor durch die Bibliothek verursacht wurden.
  • Fehler bei der Klassenüberprüfung wurden behoben, die sich auf die Leistung unter älteren Android-Versionen auswirken konnten.
  • 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 wurde veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Auf einigen Geräten wurde ein Problem behoben, bei dem bei bestimmten Aktionen (Authentifizierung, Stornierung usw.) manchmal der Fehler NullPointerException ausgelöst wurde. (b/151316421)
  • Einige Pixel-Geräte meldeten unter Android 10 den falschen Status, wenn BiometricManager#canAuthenticate(int) verwendet wurde, um ein biometrisches Verfahren der Klasse 3 zu überprüfen. Dieses Problem wurde behoben. (b/170406186)

Version 1.1.0-beta01

1. Oktober 2020

androidx.biometric:biometric:1.1.0-beta01 wurde veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

Neue Funktionen

  • Die APK-Größe der Bibliothek unter Android 8.1 und niedriger wurde deutlich reduziert (in einigen Fällen um mehr als 100 KB komprimiert), da Dialogfeldanimationen durch statische Assets ersetzt wurden. (I4844e)
  • BiometricPrompt greift nun bei allen unterstützten Android-Versionen automatisch auf die Authentifizierung von Geräteanmeldedaten (falls zulässig) zurück, wenn die biometrische Authentifizierung gesperrt ist. (b/149579143)

Fehlerkorrekturen

  • BiometricPrompt verursachte auf einigen Android 9-Geräten ohne Fingerabdrucksensor einen Absturz. Dieses Problem wurde behoben. (b/151443237)
  • Potenzielles NullPointerException in FingerprintDialogFragment behoben. (b/167951429)
  • Es wurde ein Problem behoben, bei dem der falsche CryptoObject-Typ für einen Aufruf einer reflektierenden Methode in BiometricManager verwendet wurde. (b/165824669)
  • Auf einigen Android 10-Geräten wurde die neue Aufforderung automatisch geschlossen, wenn BiometricPrompt kurz nach dem Schließen wieder angezeigt wurde. Dieses Problem wurde behoben. (b/157783075)
  • Speicherlecks im Zusammenhang mit der Verwendung von FingerprintManagerCompat wurden behoben. (b/165840273)
  • Es wurden Probleme behoben, bei denen die Benutzeroberfläche des Fingerabdruck-Dialogfelds auf einigen Android 9-Geräten nicht korrekt angezeigt oder ausgeblendet wurde. (b/154868505, b/148350291)

Version 1.1.0-alpha02

19. August 2020

androidx.biometric:biometric:1.1.0-alpha02 wurde veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.

Neue Funktionen

  • BiometricManager#canAuthenticate() kann nun BIOMETRIC_STATUS_UNKNOWN zurückgeben, um anzugeben, dass der Nutzer sich noch authentifizieren kann, oder BIOMETRIC_ERROR_UNSUPPORTED, um anzugeben, dass eine bestimmte Authenticator-Kombination vom Gerät nicht unterstützt wird.
  • BiometricPrompt#authenticate() kann jetzt nur unter Android 11 (API-Level 30) und höher für die Authentifizierung von Geräteanmeldedaten mit einer zugehörigen CryptoObject verwendet werden.

API-Änderungen

Fehlerkorrekturen

  • Von LeakCanary in BiometricFragment und BiometricViewModel gemeldete Speicherlecks wurden behoben. (b/144919472)
  • Es wurde sichergestellt, dass BiometricViewModel MutableLiveData#setValue() nicht mehr aus einem Hintergrundthread aufruft. (b/159983244)
  • Es wurde ein Problem behoben, bei dem BiometricPrompt die vorübergehende Sperrung auf einigen API-Ebenen nicht korrekt verarbeitet hat. (9acfce9)
  • Es wurde ein Problem behoben, bei dem BiometricPrompt für ein Gerät, das auf einigen API-Ebenen nicht mit Anmeldedaten für die Displaysperre gesichert war, den falschen Fehlercode zurückgibt. (b/148626482)
  • Es wurde ein Problem behoben, bei dem BiometricManager und BiometricPrompt auf einigen API-Ebenen für ein Gerät ohne Keyguard-Implementierung die falschen Fehlercodes zurückgegeben haben. (891c6e0)

Version 1.1.0-alpha01

24. Juni 2020

androidx.biometric:biometric:1.1.0-alpha01 wurde veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Die Implementierung der internen Bibliothek wurde überarbeitet, um potenzielle Quellen von Speicherlecks und anderen unbeabsichtigten Verhaltensweisen zu beseitigen:
    • Interne Fragmente teilen und speichern Daten jetzt mithilfe eines ViewModel, der an den Aktivitätslebenszyklus der Clientanwendung gebunden ist.
    • Bei der Authentifizierung der Geräteanmeldedaten vor Android 10 (API-Level 29) wird keine transparente Aktivität innerhalb der Clientanwendung mehr gestartet.

Fehlerkorrekturen

  • Einstellungswarnungen im Zusammenhang mit der Verwendung von FingerprintManagerCompat wurden behoben. (b/142967618)
  • Die Methode zum Aufrufen von SDK-gesteuerten Plattformmethoden wurde geändert, um Probleme bei der Klassenüberprüfung unter ä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 wurde veröffentlicht. Version 1.0.1 enthält diese Commits.

Fehlerkorrekturen

  • Die vorhandene Problemumgehung für die Fingerabdruck-Fallback-Lösung für die kryptografische Authentifizierung wurde auf bekannte betroffene Anbieter ausgeweitet und gleichzeitig auf API 28 beschränkt (b/143361271).
  • Auf bestimmten Geräten wurde ein Problem behoben, bei dem das biometrische Dialogfeld unter einem System-Overlay angezeigt wurde (b/143230260).
  • Mehrere Probleme mit setDeviceCredentialAllowed(true) behoben (b/143091227, b/143097321, b/143653944)
  • Bei bestimmten Android-Versionen wurde ein Problem behoben, bei dem onAuthenticationSuccess nicht immer aufgerufen wurde, nachdem der Nutzer die Anmeldedaten des Geräts bestätigt hatte (b/145232806).
  • In bestimmten Android-Versionen wurde ein Problem behoben, bei dem onAuthenticationError nicht immer aufgerufen wurde, wenn die Aufforderung beim Drehen geschlossen wurde (b/145230042).
  • In bestimmten Android-Versionen wurde ein Problem behoben, bei dem die Aufforderung bei bestimmten Fehlercodes nicht geschlossen wurde (b/143683687).
  • Potenzielles NullPointerException in BiometricFragment behoben (b/142599311)

Version 1.0.0

Version 1.0.0

7. November 2019

androidx.biometric:biometric:1.0.0 wurde ohne Änderungen seit dem 1.0.0-rc02 freigegeben. Version 1.0.0 enthält diese Commits.

Hauptfunktionen von Version 1.0.0

  • Kompatibilitätsversion der APIs BiometricPrompt und BiometricManager, wie in Android 10 implementiert, mit vollständiger Funktionsunterstützung ab Android 6.0 (API 23)
  • Integrierte Lebenszyklusverwaltung für BiometricPrompt innerhalb von Fragment oder FragmentActivity
  • Spezielle Behandlung für Geräte, von denen bekannt ist, dass sie bei der kryptobasierten Authentifizierung fälschlicherweise ein schwaches biometrisches Verfahren aufweisen

Version 1.0.0-rc02

23. Oktober 2019

androidx.biometric:biometric:1.0.0-rc02 wurde veröffentlicht. Version 1.0.0-rc02 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde eine Behelfslösung für bestimmte Geräte hinzugefügt, die bekanntermaßen fälschlicherweise eine schwache biometrische Authentifizierung bereitstellen, wenn die kryptografische 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 wurde veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Ein möglicher Absturz mit FingerprintDialogFragment beim Schließen während des Drehens des Bildschirms wurde behoben (b/141356362).
  • Es wurde ein Problem behoben, bei dem das Empfangen eines Null-AuthenticationResult von der Framework-API zu einem Absturz führte (b/138862251).
  • Abstürze verursacht, 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 wurde veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.

Fehlerkorrekturen

  • Probleme mit der Unterstützung von Geräteanmeldedaten in Version 1.0.0-beta01 behoben
  • Java 8-Abhängigkeiten wurden entfernt und zu Java 7 gewechselt (b/140508526).
  • FingerprintHelperFragment gibt ERROR_HW_NOT_PRESENT jetzt korrekt aus, wenn keine Fingerabdruckhardware erkannt wird (b/140427586).

Version 1.0.0-beta01

29. August 2019

androidx.biometric:biometric:1.0.0-beta01 wurde veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

Neue Funktionen

Wir haben einen zweiten Konstruktor für BiometricPrompt eingeführt, mit dem er in einem Fragment gehostet werden kann (im Gegensatz zum vorhandenen Konstruktor, der eine FragmentActivity erfordert).

Außerdem freuen wir uns, die folgenden Funktionen von Android 10 in die AndroidX Biometric-Bibliothek einzubinden:

  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 Prompts hinzugefügt (b/131980596)
  • Weitere Informationen finden Sie oben im Abschnitt „Neue Funktionen“.

Fehlerkorrekturen

  • Unterstützung von BiometricPrompt-Geräteanmeldedaten für L+ hinzufügen
  • BiometricPrompt wurde so korrigiert, dass öffentliche Fehlerkonstanten verwendet werden (b/137788194)
  • NullPointerException in BiometricPrompt.onAttach() korrigieren (b/136103103)
  • Das Verhalten wurde so geändert, dass BiometricPrompt nicht durch ein Touch-Ereignis außerhalb des Prompts abgebrochen werden kann (b/135684487)
  • Der Absturz von "onAuthenticationError" bei Rückgabe eines Null-Fehlerwerts in Kotlin wurde behoben (b/128350861).
  • FingerprintDialogFragment kann jetzt formatiert werden (b/127878106)
  • "FingerprintDialog" ist jetzt scrollbar (b/126367887).
  • Es wurde ein Fehler behoben, durch den beim Drehen des biometrischen Dialogfelds IllegalStateException ausgelöst wurde (b/124153656), (b/123811924).
  • Ein inkonsistentes Verhalten auf den API-Levels 23 bis 27 wurde behoben. (b/124066957)
  • Ein Problem wurde behoben, bei dem im Dialogfeld für die Anmeldung per Fingerabdruck in der TalkBack-Funktion der falsche Text vorgelesen wurde. (b/123572331)

Version 1.0.0-alpha04

3. April 2019

androidx.biometric:biometric:1.0.0-alpha04 wurde veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Fehlerkorrekturen

  • Korrigierte biometrische Fragmente werden nicht in allen Fällen bereinigt. (b/121117380)
  • Korrigiertes BiometricPrompt lässt nur eine Instanz von BiometricPrompt.AuthenticationCallback zu (b/123857949)
  • BiometricPrompt Fehlerverhalten behoben, der zwischen System- und kompatiblen Versionen nicht konsistent war. (b/123572326)
  • Korrigierter Callback onAuthenticationError() mit @NotNull errString verursacht NullPointerException zur Laufzeit (b/123167217)
  • Fehlerkorrektur für androidx.BiometricPrompt-Abstürze der Schaltfläche „Abbrechen“ (b/122054485)
  • Fehlerkorrektur: androidx.biometric.PromptInfo Titel/Beschreibung, die unter Android P nicht geändert wurde (b/122856773)

Version 1.0.0-alpha03

17. Dezember 2018

Fehlerkorrekturen

  • Probleme im Zusammenhang mit Fragmenten behoben
  • Auf Geräten O und älter werden Sperrfehler sofort zurückgegeben, um im Einklang mit P und höher zu stehen.