بیومتریک

با بیومتریک یا اعتبار دستگاه احراز هویت کنید و عملیات رمزنگاری را انجام دهید.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
20 مه 2025 1.1.0 - - 1.4.0-alpha04

اعلام وابستگی ها

برای افزودن وابستگی به Biometric، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

dependencies {
    // Java language implementation
    implementation "androidx.biometric:biometric:1.1.0"

    // Kotlin
    implementation "androidx.biometric:biometric-ktx:1.4.0-alpha02"
}

کاتلین 

dependencies {
    // Java language implementation
    implementation("androidx.biometric:biometric:1.1.0")

    // Kotlin
    implementation("androidx.biometric:biometric:1.4.0-alpha02")
}

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت مراجعه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 1.4

نسخه 1.4.0-alpha04

20 مه 2025

androidx.biometric:biometric:1.4.0-alpha04 منتشر شد. نسخه 1.4.0-alpha04 حاوی این commit ها است.

ویژگی های جدید

  • همیشه از KeyguardManager API به صورت داخلی برای برنامه‌های Wear استفاده کنید ( I9b7fd )

تغییرات API

  • افزودن یک بیت احراز هویت ممتاز IDENTITY_CHECK ( I706bb )

نسخه 1.4.0-alpha03

26 مارس 2025

androidx.biometric:biometric:1.4.0-alpha03 منتشر شد. نسخه 1.4.0-alpha03 حاوی این commit ها است.

ویژگی های جدید

  • یک API نقطه ورودی جدید برای احراز هویت registerForAuthenticationResult() برای جایگزینی ماژول androidx.biometric:biometric-ktx و androidx.BiometricPrompt معرفی کرد. این API جدید بر اساس Activity Result API مدل سازی شده است و سازگاری یکپارچه با توسعه Kotlin و Java را فراهم می کند.

تغییرات API

  • تغییر نام ERROR_MORE_OPTIONS_BUTTON به ERROR_CONTENT_VIEW_MORE_OPTIONS_BUTTON ( I71d07 )
  • برای سازگاری با چارچوب، حاشیه نویسی @Deprecated برای IdentityCredential اضافه کنید. ( I6ac90 , b/140252778 , b/217942278 , b/251211046 , b/239955609 )
  • [1/3] کتابخانه biometric.auth و kotlin را حذف کنید، که دوباره طراحی خواهد شد. ( I2f67c )
  • [2/3] AuthenticationRequest به عنوان ورودی احراز هویت و AuthenticationResult به عنوان نوع نتیجه احراز هویت اضافه کنید. دو نوع AuthenticationRequest با سازنده وجود دارد. ( I50fd9 )
    1. BiometricRequest برای احراز هویت بیومتریک با Strength مختلف و Fallback اختیاری.
    2. CredentialRequest فقط برای تأیید اعتبار دستگاه.
  • [3/3] APIهای جدید الگوی فعالیت-نتیجه را برای ماژول بیومتریک اضافه کنید. به طور خاص، یک API ثبت نام به نام registerForAuthenticationResult() اضافه کنید، که AuthenticationResultCallback و اختیاری onAuthenticationFailedCallback ثبت می‌کند و یک AuthenticationResultLauncher برای شروع احراز هویت با تمام ورودی‌ها ایجاد می‌کند. ( I2b06e )

رفع اشکال

  • این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. توسعه دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش فرض با نسخه 2.1.0 کامپایلر Kotlin شروع می شود). ( Ib49b4 , b/326456246 )
  • مشکل عدم امکان نمونه سازی قطعه androidx.biometric.FingerprintDialogFragment برطرف شد. ( I51c4a , b/181805603 )
  • مشکلی که در آن BiometricPrompt با فشار دادن دکمه هوم دستگاه حذف نمی‌شود، برطرف شد. ( I8c393 , I0ca8c , b/149770989 )
  • رفع ناسازگاری کد خطا برای غیرفعال کردن تأیید اعتبار برنامه بیومتریک در API 34/35. ( Ice99d , b/386918213 )
  • بیومتریک های اجباری را در دستگاه های قدیمی تر به تأیید کننده های ترکیبی نیز اعمال کنید. ( Ibb853 , I5cfb3 , b/257670132 )

نسخه 1.4.0-alpha02

7 آگوست 2024

androidx.biometric:biometric:1.4.0-alpha02 و androidx.biometric:biometric-ktx:1.4.0-alpha02 منتشر شدند. نسخه 1.4.0-alpha02 حاوی این تعهدات است.

ویژگی های جدید

  • PromptContentView به توسعه دهندگان اجازه می دهد تا نمای محتوای سفارشی را به عنوان یک گزینه اضافی از نمای متن توضیحات ساده نشان دهند.
  • نشان‌واره برنامه در Biometric Prompt نشان داده می‌شود - به طور خودکار با استفاده از نماد برنامه اضافه می‌شود.

تغییرات API

  • API ها را برای پشتیبانی از نمای محتوای سفارشی اضافه کنید
    • BiometricPrompt.PromptInfo.Builder#setContentView
    • BiometricPrompt.PromptInfo#getContentView
    • رابط PromptContentView
    • کلاس PromptVerticalListContentView
    • کلاس PromptContentViewWithMoreOptionsButton (فقط برای برنامه های دارای امتیاز)
  • افزودن API برای پشتیبانی از نشان‌واره (فقط برای برنامه‌های ممتاز)
    • BiometricPrompt.PromptInfo.Builder#setLogoBitmap
    • BiometricPrompt.PromptInfo.Builder#setLogoRes
    • BiometricPrompt.PromptInfo.Builder#setLogoDescription
    • BiometricPrompt.PromptInfo#getLogoBitmap
    • BiometricPrompt.PromptInfo#getLogoRes
    • BiometricPrompt.PromptInfo#getLogoDescription 58c35c6

رفع اشکال

  • compileSdk به 35 5dc41be به روز کنید

نسخه 1.4.0-alpha01

29 مه 2024

androidx.biometric:biometric:1.4.0-alpha01 و androidx.biometric:biometric-ktx:1.4.0-alpha01 منتشر شدند. این نسخه در یک شعبه داخلی توسعه یافته و اندروید 15 بتا 2 را هدف قرار داده است.

رفع اشکال

  • رابط کاربری را به‌روزرسانی کنید تا با تغییرات پلتفرم در اندروید 15 سازگار باشد

نسخه 1.2.0

نسخه 1.2.0-alpha05

21 سپتامبر 2022

androidx.biometric:biometric:1.2.0-alpha05 و androidx.biometric:biometric-ktx:1.2.0-alpha05 منتشر شدند. نسخه 1.2.0-alpha05 حاوی این commit ها است.

تغییرات API

  • پشتیبانی CryptoObject برای android.security.identity.PresentationSession در Android 13 اضافه شد. ( C5f1ec , b/197965513 )

رفع اشکال

  • انواع منابع غیر ضروری را برای کاهش اندازه کتابخانه حذف کرد. ( I3601e , b/220178553 )
  • مشکل BiometricPrompt که در زمینه‌های غیرفعالی میزبانی می‌شود، برطرف شد. ( Ife255 )

نسخه 1.2.0-alpha04

17 نوامبر 2021

androidx.biometric:biometric:1.2.0-alpha04 و androidx.biometric:biometric-ktx:1.2.0-alpha04 منتشر شدند. نسخه 1.2.0-alpha04 حاوی این commit ها است.

ویژگی های جدید

  • پشتیبانی بهبود یافته BiometricPrompt برای قطعاتی که توسط زمینه‌های غیرفعالی میزبانی می‌شوند ( I9312b )

تغییرات API

  • پشتیبانی اضافه شده برای Android 12 BiometricManager.Strings API ( I12f2d )
  • سازگاری هدف و منبع از جاوا 7 به جاوا 8 تغییر کرد ( I16129 )

رفع اشکال

  • مشکلی در API 29 که در آن برخی از دستگاه‌ها (از جمله شبیه‌سازها) هنگام بازگشت به پین/الگو/رمز عبور، خطای لغو دریافت می‌کنند، برطرف شد. توجه داشته باشید که برای برخی از دستگاه‌های موجود در API 29، این ممکن است باعث شود که کاربر قفل صفحه‌اش را درخواست کند، حتی اگر یک بیومتریک موجود و ثبت‌نام شده باشد. ( b/142740104 )
  • مشکلی در API 29 برطرف شد که در آن دستگاه‌های بدون سخت‌افزار بیومتریک به درستی به پین/الگو/رمز عبور باز نمی‌گردند ( b/170517889 )

نسخه 1.2.0-alpha03

24 فوریه 2021

androidx.biometric:biometric:1.2.0-alpha03 و androidx.biometric:biometric-ktx:1.2.0-alpha03 منتشر شدند. نسخه 1.2.0-alpha03 حاوی این commit ها است.

تغییرات API

  • افزودن برنامه‌های افزودنی در حالت تعلیق برای CredentialAuthPrompt مشابه مواردی که برای سایر انواع AuthPrompt وجود دارد. ( I9ac70 )

نسخه 1.2.0-alpha02

27 ژانویه 2021

androidx.biometric:biometric:1.2.0-alpha02 و androidx.biometric:biometric-ktx:1.2.0-alpha02 منتشر شدند. نسخه 1.2.0-alpha02 حاوی این commit ها است.

تغییرات API

  • برخی از فیلدهای AuthPrompt را که قبلاً از طریق سازنده در آرگومان های متد startAuthentication(...) تنظیم شده بودند، مجدداً فاکتور کرد. ( I18896 , b/174098373 )
  • حداقل نیازهای سطح API برای انواع AuthPrompt با پشتیبانی محدود یا بدون پشتیبانی در نسخه‌های قدیمی‌تر Android اضافه شده است. ( I18896 )
  • اضافه شدن متدهای دریافت کننده برای تمام فیلدهای AuthPrompt که از طریق سازنده تنظیم می شوند. ( I18896 )
  • افزودن برنامه‌های افزودنی کوتلین معلق برای احراز هویت بیومتریک از طریق AuthPrompt API. این توابع AuthenticationResult مستقیماً در هنگام موفقیت برمی‌گردانند یا یک استثنا در مورد خطا یا شکست ایجاد می‌کنند (رد اعتبار). ( Iffc9e )

رفع اشکال

  • مشکلی را برطرف کرد که در آن BiometricManager.canAuthenticate(int) گاهی اوقات کد وضعیت اشتباه را برای دستگاه دارای حسگر اثر انگشت در Android 10 (سطح API 29) برمی‌گرداند. ( I72420 , b/176921662 )
  • مشکلی را برطرف کرد که در آن BiometricManager.canAuthenticate(int) کد وضعیت اشتباه را برای دستگاهی بدون سخت‌افزار بیومتریک و بدون پین، الگو یا رمز عبور ثبت‌شده در Android 10 (سطح API 29) و نسخه‌های SDK قبلی برمی‌گرداند. ( I79b7d , b/174505824 )
  • هنگامی که BiometricPrompt در قطعه‌ای با چرخه عمر کوتاه‌تر از فعالیت مرتبط با آن میزبانی می‌شد، نشت حافظه را برطرف کرد. ( I70864 , b/167014923 )

نسخه 1.2.0-alpha01

2 دسامبر 2020

androidx.biometric:biometric:1.2.0-alpha01 و androidx.biometric:biometric-ktx:1.2.0-alpha01 منتشر شدند. نسخه 1.2.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

  • ماژول androidx.biometric:biometric-ktx را معرفی کرد که APIها و برنامه های افزودنی مخصوص Kotlin را در بالای androidx.biometric:biometric اضافه می کند.

تغییرات API

  • AuthPrompt APIهای جدید برای ساختن یک BiometricPrompt و انجام احراز هویت اضافه شده است. این APIها نیازی به ساخت BiometricPrompt در یک فراخوان اولیه چرخه حیات ندارند ، مانند onCreate . ( I19022 )
  • پسوندهای Kotlin به Fragment و FragmentActivity برای AuthPrompt APIهای جدید اضافه شده است. ( Iaf98c )

نسخه 1.1.0

نسخه 1.1.0

27 ژانویه 2021

androidx.biometric:biometric:1.1.0 منتشر شد. نسخه 1.1.0 حاوی این commit ها است.

تغییرات عمده از 1.0.0

  • اضافه شدن پشتیبانی سازگار با عقب برای ویژگی های جدید احراز هویت بیومتریک و به روز رسانی های API معرفی شده در اندروید 11.
  • به طور قابل توجهی ردپای اندازه برنامه کتابخانه را کاهش داد (در برخی موارد بیش از 100 کیلوبایت).
  • منابع مختلف نشت حافظه را که قبلاً توسط کتابخانه ایجاد شده بود، حذف کرد.
  • رفع خرابی‌های تأیید کلاس که می‌تواند بر عملکرد نسخه‌های قدیمی‌تر اندروید تأثیر بگذارد.
  • بهبودهای مختلف اضافی در ثبات و رفتار کتابخانه ایجاد کرد.

نسخه 1.1.0-rc01

11 نوامبر 2020

androidx.biometric:biometric:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 حاوی این commit ها است.

رفع اشکال

  • مشکلی در برخی از دستگاه‌ها برطرف شد که برخی از اقدامات (احراز هویت، لغو، و غیره) گاهی اوقات باعث ایجاد NullPointerException می‌شد. ( b/151316421 )
  • مشکلی که در آن برخی از دستگاه‌های Pixel هنگام استفاده از BiometricManager#canAuthenticate(int) برای بررسی بیومتریک کلاس 3 در Android 10 وضعیت اشتباه را گزارش می‌کردند، برطرف شد. ( b/170406186 )

نسخه 1.1.0-beta01

1 اکتبر 2020

androidx.biometric:biometric:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 حاوی این تعهدات است.

ویژگی های جدید

  • با جایگزینی انیمیشن های گفتگو با دارایی های ثابت در اندروید 8.1 و نسخه های قبلی، ردپای اندازه APK کتابخانه را به میزان قابل توجهی کاهش داد (در برخی موارد بیش از 100 کیلوبایت فشرده شده است). ( I4844e )
  • اکنون وقتی احراز هویت بیومتریک قفل می شود، BiometricPrompt به طور خودکار به احراز هویت اعتبار دستگاه (در صورت مجاز بودن) در همه نسخه های Android پشتیبانی می شود. ( b/149579143 )

رفع اشکال

  • مشکلی که در آن BiometricPrompt باعث خرابی برخی از دستگاه‌های اندروید 9 بدون حسگر اثر انگشت شد، برطرف شد. ( b/151443237 )
  • یک NullPointerException بالقوه در FingerprintDialogFragment رفع شد. ( b/167951429 )
  • مشکلی که در آن از نوع اشتباه CryptoObject برای فراخوانی روش بازتابی در BiometricManager استفاده شده بود، رفع شد. ( b/165824669 )
  • مشکلی را برطرف کرد که نشان دادن دوباره BiometricPrompt بلافاصله پس از اخراج باعث شد درخواست جدید به طور خودکار در برخی از دستگاه‌های Android 10 رد شود. ( b/157783075 )
  • رفع نشت حافظه مربوط به استفاده از FingerprintManagerCompat . ( b/165840273 )
  • مشکلات مربوط به پنهان شدن یا نمایش نادرست رابط کاربری گفتگوی اثر انگشت در برخی از دستگاه‌های اندروید 9 برطرف شد. ( b/154868505 , b/148350291 )

نسخه 1.1.0-alpha02

19 آگوست 2020

androidx.biometric:biometric:1.1.0-alpha02 منتشر شد. نسخه 1.1.0-alpha02 حاوی این commit ها است.

ویژگی های جدید

  • BiometricManager#canAuthenticate() اکنون ممکن است BIOMETRIC_STATUS_UNKNOWN را برگرداند تا نشان دهد که کاربر ممکن است همچنان بتواند احراز هویت را انجام دهد، یا BIOMETRIC_ERROR_UNSUPPORTED برای نشان دادن اینکه یک ترکیب احراز هویت معین توسط دستگاه پشتیبانی نمی‌شود.
  • BiometricPrompt#authenticate() اکنون می‌تواند فقط برای احراز هویت دستگاه با یک CryptoObject مرتبط در Android 11 (سطح API 30) و بالاتر استفاده شود.

تغییرات API

رفع اشکال

  • رفع نشت حافظه که توسط LeakCanary در BiometricFragment و BiometricViewModel گزارش شده است. ( b/144919472 )
  • مطمئن شد که BiometricViewModel دیگر MutableLiveData#setValue() از یک رشته پس‌زمینه فراخوانی نخواهد کرد. ( b/159983244 )
  • مشکلی را برطرف کرد که در آن BiometricPrompt به درستی قفل موقت را در برخی از سطوح API مدیریت نمی کرد. ( 9acfce9 )
  • مشکلی را برطرف کرد که در آن BiometricPrompt کد خطای اشتباهی را برای دستگاهی که با اعتبار قفل صفحه در برخی از سطوح API ایمن نشده بود، برمی‌گرداند. ( b/148626482 )
  • مشکلی را برطرف کرد که در آن BiometricManager و BiometricPrompt کدهای خطای اشتباهی را برای دستگاهی که در برخی از سطوح API اجرا نمی‌شود، برمی‌گرداند. ( 891c6e0 )

نسخه 1.1.0-alpha01

24 ژوئن 2020

androidx.biometric:biometric:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

  • اجرای کتابخانه داخلی را برای رسیدگی به منابع بالقوه نشت حافظه و سایر رفتارهای ناخواسته بازسازی کرد:
    • قطعات داخلی اکنون داده ها را با استفاده از ViewModel که به چرخه حیات برنامه مشتری مرتبط است، به اشتراک گذاشته و باقی می مانند.
    • احراز هویت دستگاه قبل از Android 10 (سطح API 29) دیگر فعالیت شفافی را در برنامه مشتری شروع نمی‌کند.

رفع اشکال

  • اخطارهای منسوخ شدن مربوط به استفاده از FingerprintManagerCompat برطرف شد. ( b/142967618 )
  • نحوه فراخوانی روش‌های پلتفرم دارای دروازه SDK برای جلوگیری از مشکلات تأیید کلاس در نسخه‌های قدیمی‌تر Android تغییر کرد. ( 94beb4b )
  • وابستگی‌های Gradle که بخشی از API عمومی نیستند، دیگر توسط کتابخانه صادر نمی‌شوند. ( f289d9e )

نسخه 1.0.1

نسخه 1.0.1

18 دسامبر 2019

androidx.biometric:biometric:1.0.1 منتشر شد. نسخه 1.0.1 شامل این commit ها است .

رفع اشکال

  • راه حل بازگشتی اثر انگشت موجود برای احراز هویت مبتنی بر رمزنگاری را به فروشندگان شناخته شده آسیب دیده گسترش داد، در حالی که آن را به API 28 ( b/143361271 ) محدود کرد.
  • مشکلی در دستگاه‌های خاصی که در آن گفتگوی بیومتریک تحت پوشش سیستم نشان داده می‌شد، برطرف شد ( b/143230260 )
  • چندین مشکل با setDeviceCredentialAllowed(true) رفع شد ( b/143091227 , b/143097321 , b/143653944 )
  • مشکلی در برخی از نسخه‌های Android که در آن همیشه پس از تأیید اعتبار دستگاه توسط کاربر، onAuthenticationSuccess فراخوانی نمی‌شد ( b/145232806 ) برطرف شد.
  • رفع مشکلی در برخی از نسخه‌های اندروید که در آن هنگام رد کردن فرمان در چرخش، onAuthenticationError همیشه فراخوانی نمی‌شد ( b/145230042 )
  • رفع مشکلی در برخی از نسخه‌های اندروید که در آن هنگام دریافت کدهای خطای خاص، درخواست رد نشد ( b/143683687 )
  • رفع یک NullPointerException بالقوه در BiometricFragment ( b/142599311 )

نسخه 1.0.0

نسخه 1.0.0

7 نوامبر 2019

androidx.biometric:biometric:1.0.0 بدون تغییر از 1.0.0-rc02 منتشر شده است. نسخه 1.0.0 حاوی این تعهدات است .

ویژگی های اصلی 1.0.0

  • نسخه سازگاری API های BiometricPrompt و BiometricManager ، همانطور که در Android 10 پیاده سازی شده است، با پشتیبانی کامل از ویژگی ها به Android 6.0 (API 23)
  • مدیریت چرخه حیات داخلی برای BiometricPrompt در یک Fragment یا FragmentActivity
  • مدیریت ویژه برای دستگاه‌هایی که در طی احراز هویت مبتنی بر رمزارز، بیومتریک ضعیف را به اشتباه ارائه می‌دهند.

نسخه 1.0.0-rc02

23 اکتبر 2019

androidx.biometric:biometric:1.0.0-rc02 منتشر شد. نسخه 1.0.0-rc02 حاوی این commit ها است .

رفع اشکال

  • راه‌حلی برای دستگاه‌های خاصی اضافه شده است که مشخص است وقتی احراز هویت مبتنی بر رمزنگاری در نسخه‌های 28 و 29 API ( b/142150327 ) احراز هویت مبتنی بر رمزنگاری فراخوانی می‌شود، بیومتریک ضعیفی ارائه می‌دهند.

نسخه 1.0.0-rc01

9 اکتبر 2019

androidx.biometric:biometric:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 حاوی این commit ها است .

رفع اشکال

  • رفع خرابی احتمالی با FingerprintDialogFragment هنگام رد کردن آن در حالی که صفحه در حال چرخش است ( b/141356362 )
  • رفع مشکلی که در آن دریافت یک AuthenticationResult تهی از چارچوب API ممکن است باعث خرابی شود ( b/138862251 )
  • رفع خرابی‌های ناشی از BiometricPrompt که پس از onSaveInstanceState() رد شد ( b/138825362 , b/140447194 )

نسخه 1.0.0-beta02

18 سپتامبر 2019

androidx.biometric:biometric:1.0.0-beta02 منتشر شد. نسخه 1.0.0-beta02 حاوی این تعهدات است .

رفع اشکال

  • رفع مشکلات پشتیبانی از اعتبار دستگاه در نسخه 1.0.0-beta01
  • وابستگی‌های جاوا 8 را حذف کرد و به جاوا 7 تغییر داد ( b/140508526 )
  • FingerprintHelperFragment اکنون به درستی ERROR_HW_NOT_PRESENT را هنگامی که هیچ سخت افزار اثرانگشتی شناسایی نشده است پرتاب می کند ( b/140427586 )

نسخه 1.0.0-beta01

29 آگوست 2019

androidx.biometric:biometric:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است .

ویژگی های جدید

ما سازنده دومی را برای BiometricPrompt معرفی کرده‌ایم که به آن اجازه می‌دهد در یک Fragment میزبانی شود (بر خلاف سازنده موجود، که به FragmentActivity نیاز دارد).

ما همچنین هیجان زده هستیم که عملکرد زیر را از Android 10 به کتابخانه AndroidX Biometric بیاوریم:

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

در اندروید 10، کتابخانه روش‌های مربوطه را از API پلتفرم فراخوانی می‌کند. در سطوح قدیمی‌تر API، کتابخانه رفتار را شبیه‌سازی می‌کند.

API تغییر می کند

  • سازنده قطعه خاص برای درخواست بیومتریک اضافه شد ( b/131980596 )
  • بخش «ویژگی‌های جدید» را در بالا ببینید.

رفع اشکال

  • پشتیبانی اعتبار دستگاه BiometricPrompt را برای L+ اضافه کنید
  • BiometricPrompt برای استفاده از ثابت‌های خطای عمومی ثابت شد ( b/137788194 )
  • رفع NullPointerException در BiometricPrompt.onAttach() ( b/136103103 )
  • تغییر رفتار به گونه ای که اجازه نمی دهد BiometricPrompt توسط یک رویداد لمسی خارج از فرمان لغو شود ( b/135684487 )
  • رفع خرابی AuthenticationError هنگامی که یک مقدار خطای تهی در Kotlin برگردانده می شود ( b/128350861 )
  • FingerprintDialogFragment اکنون قابل استایل است ( b/127878106 )
  • FingerprintDialog اکنون قابل پیمایش است ( b/126367887 )
  • رفع اشکال که در آن چرخش گفتگوی بیومتریک یک IllegalStateException را ایجاد می کند ( b/124153656 )، ( b/123811924 )
  • اصلاح رفتار ناسازگار در سطوح API 23 تا 27. ( b/124066957 )
  • رفع مشکل مربوط به خواندن متن نادرست با استفاده از Talkback در کادر گفتگوی ورود اثر انگشت. ( b/123572331 )

نسخه 1.0.0-alpha04

3 آوریل 2019

androidx.biometric:biometric:1.0.0-alpha04 منتشر شد. commit های موجود در این نسخه را می توانید در اینجا بیابید.

رفع اشکال

  • قطعات بیومتریک ثابت در همه موارد پاک نمی شوند. ( b/121117380 )
  • BiometricPrompt ثابت فقط یک نمونه از BiometricPrompt.AuthenticationCallback را مجاز می‌کند ( b/123857949 )
  • رفتار خطای BiometricPrompt که بین نسخه های سیستم و کامپت ناسازگار بود، رفع شد. ( b/123572326 )
  • پاسخ به تماس ثابت onAuthenticationError() با @NotNull errString باعث NullPointerException در زمان اجرا می شود ( b/123167217 )
  • رفع مشکل androidx.BiometricPrompt Cancel button ( b/122054485 )
  • عنوان/توضیحات androidx.biometric.PromptInfo در Android P ( b/122856773 ) تغییر نکرده است.

نسخه 1.0.0-alpha03

17 دسامبر 2018

رفع اشکال

  • رفع مشکلات مربوط به قطعه
  • در دستگاه‌های O و قدیمی‌تر، خطاهای قفل بلافاصله برگردانده می‌شوند تا با P و بالاتر مطابقت داشته باشند
،

بیومتریک

با بیومتریک یا اعتبار دستگاه احراز هویت کنید و عملیات رمزنگاری را انجام دهید.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
20 مه 2025 1.1.0 - - 1.4.0-alpha04

اعلام وابستگی ها

برای افزودن وابستگی به Biometric، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

dependencies {
    // Java language implementation
    implementation "androidx.biometric:biometric:1.1.0"

    // Kotlin
    implementation "androidx.biometric:biometric-ktx:1.4.0-alpha02"
}

کاتلین 

dependencies {
    // Java language implementation
    implementation("androidx.biometric:biometric:1.1.0")

    // Kotlin
    implementation("androidx.biometric:biometric:1.4.0-alpha02")
}

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت مراجعه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 1.4

نسخه 1.4.0-alpha04

20 مه 2025

androidx.biometric:biometric:1.4.0-alpha04 منتشر شد. نسخه 1.4.0-alpha04 حاوی این commit ها است.

ویژگی های جدید

  • همیشه از KeyguardManager API به صورت داخلی برای برنامه‌های Wear استفاده کنید ( I9b7fd )

تغییرات API

  • افزودن یک بیت احراز هویت ممتاز IDENTITY_CHECK ( I706bb )

نسخه 1.4.0-alpha03

26 مارس 2025

androidx.biometric:biometric:1.4.0-alpha03 منتشر شد. نسخه 1.4.0-alpha03 حاوی این commit ها است.

ویژگی های جدید

  • یک API نقطه ورودی جدید برای احراز هویت registerForAuthenticationResult() برای جایگزینی ماژول androidx.biometric:biometric-ktx و androidx.BiometricPrompt معرفی کرد. این API جدید بر اساس Activity Result API مدل سازی شده است و سازگاری یکپارچه با توسعه Kotlin و Java را فراهم می کند.

تغییرات API

  • تغییر نام ERROR_MORE_OPTIONS_BUTTON به ERROR_CONTENT_VIEW_MORE_OPTIONS_BUTTON ( I71d07 )
  • برای سازگاری با چارچوب، حاشیه نویسی @Deprecated برای IdentityCredential اضافه کنید. ( I6ac90 , b/140252778 , b/217942278 , b/251211046 , b/239955609 )
  • [1/3] کتابخانه biometric.auth و kotlin را حذف کنید، که دوباره طراحی خواهد شد. ( I2f67c )
  • [2/3] AuthenticationRequest به عنوان ورودی احراز هویت و AuthenticationResult به عنوان نوع نتیجه احراز هویت اضافه کنید. دو نوع AuthenticationRequest با سازنده وجود دارد. ( I50fd9 )
    1. BiometricRequest برای احراز هویت بیومتریک با Strength مختلف و Fallback اختیاری.
    2. CredentialRequest فقط برای تأیید اعتبار دستگاه.
  • [3/3] APIهای جدید الگوی فعالیت-نتیجه را برای ماژول بیومتریک اضافه کنید. به طور خاص، یک API ثبت نام به نام registerForAuthenticationResult() اضافه کنید، که AuthenticationResultCallback و اختیاری onAuthenticationFailedCallback ثبت می‌کند و یک AuthenticationResultLauncher برای شروع احراز هویت با تمام ورودی‌ها ایجاد می‌کند. ( I2b06e )

رفع اشکال

  • این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. توسعه دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش فرض با نسخه 2.1.0 کامپایلر Kotlin شروع می شود). ( Ib49b4 , b/326456246 )
  • مشکل عدم امکان نمونه سازی قطعه androidx.biometric.FingerprintDialogFragment برطرف شد. ( I51c4a , b/181805603 )
  • مشکلی که در آن BiometricPrompt با فشار دادن دکمه هوم دستگاه حذف نمی‌شود، برطرف شد. ( I8c393 , I0ca8c , b/149770989 )
  • رفع ناسازگاری کد خطا برای غیرفعال کردن تأیید اعتبار برنامه بیومتریک در API 34/35. ( Ice99d , b/386918213 )
  • بیومتریک های اجباری را در دستگاه های قدیمی تر به تأیید کننده های ترکیبی نیز اعمال کنید. ( Ibb853 , I5cfb3 , b/257670132 )

نسخه 1.4.0-alpha02

7 آگوست 2024

androidx.biometric:biometric:1.4.0-alpha02 و androidx.biometric:biometric-ktx:1.4.0-alpha02 منتشر شدند. نسخه 1.4.0-alpha02 حاوی این تعهدات است.

ویژگی های جدید

  • PromptContentView به توسعه دهندگان اجازه می دهد تا نمای محتوای سفارشی را به عنوان یک گزینه اضافی از نمای متن توضیحات ساده نشان دهند.
  • نشان‌واره برنامه در Biometric Prompt نشان داده می‌شود - به طور خودکار با استفاده از نماد برنامه اضافه می‌شود.

تغییرات API

  • API ها را برای پشتیبانی از نمای محتوای سفارشی اضافه کنید
    • BiometricPrompt.PromptInfo.Builder#setContentView
    • BiometricPrompt.PromptInfo#getContentView
    • رابط PromptContentView
    • کلاس PromptVerticalListContentView
    • کلاس PromptContentViewWithMoreOptionsButton (فقط برای برنامه های دارای امتیاز)
  • افزودن API برای پشتیبانی از نشان‌واره (فقط برای برنامه‌های ممتاز)
    • BiometricPrompt.PromptInfo.Builder#setLogoBitmap
    • BiometricPrompt.PromptInfo.Builder#setLogoRes
    • BiometricPrompt.PromptInfo.Builder#setLogoDescription
    • BiometricPrompt.PromptInfo#getLogoBitmap
    • BiometricPrompt.PromptInfo#getLogoRes
    • BiometricPrompt.PromptInfo#getLogoDescription 58c35c6

رفع اشکال

  • compileSdk به 35 5dc41be به روز کنید

نسخه 1.4.0-alpha01

29 مه 2024

androidx.biometric:biometric:1.4.0-alpha01 و androidx.biometric:biometric-ktx:1.4.0-alpha01 منتشر شدند. این نسخه در یک شعبه داخلی توسعه یافته و اندروید 15 بتا 2 را هدف قرار داده است.

رفع اشکال

  • رابط کاربری را به‌روزرسانی کنید تا با تغییرات پلتفرم در اندروید 15 سازگار باشد

نسخه 1.2.0

نسخه 1.2.0-alpha05

21 سپتامبر 2022

androidx.biometric:biometric:1.2.0-alpha05 و androidx.biometric:biometric-ktx:1.2.0-alpha05 منتشر شدند. نسخه 1.2.0-alpha05 حاوی این commit ها است.

تغییرات API

  • پشتیبانی CryptoObject برای android.security.identity.PresentationSession در Android 13 اضافه شد. ( C5f1ec , b/197965513 )

رفع اشکال

  • انواع منابع غیر ضروری را برای کاهش اندازه کتابخانه حذف کرد. ( I3601e , b/220178553 )
  • مشکل BiometricPrompt که در زمینه‌های غیرفعالی میزبانی می‌شود، برطرف شد. ( Ife255 )

نسخه 1.2.0-alpha04

17 نوامبر 2021

androidx.biometric:biometric:1.2.0-alpha04 و androidx.biometric:biometric-ktx:1.2.0-alpha04 منتشر شدند. نسخه 1.2.0-alpha04 حاوی این commit ها است.

ویژگی های جدید

  • پشتیبانی بهبود یافته BiometricPrompt برای قطعاتی که توسط زمینه‌های غیرفعالی میزبانی می‌شوند ( I9312b )

تغییرات API

  • پشتیبانی اضافه شده برای Android 12 BiometricManager.Strings API ( I12f2d )
  • سازگاری هدف و منبع از جاوا 7 به جاوا 8 تغییر کرد ( I16129 )

رفع اشکال

  • مشکلی در API 29 که در آن برخی از دستگاه‌ها (از جمله شبیه‌سازها) هنگام بازگشت به پین/الگو/رمز عبور، خطای لغو دریافت می‌کنند، برطرف شد. توجه داشته باشید که برای برخی از دستگاه‌های موجود در API 29، این ممکن است باعث شود که کاربر قفل صفحه‌اش را درخواست کند، حتی اگر یک بیومتریک موجود و ثبت‌نام شده باشد. ( b/142740104 )
  • مشکلی در API 29 برطرف شد که در آن دستگاه‌های بدون سخت‌افزار بیومتریک به درستی به پین/الگو/رمز عبور باز نمی‌گردند ( b/170517889 )

نسخه 1.2.0-alpha03

24 فوریه 2021

androidx.biometric:biometric:1.2.0-alpha03 و androidx.biometric:biometric-ktx:1.2.0-alpha03 منتشر شدند. نسخه 1.2.0-alpha03 حاوی این commit ها است.

تغییرات API

  • افزودن برنامه‌های افزودنی در حالت تعلیق برای CredentialAuthPrompt مشابه مواردی که برای سایر انواع AuthPrompt وجود دارد. ( I9ac70 )

نسخه 1.2.0-alpha02

27 ژانویه 2021

androidx.biometric:biometric:1.2.0-alpha02 و androidx.biometric:biometric-ktx:1.2.0-alpha02 منتشر شدند. نسخه 1.2.0-alpha02 حاوی این commit ها است.

تغییرات API

  • برخی از فیلدهای AuthPrompt را که قبلاً از طریق سازنده در آرگومان های متد startAuthentication(...) تنظیم شده بودند، مجدداً فاکتور کرد. ( I18896 , b/174098373 )
  • حداقل نیازهای سطح API برای انواع AuthPrompt با پشتیبانی محدود یا بدون پشتیبانی در نسخه‌های قدیمی‌تر Android اضافه شده است. ( I18896 )
  • اضافه شدن متدهای دریافت کننده برای تمام فیلدهای AuthPrompt که از طریق سازنده تنظیم می شوند. ( I18896 )
  • افزودن برنامه‌های افزودنی کوتلین معلق برای احراز هویت بیومتریک از طریق AuthPrompt API. این توابع AuthenticationResult مستقیماً در هنگام موفقیت برمی‌گردانند یا یک استثنا در مورد خطا یا شکست ایجاد می‌کنند (رد اعتبار). ( Iffc9e )

رفع اشکال

  • مشکلی را برطرف کرد که در آن BiometricManager.canAuthenticate(int) گاهی اوقات کد وضعیت اشتباه را برای دستگاه دارای حسگر اثر انگشت در Android 10 (سطح API 29) برمی‌گرداند. ( I72420 , b/176921662 )
  • مشکلی را برطرف کرد که در آن BiometricManager.canAuthenticate(int) کد وضعیت اشتباه را برای دستگاهی بدون سخت‌افزار بیومتریک و بدون پین، الگو یا رمز عبور ثبت‌شده در Android 10 (سطح API 29) و نسخه‌های SDK قبلی برمی‌گرداند. ( I79b7d , b/174505824 )
  • هنگامی که BiometricPrompt در قطعه‌ای با چرخه عمر کوتاه‌تر از فعالیت مرتبط با آن میزبانی می‌شد، نشت حافظه را برطرف کرد. ( I70864 , b/167014923 )

نسخه 1.2.0-alpha01

2 دسامبر 2020

androidx.biometric:biometric:1.2.0-alpha01 و androidx.biometric:biometric-ktx:1.2.0-alpha01 منتشر شدند. نسخه 1.2.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

  • ماژول androidx.biometric:biometric-ktx را معرفی کرد که APIها و برنامه های افزودنی مخصوص Kotlin را در بالای androidx.biometric:biometric اضافه می کند.

تغییرات API

  • AuthPrompt APIهای جدید برای ساختن یک BiometricPrompt و انجام احراز هویت اضافه شده است. این APIها نیازی به ساخت BiometricPrompt در یک فراخوان اولیه چرخه حیات ندارند ، مانند onCreate . ( I19022 )
  • پسوندهای Kotlin به Fragment و FragmentActivity برای AuthPrompt APIهای جدید اضافه شده است. ( Iaf98c )

نسخه 1.1.0

نسخه 1.1.0

27 ژانویه 2021

androidx.biometric:biometric:1.1.0 منتشر شد. نسخه 1.1.0 حاوی این commit ها است.

تغییرات عمده از 1.0.0

  • اضافه شدن پشتیبانی سازگار با عقب برای ویژگی های جدید احراز هویت بیومتریک و به روز رسانی های API معرفی شده در اندروید 11.
  • به طور قابل توجهی ردپای اندازه برنامه کتابخانه را کاهش داد (در برخی موارد بیش از 100 کیلوبایت).
  • منابع مختلف نشت حافظه را که قبلاً توسط کتابخانه ایجاد شده بود، حذف کرد.
  • رفع خرابی‌های تأیید کلاس که می‌تواند بر عملکرد نسخه‌های قدیمی‌تر اندروید تأثیر بگذارد.
  • بهبودهای مختلف اضافی در ثبات و رفتار کتابخانه ایجاد کرد.

نسخه 1.1.0-rc01

11 نوامبر 2020

androidx.biometric:biometric:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 حاوی این commit ها است.

رفع اشکال

  • مشکلی در برخی از دستگاه‌ها برطرف شد که برخی از اقدامات (احراز هویت، لغو، و غیره) گاهی اوقات باعث ایجاد NullPointerException می‌شد. ( b/151316421 )
  • مشکلی که در آن برخی از دستگاه‌های Pixel هنگام استفاده از BiometricManager#canAuthenticate(int) برای بررسی بیومتریک کلاس 3 در Android 10 وضعیت اشتباه را گزارش می‌کردند، برطرف شد. ( b/170406186 )

نسخه 1.1.0-beta01

1 اکتبر 2020

androidx.biometric:biometric:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 حاوی این تعهدات است.

ویژگی های جدید

  • با جایگزینی انیمیشن های گفتگو با دارایی های ثابت در اندروید 8.1 و نسخه های قبلی، ردپای اندازه APK کتابخانه را به میزان قابل توجهی کاهش داد (در برخی موارد بیش از 100 کیلوبایت فشرده شده است). ( I4844e )
  • اکنون وقتی احراز هویت بیومتریک قفل می شود، BiometricPrompt به طور خودکار به احراز هویت اعتبار دستگاه (در صورت مجاز بودن) در همه نسخه های Android پشتیبانی می شود. ( b/149579143 )

رفع اشکال

  • مشکلی که در آن BiometricPrompt باعث خرابی برخی از دستگاه‌های اندروید 9 بدون حسگر اثر انگشت شد، برطرف شد. ( b/151443237 )
  • یک NullPointerException بالقوه در FingerprintDialogFragment رفع شد. ( b/167951429 )
  • مشکلی که در آن از نوع اشتباه CryptoObject برای فراخوانی روش بازتابی در BiometricManager استفاده شده بود، رفع شد. ( b/165824669 )
  • مشکلی را برطرف کرد که نشان دادن دوباره BiometricPrompt بلافاصله پس از اخراج باعث شد درخواست جدید به طور خودکار در برخی از دستگاه‌های Android 10 رد شود. ( b/157783075 )
  • رفع نشت حافظه مربوط به استفاده از FingerprintManagerCompat . ( b/165840273 )
  • مشکلات مربوط به پنهان شدن یا نمایش نادرست رابط کاربری گفتگوی اثر انگشت در برخی از دستگاه‌های اندروید 9 برطرف شد. ( b/154868505 , b/148350291 )

نسخه 1.1.0-alpha02

19 آگوست 2020

androidx.biometric:biometric:1.1.0-alpha02 منتشر شد. نسخه 1.1.0-alpha02 حاوی این commit ها است.

ویژگی های جدید

  • BiometricManager#canAuthenticate() اکنون ممکن است BIOMETRIC_STATUS_UNKNOWN را برگرداند تا نشان دهد که کاربر ممکن است همچنان بتواند احراز هویت را انجام دهد، یا BIOMETRIC_ERROR_UNSUPPORTED برای نشان دادن اینکه یک ترکیب احراز هویت معین توسط دستگاه پشتیبانی نمی‌شود.
  • BiometricPrompt#authenticate() اکنون می‌تواند فقط برای احراز هویت دستگاه با یک CryptoObject مرتبط در Android 11 (سطح API 30) و بالاتر استفاده شود.

تغییرات API

رفع اشکال

  • رفع نشت حافظه که توسط LeakCanary در BiometricFragment و BiometricViewModel گزارش شده است. ( b/144919472 )
  • مطمئن شد که BiometricViewModel دیگر MutableLiveData#setValue() از یک رشته پس‌زمینه فراخوانی نخواهد کرد. ( b/159983244 )
  • مشکلی را برطرف کرد که در آن BiometricPrompt به درستی قفل موقت را در برخی از سطوح API مدیریت نمی کرد. ( 9acfce9 )
  • مشکلی را برطرف کرد که در آن BiometricPrompt کد خطای اشتباهی را برای دستگاهی که با اعتبار قفل صفحه در برخی از سطوح API ایمن نشده بود، برمی‌گرداند. ( b/148626482 )
  • مشکلی را برطرف کرد که در آن BiometricManager و BiometricPrompt کدهای خطای اشتباهی را برای دستگاهی که در برخی از سطوح API اجرا نمی‌شود، برمی‌گرداند. ( 891c6e0 )

نسخه 1.1.0-alpha01

24 ژوئن 2020

androidx.biometric:biometric:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

  • اجرای کتابخانه داخلی را برای رسیدگی به منابع بالقوه نشت حافظه و سایر رفتارهای ناخواسته بازسازی کرد:
    • قطعات داخلی اکنون داده ها را با استفاده از ViewModel که به چرخه حیات برنامه مشتری مرتبط است، به اشتراک گذاشته و باقی می مانند.
    • احراز هویت دستگاه قبل از Android 10 (سطح API 29) دیگر فعالیت شفافی را در برنامه مشتری شروع نمی‌کند.

رفع اشکال

  • اخطارهای منسوخ شدن مربوط به استفاده از FingerprintManagerCompat برطرف شد. ( b/142967618 )
  • نحوه فراخوانی روش‌های پلتفرم دارای دروازه SDK برای جلوگیری از مشکلات تأیید کلاس در نسخه‌های قدیمی‌تر Android تغییر کرد. ( 94beb4b )
  • وابستگی‌های Gradle که بخشی از API عمومی نیستند، دیگر توسط کتابخانه صادر نمی‌شوند. ( f289d9e )

نسخه 1.0.1

نسخه 1.0.1

18 دسامبر 2019

androidx.biometric:biometric:1.0.1 منتشر شد. نسخه 1.0.1 شامل این commit ها است .

رفع اشکال

  • راه حل بازگشتی اثر انگشت موجود برای احراز هویت مبتنی بر رمزنگاری را به فروشندگان شناخته شده آسیب دیده گسترش داد، در حالی که آن را به API 28 ( b/143361271 ) محدود کرد.
  • مشکلی در دستگاه‌های خاصی که در آن گفتگوی بیومتریک تحت پوشش سیستم نشان داده می‌شد، برطرف شد ( b/143230260 )
  • چندین مشکل با setDeviceCredentialAllowed(true) رفع شد ( b/143091227 , b/143097321 , b/143653944 )
  • مسئله ای را برای برخی از نسخه های اندرویدی برطرف کرد که در آن پس از تأیید اعتبار دستگاه خود ، همیشه به صورت onAuthenticationSuccess فراخوانده نمی شد ( b/145232806 )
  • مسئله ای را برای برخی از نسخه های اندرویدی برطرف کرد که در آن زمان onAuthenticationError همیشه در هنگام رد کردن سریع در چرخش فراخوانده نمی شد ( B/145230042 )
  • مسئله ای را در مورد نسخه های اندرویدی خاص برطرف کرد که در هنگام دریافت کدهای خطای خاص ، سریعاً رد نشد ( B/143683687 )
  • رفع یک NullPointerException بالقوه در BiometricFragment ( b/142599311 )

نسخه 1.0.0

نسخه 1.0.0

7 نوامبر 2019

androidx.biometric:biometric:1.0.0 از 1.0.0-rc02 بدون تغییر منتشر می شود. نسخه 1.0.0 شامل این تعهدات است .

ویژگی های اصلی 1.0.0

  • نسخه سازگاری API های BiometricPrompt و BiometricManager ، همانطور که در Android 10 اجرا شده است ، با پشتیبانی کامل از ویژگی های Android 6.0 (API 23)
  • مدیریت چرخه عمر داخلی برای BiometricPrompt در یک Fragment یا FragmentActivity
  • دست زدن به دستگاههای شناخته شده برای بیومتریک ضعیف در هنگام احراز هویت مبتنی بر رمزنگاری

نسخه 1.0.0-RC02

23 اکتبر 2019

androidx.biometric:biometric:1.0.0-rc02 منتشر می شود. نسخه 1.0.0-RC02 شامل این تعهدات است .

رفع اشکال

  • برای برخی از دستگاه های خاص که به طور نادرست بیومتریک ضعیف را فراهم می کنند ، هنگامی که احراز هویت مبتنی بر رمزنگاری در نسخه های API 28 و 29 ( B/142150327 ) استفاده می شود ، یک راه حل اضافه شده است.

نسخه 1.0.0-RC01

9 اکتبر 2019

androidx.biometric:biometric:1.0.0-rc01 منتشر می شود. نسخه 1.0.0-RC01 شامل این تعهدات است .

رفع اشکال

  • هنگام برطرف کردن صفحه در هنگام چرخش ، یک تصادف بالقوه با FingerprintDialogFragment را برطرف کرد ( B/141356362 )
  • مسئله ای را برطرف کرد که در آن دریافت یک AuthenticationResult تهی از API چارچوب می تواند باعث تصادف شود ( B/138862251 )
  • تصادفات ثابت ناشی از BiometricPrompt پس از onSaveInstanceState() ( B/138825362 ، B/140447194 ) رد شد

نسخه 1.0.0-beta02

18 سپتامبر 2019

androidx.biometric:biometric:1.0.0-beta02 منتشر می شود. نسخه 1.0.0-beta02 شامل این تعهدات است .

رفع اشکال

  • مشکلات ثابت با پشتیبانی اعتبار دستگاه در نسخه 1.0.0-beta01
  • وابستگی های جاوا 8 را برداشته و بسته به جاوا 7 ( B/140508526 ) به
  • FingerprintHelperFragment اکنون به درستی ERROR_HW_NOT_PRESENT پرتاب می کند وقتی که هیچ سخت افزار اثر انگشت تشخیص داده نمی شود ( B/140427586 )

نسخه 1.0.0-beta01

29 آگوست 2019

androidx.biometric:biometric:1.0.0-beta01 منتشر می شود. نسخه 1.0.0-beta01 شامل این تعهدات است .

ویژگی های جدید

ما یک سازنده دوم را برای BiometricPrompt معرفی کرده ایم که اجازه می دهد تا در یک قطعه میزبانی شود (بر خلاف سازنده موجود ، که به یک قطعه قطعه نیاز دارد).

ما همچنین هیجان زده ایم که عملکرد زیر را از Android 10 به کتابخانه بیومتریک Androidx وارد کنیم:

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

در Android 10 ، این کتابخانه از روشهای مربوطه از API پلتفرم استفاده می کند. در سطح API قدیمی تر ، این کتابخانه رفتار را تقلید می کند.

API تغییر می کند

  • سازنده اختصاصی قطعه اضافه شده برای سریع بیومتریک ( B/131980596 )
  • بخش "ویژگی های جدید" را در بالا مشاهده کنید.

رفع اشکال

  • پشتیبانی از اعتبارنامه دستگاه BiometricPrompt را برای L+ اضافه کنید
  • BiometricPrompt ثابت برای استفاده از ثابت خطای عمومی ( B/137788194 )
  • رفع NullPointerException در BiometricPrompt.onAttach() ( b/136103103 )
  • رفتار تغییر یافته برای عدم اجازه BiometricPrompt توسط یک رویداد لمسی در خارج از سریع ( B/135684487 )
  • سقوط onAuthenticationError هنگام بازگشت مقدار خطای تهی در کوتلین ( B/128350861 )
  • Fingerprintdialogfragment اکنون به سبک قابل استفاده است ( B/127878106 )
  • Fingerprintdialog اکنون قابل پیمایش است ( B/126367887 )
  • اشکال ثابت که در آن چرخاندن گفتگوی بیومتریک یک IllegalStateException ایجاد می کند ( B/124153656 ) ، ( b/123811924 )
  • رفتار متناقض ثابت در سطح API 23 تا 27. ( B/124066957 )
  • مسئله ثابت که گفتگوی ورود به سیستم اثر انگشت با استفاده از TalkBack متن نادرست را بخوانید. ( b/123572331 )

نسخه 1.0.0-alpha04

3 آوریل 2019

androidx.biometric:biometric:1.0.0-alpha04 منتشر می شود. تعهدات موجود در این نسخه را می توان در اینجا یافت.

رفع اشکال

  • قطعات بیومتریک ثابت در همه موارد تمیز نمی شوند. ( b/121117380 )
  • BiometricPrompt ثابت فقط یک نمونه از BiometricPrompt.AuthenticationCallback ( B/123857949 )
  • رفتار خطای BiometricPrompt ثابت بین نسخه های سیستم و سازگار متناقض است. ( b/123572326 )
  • پاسخ برگشت به تماس onAuthenticationError() با @NotNull errString باعث NullPointerException در زمان اجرا می شود ( B/123167217 )
  • androidx.BiometricPrompt Cancel Crances Fived ( B/122054485 )
  • androidx.biometric.PromptInfo ثابت/توضیحات در Android P تغییر نکرده است ( B/122856773 )

نسخه 1.0.0-alpha03

17 دسامبر 2018

رفع اشکال

  • مسائل مربوط به قطعه ثابت
  • در دستگاه های O و بالاتر ، خطاهای قفل بلافاصله بازگردانده می شوند تا با P و بالاتر سازگار باشند
،

بیومتریک

با اعتبار بیومتریک یا اعتبار دستگاه تأیید کنید و عملیات رمزنگاری را انجام دهید.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
20 مه 2025 1.1.0 - - 1.4.0-alpha04

اعلام وابستگی ها

برای افزودن وابستگی به بیومتریک ، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر ، مخزن Maven Google را بخوانید.

وابستگی های مصنوعات مورد نیاز خود را در پرونده build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

dependencies {
    // Java language implementation
    implementation "androidx.biometric:biometric:1.1.0"

    // Kotlin
    implementation "androidx.biometric:biometric-ktx:1.4.0-alpha02"
}

کاتلین 

dependencies {
    // Java language implementation
    implementation("androidx.biometric:biometric:1.1.0")

    // Kotlin
    implementation("androidx.biometric:biometric:1.4.0-alpha02")
}

برای کسب اطلاعات بیشتر در مورد وابستگی ها ، به افزودن وابستگی های ساخت مراجعه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. به ما اطلاع دهید که آیا موضوعات جدیدی را کشف کرده اید یا ایده هایی برای بهبود این کتابخانه دارید. لطفاً قبل از ایجاد یک کتاب جدید ، به موضوعات موجود در این کتابخانه نگاهی بیندازید. می توانید با کلیک روی دکمه ستاره ، رای خود را به یک مسئله موجود اضافه کنید.

یک مسئله جدید ایجاد کنید

برای اطلاعات بیشتر به اسناد ردیاب شماره مراجعه کنید.

نسخه 1.4

نسخه 1.4.0-alpha04

20 مه 2025

androidx.biometric:biometric:1.4.0-alpha04 منتشر می شود. نسخه 1.4.0-alpha04 شامل این تعهدات است.

ویژگی های جدید

  • همیشه از API KeyguardManager API برای برنامه های Wear ( I9B7FD ) استفاده کنید

تغییرات API

  • یک هویت بیت IDENTITY_CHECK ممتاز را اضافه کنید ( I706BB )

نسخه 1.4.0-alpha03

26 مارس 2025

androidx.biometric:biometric:1.4.0-alpha03 منتشر می شود. نسخه 1.4.0-alpha03 شامل این تعهدات است.

ویژگی های جدید

  • یک API جدید ورود به تأیید اعتبار جدید registerForAuthenticationResult() برای جایگزینی androidx.biometric:biometric-ktx و androidx.BiometricPrompt معرفی کرد. این API جدید پس از API نتیجه فعالیت مدل سازی می شود و سازگاری یکپارچه را با توسعه کوتلین و جاوا فراهم می کند.

تغییرات API

  • تغییر نام ERROR_MORE_OPTIONS_BUTTON به ERROR_CONTENT_VIEW_MORE_OPTIONS_BUTTON ( I71D07 )
  • حاشیه نویسی @Deprecated را برای IdentityCredential اضافه کنید تا با چارچوب سازگار باشد. ( I6AC90 ، B/140252778 ، B/217942278 ، B/251211046 ، B/239955609 )
  • [1/3] کتابخانه Biometric.Auth و Kotlin را حذف کنید ، که دوباره طراحی می شود. ( i2f67c )
  • [2/3] AuthenticationRequest به عنوان ورودی تأیید اعتبار و AuthenticationResult به عنوان نوع نتیجه تأیید اعتبار اضافه کنید. دو نوع AuthenticationRequest با سازندگان وجود دارد. ( I50FD9 )
    1. BiometricRequest برای احراز هویت بیومتریک با Strength مختلف و Fallback اختیاری.
    2. CredentialRequest برای تأیید اعتبار فقط اعتبار دستگاه.
  • [3/3] API های جدید-با الگوی فعالیت را برای ماژول بیومتریک اضافه کنید. به طور خاص ، یک API ثبت نام به نام registerForAuthenticationResult() اضافه کنید ، که AuthenticationResultCallback و onAuthenticationFailedCallback اختیاری را ثبت می کند ، و یک AuthenticationResultLauncher برای شروع احراز هویت با تمام ورودی ها نتیجه می دهد. ( i2b06e )

رفع اشکال

  • این کتابخانه در حال حاضر از حاشیه نویسی jspecify nulnness ، که از نوع استفاده هستند استفاده می کند. توسعه دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اجرای صحیح استفاده استفاده کنند: -Xjspecify-annotations=strict (این پیش فرض با نسخه 2.1.0 کامپایلر کوتلین شروع می شود). ( IB49B4 ، B/326456246 )
  • مسئله عدم توانایی در فوری قطعات androidx.biometric.FingerprintDialogFragment . ( i51c4a ، b/181805603 )
  • مسئله ای را برطرف کرد که هنگام فشار دادن دکمه صفحه اصلی دستگاه ، BiometricPrompt رد نمی شود. ( i8c393 ، i0ca8c ، b/149770989 )
  • ناسازگاری کد خطای ثابت برای غیرفعال کردن برنامه بیومتریک AUTH در API 34/35. ( ICE99D ، B/386918213 )
  • از بیومتریک های قوی در دستگاه های قدیمی تر نیز استفاده کنید. ( IBB853 ، I5CFB3 ، B/257670132 )

نسخه 1.4.0-alpha02

7 آگوست 2024

androidx.biometric:biometric:1.4.0-alpha02 و androidx.biometric:biometric-ktx:1.4.0-alpha02 منتشر می شود. نسخه 1.4.0-alpha02 شامل این تعهدات است.

ویژگی های جدید

  • PromptContentView به توسعه دهندگان این امکان را می دهد تا نمای محتوای سفارشی را به عنوان گزینه دیگری برای نمایش متن توضیحات ساده نشان دهند
  • آرم برنامه در سریع بیومتریک نشان داده شده است - به طور خودکار با استفاده از نماد برنامه اضافه می شود.

تغییرات API

  • API ها را برای پشتیبانی از نمای محتوای سفارشی اضافه کنید
    • BiometricPrompt.PromptInfo.Builder#setContentView
    • BiometricPrompt.PromptInfo#getContentView
    • رابط PromptContentView
    • کلاس PromptVerticalListContentView
    • کلاس PromptContentViewWithMoreOptionsButton (فقط برای برنامه های ممتاز)
  • اضافه کردن API برای پشتیبانی از آرم (فقط برای برنامه های ممتاز)
    • BiometricPrompt.PromptInfo.Builder#setLogoBitmap
    • BiometricPrompt.PromptInfo.Builder#setLogoRes
    • BiometricPrompt.PromptInfo.Builder#setLogoDescription
    • BiometricPrompt.PromptInfo#getLogoBitmap
    • BiometricPrompt.PromptInfo#getLogoRes
    • BiometricPrompt.PromptInfo#getLogoDescription 58C35C6

رفع اشکال

  • compileSdk به 35 5dc41be بروزرسانی کنید

نسخه 1.4.0-alpha01

29 مه 2024

androidx.biometric:biometric:1.4.0-alpha01 و androidx.biometric:biometric-ktx:1.4.0-alpha01 منتشر می شود. این نسخه در یک شاخه داخلی تهیه شده و Android 15 Beta 2 را هدف قرار داده است.

رفع اشکال

  • UI را به روز کنید تا با تغییرات پلتفرم در Android 15 سازگار باشد

نسخه 1.2.0

نسخه 1.2.0-alpha05

21 سپتامبر 2022

androidx.biometric:biometric:1.2.0-alpha05 و androidx.biometric:biometric-ktx:1.2.0-alpha05 منتشر می شود. نسخه 1.2.0-alpha05 شامل این تعهدات است.

تغییرات API

  • پشتیبانی CryptoObject برای android.security.identity.PresentationSession در Android 13. ( C5F1EC ، B/197965513 )

رفع اشکال

  • انواع منابع غیر ضروری را برای کاهش اندازه کتابخانه حذف کرد. ( i3601e ، b/220178553 )
  • مسئله ثابت برای BiometricPrompt میزبان در زمینه های غیر فعالیتی. ( IFE255 )

نسخه 1.2.0-alpha04

17 نوامبر 2021

androidx.biometric:biometric:1.2.0-alpha04 و androidx.biometric:biometric-ktx:1.2.0-alpha04 منتشر می شود. نسخه 1.2.0-alpha04 شامل این تعهدات است.

ویژگی های جدید

  • بهبود پشتیبانی BiometricPrompt برای قطعاتی که توسط زمینه های غیر فعالیتی میزبانی می شوند ( I9312B )

تغییرات API

رفع اشکال

  • مسئله ای را در API 29 برطرف کرد که در آن برخی از دستگاه ها (از جمله شبیه ساز) هنگام بازگشت به پین/الگوی/رمز عبور ، خطای لغو دریافت می کنند. توجه داشته باشید که ، برای برخی از دستگاه های API 29 ، این ممکن است باعث شود که کاربر برای قفل صفحه نمایش آنها حتی اگر یک بیومتریک در دسترس باشد و ثبت نام کند ، خواسته شود. ( b/142740104 )
  • مسئله ای را در مورد API 29 برطرف کرد که در آن دستگاه های بدون سخت افزار بیومتریک به درستی نمی توانند به پین/الگوی/رمز عبور برسند ( b/170517889 )

نسخه 1.2.0-alpha03

24 فوریه 2021

androidx.biometric:biometric:1.2.0-alpha03 و androidx.biometric:biometric-ktx:1.2.0-alpha03 منتشر می شود. نسخه 1.2.0-alpha03 شامل این تعهدات است.

تغییرات API

  • افزودنی های تعلیق Coroutine برای CredentialAuthPrompt مشابه مواردی که برای سایر انواع AuthPrompt وجود دارد ، اضافه شده است. ( i9ac70 )

نسخه 1.2.0-alpha02

27 ژانویه 2021

androidx.biometric:biometric:1.2.0-alpha02 و androidx.biometric:biometric-ktx:1.2.0-alpha02 منتشر می شود. نسخه 1.2.0-alpha02 شامل این تعهدات است.

تغییرات API

  • برخی از زمینه های AuthPrompt را که قبلاً از طریق یک سازنده به آرگومان های روش startAuthentication(...) تنظیم شده بودند ، بازپرداخت کرد. ( i18896 ، b/174098373 )
  • حداقل الزامات سطح API برای انواع AuthPrompt با پشتیبانی محدود یا بدون پشتیبانی از نسخه های قدیمی Android. ( I18896 )
  • روشهای دریافت کننده اضافه شده برای همه زمینه های AuthPrompt که از طریق یک سازنده تنظیم می شوند. ( I18896 )
  • افزودنی تعلیق Coroutine Kotlin برای احراز هویت بیومتریک از طریق API های AuthPrompt . این توابع ، AuthenticationResult مستقیماً بر روی موفقیت باز می گردانند یا استثناء خطا یا عدم موفقیت (رد اعتبار) را به وجود می آورند. ( iffc9e )

رفع اشکال

  • مسئله ای را برطرف کرد که BiometricManager.canAuthenticate(int) گاهی اوقات کد وضعیت اشتباه را برای دستگاهی با سنسور اثر انگشت در Android 10 (API سطح 29) بازگرداند. ( i72420 ، b/176921662 )
  • مسئله ای را برطرف کرد که BiometricManager.canAuthenticate(int) کد وضعیت اشتباه را برای دستگاهی بدون سخت افزار بیومتریک و بدون پین ، الگوی یا رمزعبور در Android 10 (API سطح 29) و نسخه های SDK قبلی بازگرداند. ( i79b7d ، b/174505824 )
  • رفع نشت حافظه ای که هنگام BiometricPrompt در یک قطعه با یک چرخه عمر کوتاه تر از فعالیت مرتبط با آن برگزار می شود ، برطرف می شود. ( i70864 ، b/167014923 )

نسخه 1.2.0-alpha01

2 دسامبر 2020

androidx.biometric:biometric:1.2.0-alpha01 و androidx.biometric:biometric-ktx:1.2.0-alpha01 منتشر می شود. نسخه 1.2.0-alpha01 شامل این تعهدات است.

ویژگی های جدید

  • androidx.biometric:biometric-ktx را معرفی کرد ، که API های خاص Kotlin و پسوندها را در بالای androidx.biometric:biometric اضافه می کند.

تغییرات API

  • API های جدید AuthPrompt برای ساخت یک BiometricPrompt و انجام احراز هویت اضافه شده است. این API ها نیازی به ساخت BiometricPrompt در پاسخ به پاسخ به چرخه عمر اولیه ، مانند onCreate ندارند . ( I19022 )
  • افزودنی های Kotlin به Fragment و FragmentActivity برای API های جدید AuthPrompt اضافه شده است. ( IAF98C )

نسخه 1.1.0

نسخه 1.1.0

27 ژانویه 2021

androidx.biometric:biometric:1.1.0 منتشر می شود. نسخه 1.1.0 شامل این تعهدات است.

تغییرات اساسی از 1.0.0

  • پشتیبانی سازگار به عقب برای ویژگی های احراز هویت جدید بیومتریک و به روزرسانی های API معرفی شده در Android 11 اضافه شده است.
  • به طور قابل توجهی ردپای اندازه برنامه کتابخانه را کاهش داد (در برخی موارد با> 100 کیلوبایت).
  • منابع مختلف نشت حافظه را که قبلاً توسط کتابخانه ایجاد شده بودند ، برداشته شد.
  • خرابی های تأیید کلاس ثابت که می تواند بر عملکرد نسخه های قدیمی Android تأثیر بگذارد.
  • پیشرفت های دیگری را در ثبات و رفتار کتابخانه انجام داد.

نسخه 1.1.0-RC01

11 نوامبر 2020

androidx.biometric:biometric:1.1.0-rc01 منتشر می شود. نسخه 1.1.0-RC01 شامل این تعهدات است.

رفع اشکال

  • مسئله ای را در برخی از دستگاه ها برطرف کرد که در آن اقدامات خاص (تأیید اعتبار ، لغو و غیره) گاهی اوقات یک NullPointerException را پرتاب می کند. ( b/151316421 )
  • مسئله ای را برطرف کرد که برخی از دستگاه های پیکسل هنگام استفاده از BiometricManager#canAuthenticate(int) وضعیت اشتباه را گزارش می کنند تا بیومتریک کلاس 3 را در اندروید 10 بررسی کنند. ( b/170406186 )

نسخه 1.1.0-beta01

1 اکتبر 2020

androidx.biometric:biometric:1.1.0-beta01 منتشر می شود. نسخه 1.1.0-beta01 شامل این تعهدات است.

ویژگی های جدید

  • با جایگزینی انیمیشن های گفتگو با دارایی های استاتیک در Android 8.1 و قبل از آن ، به طور قابل توجهی ردپای اندازه APK کتابخانه (توسط> 100 کیلوبایت فشرده شده ، در برخی موارد) را کاهش داد. ( i4844e )
  • BiometricPrompt اکنون به طور خودکار به تأیید اعتبار اعتبار دستگاه (در صورت مجاز بودن) در تمام نسخه های پشتیبانی شده اندرویدی در هنگام قفل شدن احراز هویت بیومتریک باز می گردد. ( b/149579143 )

رفع اشکال

  • مسئله ای را برطرف کرد که BiometricPrompt باعث خرابی در برخی از دستگاه های Android 9 بدون سنسور اثر انگشت شد. ( b/151443237 )
  • رفع یک NullPointerException بالقوه در FingerprintDialogFragment . ( b/167951429 )
  • مسئله ای را برطرف کرد که در آن از نوع CryptoObject اشتباه برای یک استفاده از روش بازتابی در BiometricManager استفاده شد. ( b/165824669 )
  • مسئله ای را برطرف کرد که در آن نشان دادن BiometricPrompt دوباره اندکی پس از برکناری باعث شد که سریع سریع به طور خودکار در برخی از دستگاه های Android 10 رد شود. ( b/157783075 )
  • نشت حافظه ثابت مربوط به استفاده از FingerprintManagerCompat . ( b/165840273 )
  • مشکلات رفع شده در مورد گفتگوی اثر انگشت UI پنهان یا نادرست در برخی از دستگاه های Android 9 نشان داده شده است. ( b/154868505 ، b/148350291 )

نسخه 1.1.0-alpha02

19 آگوست 2020

androidx.biometric:biometric:1.1.0-alpha02 منتشر می شود. نسخه 1.1.0-alpha02 شامل این تعهدات است.

ویژگی های جدید

  • BiometricManager#canAuthenticate() ممکن است اکنون BIOMETRIC_STATUS_UNKNOWN برگرداند تا نشان دهد که کاربر هنوز هم قادر به تأیید اعتبار است ، یا BIOMETRIC_ERROR_UNSUPPORTED برای نشان دادن اینکه یک ترکیب تأیید کننده داده شده توسط دستگاه پشتیبانی نمی شود.
  • BiometricPrompt#authenticate() اکنون ممکن است برای تأیید اعتبار دستگاه با یک CryptoObject مرتبط با Android 11 (API سطح 30) و بالاتر استفاده شود.

تغییرات API

رفع اشکال

  • نشت حافظه ثابت گزارش شده توسط Leakcanary در BiometricFragment و BiometricViewModel . ( b/144919472 )
  • تضمین می کند که BiometricViewModel دیگر از یک موضوع پس زمینه دیگر MutableLiveData#setValue() را فراخوانی نمی کند. ( b/159983244 )
  • مسئله ای را برطرف کرد که در آن BiometricPrompt به درستی در برخی از سطوح API قفل موقت را انجام نمی داد. ( 9ACFCE9 )
  • مسئله ای را برطرف کرد که BiometricPrompt کد خطای اشتباه را برای دستگاهی که با اعتبار قفل صفحه نمایش در برخی از سطوح API تضمین نشده است ، بازگرداند. ( b/148626482 )
  • مسئله ای را برطرف کرد که در آن BiometricManager و BiometricPrompt کدهای خطای اشتباه را برای دستگاهی بدون اجرای KeyGuard در برخی از سطوح API بازگردانند. ( 891C6E0 )

نسخه 1.1.0-alpha01

24 ژوئن 2020

androidx.biometric:biometric:1.1.0-alpha01 منتشر می شود. نسخه 1.1.0-alpha01 شامل این تعهدات است.

ویژگی های جدید

  • اجرای کتابخانه داخلی را برای پرداختن به منابع بالقوه نشت حافظه و سایر رفتار ناخواسته اصلاح کرد:
    • قطعات داخلی اکنون با استفاده از یک ViewModel که به چرخه عمر فعالیت مشتری مرتبط است ، داده ها را به اشتراک می گذارند و ادامه می دهند.
    • تأیید اعتبار اعتبار دستگاه قبل از Android 10 (API سطح 29) دیگر یک فعالیت شفاف را در برنامه مشتری شروع نمی کند.

رفع اشکال

  • هشدارهای استهلاک حل شده مربوط به استفاده از FingerprintManagerCompat . ( b/142967618 )
  • تغییر نحوه استفاده از روشهای پلت فرم دارای SDK برای جلوگیری از مشکلات تأیید کلاس در نسخه های قدیمی Android. ( 94beb4b )
  • وابستگی های Gradle که جزئی از API عمومی نیستند ، دیگر توسط کتابخانه صادر نمی شوند. ( F289D9E )

نسخه 1.0.1

نسخه 1.0.1

18 دسامبر 2019

androidx.biometric:biometric:1.0.1 منتشر می شود. نسخه 1.0.1 شامل این تعهدات است .

رفع اشکال

  • گسترش کارنامه برگشت انگشت موجود برای احراز هویت مبتنی بر رمزنگاری به فروشندگان تحت تأثیر شناخته شده ، در عین حال محدود کردن آن به API 28 ( B/143361271 )
  • مسئله ای را در مورد دستگاههای خاص که در آن گفتگوی بیومتریک تحت پوشش سیستم نشان داده شده است ( B/143230260 )
  • چندین مسئله با setDeviceCredentialAllowed(true) ( b/143091227 ، b/143097321 ، b/143653944 ) برطرف شد
  • مسئله ای را برای برخی از نسخه های اندرویدی برطرف کرد که در آن پس از تأیید اعتبار دستگاه خود ، همیشه به صورت onAuthenticationSuccess فراخوانده نمی شد ( b/145232806 )
  • مسئله ای را برای برخی از نسخه های اندرویدی برطرف کرد که در آن زمان onAuthenticationError همیشه در هنگام رد کردن سریع در چرخش فراخوانده نمی شد ( B/145230042 )
  • مسئله ای را در مورد نسخه های اندرویدی خاص برطرف کرد که در هنگام دریافت کدهای خطای خاص ، سریعاً رد نشد ( B/143683687 )
  • رفع یک NullPointerException بالقوه در BiometricFragment ( b/142599311 )

نسخه 1.0.0

نسخه 1.0.0

7 نوامبر 2019

androidx.biometric:biometric:1.0.0 از 1.0.0-rc02 بدون تغییر منتشر می شود. نسخه 1.0.0 شامل این تعهدات است .

ویژگی های اصلی 1.0.0

  • نسخه سازگاری API های BiometricPrompt و BiometricManager ، همانطور که در Android 10 اجرا شده است ، با پشتیبانی کامل از ویژگی های Android 6.0 (API 23)
  • مدیریت چرخه عمر داخلی برای BiometricPrompt در یک Fragment یا FragmentActivity
  • دست زدن به دستگاههای شناخته شده برای ارائه نادرست بیومتریک ضعیف در حین احراز هویت مبتنی بر رمزنگاری

نسخه 1.0.0-RC02

23 اکتبر 2019

androidx.biometric:biometric:1.0.0-rc02 منتشر می شود. نسخه 1.0.0-RC02 شامل این تعهدات است .

رفع اشکال

  • برای برخی از دستگاه های خاص که به طور نادرست بیومتریک ضعیف را فراهم می کنند ، هنگامی که احراز هویت مبتنی بر رمزنگاری در نسخه های API 28 و 29 ( B/142150327 ) استفاده می شود ، یک راه حل اضافه شده است.

نسخه 1.0.0-RC01

9 اکتبر 2019

androidx.biometric:biometric:1.0.0-rc01 منتشر می شود. نسخه 1.0.0-RC01 شامل این تعهدات است .

رفع اشکال

  • هنگام برطرف کردن صفحه در هنگام چرخش ، یک تصادف بالقوه با FingerprintDialogFragment را برطرف کرد ( B/141356362 )
  • مسئله ای را برطرف کرد که در آن دریافت یک AuthenticationResult تهی از API چارچوب می تواند باعث تصادف شود ( B/138862251 )
  • تصادفات ثابت ناشی از BiometricPrompt پس از onSaveInstanceState() ( B/138825362 ، B/140447194 ) رد شد

نسخه 1.0.0-beta02

18 سپتامبر 2019

androidx.biometric:biometric:1.0.0-beta02 منتشر می شود. نسخه 1.0.0-beta02 شامل این تعهدات است .

رفع اشکال

  • مشکلات ثابت با پشتیبانی اعتبار دستگاه در نسخه 1.0.0-beta01
  • وابستگی های جاوا 8 را برداشته و بسته به جاوا 7 ( B/140508526 ) به
  • FingerprintHelperFragment اکنون به درستی ERROR_HW_NOT_PRESENT پرتاب می کند وقتی که هیچ سخت افزار اثر انگشت تشخیص داده نمی شود ( B/140427586 )

نسخه 1.0.0-beta01

29 آگوست 2019

androidx.biometric:biometric:1.0.0-beta01 منتشر می شود. نسخه 1.0.0-beta01 شامل این تعهدات است .

ویژگی های جدید

ما یک سازنده دوم را برای BiometricPrompt معرفی کرده ایم که اجازه می دهد تا در یک قطعه میزبانی شود (بر خلاف سازنده موجود ، که به یک قطعه قطعه نیاز دارد).

ما همچنین هیجان زده ایم که عملکرد زیر را از Android 10 به کتابخانه بیومتریک Androidx وارد کنیم:

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

در Android 10 ، این کتابخانه از روشهای مربوطه از API پلتفرم استفاده می کند. در سطح API قدیمی تر ، این کتابخانه رفتار را تقلید می کند.

API تغییر می کند

  • سازنده اختصاصی قطعه اضافه شده برای سریع بیومتریک ( B/131980596 )
  • بخش "ویژگی های جدید" را در بالا مشاهده کنید.

رفع اشکال

  • پشتیبانی از اعتبارنامه دستگاه BiometricPrompt را برای L+ اضافه کنید
  • BiometricPrompt ثابت برای استفاده از ثابت خطای عمومی ( B/137788194 )
  • رفع NullPointerException در BiometricPrompt.onAttach() ( b/136103103 )
  • رفتار تغییر یافته برای عدم اجازه BiometricPrompt توسط یک رویداد لمسی در خارج از سریع ( B/135684487 )
  • سقوط onAuthenticationError هنگام بازگشت مقدار خطای تهی در کوتلین ( B/128350861 )
  • Fingerprintdialogfragment اکنون به سبک قابل استفاده است ( B/127878106 )
  • Fingerprintdialog اکنون قابل پیمایش است ( B/126367887 )
  • اشکال ثابت که در آن چرخاندن گفتگوی بیومتریک یک IllegalStateException ایجاد می کند ( B/124153656 ) ، ( b/123811924 )
  • رفتار متناقض ثابت در سطح API 23 تا 27. ( B/124066957 )
  • مسئله ثابت که گفتگوی ورود به سیستم اثر انگشت با استفاده از TalkBack متن نادرست را بخوانید. ( b/123572331 )

نسخه 1.0.0-alpha04

3 آوریل 2019

androidx.biometric:biometric:1.0.0-alpha04 منتشر می شود. تعهدات موجود در این نسخه را می توان در اینجا یافت.

رفع اشکال

  • قطعات بیومتریک ثابت در همه موارد تمیز نمی شوند. ( b/121117380 )
  • BiometricPrompt ثابت فقط یک نمونه از BiometricPrompt.AuthenticationCallback ( B/123857949 )
  • رفتار خطای BiometricPrompt ثابت بین نسخه های سیستم و سازگار متناقض است. ( b/123572326 )
  • پاسخ برگشت به تماس onAuthenticationError() با @NotNull errString باعث NullPointerException در زمان اجرا می شود ( B/123167217 )
  • androidx.BiometricPrompt Cancel Crances Fived ( B/122054485 )
  • androidx.biometric.PromptInfo ثابت/توضیحات در Android P تغییر نکرده است ( B/122856773 )

نسخه 1.0.0-alpha03

17 دسامبر 2018

رفع اشکال

  • مسائل مربوط به قطعه ثابت
  • در دستگاه های O و بالاتر ، خطاهای قفل بلافاصله بازگردانده می شوند تا با P و بالاتر سازگار باشند
،

بیومتریک

با اعتبار بیومتریک یا اعتبار دستگاه تأیید کنید و عملیات رمزنگاری را انجام دهید.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
20 مه 2025 1.1.0 - - 1.4.0-alpha04

اعلام وابستگی ها

برای افزودن وابستگی به بیومتریک ، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر ، مخزن Maven Google را بخوانید.

وابستگی های مصنوعات مورد نیاز خود را در پرونده build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

dependencies {
    // Java language implementation
    implementation "androidx.biometric:biometric:1.1.0"

    // Kotlin
    implementation "androidx.biometric:biometric-ktx:1.4.0-alpha02"
}

کاتلین 

dependencies {
    // Java language implementation
    implementation("androidx.biometric:biometric:1.1.0")

    // Kotlin
    implementation("androidx.biometric:biometric:1.4.0-alpha02")
}

برای کسب اطلاعات بیشتر در مورد وابستگی ها ، به افزودن وابستگی های ساخت مراجعه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. به ما اطلاع دهید که آیا موضوعات جدیدی را کشف کرده اید یا ایده هایی برای بهبود این کتابخانه دارید. لطفاً قبل از ایجاد یک کتاب جدید ، به موضوعات موجود در این کتابخانه نگاهی بیندازید. می توانید با کلیک روی دکمه ستاره ، رای خود را به یک مسئله موجود اضافه کنید.

یک مسئله جدید ایجاد کنید

برای اطلاعات بیشتر به اسناد ردیاب شماره مراجعه کنید.

نسخه 1.4

نسخه 1.4.0-alpha04

20 مه 2025

androidx.biometric:biometric:1.4.0-alpha04 منتشر می شود. نسخه 1.4.0-alpha04 شامل این تعهدات است.

ویژگی های جدید

  • همیشه از API KeyguardManager API برای برنامه های Wear ( I9B7FD ) استفاده کنید

تغییرات API

  • یک هویت بیت IDENTITY_CHECK ممتاز را اضافه کنید ( I706BB )

نسخه 1.4.0-alpha03

26 مارس 2025

androidx.biometric:biometric:1.4.0-alpha03 منتشر می شود. نسخه 1.4.0-alpha03 شامل این تعهدات است.

ویژگی های جدید

  • یک API جدید ورود به تأیید اعتبار جدید registerForAuthenticationResult() برای جایگزینی androidx.biometric:biometric-ktx و androidx.BiometricPrompt معرفی کرد. این API جدید پس از API نتیجه فعالیت مدل سازی می شود و سازگاری یکپارچه را با توسعه کوتلین و جاوا فراهم می کند.

تغییرات API

  • تغییر نام ERROR_MORE_OPTIONS_BUTTON به ERROR_CONTENT_VIEW_MORE_OPTIONS_BUTTON ( I71D07 )
  • حاشیه نویسی @Deprecated را برای IdentityCredential اضافه کنید تا با چارچوب سازگار باشد. ( I6AC90 ، B/140252778 ، B/217942278 ، B/251211046 ، B/239955609 )
  • [1/3] کتابخانه Biometric.Auth و Kotlin را حذف کنید ، که دوباره طراحی می شود. ( i2f67c )
  • [2/3] AuthenticationRequest به عنوان ورودی تأیید اعتبار و AuthenticationResult به عنوان نوع نتیجه تأیید اعتبار اضافه کنید. دو نوع AuthenticationRequest با سازندگان وجود دارد. ( I50FD9 )
    1. BiometricRequest برای احراز هویت بیومتریک با Strength مختلف و Fallback اختیاری.
    2. CredentialRequest برای تأیید اعتبار فقط اعتبار دستگاه.
  • [3/3] API های جدید-با الگوی فعالیت را برای ماژول بیومتریک اضافه کنید. به طور خاص ، یک API ثبت نام به نام registerForAuthenticationResult() اضافه کنید ، که AuthenticationResultCallback و onAuthenticationFailedCallback اختیاری را ثبت می کند ، و یک AuthenticationResultLauncher برای شروع احراز هویت با تمام ورودی ها نتیجه می دهد. ( i2b06e )

رفع اشکال

  • این کتابخانه در حال حاضر از حاشیه نویسی jspecify nulnness ، که از نوع استفاده هستند استفاده می کند. توسعه دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اجرای صحیح استفاده استفاده کنند: -Xjspecify-annotations=strict (این پیش فرض با نسخه 2.1.0 کامپایلر کوتلین شروع می شود). ( IB49B4 ، B/326456246 )
  • مسئله عدم توانایی در فوری قطعات androidx.biometric.FingerprintDialogFragment . ( i51c4a ، b/181805603 )
  • مسئله ای را برطرف کرد که هنگام فشار دادن دکمه صفحه اصلی دستگاه ، BiometricPrompt رد نمی شود. ( i8c393 ، i0ca8c ، b/149770989 )
  • ناسازگاری کد خطای ثابت برای غیرفعال کردن برنامه بیومتریک AUTH در API 34/35. ( ICE99D ، B/386918213 )
  • از بیومتریک های قوی در دستگاه های قدیمی تر نیز استفاده کنید. ( IBB853 ، I5CFB3 ، B/257670132 )

نسخه 1.4.0-alpha02

7 آگوست 2024

androidx.biometric:biometric:1.4.0-alpha02 و androidx.biometric:biometric-ktx:1.4.0-alpha02 منتشر می شود. نسخه 1.4.0-alpha02 شامل این تعهدات است.

ویژگی های جدید

  • PromptContentView به توسعه دهندگان این امکان را می دهد تا نمای محتوای سفارشی را به عنوان گزینه دیگری برای نمایش متن توضیحات ساده نشان دهند
  • آرم برنامه در سریع بیومتریک نشان داده شده است - به طور خودکار با استفاده از نماد برنامه اضافه می شود.

تغییرات API

  • API ها را برای پشتیبانی از نمای محتوای سفارشی اضافه کنید
    • BiometricPrompt.PromptInfo.Builder#setContentView
    • BiometricPrompt.PromptInfo#getContentView
    • رابط PromptContentView
    • کلاس PromptVerticalListContentView
    • کلاس PromptContentViewWithMoreOptionsButton (فقط برای برنامه های ممتاز)
  • اضافه کردن API برای پشتیبانی از آرم (فقط برای برنامه های ممتاز)
    • BiometricPrompt.PromptInfo.Builder#setLogoBitmap
    • BiometricPrompt.PromptInfo.Builder#setLogoRes
    • BiometricPrompt.PromptInfo.Builder#setLogoDescription
    • BiometricPrompt.PromptInfo#getLogoBitmap
    • BiometricPrompt.PromptInfo#getLogoRes
    • BiometricPrompt.PromptInfo#getLogoDescription 58C35C6

رفع اشکال

  • compileSdk به 35 5dc41be بروزرسانی کنید

نسخه 1.4.0-alpha01

29 مه 2024

androidx.biometric:biometric:1.4.0-alpha01 و androidx.biometric:biometric-ktx:1.4.0-alpha01 منتشر می شود. این نسخه در یک شاخه داخلی تهیه شده و Android 15 Beta 2 را هدف قرار داده است.

رفع اشکال

  • UI را به روز کنید تا با تغییرات پلتفرم در Android 15 سازگار باشد

نسخه 1.2.0

نسخه 1.2.0-alpha05

21 سپتامبر 2022

androidx.biometric:biometric:1.2.0-alpha05 و androidx.biometric:biometric-ktx:1.2.0-alpha05 منتشر می شود. نسخه 1.2.0-alpha05 شامل این تعهدات است.

تغییرات API

  • پشتیبانی CryptoObject برای android.security.identity.PresentationSession در Android 13. ( C5F1EC ، B/197965513 )

رفع اشکال

  • انواع منابع غیر ضروری را برای کاهش اندازه کتابخانه حذف کرد. ( i3601e ، b/220178553 )
  • مسئله ثابت برای BiometricPrompt میزبان در زمینه های غیر فعالیتی. ( IFE255 )

نسخه 1.2.0-alpha04

17 نوامبر 2021

androidx.biometric:biometric:1.2.0-alpha04 و androidx.biometric:biometric-ktx:1.2.0-alpha04 منتشر می شود. نسخه 1.2.0-alpha04 شامل این تعهدات است.

ویژگی های جدید

  • بهبود پشتیبانی BiometricPrompt برای قطعاتی که توسط زمینه های غیر فعالیتی میزبانی می شوند ( I9312B )

تغییرات API

رفع اشکال

  • مسئله ای را در API 29 برطرف کرد که در آن برخی از دستگاه ها (از جمله شبیه ساز) هنگام بازگشت به پین/الگوی/رمز عبور ، خطای لغو دریافت می کنند. توجه داشته باشید که ، برای برخی از دستگاه های API 29 ، این ممکن است باعث شود که کاربر برای قفل صفحه نمایش آنها حتی اگر یک بیومتریک در دسترس باشد و ثبت نام کند ، خواسته شود. ( b/142740104 )
  • مسئله ای را در مورد API 29 برطرف کرد که در آن دستگاه های بدون سخت افزار بیومتریک به درستی نمی توانند به پین/الگوی/رمز عبور برسند ( b/170517889 )

نسخه 1.2.0-alpha03

24 فوریه 2021

androidx.biometric:biometric:1.2.0-alpha03 و androidx.biometric:biometric-ktx:1.2.0-alpha03 منتشر می شود. نسخه 1.2.0-alpha03 شامل این تعهدات است.

تغییرات API

  • افزودنی های تعلیق Coroutine برای CredentialAuthPrompt مشابه مواردی که برای سایر انواع AuthPrompt وجود دارد ، اضافه شده است. ( i9ac70 )

نسخه 1.2.0-alpha02

27 ژانویه 2021

androidx.biometric:biometric:1.2.0-alpha02 و androidx.biometric:biometric-ktx:1.2.0-alpha02 منتشر می شود. نسخه 1.2.0-alpha02 شامل این تعهدات است.

تغییرات API

  • برخی از زمینه های AuthPrompt را که قبلاً از طریق یک سازنده به آرگومان های روش startAuthentication(...) تنظیم شده بودند ، بازپرداخت کرد. ( i18896 ، b/174098373 )
  • حداقل الزامات سطح API برای انواع AuthPrompt با پشتیبانی محدود یا بدون پشتیبانی از نسخه های قدیمی Android. ( I18896 )
  • روشهای دریافت کننده اضافه شده برای همه زمینه های AuthPrompt که از طریق یک سازنده تنظیم می شوند. ( I18896 )
  • افزودنی تعلیق Coroutine Kotlin برای احراز هویت بیومتریک از طریق API های AuthPrompt . این توابع ، AuthenticationResult مستقیماً بر روی موفقیت باز می گردانند یا استثناء خطا یا عدم موفقیت (رد اعتبار) را به وجود می آورند. ( iffc9e )

رفع اشکال

  • مسئله ای را برطرف کرد که BiometricManager.canAuthenticate(int) گاهی اوقات کد وضعیت اشتباه را برای دستگاهی با سنسور اثر انگشت در Android 10 (API سطح 29) بازگرداند. ( i72420 ، b/176921662 )
  • مسئله ای را برطرف کرد که BiometricManager.canAuthenticate(int) کد وضعیت اشتباه را برای دستگاهی بدون سخت افزار بیومتریک و بدون پین ، الگوی یا رمزعبور در Android 10 (API سطح 29) و نسخه های SDK قبلی بازگرداند. ( i79b7d ، b/174505824 )
  • رفع نشت حافظه ای که هنگام BiometricPrompt در یک قطعه با یک چرخه عمر کوتاه تر از فعالیت مرتبط با آن برگزار می شود ، برطرف می شود. ( i70864 ، b/167014923 )

نسخه 1.2.0-alpha01

2 دسامبر 2020

androidx.biometric:biometric:1.2.0-alpha01 و androidx.biometric:biometric-ktx:1.2.0-alpha01 منتشر می شود. نسخه 1.2.0-alpha01 شامل این تعهدات است.

ویژگی های جدید

  • androidx.biometric:biometric-ktx را معرفی کرد ، که API های خاص Kotlin و پسوندها را در بالای androidx.biometric:biometric اضافه می کند.

تغییرات API

  • API های جدید AuthPrompt برای ساخت یک BiometricPrompt و انجام احراز هویت اضافه شده است. این API ها نیازی به ساخت BiometricPrompt در پاسخ به پاسخ به چرخه عمر اولیه ، مانند onCreate ندارند . ( I19022 )
  • افزودنی های Kotlin به Fragment و FragmentActivity برای API های جدید AuthPrompt اضافه شده است. ( IAF98C )

نسخه 1.1.0

نسخه 1.1.0

27 ژانویه 2021

androidx.biometric:biometric:1.1.0 منتشر می شود. نسخه 1.1.0 شامل این تعهدات است.

تغییرات اساسی از 1.0.0

  • پشتیبانی سازگار به عقب برای ویژگی های احراز هویت جدید بیومتریک و به روزرسانی های API معرفی شده در Android 11 اضافه شده است.
  • به طور قابل توجهی ردپای اندازه برنامه کتابخانه را کاهش داد (در برخی موارد با> 100 کیلوبایت).
  • منابع مختلف نشت حافظه را که قبلاً توسط کتابخانه ایجاد شده بودند ، برداشته شد.
  • خرابی های تأیید کلاس ثابت که می تواند بر عملکرد نسخه های قدیمی Android تأثیر بگذارد.
  • پیشرفت های دیگری را در ثبات و رفتار کتابخانه انجام داد.

نسخه 1.1.0-RC01

11 نوامبر 2020

androidx.biometric:biometric:1.1.0-rc01 منتشر می شود. نسخه 1.1.0-RC01 شامل این تعهدات است.

رفع اشکال

  • مسئله ای را در برخی از دستگاه ها برطرف کرد که در آن اقدامات خاص (تأیید اعتبار ، لغو و غیره) گاهی اوقات یک NullPointerException را پرتاب می کند. ( b/151316421 )
  • Fixed an issue where some Pixel devices would report the wrong status when using BiometricManager#canAuthenticate(int) to check for Class 3 biometrics on Android 10. ( b/170406186 )

Version 1.1.0-beta01

1 اکتبر 2020

androidx.biometric:biometric:1.1.0-beta01 is released. Version 1.1.0-beta01 contains these commits.

ویژگی های جدید

  • Significantly reduced the library's APK size footprint (by >100 KB compressed, in some cases) by replacing dialog animations with static assets on Android 8.1 and earlier. ( I4844e )
  • BiometricPrompt now automatically falls back to device credential authentication (if allowed) on all supported Android versions when biometric authentication is locked out. ( b/149579143 )

رفع اشکال

  • Fixed an issue where BiometricPrompt caused a crash on some Android 9 devices without a fingerprint sensor. ( b/151443237 )
  • Fixed a potential NullPointerException in FingerprintDialogFragment . ( b/167951429 )
  • Fixed an issue where the wrong CryptoObject type was used for a reflective method invocation in BiometricManager . ( b/165824669 )
  • Fixed an issue where showing BiometricPrompt again shortly after dismissal caused the new prompt to be dismissed automatically on some Android 10 devices. ( b/157783075 )
  • Fixed memory leaks related to the use of FingerprintManagerCompat . ( b/165840273 )
  • Fixed issues with the fingerprint dialog UI being hidden or shown incorrectly on some Android 9 devices. ( b/154868505 , b/148350291 )

Version 1.1.0-alpha02

19 آگوست 2020

androidx.biometric:biometric:1.1.0-alpha02 is released. Version 1.1.0-alpha02 contains these commits.

ویژگی های جدید

  • BiometricManager#canAuthenticate() may now return BIOMETRIC_STATUS_UNKNOWN to indicate that the user may still be able to authenticate, or BIOMETRIC_ERROR_UNSUPPORTED to indicate that a given authenticator combination is not supported by the device.
  • BiometricPrompt#authenticate() may now be used for device credential authentication with an associated CryptoObject on Android 11 (API level 30) and above only .

تغییرات API

رفع اشکال

  • Fixed memory leaks reported by LeakCanary in BiometricFragment and BiometricViewModel . ( b/144919472 )
  • Ensured that BiometricViewModel will no longer call MutableLiveData#setValue() from a background thread. ( b/159983244 )
  • Fixed an issue where BiometricPrompt was not correctly handling temporary lockout on some API levels. ( 9acfce9 )
  • Fixed an issue where BiometricPrompt would return the wrong error code for a device not secured with a screen lock credential on some API levels. ( b/148626482 )
  • Fixed an issue where BiometricManager and BiometricPrompt would return the wrong error codes for a device with no keyguard implementation on some API levels. ( 891c6e0 )

Version 1.1.0-alpha01

24 ژوئن 2020

androidx.biometric:biometric:1.1.0-alpha01 is released. Version 1.1.0-alpha01 contains these commits.

ویژگی های جدید

  • Refactored the internal library implementation to address potential sources of memory leaks and other unintended behavior:
    • Internal fragments now share and persist data using a ViewModel that is tied to the client application's activity lifecycle.
    • Device credential authentication prior to Android 10 (API level 29) no longer starts a transparent activity within the client application.

رفع اشکال

  • Resolved deprecation warnings related to the use of FingerprintManagerCompat . ( b/142967618 )
  • Changed how SDK-gated platform methods are called to avoid class verification issues on older Android versions. ( 94beb4b )
  • Gradle dependencies that are not part of the public API are no longer exported by the library. ( f289d9e )

نسخه 1.0.1

نسخه 1.0.1

18 دسامبر 2019

androidx.biometric:biometric:1.0.1 is released. Version 1.0.1 contains these commits .

رفع اشکال

  • Extended the existing fingerprint fallback workaround for crypto-based authentication to known affected vendors, while also limiting it to API 28 ( b/143361271 )
  • Fixed an issue on certain devices where the biometric dialog was shown under a system overlay ( b/143230260 )
  • Fixed several issues with setDeviceCredentialAllowed(true) ( b/143091227 , b/143097321 , b/143653944 )
  • Fixed an issue on certain Android versions where onAuthenticationSuccess was not always called after the user confirmed their device credential ( b/145232806 )
  • Fixed an issue on certain Android versions where onAuthenticationError was not always called when the prompt was dismissed on rotation ( b/145230042 )
  • Fixed an issue on certain Android versions where the prompt was not dismissed when receiving certain error codes ( b/143683687 )
  • Fixed a potential NullPointerException in BiometricFragment ( b/142599311 )

نسخه 1.0.0

نسخه 1.0.0

7 نوامبر 2019

androidx.biometric:biometric:1.0.0 is released with no changes since 1.0.0-rc02 . Version 1.0.0 contains these commits .

Major features of 1.0.0

  • Compatibility version of the BiometricPrompt and BiometricManager APIs, as implemented in Android 10, with full feature support back to Android 6.0 (API 23)
  • Built-in lifecycle management for BiometricPrompt within a Fragment or FragmentActivity
  • Special handling for devices known to incorrectly present weak biometrics during crypto-based authentication

Version 1.0.0-rc02

23 اکتبر 2019

androidx.biometric:biometric:1.0.0-rc02 is released. Version 1.0.0-rc02 contains these commits .

رفع اشکال

  • Added a workaround for certain devices that are known to incorrectly provide a weak biometric when crypto-based authentication is invoked on API versions 28 and 29 ( b/142150327 )

Version 1.0.0-rc01

9 اکتبر 2019

androidx.biometric:biometric:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits .

رفع اشکال

  • Fixed a potential crash with FingerprintDialogFragment when dismissing it while the screen is rotating ( b/141356362 )
  • Fixed an issue where receiving a null AuthenticationResult from the framework API could cause a crash ( b/138862251 )
  • Fixed crashes caused by BiometricPrompt being dismissed after onSaveInstanceState() ( b/138825362 , b/140447194 )

Version 1.0.0-beta02

18 سپتامبر 2019

androidx.biometric:biometric:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits .

رفع اشکال

  • Fixed issues with device credential support in version 1.0.0-beta01
  • Removed Java 8 dependencies and switched to depending on Java 7 ( b/140508526 )
  • FingerprintHelperFragment now correctly throws ERROR_HW_NOT_PRESENT when no fingerprint hardware is detected ( b/140427586 )

Version 1.0.0-beta01

August 29, 2019

androidx.biometric:biometric:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits .

ویژگی های جدید

We've introduced a second constructor for BiometricPrompt that allows it to be hosted in a Fragment (as opposed to the existing constructor, which requires a FragmentActivity).

We're also excited to bring the following functionality from Android 10 to the AndroidX Biometric library:

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

On Android 10, the library will invoke the corresponding methods from the platform API. On older API levels, the library will emulate the behavior.

API changes

  • Added fragment-specific constructor for biometric prompt ( b/131980596 )
  • See the “New features” section above.

رفع اشکال

  • Add BiometricPrompt device credential support for L+
  • Fixed BiometricPrompt to use public error constants ( b/137788194 )
  • Fix NullPointerException in BiometricPrompt.onAttach() ( b/136103103 )
  • Changed behavior to not allow BiometricPrompt to be cancelled by a touch event outside the prompt ( b/135684487 )
  • Fixed onAuthenticationError crash when a null error value is returned in Kotlin ( b/128350861 )
  • FingerprintDialogFragment is now style-able ( b/127878106 )
  • FingerprintDialog is now scrollable ( b/126367887 )
  • Fixed bug where rotating the biometric dialog raises an IllegalStateException ( b/124153656 ), ( b/123811924 )
  • Fixed inconsistent behavior on API Levels 23 to 27. ( b/124066957 )
  • Fixed issue where Fingerprint Login Dialog read incorrect text using Talkback. ( b/123572331 )

Version 1.0.0-alpha04

3 آوریل 2019

androidx.biometric:biometric:1.0.0-alpha04 is released. The commits included in this version can be found here .

رفع اشکال

  • Fixed Biometric fragments don't clean up in all cases. ( b/121117380 )
  • Fixed BiometricPrompt only allows one instance of BiometricPrompt.AuthenticationCallback ( b/123857949 )
  • Fixed BiometricPrompt error behavior inconsistent between system and compat versions. ( b/123572326 )
  • Fixed callback onAuthenticationError() with @NotNull errString causes NullPointerException at runtime ( b/123167217 )
  • Fixed androidx.BiometricPrompt Cancel button Crashes ( b/122054485 )
  • Fixed androidx.biometric.PromptInfo title/description not changed on Android P ( b/122856773 )

Version 1.0.0-alpha03

17 دسامبر 2018

رفع اشکال

  • Fixed fragment-related issues
  • On devices O and older, lockout errors are returned immediately to be consistent with P and above