بیومتریک

با استفاده از اطلاعات بیومتریک یا اعتبارنامه‌های دستگاه، احراز هویت کنید و عملیات رمزنگاری را انجام دهید.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۱۷ دسامبر ۲۰۲۵ ۱.۱.۰ - - ۱.۴.۰-آلفا۰۵

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

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

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل 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 کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

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

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

نسخه ۱.۴

نسخه ۱.۴.۰-آلفا۰۵

۱۷ دسامبر ۲۰۲۵

androidx.biometric:biometric:1.4.0-alpha05 و androidx.biometric:biometric-compose:1.4.0-alpha05 منتشر شدند. نسخه 1.4.0-alpha05 شامل این کامیت‌ها است.

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

  • یک کتابخانه جدید biometric-compose
    • کتابخانه جدید biometric-compose ادغام بیومتریک را در رابط‌های کاربری مبتنی بر Compose ساده می‌کند. توسعه‌دهندگان اکنون می‌توانند از تابع rememberAuthenticationLauncher برای مدیریت درخواست‌های احراز هویت و فراخوانی‌ها در کامپوننت‌های خود استفاده کنند. ( I4a88d )

تغییرات API

  • کتابخانه بیومتریک activity-result-pattern تغییرات API جدیدی را معرفی می‌کند:
    • تابع فراخوانی onAuthFailure به AuthenticationResultCallback منتقل شده و به onAuthAttemptFailed تغییر نام داده است. ( Ied96b , /Id6a73 )
    • به برنامه‌ها اجازه دهید برای فراخوانی‌های برگشتی خود یک اجراکننده ارائه دهند. ( Id6a73 )
    • پشتیبانی از چندین لانچر احراز هویت در یک Activity/Fragment واحد: این قابلیت توسط یک مکانیزم ردیابی داخلی جدید ( currentAuthenticationKey ) فعال می‌شود که به درستی نتایج را به نمونه لانچر خاصی که آنها را درخواست کرده است، هدایت می‌کند. ( I2848c )
  • منسوخ کردن androidx.core.hardware.fingerprint.FingerprintManagerCompat : androidx.core.hardware.fingerprint.FingerprintManagerCompat اکنون یک تابع بدون عملیات است، هیچ کاری انجام نمی‌دهد یا مقدار false را برمی‌گرداند. یک androidx.biometric.FingerprintManagerCompat داخلی جدید در کتابخانه androidx.biometric برای سازگاری با نسخه‌های قبلی استفاده می‌شود. ( I0360b ، If5687 )

رفع اشکالات

نسخه ۱.۴.۰-آلفا۰۴

۲۰ مه ۲۰۲۵

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

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

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

تغییرات API

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

نسخه ۱.۴.۰-آلفا۰۳

۲۶ مارس ۲۰۲۵

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

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

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

تغییرات 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های activity-result-pattern جدیدی برای ماژول بیومتریک اضافه کنید. به طور خاص، یک API ثبت نام به نام registerForAuthenticationResult() اضافه کنید که AuthenticationResultCallback و onAuthenticationFailedCallback اختیاری را ثبت می‌کند و یک AuthenticationResultLauncher برای شروع احراز هویت با تمام ورودی‌ها ایجاد می‌کند. ( I2b06e )

رفع اشکالات

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

نسخه ۱.۴.۰-آلفا۰۲

۷ آگوست ۲۰۲۴

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 به‌روزرسانی کنید

نسخه ۱.۴.۰-آلفا۰۱

۲۹ مه ۲۰۲۴

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

رفع اشکالات

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

نسخه ۱.۲.۰

نسخه ۱.۲.۰-آلفا۰۵

۲۱ سپتامبر ۲۰۲۲

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 در اندروید ۱۳ اضافه شد. ( C5f1ec ، b/197965513 )

رفع اشکالات

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

نسخه ۱.۲.۰-آلفا۰۴

۱۷ نوامبر ۲۰۲۱

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

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

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

تغییرات API

  • پشتیبانی از API مربوط به BiometricManager.Strings در اندروید ۱۲ ( I12f2d ) اضافه شد.
  • سازگاری هدف و منبع از جاوا ۷ به جاوا ۸ ( I16129 ) تغییر یافت.

رفع اشکالات

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

نسخه ۱.۲.۰-آلفا۰۳

۲۴ فوریه ۲۰۲۱

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

تغییرات API

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

نسخه ۱.۲.۰-آلفا۰۲

۲۷ ژانویه ۲۰۲۱

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 با پشتیبانی محدود یا بدون پشتیبانی در نسخه‌های قدیمی‌تر اندروید اضافه شد. ( I18896 )
  • متدهای دریافت‌کننده برای تمام فیلدهای AuthPrompt که از طریق سازنده تنظیم می‌شوند، اضافه شد. ( I18896 )
  • افزونه‌های تعلیق کوروتین کاتلین برای احراز هویت بیومتریک از طریق APIهای AuthPrompt اضافه شد. این توابع در صورت موفقیت، مستقیماً AuthenticationResult برمی‌گردانند یا در صورت خطا یا عدم موفقیت (رد اعتبارنامه) یک استثنا ایجاد می‌کنند. ( Iffc9e )

رفع اشکالات

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

نسخه ۱.۲.۰-آلفا۰۱

۲ دسامبر ۲۰۲۰

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

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

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

تغییرات API

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

نسخه ۱.۱.۰

نسخه ۱.۱.۰

۲۷ ژانویه ۲۰۲۱

androidx.biometric:biometric:1.1.0 منتشر شد. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات عمده از زمان ۱.۰.۰

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

نسخه ۱.۱.۰-rc01

۱۱ نوامبر ۲۰۲۰

androidx.biometric:biometric:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

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

نسخه ۱.۱.۰-بتا۰۱

۱ اکتبر ۲۰۲۰

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

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

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

رفع اشکالات

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

نسخه ۱.۱.۰-آلفا۰۲

۱۹ آگوست ۲۰۲۰

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

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

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

تغییرات API

رفع اشکالات

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

نسخه ۱.۱.۰-آلفا۰۱

۲۴ ژوئن ۲۰۲۰

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

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

  • پیاده‌سازی کتابخانه داخلی را برای رسیدگی به منابع احتمالی نشت حافظه و سایر رفتارهای ناخواسته، بازسازی کردم:
    • قطعات داخلی اکنون با استفاده از یک ViewModel که به چرخه حیات فعالیت برنامه کلاینت گره خورده است، داده‌ها را به اشتراک گذاشته و ذخیره می‌کنند.
    • احراز هویت دستگاه قبل از اندروید ۱۰ (سطح API ۲۹) دیگر فعالیت شفافی را در برنامه کلاینت شروع نمی‌کند.

رفع اشکالات

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

نسخه ۱.۰.۱

نسخه ۱.۰.۱

۱۸ دسامبر ۲۰۱۹

androidx.biometric:biometric: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 ) برطرف شد.

نسخه ۱.۰.۰

نسخه ۱.۰.۰

۷ نوامبر ۲۰۱۹

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

ویژگی‌های اصلی نسخه ۱.۰.۰

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

نسخه ۱.۰.۰-rc02

۲۳ اکتبر ۲۰۱۹

androidx.biometric:biometric:1.0.0-rc02 منتشر شد. نسخه 1.0.0-rc02 شامل این کامیت‌ها است .

رفع اشکالات

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

نسخه ۱.۰.۰-rc01

۹ اکتبر ۲۰۱۹

androidx.biometric:biometric:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 شامل این کامیت‌ها است .

رفع اشکالات

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

نسخه ۱.۰.۰-بتا۰۲

۱۸ سپتامبر ۲۰۱۹

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

رفع اشکالات

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

نسخه ۱.۰.۰-بتا۰۱

۲۹ آگوست ۲۰۱۹

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

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

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

ما همچنین از ارائه قابلیت‌های زیر از اندروید ۱۰ به کتابخانه بیومتریک AndroidX بسیار هیجان‌زده‌ایم:

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

در اندروید ۱۰، کتابخانه متدهای مربوطه را از 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 )

نسخه ۱.۰.۰-آلفا۰۴

۳ آوریل ۲۰۱۹

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

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۳

۱۷ دسامبر ۲۰۱۸

رفع اشکالات

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