Biyometrik

Biyometri veya cihaz kimlik bilgileriyle kimliğinizi doğrulayın ve kriptografik işlemler yapın.
Son Güncelleme Kararlı Sürüm Serbest Bırakma Adayı Beta Sürümü Alfa Sürümü
29 Mayıs 2024 1.1.0 - - 1.4.0-alpha01

Bağımlılıkları bildirme

Biyometrik bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.

Uygulamanızın veya modülünüz için build.gradle dosyasına ihtiyaç duyduğunuz yapıların bağımlılıklarını ekleyin:

Groovy

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")
}

Bağımlılıklar hakkında daha fazla bilgi edinmek için Derleme Bağımlılıkları Ekleme bölümüne bakın.

Geri bildirim

Geri bildiriminiz Jetpack'i daha iyi hale getirmemize yardımcı oluyor. Yeni sorunlar keşfederseniz veya bu kitaplığı nasıl geliştirebileceğimizle ilgili fikirleriniz varsa bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.

Yeni sayı oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerine bakın.

Sürüm 1.4

Sürüm 1.4.0-alpha01

29 Mayıs 2024

androidx.biometric:biometric:1.4.0-alpha01 ve androidx.biometric:biometric-ktx:1.4.0-alpha01 yayınlandı. Bu sürüm, dahili bir dal olarak geliştirilmiştir ve Android 15 Beta 2'yi hedefler.

Hata Düzeltmeleri

  • Kullanıcı arayüzünü, Android 15'teki platform değişiklikleriyle tutarlı olacak şekilde güncelleyin

Sürüm 1.2.0

Sürüm 1.2.0-alpha05

21 Eylül 2022

androidx.biometric:biometric:1.2.0-alpha05 ve androidx.biometric:biometric-ktx:1.2.0-alpha05 yayınlandı. Sürüm 1.2.0-alpha05 bu kayıtları içerir.

API Değişiklikleri

  • Android 13'e android.security.identity.PresentationSession için CryptoObject desteği eklendi. (C5f1ec, b/197965513)

Hata Düzeltmeleri

  • Kitaplık boyutunu küçültmek için gereksiz kaynak varyantları kaldırıldı. (I3601e, b/220178553)
  • Etkinlik dışı bağlamlarda barındırılan BiometricPrompt ile ilgili sorun düzeltildi. (Ife255)

Sürüm 1.2.0-alpha04

17 Kasım 2021

androidx.biometric:biometric:1.2.0-alpha04 ve androidx.biometric:biometric-ktx:1.2.0-alpha04 yayınlandı. Sürüm 1.2.0-alpha04 bu kayıtları içerir.

Yeni Özellikler

  • Etkinlik dışı bağlamlar tarafından barındırılan parçalar için geliştirilmiş BiometricPrompt desteği (I9312b)

API Değişiklikleri

Hata Düzeltmeleri

  • API 29'da, bazı cihazların (emülatörler dahil) PIN/desen/şifreye dönerken iptal hatası almasına neden olan sorun düzeltildi. API 29'daki bazı cihazlarda bu, biyometri kullanılabilir ve kayıtlı olsa bile kullanıcıdan ekran kilidinin istenmesine neden olabilir. (b/142740104)
  • API 29'da biyometrik donanıma sahip olmayan cihazların PIN/desen/şifreye doğru şekilde dönüşmemesi sorunu giderildi (b/170517889)

Sürüm 1.2.0-alpha03

24 Şubat 2021

androidx.biometric:biometric:1.2.0-alpha03 ve androidx.biometric:biometric-ktx:1.2.0-alpha03 yayınlandı. Sürüm 1.2.0-alpha03 bu kayıtları içerir.

API Değişiklikleri

  • CredentialAuthPrompt için diğer AuthPrompt türlerine benzer askıya alma eş yordam uzantıları eklendi. (I9ac70)

Sürüm 1.2.0-alpha02

27 Ocak 2021

androidx.biometric:biometric:1.2.0-alpha02 ve androidx.biometric:biometric-ktx:1.2.0-alpha02 yayınlandı. Sürüm 1.2.0-alpha02 bu kayıtları içerir.

API Değişiklikleri

  • Daha önce derleyici aracılığıyla ayarlanan bazı AuthPrompt alanları, startAuthentication(...) yöntem bağımsız değişkenleri olarak yeniden düzenlendi. (I18896, b/174098373)
  • Eski Android sürümlerinde sınırlı desteğe sahip olan veya hiç destek vermeyen AuthPrompt türleri için minimum API düzeyi şartları eklendi. (I18896)
  • Oluşturucu aracılığıyla ayarlanan tüm AuthPrompt alanları için alıcı yöntemleri eklendi. (I18896)
  • AuthPrompt API'leri aracılığıyla biyometrik kimlik doğrulama için eş yordam Kotlin uzantılarının askıya alınması eklendi. Bu işlevler, başarılı olduğunda doğrudan AuthenticationResult öğesini döndürür veya hata ya da başarısızlık durumunda (kimlik bilgisi reddi) bir istisna oluşturur. (Iffc9e)

Hata Düzeltmeleri

  • BiometricManager.canAuthenticate(int) uygulamasının, Android 10'da (API düzeyi 29) parmak izi sensörü olan bir cihaz için bazen yanlış durum kodu döndürmesine neden olan sorun düzeltildi. (I72420, b/176921662)
  • BiometricManager.canAuthenticate(int) ürününün, biyometrik donanımı olmayan ve Android 10 (API düzeyi 29) ile önceki SDK sürümlerinde kayıtlı PIN, desen veya şifre bulunmayan bir cihaz için yanlış durum kodunu döndürmesine neden olan sorun düzeltildi. (I79b7d, b/174505824)
  • BiometricPrompt, ilişkili etkinliğinden daha kısa bir yaşam döngüsüne sahip bir parçada barındırıldığında ortaya çıkan bellek sızıntısı düzeltildi. (I70864, b/167014923)

Sürüm 1.2.0-alpha01

2 Aralık 2020

androidx.biometric:biometric:1.2.0-alpha01 ve androidx.biometric:biometric-ktx:1.2.0-alpha01 yayınlandı. Sürüm 1.2.0-alpha01 bu kayıtları içerir.

Yeni Özellikler

  • androidx.biometric:biometric öğesinin üzerine Kotlin'e özel API'ler ve uzantılar ekleyen androidx.biometric:biometric-ktx modülü kullanıma sunuldu.

API Değişiklikleri

  • BiometricPrompt oluşturmak ve kimlik doğrulama gerçekleştirmek için yeni AuthPrompt API'leri eklendi. Bu API'ler BiometricPrompt öğesinin onCreate gibi erken yaşam döngüsü geri çağırma işleminde oluşturulmasını gerektirmez. (I19022)
  • Yeni AuthPrompt API'leri için Fragment ve FragmentActivity öğelerine Kotlin uzantıları eklendi. (Iaf98c)

Sürüm 1.1.0

Sürüm 1.1.0

27 Ocak 2021

androidx.biometric:biometric:1.1.0 yayınlandı. 1.1.0 sürümü bu kayıtları içerir.

1.0.0'dan bu yana yapılan önemli değişiklikler

  • Android 11'de sunulan yeni biyometrik kimlik doğrulama özellikleri ve API güncellemeleri için geriye dönük uyumlu destek eklendi.
  • Kitaplığın uygulama boyutu ayak izi önemli ölçüde azaltıldı (bazı durumlarda >100 KB).
  • Daha önce kitaplıktan kaynaklanan çeşitli bellek sızıntısı kaynakları kaldırıldı.
  • Eski Android sürümlerinin performansını etkileyebilecek sınıf doğrulama hataları düzeltildi.
  • Kütüphanenin kararlılığı ve davranışı ile ilgili çeşitli ek iyileştirmeler yapıldı.

Sürüm 1.1.0-rc01

11 Kasım 2020

androidx.biometric:biometric:1.1.0-rc01 yayınlandı. 1.1.0-rc01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Bazı cihazlarda, belirli işlemlerin (kimlik doğrulama, iptal etme vb.) bazen NullPointerException hata vermesine neden olan sorun düzeltildi. (b/151316421)
  • Android 10'da 3. Sınıf biyometri kontrolü için BiometricManager#canAuthenticate(int) kullanılırken bazı Pixel cihazların yanlış durumu bildirmesine neden olan sorun düzeltildi. (b/170406186)

Sürüm 1.1.0-beta01

1 Ekim 2020

androidx.biometric:biometric:1.1.0-beta01 yayınlandı. 1.1.0-beta01 sürümü bu kayıtları içerir.

Yeni Özellikler

  • İletişim kutusu animasyonlarını Android 8.1 ve önceki sürümlerde statik öğelerle değiştirerek kitaplığın APK boyutu ayak izini önemli ölçüde azalttı (bazı durumlarda sıkıştırılmış olarak >100 KB). (I4844e)
  • Biyometrik kimlik doğrulama kilitli olduğunda BiometricPrompt artık desteklenen tüm Android sürümlerinde otomatik olarak cihaz kimlik bilgisi kimlik doğrulamasına (izin veriliyorsa) geri dönüyor. (b/149579143)

Hata Düzeltmeleri

  • BiometricPrompt ürününün, parmak izi sensörü olmayan bazı Android 9 cihazlarda kilitlenmeye neden olması sorunu düzeltildi. (b/151443237)
  • FingerprintDialogFragment öğesinde olası bir NullPointerException düzeltildi. (b/167951429)
  • BiometricManager ürününde yansıtıcı yöntem çağrısı için yanlış CryptoObject türünün kullanılmasına neden olan sorun düzeltildi. (b/165824669)
  • Kapatma işleminden kısa bir süre sonra BiometricPrompt gösterilmesinin bazı Android 10 cihazlarda yeni istemin otomatik olarak kapatılmasına neden olan sorun düzeltildi. (b/157783075)
  • FingerprintManagerCompat kullanımıyla ilgili bellek sızıntıları düzeltildi. (b/165840273)
  • Bazı Android 9 cihazlarda parmak izi iletişim kutusu kullanıcı arayüzünün gizlenmesi veya yanlış gösterilmesiyle ilgili sorunlar düzeltildi. (b/154868505, b/148350291)

Sürüm 1.1.0-alpha02

19 Ağustos 2020

androidx.biometric:biometric:1.1.0-alpha02 yayınlandı. Sürüm 1.1.0-alpha02 bu kayıtları içerir.

Yeni Özellikler

  • BiometricManager#canAuthenticate() artık kullanıcının hâlâ kimlik doğrulaması yapabileceğini belirtmek için BIOMETRIC_STATUS_UNKNOWN veya belirli bir kimlik doğrulayıcı kombinasyonunun cihaz tarafından desteklenmediğini belirtmek için BIOMETRIC_ERROR_UNSUPPORTED hatası döndürebilir.
  • BiometricPrompt#authenticate() artık yalnızca Android 11 (API düzeyi 30) ve sonraki sürümlerde ilişkilendirilmiş bir CryptoObject ile cihaz kimlik bilgisi kimlik doğrulaması için kullanılabilir.

API Değişiklikleri

Hata Düzeltmeleri

  • BiometricFragment ve BiometricViewModel ürünlerinde LeakCanary tarafından bildirilen bellek sızıntıları düzeltildi. (b/144919472)
  • BiometricViewModel işlevinin artık MutableLiveData#setValue() öğesini arka plandaki bir ileti dizisinden çağırmayacağından emin olun. (b/159983244)
  • BiometricPrompt uygulamasının bazı API düzeylerinde geçici olarak kilitlenmeyi doğru şekilde işlememesine neden olan sorun düzeltildi. (9acfce9)
  • BiometricPrompt hizmetinin, bazı API düzeylerinde ekran kilidi kimlik bilgileriyle güvenliği sağlanmayan bir cihaz için yanlış hata kodu döndürmesine neden olan sorun düzeltildi. (b/148626482)
  • BiometricManager ve BiometricPrompt öğelerinin, bazı API düzeylerinde tuş koruyucu uygulanmayan bir cihaz için yanlış hata kodlarını döndürmesine neden olan sorun giderildi. (891c6e0)

Sürüm 1.1.0-alpha01

24 Haziran 2020

androidx.biometric:biometric:1.1.0-alpha01 yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.

Yeni Özellikler

  • Olası bellek sızıntıları kaynaklarını ve istenmeyen diğer davranışları gidermek için dahili kitaplık uygulaması yeniden düzenlendi:
    • Dahili parçalar artık verileri, istemci uygulamasının etkinlik yaşam döngüsüne bağlı bir ViewModel kullanarak paylaşıp saklar.
    • Android 10'dan (API düzeyi 29) önceki cihaz kimlik bilgisi kimlik doğrulaması artık istemci uygulamasında şeffaf bir etkinlik başlatmamaktadır.

Hata Düzeltmeleri

  • FingerprintManagerCompat kullanımıyla ilgili desteği sonlandırma uyarıları çözüme ulaştırıldı. (b/142967618)
  • Eski Android sürümlerinde sınıf doğrulaması sorunlarını önlemek için SDK korumalı platform yöntemlerinin çağrılma şekli değiştirildi. (94beb4b)
  • Genel API'nin bir parçası olmayan Gradle bağımlılıkları artık kitaplık tarafından dışa aktarılmaz. (f289d9e)

Sürüm 1.0.1

Sürüm 1.0.1

18 Aralık 2019

androidx.biometric:biometric:1.0.1 yayınlandı. Sürüm 1.0.1 bu kayıtları içerir.

Hata düzeltmeleri

  • Kripto tabanlı kimlik doğrulaması için mevcut dijital parmak izi yedek çözümü, API 28 (b/143361271) ile sınırlandırılırken, etkilenen bilinen sağlayıcılar da dahil edilecek şekilde genişletildi
  • Belirli cihazlarda, biyometrik iletişim kutusunun sistem yer paylaşımı altında gösterilmesi sorunu giderildi (b/143230260)
  • setDeviceCredentialAllowed(true) ile ilgili bazı sorunlar giderildi (b/143091227, b/143097321, b/143653944)
  • Belirli Android sürümlerinde, kullanıcı cihaz kimlik bilgilerini onayladıktan sonra onAuthenticationSuccess ürününün her zaman çağrılmadığı bir sorun düzeltildi (b/145232806)
  • Belirli Android sürümlerinde, rotasyon sırasında istem kapatıldığında onAuthenticationError ürününün her zaman çağrılmadığı bir sorun düzeltildi (b/145230042)
  • Belirli Android sürümlerinde, belirli hata kodları alınırken istemin kapatılmamasına neden olan sorun düzeltildi (b/143683687)
  • BiometricFragment öğesinde olası bir NullPointerException düzeltildi (b/142599311)

Sürüm 1.0.0

Sürüm 1.0.0

7 Kasım 2019

androidx.biometric:biometric:1.0.0, 1.0.0-rc02 tarihinden bu yana herhangi bir değişiklik olmadan yayınlandı. Sürüm 1.0.0 bu kayıtları içerir.

1.0.0'ın temel özellikleri

  • BiometricPrompt ve BiometricManager API'lerinin Android 10'da uygulandığı şekliyle uyumluluk sürümleri ile Android 6.0'a (API 23) geri dönen tam özellik desteği
  • Fragment veya FragmentActivity içinde BiometricPrompt için yerleşik yaşam döngüsü yönetimi
  • Kripto tabanlı kimlik doğrulama sırasında yanlış biyometriyi yanlış gösterdiği bilinen cihazlar için özel işlem

Sürüm 1.0.0-rc02

23 Ekim 2019

androidx.biometric:biometric:1.0.0-rc02 yayınlandı. 1.0.0-rc02 sürümü bu kayıtları içerir.

Hata düzeltmeleri

  • API 28 ve 29 sürümlerinde kripto tabanlı kimlik doğrulama çağrıldığında hatalı bir şekilde zayıf biyometrik kimlik doğrulaması sağladığı bilinen belirli cihazlar için geçici bir çözüm eklendi (b/142150327)

Sürüm 1.0.0-rc01

9 Ekim 2019

androidx.biometric:biometric:1.0.0-rc01 yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.

Hata düzeltmeleri

  • Ekran döndürülürken FingerprintDialogFragment kapatıldığında yaşanabilecek kilitlenme sorunu düzeltildi (b/141356362)
  • Çerçeve API'sinden boş AuthenticationResult almanın kilitlenmeye neden olabileceği bir sorun düzeltildi (b/138862251)
  • BiometricPrompt uygulamasının onSaveInstanceState() tarihinden sonra reddedilmesinden kaynaklanan kilitlenmeler düzeltildi (b/138825362, b/140447194)

Sürüm 1.0.0-beta02

18 Eylül 2019

androidx.biometric:biometric:1.0.0-beta02 yayınlandı. 1.0.0-beta02 sürümü bu kayıtları içerir.

Hata düzeltmeleri

  • 1.0.0-beta01 sürümünde cihaz kimlik bilgisi desteğiyle ilgili sorunlar düzeltildi
  • Java 8 bağımlılıkları kaldırıldı ve Java 7'ye bağlı olarak değiştirildi (b/140508526)
  • Parmak izi donanımı algılanmadığında FingerprintHelperFragment, artık doğru şekilde ERROR_HW_NOT_PRESENT sinyali veriyor (b/140427586)

Sürüm 1.0.0-beta01

29 Ağustos 2019

androidx.biometric:biometric:1.0.0-beta01 yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.

Yeni özellikler

BiometricPrompt için bir Fragment içinde barındırılmasına olanak tanıyan ikinci bir kurucuyu (FragmentActivity gerektiren mevcut kurucunun aksine) tanıttık.

Ayrıca, aşağıdaki işlevleri Android 10'daki AndroidX Biometric kitaplığına eklemenin heyecanını yaşıyoruz:

  1. BiometricManager#canAuthenticate
  2. BiometricPrompt.PromptInfo#setConfirmationRequired
  3. BiometricPrompt.PromptInfo#setDeviceCredentialAllowed

Android 10'da kitaplık, platform API'sinden ilgili yöntemleri çağırır. Daha eski API düzeylerinde ise kitaplık, davranışı emüle eder.

API değişiklikleri

  • Biyometrik istem için parçaya özgü kurucu eklendi (b/131980596)
  • Yukarıdaki "Yeni özellikler" bölümüne bakın.

Hata düzeltmeleri

  • L+ için BiometricPrompt cihaz kimlik bilgisi desteği ekleme
  • Genel hata sabitlerini kullanmak için BiometricPrompt düzeltildi (b/137788194)
  • BiometricPrompt.onAttach() dokümanındaki NullPointerException sorununu düzeltin (b/136103103)
  • Davranış, BiometricPrompt ile istem dışındaki bir dokunma etkinliği tarafından iptal edilmesine izin vermeyecek şekilde değiştirildi (b/135684487)
  • Kotlin'de boş hata değeri döndürüldüğünde meydana gelen onAuthenticationError kilitlenmesi düzeltildi (b/128350861)
  • FingerprintDialogFragment artık stil özelliklerini kullanabiliyor (b/127878106)
  • FingerprintDialog artık kaydırılabilir (b/126367887)
  • Biyometrik iletişim kutusu döndürüldüğünde IllegalStateException (b/124153656) değeri verilmesiyle ilgili hata düzeltildi (b/123811924)
  • API Seviye 23 ile 27 arasındaki tutarsız davranış düzeltildi. (b/124066957)
  • Parmak İzi Giriş İletişim Kutusunun TalkBack kullanılarak yanlış metinleri okumasıyla ilgili sorun düzeltildi. (b/123572331)

Sürüm 1.0.0-alpha04

3 Nisan 2019

androidx.biometric:biometric:1.0.0-alpha04 yayınlandı. Bu sürümdeki kaydetmeleri burada bulabilirsiniz.

Hata düzeltmeleri

  • Düzeltilmiş Biyometrik parçalar her durumda temizlenmez. (b/121117380)
  • Düzeltilen BiometricPrompt, yalnızca bir BiometricPrompt.AuthenticationCallback örneğine izin verir (b/123857949)
  • Sistem ve uyumlu sürümler arasında tutarsız BiometricPrompt hatası düzeltildi. (b/123572326)
  • Çalışma zamanında NullPointerException değerine neden olan @NotNull errString içeren onAuthenticationError() geri çağırması (b/123167217) düzeltildi
  • androidx.BiometricPrompt İptal düğmesi Kilitlenmeleri Düzeltildi (b/122054485)
  • Android P'de androidx.biometric.PromptInfo başlık/açıklama değişmez (b/122856773)

Sürüm 1.0.0-alpha03

17 Aralık 2018

Hata düzeltmeleri

  • Parçayla ilgili sorunlar düzeltildi
  • O ve daha eski cihazlarda, P ve sonraki sürümlerle tutarlı olması için kilitlenme hataları hemen döndürülür