Biometrischen

Authentifizierung mit biometrischen Verfahren oder Geräte-Anmeldedaten und kryptografische Vorgänge ausführen.
Letzte Aktualisierung Stabile Version Release Candidate Beta-Ausgabe Alphaversion
7. August 2024 1.1.0 - - 1.4.0-alpha02

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von Biometric 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 Anwendung oder Ihr Modul die Abhängigkeiten für die Artefakte hinzu, die Sie benötigen:

Groovy

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. 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.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 mit benutzerdefinierten Inhalten als zusätzliche Option für die Textansicht der Beschreibung anzeigen.
  • Das App-Logo wird im biometric prompt angezeigt. Es wird automatisch über das App-Symbol hinzugefügt.

API-Änderungen

  • APIs zur Unterstützung der Ansicht mit benutzerdefinierten Inhalten hinzufügen
    • BiometricPrompt.PromptInfo.Builder#setContentView
    • BiometricPrompt.PromptInfo#getContentView
    • PromptContentView-Oberfläche
    • PromptVerticalListContentView-Kurs
    • Klasse PromptContentViewWithMoreOptionsButton (nur für privilegierte Apps)
  • APIs zur Unterstützung des Logos 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 werden freigegeben. Diese Version wird 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 werden freigegeben. Version 1.2.0-alpha05 enthält diese Commits.

API-Änderungen

  • Unterstützung für CryptoObject 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 mit BiometricPrompt, das in nicht aktivitätsbezogenen Kontexten 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 werden freigegeben. Version 1.2.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Verbesserte Unterstützung von BiometricPrompt für Fragmente, die von nicht aktivitätsbezogenen Kontexten gehostet werden (I9312b)

API-Änderungen

Fehlerkorrekturen

  • Ein Problem in der API 29 wurde behoben, bei dem einige Geräte (einschließlich Emulatoren) einen Fehler beim Abbruch erhielten, wenn sie zur PIN, zum Muster oder zum Passwort zurückkehrten. Hinweis: Bei einigen Geräten mit API 29 wird der Nutzer möglicherweise aufgefordert, seine Displaysperre zu verwenden, auch wenn eine biometrische Authentifizierung 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

  • Es wurden sitzungsspezifische coroutine-Erweiterungen für CredentialAuthPrompt hinzugefügt, die denen für andere AuthPrompt-Typen ähneln. (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 freigegeben. 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 umgestellt. (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)
  • Es wurden Gettermethoden für alle AuthPrompt-Felder hinzugefügt, die über einen Builder festgelegt werden. (I18896)
  • Es wurden Kotlin-Erweiterungen für pausierende Tasks für die biometrische Authentifizierung über die AuthPrompt APIs hinzugefügt. Diese Funktionen geben AuthenticationResult direkt bei Erfolg zurück oder werfen bei Fehlern oder Fehlschlägen (Ablehnung von Anmeldedaten) eine Ausnahme. (Iffc9e)

Fehlerkorrekturen

  • Ein Problem wurde 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ückgab. (I72420, b/176921662)
  • Es wurde ein Problem behoben, bei dem BiometricManager.canAuthenticate(int) unter Android 10 (API-Level 29) und früheren SDK-Versionen den falschen Statuscode für ein Gerät ohne biometrische Hardware und ohne registrierte PIN, Muster oder Passwort zurückgab. (I79b7d, b/174505824)
  • Ein Speicherleck wurde behoben, das auftrat, wenn BiometricPrompt in einem Fragment gehostet wurde, dessen Lebenszyklus kürzer war als der der zugehörigen Aktivität. (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 freigegeben. Version 1.2.0-alpha01 enthält diese Commits.

Neue Funktionen

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

API-Änderungen

  • Es wurden neue AuthPrompt APIs zum Erstellen eines 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 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 veröffentlicht. Version 1.1.0 enthält diese Commits.

Wichtige Ä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 erheblich reduziert (in einigen Fällen um mehr als 100 KB).
  • Verschiedene Quellen von Speicherlecks wurden entfernt, die zuvor von der Bibliothek verursacht wurden.
  • Fehler bei der Klassenüberprüfung behoben, die sich auf die Leistung bei älteren Android-Versionen auswirken können.
  • 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 veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem auf einigen Geräten wurde behoben, bei dem bestimmte Aktionen (z. B. Authentifizierung oder Abbrechen) manchmal eine NullPointerException auslösten. (b/151316421)
  • Ein Problem wurde behoben, bei dem auf einigen Pixel-Geräten der falsche Status gemeldet wurde, wenn mit BiometricManager#canAuthenticate(int) nach biometrischen Daten der Klasse 3 auf Android 10 gesucht wurde. (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 wurde erheblich reduziert (in einigen Fällen um mehr als 100 KB komprimiert), indem Dialogfeldanimationen unter Android 8.1 und niedriger durch statische Assets ersetzt wurden. (I4844e)
  • BiometricPrompt greift nun bei allen unterstützten Android-Versionen automatisch auf die Authentifizierung mit Geräteanmeldedaten (falls zulässig) zurück, wenn die biometrische Authentifizierung gesperrt ist. (b/149579143)

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem BiometricPrompt auf einigen Android 9-Geräten ohne Fingerabdrucksensor zu einem Absturz führte. (b/151443237)
  • Ein potenzielles NullPointerException in FingerprintDialogFragment wurde behoben. (b/167951429)
  • Ein Problem wurde behoben, bei dem für eine reflektive Methodenaufruf in BiometricManager der falsche CryptoObject-Typ verwendet wurde. (b/165824669)
  • Ein Problem wurde behoben, bei dem die neue Aufforderung auf einigen Android 10-Geräten automatisch geschlossen wurde, wenn BiometricPrompt kurz nach dem Schließen noch einmal angezeigt wurde. (b/157783075)
  • Speicherlecks im Zusammenhang mit der Verwendung von FingerprintManagerCompat wurden behoben. (b/165840273)
  • Probleme behoben, bei denen das Fingerabdruckdialogfeld 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 veröffentlicht. 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 möglicherweise noch authentifizieren kann, oder BIOMETRIC_ERROR_UNSUPPORTED, um anzugeben, dass eine bestimmte Kombination aus Authentifizierungsmethoden vom Gerät nicht unterstützt wird.
  • BiometricPrompt#authenticate() kann jetzt nur unter Android 11 (API-Level 30) oder höher für die Authentifizierung von Geräteanmeldedaten mit einem verknüpften CryptoObject verwendet werden.

API-Änderungen

Fehlerkorrekturen

  • Von LeakCanary in BiometricFragment und BiometricViewModel gemeldete Speicherlecks wurden behoben. (b/144919472)
  • BiometricViewModel ruft MutableLiveData#setValue() nicht mehr über einen Hintergrund-Thread auf. (b/159983244)
  • Es wurde ein Problem behoben, bei dem BiometricPrompt die vorübergehende Sperrung auf einigen API-Ebenen nicht korrekt verarbeitet hat. (9acfce9)
  • Ein Problem wurde behoben, bei dem BiometricPrompt auf einigen API-Ebenen den falschen Fehlercode für ein Gerät zurückgab, das nicht mit Anmeldedaten für die Bildschirmsperre gesichert war. (b/148626482)
  • Behoben: Bei einigen API-Ebenen wurden von BiometricManager und BiometricPrompt falsche Fehlercodes für ein Gerät ohne Keyguard-Implementierung zurückgegeben. (891c6e0)

Version 1.1.0-alpha01

24. Juni 2020

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

Neue Funktionen

  • Die interne Bibliotheksimplementierung wurde überarbeitet, um potenzielle Quellen von Speicherlecks und anderen unbeabsichtigten Verhaltensweisen zu beheben:
    • Interne Fragmente geben Daten jetzt mithilfe einer ViewModel frei und speichern sie. Diese ViewModel ist mit dem Aktivitätszyklus der Clientanwendung verknüpft.
    • Bei der Authentifizierung von Geräteanmeldedaten vor Android 10 (API-Level 29) wird keine transparente Aktivität mehr in der Clientanwendung gestartet.

Fehlerkorrekturen

  • Warnungen zur Einstellung von FingerprintManagerCompat wurden behoben. (b/142967618)
  • Die Aufrufweise von SDK-geschützten Plattformmethoden wurde geändert, um Probleme bei der Klassenüberprüfung bei älteren Android-Versionen zu vermeiden. (94beb4b)
  • Gradle-Abhängigkeiten, die nicht Teil der öffentlichen API sind, werden von der Bibliothek nicht mehr 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 Fallback-Umgehung für den Fingerabdruck 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 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).
  • Ein Problem bei bestimmten Android-Versionen wurde behoben, bei dem onAuthenticationError nicht immer aufgerufen wurde, wenn die Aufforderung bei der Bildschirmdrehung geschlossen wurde (b/145230042)
  • Ein Problem bei bestimmten Android-Versionen wurde behoben, bei dem die Aufforderung beim Empfang bestimmter 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 wird seit 1.0.0-rc02 unverändert veröffentlicht. 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 in einer Fragment oder FragmentActivity
  • Spezielle Behandlung von Geräten, bei denen bei der kryptobasierten Authentifizierung fälschlicherweise schwache biometrische Daten angegeben werden

Version 1.0.0-rc02

23. Oktober 2019

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

Fehlerkorrekturen

  • Es wurde eine Problemumgehung für bestimmte Geräte hinzugefügt, bei denen bei der kryptobasierten Authentifizierung in den API-Versionen 28 und 29 fälschlicherweise ein schwaches biometrisches Merkmal angegeben wird (b/142150327)

Version 1.0.0-rc01

9. Oktober 2019

androidx.biometric:biometric:1.0.0-rc01 wird veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein potenzieller Absturz mit FingerprintDialogFragment behoben, wenn die Taste geschlossen wurde, während das Display gedreht wurde (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 behoben, 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 veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.

Fehlerkorrekturen

  • In Version 1.0.0-beta01 wurden Probleme mit der Unterstützung von Geräteanmeldedaten behoben.
  • Java 8-Abhängigkeiten 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. Der vorhandene Konstruktor erfordert dagegen eine FragmentActivity.

Außerdem freuen wir uns, die folgenden Funktionen aus 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. Bei ä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 Geräteanmeldedaten von BiometricPrompt für L+ hinzufügen
  • BiometricPrompt wurde so korrigiert, dass öffentliche Fehlerkonstanten verwendet werden (b/137788194)
  • Fehler bei NullPointerException in BiometricPrompt.onAttach() beheben (b/136103103)
  • Das Verhalten wurde so geändert, dass BiometricPrompt nicht durch ein Touch-Ereignis außerhalb des Prompts abgebrochen werden kann (b/135684487)
  • Behebung des Absturzes bei onAuthenticationError, wenn in Kotlin ein Null-Fehlerwert zurückgegeben wird (b/128350861)
  • FingerprintDialogFragment kann jetzt formatiert werden (b/127878106)
  • Der Fingerabdruckdialog ist jetzt scrollbar (b/126367887)
  • Es wurde ein Fehler behoben, durch den beim Drehen des biometrischen Dialogfelds ein IllegalStateException angezeigt wurde (b/124153656), (b/123811924)
  • Inkonsistentes Verhalten bei API-Level 23 bis 27 behoben (b/124066957)
  • Das Problem, dass im Dialogfeld für die Fingerabdruckanmeldung mit Talkback der falsche Text vorgelesen wurde, wurde behoben. (b/123572331)

Version 1.0.0-alpha04

3. April 2019

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

Fehlerkorrekturen

  • Feste biometrische Fragmente werden nicht in allen Fällen bereinigt. (b/121117380)
  • Für die feste BiometricPrompt-Version ist nur eine Instanz von BiometricPrompt.AuthenticationCallback zulässig (b/123857949)
  • Das unterschiedliche Verhalten von BiometricPrompt-Fehlern bei System- und kompatiblen Versionen wurde behoben. (b/123572326)
  • Korrigierter Callback onAuthenticationError() mit @NotNull errString verursacht NullPointerException zur Laufzeit (b/123167217)
  • Behobene Abstürze bei der Schaltfläche „Abbrechen“ von androidx.BiometricPrompt (b/122054485)
  • Behoben: androidx.biometric.PromptInfo Titel/Beschreibung werden unter Android P nicht geändert (b/122856773)

Version 1.0.0-alpha03

17. Dezember 2018

Fehlerkorrekturen

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