Biyometrik

Biyometrik veriler veya cihaz kimlik bilgileriyle kimlik doğrulama yapın ve kriptografik işlemler gerçekleştirin.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
7 Ağustos 2024 1.1.0 - - 1.4.0-alpha02

Bağımlılıkları beyan etme

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

Uygulamanızın veya modülünüzün build.gradle dosyasına ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

Eski

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

Bağımlılıklar hakkında daha fazla bilgi için Derleme Bağımlılıkları Ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni bir kitaplık oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oy verebilirsiniz.

Yeni sayı oluştur

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

Sürüm 1.4

Sürüm 1.4.0-alpha02

7 Ağustos 2024

androidx.biometric:biometric:1.4.0-alpha02 ve androidx.biometric:biometric-ktx:1.4.0-alpha02 serbest bırakıldı. 1.4.0-alpha02 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • PromptContentView, geliştiricilerin özel içerik görünümünü düz açıklama metni görünümüne ek bir seçenek olarak göstermelerine olanak tanır.
  • Biyometrik İstem'de uygulama logosu gösteriliyor. Uygulama simgesi kullanılarak otomatik olarak ekleniyor.

API Değişiklikleri

  • Özel içerik görüntülemeyi desteklemek için API ekleme
    • BiometricPrompt.PromptInfo.Builder#setContentView
    • BiometricPrompt.PromptInfo#getContentView
    • PromptContentView arayüz
    • PromptVerticalListContentView sınıf
    • PromptContentViewWithMoreOptionsButton sınıfı (yalnızca ayrıcalıklı uygulamalar için)
  • Logoyu desteklemek için API'ler ekleyin (yalnızca ayrıcalıklı uygulamalar için)
    • BiometricPrompt.PromptInfo.Builder#setLogoBitmap
    • BiometricPrompt.PromptInfo.Builder#setLogoRes
    • BiometricPrompt.PromptInfo.Builder#setLogoDescription
    • BiometricPrompt.PromptInfo#getLogoBitmap
    • BiometricPrompt.PromptInfo#getLogoRes
    • BiometricPrompt.PromptInfo#getLogoDescription 58c35c6

Hata Düzeltmeleri

  • compileSdk, 35 5dc41be olarak güncellendi

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 dalda 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üncelleme

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 serbest bırakıldı. 1.2.0-alpha05 sürümü bu kaydetmeleri 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 azaltmak 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ı. 1.2.0-alpha04 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Etkinlik dışı 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/şifre ile ilgilenirken iptal hatası almasına neden olan sorun düzeltildi. API 29'daki bazı cihazlarda, biyometrik mevcut ve kayıtlı olsa bile kullanıcıdan ekran kilidi istenebileceğini unutmayın. (b/142740104)
  • API 29'da, biyometrik donanımı olmayan cihazların PIN/desen/şifreyi doğru şekilde kullanamamasına neden olan sorun düzeltildi (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ı. 1.2.0-alpha03 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Diğer AuthPrompt türlerinde mevcut olanlara benzer şekilde, CredentialAuthPrompt için askıya alma coroutine 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ı. 1.2.0-alpha02 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Daha önce bir oluşturucu aracılığıyla ayarlanan bazı AuthPrompt alanları, startAuthentication(...) yöntem bağımsız değişkenlerine dönüştürüldü. (I18896, b/174098373)
  • Eski Android sürümlerinde sınırlı veya hiç destek almayan AuthPrompt türleri için minimum API düzeyi koşulları 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 askıya alınan eş yordam Kotlin uzantıları eklendi. Bu işlevler, başarılı olursa doğrudan AuthenticationResult öğesini döndürür ya da hata veya başarısızlık durumunda bir istisnaya neden olur (kimlik bilgisi reddi). (Iffc9e)

Hata Düzeltmeleri

  • BiometricManager.canAuthenticate(int)'ün, Android 10 (API düzeyi 29) çalıştıran ve parmak izi sensörü bulunan bir cihaz için bazen yanlış durum kodu döndürmesine neden olan sorun düzeltildi. (I72420, b/176921662)
  • Android 10 (API düzeyi 29) ile önceki SDK sürümlerinde biyometrik donanımı olmayan ve kayıtlı PIN, desen ya da şifre bulunmayan bir cihaz için BiometricManager.canAuthenticate(int) ürününün 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 meydana gelen 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ı. 1.2.0-alpha01 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • androidx.biometric:biometric eklentisine 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'nin onCreate gibi erken yaşam döngüsü geri çağırmalarında oluşturulmasını gerektirmez. (I19022)
  • Yeni AuthPrompt API'leri için Fragment ve FragmentActivity'e Kotlin uzantıları eklendi. (Iaf98c)

Sürüm 1.1.0

1.1.0 sürümü

27 Ocak 2021

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

1.0.0'dan bu yana ö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 ayak izini önemli ölçüde azalttı (bazı durumlarda 100 KB'tan fazla).
  • 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.
  • Kitaplığın kararlılığı ve davranışıyla 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ınlanır. 1.1.0-rc01 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • Bazı cihazlarda, belirli işlemlerin (kimlik doğrulama, iptal etme vb.) bazen NullPointerException hatası vermesine neden olan sorun düzeltildi. (b/151316421)
  • Bazı Pixel cihazların, Android 10'da Sınıf 3 biyometri olup olmadığını kontrol etmek için BiometricManager#canAuthenticate(int) kullanılırken 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ınlanır. 1.1.0-beta01 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Android 8.1 ve önceki sürümlerde iletişim kutusu animasyonları statik öğelerle değiştirilerek kitaplığın APK boyutu önemli ölçüde küçültüldü (bazı durumlarda sıkıştırılmış durumda 100 KB'tan fazla). (I4844e)
  • BiometricPrompt artık biyometrik kimlik doğrulama devre dışı bırakıldığında desteklenen tüm Android sürümlerinde otomatik olarak cihaz kimlik bilgisi kimlik doğrulamasına (izin veriliyorsa) geçer. (b/149579143)

Hata Düzeltmeleri

  • BiometricPrompt'ün, parmak izi sensörü olmayan bazı Android 9 cihazlarda kilitlenmeye neden olduğu sorun düzeltildi. (b/151443237)
  • FingerprintDialogFragment içindeki olası 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)
  • BiometricPrompt'ün reddedildikten kısa süre sonra tekrar gösterilmesinin, bazı Android 10 cihazlarda yeni istemin otomatik olarak reddedilmesine neden olduğu 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ınlanır. 1.1.0-alpha02 sürümü bu taahhütleri içerir.

Yeni Özellikler

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

API Değişiklikleri

Hata Düzeltmeleri

  • BiometricFragment ve BiometricViewModel'te LeakCanary tarafından bildirilen bellek sızıntıları düzeltildi. (b/144919472)
  • BiometricViewModel'ün artık arka plan ileti dizisinden MutableLiveData#setValue()'u çağırmayacağından emin olun. (b/159983244)
  • BiometricPrompt ürününün, bazı API düzeylerinde geçici kilitlenmeyi doğru şekilde işlememesine neden olan sorun düzeltildi. (9acfce9)
  • BiometricPrompt'ün bazı API düzeylerinde ekran kilidi kimlik bilgisiyle korunmayan bir cihaz için yanlış hata kodu döndürdüğü sorun düzeltildi. (b/148626482)
  • Bazı API düzeylerinde anahtar koruması uygulanmayan cihazlar için BiometricManager ve BiometricPrompt'ün yanlış hata kodları döndürdüğü sorun düzeltildi. (891c6e0)

Sürüm 1.1.0-alpha01

24 Haziran 2020

androidx.biometric:biometric:1.1.0-alpha01 yayınlanır. 1.1.0-alpha01 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Bellek sızıntılarının olası kaynaklarını ve diğer istenmeyen 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şıyor ve sürdürüyor.
    • Android 10 (API düzeyi 29) sürümünden önceki cihaz kimlik bilgileri kimlik 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üldü. (b/142967618)
  • Eski Android sürümlerinde sınıf doğrulama sorunlarını önlemek için SDK denetimli 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)

1.0.1 sürümü

1.0.1 sürümü

18 Aralık 2019

androidx.biometric:biometric:1.0.1 yayınlanır. Sürüm 1.0.1 bu kaydetmeleri içerir.

Hata düzeltmeleri

  • Kripto tabanlı kimlik doğrulama için mevcut parmak izi yedek çözümü, etkilendiği bilinen tedarikçileri kapsayacak şekilde genişletildi ve API 28 ile sınırlandırıldı (b/143361271)
  • Belirli cihazlarda biyometri iletişim kutusunun bir sistem yer paylaşımının altında gösterildiği sorun düzeltildi (b/143230260)
  • setDeviceCredentialAllowed(true) ile ilgili birkaç sorun düzeltildi (b/143091227, b/143097321, b/143653944)
  • Kullanıcı cihaz kimlik bilgilerini onayladıktan sonra onAuthenticationSuccess işlevinin her zaman çağrılmadığı belirli Android sürümlerinde yaşanan bir sorun düzeltildi (b/145232806)
  • Belirli Android sürümlerinde, rotasyon sırasında istem kapatıldığında onAuthenticationError her zaman çağrılmadığı bir sorun düzeltildi (b/145230042)
  • Belirli Android sürümlerinde, belirli hata kodları alındığında istemin kapatılmaması sorunu düzeltildi (b/143683687)
  • BiometricFragment'da 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 içermeden yayınlandı. 1.0.0 sürümü bu taahhütleri içerir.

1.0.0 sürümünün önemli özellikleri

  • Android 10'da uygulandığı şekilde BiometricPrompt ve BiometricManager API'lerinin Android 6.0'a (API 23) kadar tam özellik desteği sunan uyumluluk sürümü
  • 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 zayıf biyometrileri yanlış şekilde sunduğu bilinen cihazlar için özel işleme

Sürüm 1.0.0-rc02

23 Ekim 2019

androidx.biometric:biometric:1.0.0-rc02 yayınlanır. Sürüm 1.0.0-rc02 bu kaydetmeleri içerir.

Hata düzeltmeleri

  • API 28 ve 29 sürümlerinde kripto tabanlı kimlik doğrulama çağrıldığında yanlış bir şekilde 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ınlanır. Sürüm 1.0.0-rc01 bu kaydetmeleri içerir.

Hata düzeltmeleri

  • Ekran dönerken FingerprintDialogFragment kapatıldığında ortaya çıkabilecek kilitlenme sorunu düzeltildi (b/141356362)
  • Framework API'den null AuthenticationResult alınmasının kilitlenmeye neden olabileceği sorun düzeltildi (b/138862251)
  • BiometricPrompt'ün onSaveInstanceState()'ten sonra kapatılmasından 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ınlanır. 1.0.0-beta02 sürümü bu taahhütleri 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ılığa geçildi (b/140508526)
  • FingerprintHelperFragment artık parmak izi donanımı algılanmadığında doğru şekilde ERROR_HW_NOT_PRESENT değerini döndürüyor (b/140427586)

Sürüm 1.0.0-beta01

29 Ağustos 2019

androidx.biometric:biometric:1.0.0-beta01 yayınlanır. 1.0.0-beta01 sürümü bu taahhütleri içerir.

Yeni özellikler

BiometricPrompt için, FragmentActivity gerektiren mevcut kurucunun aksine, bir Fragment'te barındırılmasına olanak tanıyan ikinci bir kurucu tanıttık.

Android 10'daki aşağıdaki işlevleri AndroidX Biyometrik kitaplığına eklemekten de heyecan duyuyoruz:

  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ışı taklit eder.

API değişiklikleri

  • Biyometri istemi için parçaya özgü bir 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
  • BiometricPrompt'in herkese açık hata sabitlerini kullanması düzeltildi (b/137788194)
  • BiometricPrompt.onAttach()'teki NullPointerException sorununu düzeltin (b/136103103)
  • Davranış, BiometricPrompt'ın 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 onAuthenticationError kilitlenmesi düzeltildi (b/128350861)
  • FingerprintDialogFragment artık stillenebilir (b/127878106)
  • FingerprintDialog artık kaydırılabilir (b/126367887)
  • Biyometrik iletişim kutusunu döndürdüğünüzde IllegalStateException hatası oluşmasına neden olan hata düzeltildi (b/124153656), (b/123811924)
  • API düzeyleri 23 ila 27'de tutarsız davranış düzeltildi. (b/124066957)
  • Parmak İzi Giriş İletişim Kutusu'nun Talkback'i kullanarak yanlış metin 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ınlanır. Bu sürüme dahil edilen taahhütleri burada bulabilirsiniz.

Hata düzeltmeleri

  • Düzeltilen Biyometrik parçalar her durumda temizlenmez. (b/121117380)
  • Sabit BiometricPrompt, yalnızca bir BiometricPrompt.AuthenticationCallback örneğine (b/123857949) izin verir
  • Sistem ve uyumlu sürümler arasında tutarsız olan BiometricPrompt hata davranışı düzeltildi. (b/123572326)
  • Çalışma zamanında @NotNull errString içeren onAuthenticationError() geri çağırması sorunu düzeltildi (b/123167217)NullPointerException
  • androidx.BiometricPrompt iptal düğmesi kilitlenmelerini düzeltme (b/122054485)
  • Android P'de androidx.biometric.PromptInfo başlığı/açıklaması değiştirilmemesine ilişkin sorun düzeltildi (b/122856773)

Sürüm 1.0.0-alpha03

17 Aralık 2018

Hata düzeltmeleri

  • Parçayla ilgili sorunlar düzeltildi
  • O ve önceki sürümlerin yüklü olduğu cihazlarda, kilitlenme hataları P ve sonraki sürümlerle tutarlı olması için hemen döndürülür.