Biyometrik

Biyometri veya cihaz kimlik bilgileriyle kimlik doğrulayın ve şifreleme işlemleri gerçekleştirin.
Son Güncelleme Kararlı Sürüm Yayın Adayı Beta Sürümü Alfa Sürümü
7 Ağustos 2024 1.1.0 - - 1.4.0-alfa02

Bağımlılıkları bildirme

Biyometriye bağımlılık eklemek için Google Maven deposunu belirler. Google'ın Maven deposunu okuyun konulu videomuzu izleyin.

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

Modern

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 bölümüne bakın.

Geri bildirim

Geri bildiriminiz Jetpack'i iyileştirmemize yardımcı olacaktır. Yeni sorunlarla karşılaşırsanız veya fikir edinebilirsiniz. Daha fazla bilgi için lütfen mevcut sorunlar tıklayın. Oyunuzu mevcut bir soruna eklemek için yıldız düğmesini tıklayın.

Yeni sayı oluştur

Sorun İzleyici dokümanlarına bakın konulu videomuzu izleyin.

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ı. Sürüm 1.4.0-alpha02 bu kaydetmeleri içerir.

Yeni Özellikler

  • PromptContentView, geliştiricilerin ek bir düz açıklama metni görünümü olarak özel içerik görünümünü göstermesine 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ünümünü desteklemek için API'ler ekleyin
    • 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 değerini 35 5dc41be olarak güncelleyin

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 serbest bırakıldı. Dahili bir kolda geliştirilen bu sürüm Android 15 Beta 2'yi hedefler.

Hata Düzeltmeleri

  • Android 15'te kullanıcı arayüzünü platform değişikliklerine uygun 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 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 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 serbest bırakıldı. 1.2.0-alpha04 sürümü bu kaydetmeleri 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/şifre ile ilgilenirken iptal hatası almasına neden olan sorun düzeltildi. API 29 kullanan bazı cihazlarda bu durumun, bir biyometri kullanılabilir ve kayıtlı olsa bile kullanıcıdan ekran kilidinin istenmesine neden olabileceğ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 serbest bırakıldı. 1.2.0-alpha03 sürümü bu kaydetmeleri içerir.

API Değişiklikleri

  • CredentialAuthPrompt için askıya alınan eş yordam uzantıları eklendi Bunlar, diğer AuthPrompt türlerindekilere benzer. (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 serbest bırakıldı. 1.2.0-alpha02 sürümü bu kaydetmeleri içerir.

API Değişiklikleri

  • Daha önce 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ı destek sunan veya hiç desteklenmeyen 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 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

  • Android 10'da (API düzeyi 29) parmak izi sensörü olan bir cihaz için BiometricManager.canAuthenticate(int) ürününün 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 serbest bırakıldı. Sürüm 1.2.0-alpha01 bu kaydetmeleri 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 öğesinin onCreate gibi erken bir yaşam döngüsü geri çağırması içinde oluşturulmasını gerektirmez. (I19022)
  • Yeni AuthPrompt API'leri için Fragment ve FragmentActivity hizmetlerine 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 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 izi büyük ölçüde azaltıldı (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 ilave 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 kaydetmeleri 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ınlandı. Sürüm 1.1.0-beta01 bu kaydetmeleri içerir.

Yeni Özellikler

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

Hata Düzeltmeleri

  • Parmak izi sensörü olmayan bazı Android 9 cihazlarda BiometricPrompt kilitlenmesine neden olan 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 kapatıldıktan kısa bir süre sonra tekrar gösterilmesinin, bazı Android 10 cihazlarda yeni istemin otomatik olarak kapatılmasına 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ınlandı. 1.1.0-alpha02 sürümü bu kaydetmeleri içerir.

Yeni Özellikler

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

API Değişiklikleri

Hata Düzeltmeleri

  • LeakCanary tarafından BiometricFragment ve BiometricViewModel cihazlarda bildirilen bellek sızıntıları düzeltildi. (b/144919472)
  • BiometricViewModel işlevinin artık arka plandaki bir ileti dizisinden MutableLiveData#setValue() çağrısı yapmayacağı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 ürününün, bazı API düzeylerinde ekran kilidi kimlik bilgileriyle 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ş kilidi uygulanmayan bir cihaz için BiometricManager ve BiometricPrompt öğelerinin 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ı. 1.1.0-alpha01 sürümü bu kaydetmeleri 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ğin sonlandırılmasıyla ilgili uyarılar düzeltildi. (b/142967618)
  • Eski Android sürümlerinde sınıf doğrulaması sorunlarını önlemek için SDK geçişli 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 kaydetmeleri içerir.

Hata düzeltmeleri

  • Kripto tabanlı kimlik doğrulama için mevcut parmak izi yedeğiyle ilgili geçici çözümü, sorundan etkilendiği bilinen sağlayıcılar için genişletildi ve API 28 (b/143361271) ile sınırlandı.
  • Belirli cihazlarda biyometrik iletişim kutusunun sistem yer paylaşımı altında gösterildiği bir sorun düzeltildi (b/143230260)
  • setDeviceCredentialAllowed(true) ile ilgili birkaç sorun düzeltildi (b/143091227, b/143097321, b/143653944)
  • Belirli Android sürümlerinde, kullanıcı cihaz kimlik bilgilerini onayladıktan sonra onAuthenticationSuccess uygulaması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 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 içinde 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 yapılmadan yayınlandı. 1.0.0 sürümü bu kaydetmeleri içerir.

1.0.0'ın temel özellikleri

  • BiometricPrompt ve BiometricManager API'lerinin Android 10'da uygulanmış olan ve Android 6.0'a (API 23) kadar tam özellik desteğine sahip 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 yanlış bir şekilde zayıf biyometri gösterdiği 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ınlandı. 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ınlandı. Sürüm 1.0.0-rc01 bu kaydetmeleri içerir.

Hata düzeltmeleri

  • Ekran döndürülürken FingerprintDialogFragment özelliğinin kapatılmasıyla ilgili olası kilitlenme 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 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ınlandı. Sürüm 1.0.0-beta02 bu kaydetmeleri 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 geçildi (b/140508526)
  • FingerprintHelperFragment, parmak izi donanımı algılanmadığında artık doğru şekilde ERROR_HW_NOT_PRESENT gönderiyor (b/140427586)

Sürüm 1.0.0-beta01

29 Ağustos 2019

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

Yeni özellikler

BiometricPrompt için, bir Fragment içinde barındırılmasına izin veren ikinci bir kurucuyu) kullanıma sunduk (FranmentActivity gerektiren mevcut kurucunun aksine).

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. Kitaplık, eski API düzeylerinde davranışı emüle eder.

API değişiklikleri

  • Biyometrik istem için parçaya özgü oluşturucu 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 ile herkese açık hata sabitleri kullanılması düzeltildi (b/137788194)
  • BiometricPrompt.onAttach() içindeki NullPointerException politikasını düzeltin (b/136103103)
  • BiometricPrompt, 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 (b/128350861) onAuthenticationError kilitlenmesi düzeltildi
  • Parmak İziDialogFragment'a artık stil uygulanabilir (b/127878106)
  • Parmak İzi İletişimi artık kaydırılabilir (b/126367887)
  • Biyometrik iletişim kutusunu döndürmenin IllegalStateException (b/124153656), (b/123811924) döndürmesine neden olan hata düzeltildi
  • API Düzey 23 ile 27 arasında tutarsız davranış düzeltildi. (b/124066957)
  • TalkBack'i kullanarak Parmak İzi Giriş İletişimi'nin yanlış metni okumasına neden olan 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 kaydetmelere buradan ulaşabilirsiniz.

Hata düzeltmeleri

  • Düzeltilen Biyometrik parçalar her durumda temizlenmez. (b/121117380)
  • Düzeltilmiş 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 @NotNull errString nedeniyle NullPointerException nedeniyle onAuthenticationError() geri çağırma düzeltildi (b/123167217)
  • androidx.BiometricPrompt İptal düğmesi kilitlenmeleri düzeltildi (b/122054485)
  • Düzeltilen androidx.biometric.PromptInfo başlığı/açıklaması Android P'de 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ılık için kilitlenme hataları hemen döndürülür