Biyometrik

Biyometri veya cihaz kimlik bilgileriyle kimlik doğrulama ve kriptografik işlemler yapma.
Son Güncelleme Kararlı Sürüm Serbest Bırakma Adayı Beta Sürümü Alfa Sürümü
21 Eylül 2022 1.1.0 - - 1.2.0-alfa05

Bağımlılıkları bildirme

Biyometride 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 veya modülünüz için build.gradle dosyasına ihtiyaç duyduğunuz yapıların bağımlılıklarını ekleyin:

Modern

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

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

Geri bildirim

Geri bildirimleriniz Jetpack'i iyileştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı geliştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni hesap 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 sorun oluşturma

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

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'te 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 olmayan bağlamlar tarafından barındırılan parçalar için iyileş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 durum, bir biyometri kullanılabilir ve kayıtlı olsa bile kullanıcıdan ekran kilidinin istenmesine neden olabilir. (b/142740104)
  • API 29'da biyometrik donanımı olmayan cihazların PIN/desen/şifre değerini doğru şekilde ayarlayamamasına neden olan sorun 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ürleri için var olan eş yordam uzantılarının askıya alınması 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 kaydetmeleri içerir.

API Değişiklikleri

  • Daha önce bir oluşturucu aracılığıyla ayarlanan bazı AuthPrompt alanları, startAuthentication(...) yöntemi 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 getter 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, AuthenticationResult öğesini doğrudan başarılı bir şekilde döndürür veya hata ya da başarısızlık durumunda (kimlik bilgisi reddi) bir istisna bildirir. (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, Android 10 (API düzeyi 29) ile önceki SDK sürümlerinde biyometrik donanımı olmayan ve kayıtlı PIN, desen veya şifre bulunmayan bir cihaz için yanlış durum kodu döndürmesine neden olan sorun düzeltildi. (I79b7d, b/174505824)
  • BiometricPrompt, ilişkili etkinliğinden daha kısa yaşam döngüsüne sahip bir parçada barındırıldığında oluşan 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 ü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 uzantılarına 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ı. Sürüm 1.1.0 bu kayıtları içerir.

1.0.0 sürümünden beri yapılan önemli değişiklikler

  • Android 11'de kullanıma sunulan yeni biyometrik kimlik doğrulama özellikleri ve API güncellemeleri için geriye dönük uyumlu destek eklendi.
  • Kitaplığın uygulama boyutu büyük ölçüde azaltıldı (bazı durumlarda 100 KB'tan büyük).
  • 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ı. Sürüm 1.1.0-rc01 bu kayıtları içerir.

Hata Düzeltmeleri

  • Bazı cihazlarda, belirli işlemlerin (kimlik doğrulama, iptal etme vb.) zaman zaman NullPointerException uygulamasına neden olmasına neden olan sorun düzeltildi. (b/151316421)
  • Bazı Pixel cihazların, Android 10'da 3. Sınıf biyometriyi kontrol etmek için BiometricManager#canAuthenticate(int) kullanılırken yanlış durum 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ı. Sürüm 1.1.0-beta01 bu kayıtları içerir.

Yeni Özellikler

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

Hata Düzeltmeleri

  • BiometricPrompt uygulaması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 öğesinde 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 olmasıyla ilgili 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 kutusunun 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 kaydetmeleri içerir.

Yeni Özellikler

  • BiometricManager#canAuthenticate() artık kullanıcının kimliğini hâlâ doğrulayabildiğ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ını döndürebilir.
  • BiometricPrompt#authenticate() artık yalnızca Android 11 (API düzeyi 30) ve sonraki sürümlerde ilişkilendirilmiş CryptoObject ile cihaz kimlik bilgisi doğrulaması için kullanılabilir.

API Değişiklikleri

Hata Düzeltmeleri

  • BiometricFragment ve BiometricViewModel için LeakCanary tarafından bildirilen bellek sızıntıları düzeltildi. (b/144919472)
  • BiometricViewModel cihazının artık MutableLiveData#setValue() numaralı telefonu arka plandaki bir ileti dizisinden çağırmayacağından emin olun. (b/159983244)
  • BiometricPrompt uygulamasının bazı API düzeylerinde geçici kilitlenmeyi doğru şekilde işlememesi sorunu düzeltildi. (9acfce9)
  • BiometricPrompt ürününün, bazı API düzeylerinde ekran kilidi kimlik bilgisi ile güvenliği sağlanmamış bir cihaz için yanlış hata kodu döndürmesine neden olan sorun düzeltildi. (b/148626482)
  • Bazı API düzeylerinde tuş koruyucu uygulaması olmayan bir cihaz için BiometricManager ve BiometricPrompt kodlarının yanlış hata kodları döndürmesine neden olan sorun düzeltildi. (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ısı kaynaklarını ve istenmeyen diğer davranışları gidermek için dahili kitaplık uygulaması yeniden düzenlendi:
    • Dahili parçalar artık istemci uygulamasının etkinlik yaşam döngüsüne bağlı bir ViewModel kullanarak verileri paylaşır ve korur.
    • Android 10'dan (API düzeyi 29) önceki cihaz kimlik bilgisi doğrulaması artık istemci uygulamasında şeffaf bir etkinlik başlatmıyor.

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 kapılı platform yöntemlerinin çağrılma şekli değiştirildi. (94beb4b)
  • Genel API'nin 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ğrulama için mevcut parmak izi yedek çözümü, etkilenen bilinen tedarikçi firmalarla genişletilerek API 28 ile sınırlandırıldı (b/143361271)
  • Biyometrik iletişim kutusunun sistem yerleşimi altında gösterildiği belirli cihazlarda yaşanan bir sorun düzeltildi (b/143230260)
  • setDeviceCredentialAllowed(true) ile ilgili bazı sorunlar düzeltildi (b/143091227, b/143097321, b/143653944)
  • Kullanıcı, cihaz kimlik bilgilerini onayladıktan sonra onAuthenticationSuccess ürününün her zaman çağrılmadığı belirli Android sürümlerindeki 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ığı sorun giderildi (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 hiç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ümü ve Android 6.0 (API 23) sonrası 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 hatalı olarak zayıf biyometri sunduğu 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ı. Sürüm 1.0.0-rc02 bu kayıtları içerir.

Hata düzeltmeleri

  • API 28 ve 29 sürümünde kripto tabanlı kimlik doğrulama çağrıldığında hatalı olarak zayıf bir biyometri 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ı. Sürüm 1.0.0-rc01 bu kayıtları içerir.

Hata düzeltmeleri

  • Ekran dönerken kapatıldığında FingerprintDialogFragment ile ilgili olası kilitlenme düzeltildi (b/141356362)
  • Çerçeve API'sinden boş AuthenticationResult almanın kilitlenmeye neden olabilmesine neden olan sorun düzeltildi (b/138862251)
  • BiometricPrompt uygulamasının onSaveInstanceState() tarihinden sonra reddedilmesinden kaynaklanan kilitlenmeler (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)
  • FingerprintHelperFragment, artık parmak izi donanımı algılanmadığında ERROR_HW_NOT_PRESENT doğru şekilde fırlatıyor (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 Fragment'ta barındırılmasına izin veren ikinci bir kurucuyu (FragmentActivity gerektiren mevcut oluşturucunun aksine) kullanıma sunduk.

Ayrıca, aşağıdaki işlevleri Android 10'daki AndroidX Biyometrik 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. Eski API düzeylerinde kitaplık, bu 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() hesabındaki NullPointerException sorununu düzeltin (b/136103103)
  • Davranış, BiometricPrompt'un istem dışındaki bir dokunma etkinliği tarafından iptal edilmesine izin vermeyecek şekilde değiştirildi (b/135684487)
  • Kotlin'de null hata değeri döndürüldüğünde meydana gelen on AuthenticationError çökmesi düzeltildi (b/128350861)
  • FingerprintDialogFragment artık stil uygulanabilir (b/127878106)
  • FingerprintDialog artık kaydırılabilir (b/126367887)
  • Biyometrik iletişim kutusunu döndürmenin IllegalStateException (b/124153656) değerini yükseltmesiyle ilgili hata düzeltildi (b/123811924)
  • API Seviyeleri 23 ile 27 arasındaki tutarsız davranış düzeltildi. (b/124066957)
  • Parmak İzi Giriş İletişim Kutusu'nun, Talkback kullanılarak yanlış metni 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 olan BiometricPrompt hata davranışı düzeltildi. (b/123572326)
  • Çalışma zamanında NullPointerException değerine neden olan, @NotNull errString değerine sahip onAuthenticationError() düzeltildi (b/123167217)
  • androidx.BiometricPrompt İptal düğmesindeki Kilitlenmeler düzeltildi (b/122054485)
  • Android P'de androidx.biometric.PromptInfo başlığı/açıklaması değiştirilmedi (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 üstü ile tutarlı olmak için kilitlenme hataları hemen döndürülür