المقاييس الحيوية

المصادقة باستخدام المقاييس الحيوية أو بيانات اعتماد الجهاز وتنفيذ عمليات التشفير
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫25 مارس 2026 1.1.0 - - 1.4.0-alpha06

تحديد الاعتماديات

لإضافة اعتمادية على 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"
}

Kotlin

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

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

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.4

الإصدار ‎1.4.0-alpha06

‫25 مارس 2026

تم طرح androidx.biometric:biometric:1.4.0-alpha06 وandroidx.biometric:biometric-compose:1.4.0-alpha06. يتضمّن الإصدار 1.4.0-alpha06 هذه التعديلات.

الميزات الجديدة

  • إتاحة خيارات احتياطية متعدّدة (Ib078e، b/349218025)
  • بدءًا من الإصدار 36.1 من نظام التشغيل Android (Baklava)، يتيح طلب المصادقة باستخدام المقاييس الحيوية الآن ما يصل إلى أربعة خيارات احتياطية مخصّصة بدلاً من زر سلبي واحد. يمكن للمطوّرين توفير خيارات احتياطية مخصّصة متعدّدة مع الرموز المرتبطة بها (على إصدارات Android المتوافقة) من خلال AuthenticationRequest.Biometric.Fallback. يتم الآن تسجيل النقرات على هذه الخيارات من خلال AuthenticationResult.CustomFallbackSelected بدلاً من رمز الخطأ.

تغييرات واجهة برمجة التطبيقات

  • إزالة JvmSynthetic من AuthenticationRequest (Ia2dcb، b/434257610)
  • إضافة دعم KeyAgreement إلى BiometricPrompt.CryptoObject (I73029، b/400115331)
  • عدِّل registerForAuthenticationResult() لاستخدام ComponentActivity بدلاً من ذلك FragmentActivity لتحقيق توافق أوسع. (Id5db6، b/349213716)

إصلاح الأخطاء

  • تم إصلاح مشكلة اختفاء رمز بصمة الإصبع أثناء تدوير الجهاز. (I366f2)
  • تم نقل عملية إغلاق مربّع حوار بصمة الإصبع إلى onDestroy(). (I619b0)
  • تم تعديل compileSdk إلى الإصدار 36.1 ليتوافق مع ميزات منصة Baklava الجديدة. (I9da03)

الإصدار ‎1.4.0-alpha05

‫17 ديسمبر 2025

تم طرح 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)

تغييرات واجهة برمجة التطبيقات

  • تتضمّن مكتبة المقارنة بنمط نتائج النشاط تغييرات جديدة في واجهة برمجة التطبيقات، وهي:
    • تم نقل دالة الاستدعاء onAuthFailure إلى AuthenticationResultCallback وإعادة تسميتها إلى onAuthAttemptFailed. (Ied96b، /Id6a73)
    • السماح للتطبيقات بتوفير منفِّذ لعمليات رد الاتصال (Id6a73)
    • إتاحة استخدام أدوات تشغيل مصادقة متعددة في نشاط أو جزء واحد: يتم تفعيل هذه الميزة من خلال آلية تتبُّع داخلية جديدة (currentAuthenticationKey) تعمل على توجيه النتائج بشكل صحيح إلى مثيل أداة التشغيل المحدّد الذي طلبها. (I2848c)
  • إيقاف androidx.core.hardware.fingerprint.FingerprintManagerCompat نهائيًا: androidx.core.hardware.fingerprint.FingerprintManagerCompat لا تنفّذ أي عملية الآن، أي لا تفعل شيئًا أو تعرض القيمة "خطأ". يتم استخدام androidx.biometric.FingerprintManagerCompat داخلي جديد في مكتبة androidx.biometric لتحقيق التوافق مع الأنظمة القديمة. (I0360b، If5687)

إصلاح الأخطاء

  • تم إصلاح مشكلة عرض خطأ الحظر في canAuthenticate() عن غير قصد (I33ae1، b/431824303)
  • تغيير الحد الأدنى التلقائي لإصدار SDK من المستوى 21 لواجهة برمجة التطبيقات إلى المستوى 23 (Ibdfca، b/380448311، b/435705964، b/435705223)

الإصدار ‎1.4.0-alpha04

‫20 مايو 2025

تم طرح androidx.biometric:biometric:1.4.0-alpha04. يتضمّن الإصدار 1.4.0-alpha04 هذه التعديلات.

الميزات الجديدة

  • استخدام واجهة برمجة التطبيقات KeyguardManager داخليًا دائمًا لتطبيقات Wear‏ (I9b7fd)

تغييرات واجهة برمجة التطبيقات

  • إضافة جزء من برنامج المصادقة ذي الامتيازات IDENTITY_CHECK (I706bb)

الإصدار 1.4.0-alpha03

‫26 مارس 2025

تم طرح androidx.biometric:biometric:1.4.0-alpha03. يتضمّن الإصدار 1.4.0-alpha03 هذه التعديلات.

الميزات الجديدة

  • تم تقديم نقطة دخول جديدة للمصادقة registerForAuthenticationResult() API لتحلّ محل الوحدة androidx.biometric:biometric-ktx وandroidx.BiometricPrompt. تم تصميم واجهة برمجة التطبيقات الجديدة هذه على غرار Activity Result API، وهي توفّر توافقًا سلسًا مع كلٍّ من تطوير Kotlin وJava.

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تسمية 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] إضافة واجهات برمجة تطبيقات جديدة لنمط نتيجة النشاط لوحدة المقاييس الحيوية على وجه التحديد، أضِف واجهة برمجة تطبيقات للتسجيل باسم 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)
  • تم إصلاح حالات عدم الاتساق في رموز الخطأ عند إيقاف ميزة المصادقة الحيوية في التطبيقات على الإصدار 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 للمطوّرين عرض طريقة عرض المحتوى المخصّص كخيار إضافي لطريقة عرض نص الوصف العادي
  • يظهر شعار التطبيق على طلب المصادقة البيومترية - تتم إضافته تلقائيًا باستخدام رمز التطبيق.

تغييرات واجهة برمجة التطبيقات

  • إضافة واجهات برمجة تطبيقات لدعم طريقة عرض المحتوى المخصّص
    • BiometricPrompt.PromptInfo.Builder#setContentView
    • BiometricPrompt.PromptInfo#getContentView
    • واجهة PromptContentView
    • الصف PromptVerticalListContentView
    • فئة PromptContentViewWithMoreOptionsButton (للتطبيقات ذات الامتيازات فقط)
  • إضافة واجهات برمجة التطبيقات لدعم الشعار (للتطبيقات ذات الامتيازات فقط)
    • 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. تم تطوير هذا الإصدار في فرع داخلي ويستهدف الإصدار التجريبي 2 من Android 15.

إصلاح الأخطاء

  • تعديل واجهة المستخدم لتتوافق مع التغييرات في النظام الأساسي في 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة إمكانية استخدام 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)

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة دعم لواجهة برمجة التطبيقات BiometricManager.Strings في Android 12 (I12f2d)
  • تم تغيير توافق الإصدار المستهدف والمصدر من Java 7 إلى Java 8 (I16129)

إصلاح الأخطاء

  • تم إصلاح مشكلة في الإصدار 29 من واجهة برمجة التطبيقات حيث كانت بعض الأجهزة (بما في ذلك المحاكيات) تتلقّى خطأ إلغاء عند الرجوع إلى رقم التعريف الشخصي أو النقش أو كلمة المرور. يُرجى العِلم أنّه في بعض الأجهزة التي تعمل بالإصدار 29 من واجهة برمجة التطبيقات، قد يؤدي ذلك إلى مطالبة المستخدم بإدخال رمز قفل الشاشة حتى إذا كانت المقاييس الحيوية متاحة ومسجّلة. (b/142740104)
  • تم إصلاح مشكلة في الإصدار 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة تعليق إضافات إجراءات روتينية متزامنة إلى 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • أعدنا تصميم بعض حقول AuthPrompt التي تم ضبطها سابقًا من خلال أداة إنشاء إلى وسيطات طريقة startAuthentication(...). (I18896، b/174098373)
  • تمت إضافة الحد الأدنى من متطلبات مستوى واجهة برمجة التطبيقات لأنواع AuthPrompt التي لا تتوافق أو تتوافق بشكل محدود مع إصدارات Android القديمة. (I18896)
  • تمّت إضافة طرق getter لجميع حقول AuthPrompt التي يتمّ ضبطها من خلال أداة إنشاء. (I18896)
  • تمت إضافة إضافات Kotlin لتعليق الكوروتينات من أجل المصادقة باستخدام المقاييس الحيوية من خلال واجهات برمجة التطبيقات AuthPrompt. ستعرض هذه الدوال AuthenticationResult مباشرةً عند النجاح أو ستطرح استثناءً عند حدوث خطأ أو فشل (رفض بيانات الاعتماد). (Iffc9e)

إصلاح الأخطاء

  • تم إصلاح مشكلة كانت تتسبّب في أن تعرض الدالة BiometricManager.canAuthenticate(int) أحيانًا رمز الحالة غير الصحيح لجهاز مزوّد بأداة استشعار بصمات الأصابع على نظام التشغيل Android 10 (مستوى واجهة برمجة التطبيقات 29). (I72420، b/176921662)
  • تم إصلاح مشكلة كانت تؤدي إلى عرض BiometricManager.canAuthenticate(int) لرمز حالة غير صحيح لجهاز لا يتضمّن أجهزة مقاييس حيوية ولم يتم تسجيل رقم تعريف شخصي أو نقش أو كلمة مرور عليه على الإصدار 10 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 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 التي تضيف واجهات برمجة تطبيقات وإضافات خاصة بلغة Kotlin إلى جانب androidx.biometric:biometric.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة واجهات برمجة تطبيقات AuthPrompt جديدة لإنشاء BiometricPrompt وإجراء المصادقة. لا تتطلّب واجهات برمجة التطبيقات هذه إنشاء BiometricPrompt في الاستدعاء في إحدى مراحل النشاط مبكر، مثل onCreate. (I19022)
  • تمّت إضافة إضافات Kotlin إلى Fragment وFragmentActivity لواجهات برمجة التطبيقات الجديدة AuthPrompt. (Iaf98c)

الإصدار 1.1.0

الإصدار 1.1.0

‫27 يناير 2021

تم طرح androidx.biometric:biometric:1.1.0. يتضمّن الإصدار 1.1.0 هذه التعديلات.

التغييرات الرئيسية منذ الإصدار 1.0.0

  • تمت إضافة إمكانية استخدام الميزات الجديدة وتحديثات واجهة برمجة التطبيقات الخاصة بالمصادقة بالمقاييس الحيوية والتي تم طرحها في Android 11، مع ضمان التوافق مع الإصدارات القديمة.
  • تم تقليل حجم مساحة مكتبة التطبيق بشكل كبير (بأكثر من 100 كيلوبايت في بعض الحالات).
  • تمت إزالة مصادر مختلفة لتسرُّب الذاكرة كانت تتسبّب فيها المكتبة سابقًا.
  • تم إصلاح حالات تعذُّر التحقّق من الفئة التي قد تؤثّر في الأداء على إصدارات Android القديمة.
  • أجرينا تحسينات إضافية متنوّعة على ثبات المكتبة وسلوكها.

الإصدار ‎1.1.0-rc01

‫11 نوفمبر 2020

تم طرح androidx.biometric:biometric:1.1.0-rc01. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة على بعض الأجهزة كانت تتسبّب أحيانًا في ظهور الخطأ 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 هذه التعديلات.

الميزات الجديدة

  • تم تقليل حجم حزمة APK للمكتبة بشكل كبير (بأكثر من 100 كيلوبايت مضغوطة في بعض الحالات) من خلال استبدال الرسوم المتحركة لمربّعات الحوار بأصول ثابتة على الإصدار 8.1 من نظام التشغيل Android والإصدارات الأقدم. (I4844e)
  • في حال تعذُّر المصادقة باستخدام المقاييس الحيوية، سيتم تلقائيًا استخدام مصادقة بيانات اعتماد الجهاز (إذا كان ذلك مسموحًا به) في جميع إصدارات Android المتوافقة مع BiometricPrompt. (b/149579143)

إصلاح الأخطاء

  • تم إصلاح المشكلة التي تسبّبت في تعطُّل BiometricPrompt على بعض أجهزة Android 9 التي لا تحتوي على أداة استشعار بصمة الإصبع. (b/151443237)
  • تم إصلاح NullPointerException محتمل في FingerprintDialogFragment. (b/167951429)
  • تم إصلاح المشكلة التي تم فيها استخدام النوع CryptoObject الخاطئ لاستدعاء طريقة انعكاسية في BiometricManager. (b/165824669)
  • تم إصلاح مشكلة كانت تؤدي إلى إغلاق الطلب الجديد تلقائيًا على بعض أجهزة Android 10 عند عرض BiometricPrompt مرة أخرى بعد وقت قصير من إغلاقه. (b/157783075)
  • تم إصلاح أخطاء تسريب الذاكرة المرتبطة باستخدام FingerprintManagerCompat. (b/165840273)
  • تم إصلاح المشاكل المتعلّقة بإخفاء واجهة مستخدم مربّع حوار بصمة الإصبع أو عرضها بشكل غير صحيح على بعض أجهزة 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 مرتبط على الإصدار 11 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 30) والإصدارات الأحدث فقط.

تغييرات واجهة برمجة التطبيقات

إصلاح الأخطاء

  • تم إصلاح تسربات الذاكرة التي أبلغ عنها LeakCanary في BiometricFragment وBiometricViewModel. (b/144919472)
  • تم التأكّد من أنّ BiometricViewModel لن يعود يتصل بـ MutableLiveData#setValue() من سلسلة محادثات في الخلفية. (b/159983244)
  • تم إصلاح مشكلة عدم تعامل BiometricPrompt بشكلٍ صحيح مع عمليات الحظر المؤقت على بعض مستويات واجهة برمجة التطبيقات. (9acfce9)
  • تم إصلاح مشكلة كانت تؤدي إلى عرض BiometricPrompt لرمز خطأ غير صحيح لجهاز غير محمي ببيانات اعتماد قفل الشاشة على بعض مستويات واجهة برمجة التطبيقات. (b/148626482)
  • تم إصلاح المشكلة التي كانت تتسبّب في عرض BiometricManager وBiometricPrompt لرموز خطأ غير صحيحة لجهاز لا يتضمّن تنفيذًا لـ Keyguard على بعض مستويات واجهة برمجة التطبيقات. (891c6e0)

الإصدار ‎1.1.0-alpha01

‫24 يونيو 2020

تم طرح androidx.biometric:biometric:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

الميزات الجديدة

  • تمت إعادة تصميم عملية تنفيذ المكتبة الداخلية لمعالجة المصادر المحتملة لتسرُّب الذاكرة والسلوكيات الأخرى غير المقصودة:
    • تتشارك الآن الأجزاء الداخلية البيانات وتحتفظ بها باستخدام ViewModel مرتبط بدورة حياة نشاط تطبيق العميل.
    • لم تعُد مصادقة بيانات اعتماد الجهاز قبل الإصدار Android 10 (مستوى واجهة برمجة التطبيقات 29) تبدأ نشاطًا شفافًا داخل تطبيق العميل.

إصلاح الأخطاء

  • تم حلّ تحذيرات الإيقاف النهائي المتعلّقة باستخدام FingerprintManagerCompat. (b/142967618)
  • تم تغيير طريقة استدعاء طرق النظام الأساسي التي تتطلّب حزمة تطوير البرامج (SDK) لتجنُّب مشاكل التحقّق من الفئة في إصدارات Android القديمة. (94beb4b)
  • لم تعُد المكتبة تصدّر تبعيات Gradle التي لا تشكّل جزءًا من واجهة برمجة التطبيقات العامة. (f289d9e)

الإصدار 1.0.1

الإصدار 1.0.1

‫18 كانون الأول (ديسمبر) 2019

تم طرح androidx.biometric:biometric:1.0.1. يتضمّن الإصدار 1.0.1 هذه التعديلات.

إصلاح الأخطاء

  • تم توسيع نطاق الحلّ البديل الحالي للمصادقة المستندة إلى التشفير في حال عدم توفّر بصمة الإصبع ليشمل المورّدين المعروفين المتأثرين بالمشكلة، مع اقتصاره أيضًا على الإصدار 28 من واجهة برمجة التطبيقات (b/143361271).
  • تم إصلاح مشكلة على أجهزة معيّنة كانت تؤدي إلى ظهور مربّع حوار المقاييس الحيوية تحت تراكب النظام (b/143230260)
  • تم إصلاح عدة مشاكل في setDeviceCredentialAllowed(true) (b/143091227 وb/143097321 وb/143653944)
  • تم إصلاح مشكلة في بعض إصدارات Android حيث لم يكن يتم دائمًا استدعاء onAuthenticationSuccess بعد أن يؤكّد المستخدم بيانات اعتماد جهازه (b/145232806)
  • تم إصلاح مشكلة في بعض إصدارات Android حيث لم يكن يتم استدعاء onAuthenticationError دائمًا عند إغلاق الطلب أثناء التدوير (b/145230042)
  • تم إصلاح مشكلة في بعض إصدارات Android حيث لم يتم إغلاق الطلب عند تلقّي رموز خطأ معيّنة (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

  • إصدار متوافق من واجهتَي برمجة التطبيقات BiometricPrompt وBiometricManager، كما هو مطبَّق في Android 10، مع توفير ميزات كاملة متوافقة مع الإصدارات السابقة حتى Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات)
  • إدارة مراحل النشاط المضمّنة لـ BiometricPrompt ضمن Fragment أو FragmentActivity
  • التعامل الخاص مع الأجهزة المعروفة بعرض مقاييس حيوية ضعيفة بشكل غير صحيح أثناء المصادقة المستندة إلى التشفير

الإصدار ‎1.0.0-rc02

‫23 تشرين الأول (أكتوبر) 2019

تم طرح androidx.biometric:biometric:1.0.0-rc02. يتضمّن الإصدار 1.0.0-rc02 هذه التعديلات.

إصلاح الأخطاء

  • تمت إضافة حلّ بديل لبعض الأجهزة المعروف عنها أنّها تقدّم مقاييس حيوية ضعيفة بشكل غير صحيح عند طلب المصادقة المستندة إلى التشفير على الإصدارَين 28 و29 من واجهة برمجة التطبيقات (b/142150327)

الإصدار 1.0.0-rc01

‫9 أكتوبر 2019

تم طرح androidx.biometric:biometric:1.0.0-rc01. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح عُطل محتمل في FingerprintDialogFragment عند إغلاقه أثناء تدوير الشاشة (b/141356362)
  • تم إصلاح المشكلة التي كان فيها تلقّي قيمة فارغة (null) AuthenticationResult من واجهة برمجة التطبيقات للإطار يؤدي إلى حدوث تعطُّل (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
  • تمت إزالة تبعيات Java 8 والتبديل إلى Java 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 تتيح استضافتها في جزء (على عكس طريقة وضع التصميم الحالية التي تتطلّب FragmentActivity).

يسرّنا أيضًا توفير الوظائف التالية من نظام التشغيل Android 10 في مكتبة AndroidX Biometric:

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

في نظام التشغيل Android 10، ستستدعي المكتبة الطرق المقابلة من واجهة برمجة التطبيقات الخاصة بالنظام الأساسي. في مستويات واجهة برمجة التطبيقات القديمة، ستحاكي المكتبة السلوك.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة أداة إنشاء خاصة بالجزء لطلب المصادقة باستخدام المقاييس الحيوية (b/131980596)
  • راجِع قسم "الميزات الجديدة" أعلاه.

إصلاح الأخطاء

  • إضافة إمكانية استخدام بيانات اعتماد الجهاز في BiometricPrompt على الإصدارات L+
  • تم تعديل BiometricPrompt لاستخدام ثوابت الخطأ العامة (b/137788194)
  • حلّ المشكلة NullPointerException في BiometricPrompt.onAttach() (b/136103103)
  • تم تغيير السلوك لعدم السماح بإلغاء BiometricPrompt من خلال حدث لمس خارج الطلب (b/135684487)
  • تم إصلاح عُطل onAuthenticationError عند عرض قيمة خطأ فارغة في Kotlin (b/128350861)
  • أصبح بالإمكان الآن ضبط نمط FingerprintDialogFragment (b/127878106)
  • أصبح بإمكانك الآن الانتقال للأعلى أو للأسفل في FingerprintDialog (b/126367887)
  • تم إصلاح الخطأ الذي كان يؤدي إلى ظهور IllegalStateException عند تدوير مربّع حوار المقاييس الحيوية (b/124153656)، (b/123811924)
  • تم إصلاح السلوك غير المتسق في المستويات من 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 زرّ الإلغاء (b/122054485)
  • تم إصلاح مشكلة عدم تغيير عنوان/وصف androidx.biometric.PromptInfo على نظام التشغيل Android P (b/122856773)

الإصدار ‎1.0.0-alpha03

‫17 كانون الأول (ديسمبر) 2018

إصلاح الأخطاء

  • إصلاح المشاكل المتعلّقة بالتقسيم
  • في الإصدارات O والإصدارات الأقدم، يتم عرض أخطاء قفل الشاشة على الفور لضمان التوافق مع الإصدار P والإصدارات الأحدث.