Biyometrik
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.
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ıfPromptContentViewWithMoreOptionsButton
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çinCryptoObject
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
- Android 12 BiometricManager.Strings API'si (I12f2d) için destek eklendi
- Java 7 olan hedef ve kaynak uyumluluğu Java 8 (I16129) olarak değiştirildi
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ğrudanAuthenticationResult
öğ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 ekleyenandroidx.biometric:biometric-ktx
modülü kullanıma sunuldu.
API Değişiklikleri
BiometricPrompt
oluşturmak ve kimlik doğrulama gerçekleştirmek için yeniAuthPrompt
API'leri eklendi. Bu API'ler,BiometricPrompt
öğesininonCreate
gibi erken bir yaşam döngüsü geri çağırması içinde oluşturulmasını gerektirmez. (I19022)- Yeni
AuthPrompt
API'leri içinFragment
veFragmentActivity
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çinBIOMETRIC_STATUS_UNKNOWN
veya belirli bir kimlik doğrulayıcı kombinasyonunun cihaz tarafından desteklenmediğini belirtmek içinBIOMETRIC_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 birCryptoObject
ile kullanılabilir.
API Değişiklikleri
BiometricPrompt
örneği oluşturulurken açık birExecutor
sağlanması isteğe bağlı hale getirildi. (I6bb8a)- Android 11'den
BiometricManager#canAuthenticate(int)
yöntemi eklendi. (Ia3f1c) BiometricPrompt
, Android 11'denBiometricManager.Authenticators
sabit değerleri için destek sunacak şekilde güncellendi. (I39bd8)- Android 11'den
BiometricPrompt.AuthenticationResult#getAuthenticationType()
yöntemi eklendi. (Icfad5) - Android 11'deki
BiometricPrompt.ERROR_SECURITY_UPDATE_REQUIRED
hata kodu eklendi. (I6610b) BiometricPrompt.CryptoObject
, yalnızca Android 11 (API düzeyi 30) ve sonraki sürümlerdeIdentityCredential
uygulamasını destekleyecek şekilde güncellendi. (I1d9f6)
Hata Düzeltmeleri
- LeakCanary tarafından
BiometricFragment
veBiometricViewModel
cihazlarda bildirilen bellek sızıntıları düzeltildi. (b/144919472) BiometricViewModel
işlevinin artık arka plandaki bir ileti dizisindenMutableLiveData#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
veBiometricPrompt
öğ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.
- Dahili parçalar artık istemci uygulamasının etkinlik yaşam döngüsüne bağlı bir
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ı birNullPointerException
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
veBiometricManager
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
veyaFragmentActivity
içindeBiometricPrompt
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ınonSaveInstanceState()
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 şekildeERROR_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:
BiometricManager#canAuthenticate
BiometricPrompt.PromptInfo#setConfirmationRequired
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çindekiNullPointerException
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 birBiometricPrompt.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
nedeniyleNullPointerException
nedeniyleonAuthenticationError()
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