تسهّل "إدارة بيانات الاعتماد" عملية المصادقة في جميع أنحاء نظام Android المتكامل. وتوفّر هذه الخدمة تجربة متسقة للمستخدمين وواجهة برمجة تطبيقات موحّدة للمطوّرين لاستخدام مفاتيح المرور وكلمات المرور وآليات تسجيل الدخول الموحَّدة، مثل "تسجيل الدخول باستخدام حساب Google". على الرغم من أنّ واجهة البرمجة الأساسية تظل متسقة على مستوى أشكال الأجهزة، فإنّ لكل شكل من أشكال الأجهزة اعتبارات فريدة بشأن واجهة المستخدم وتجربة المستخدم. ويتطلّب التنفيذ الناجح تعديل مسارات المصادقة في تطبيقك لتناسب طرق الإدخال وأحجام الشاشة وسياقات المستخدمين المحددة لكل جهاز.
يقدّم هذا الدليل نظرة عامة على كيفية تنفيذ Credential Manager على مختلف أشكال أجهزة Android، مع تسليط الضوء على الاعتبارات الرئيسية وتقديم روابط إلى مستندات أكثر تفصيلاً.
الأجهزة الجوّالة
تمثّل الأجهزة الجوّالة، بما في ذلك الهواتف والأجهزة اللوحية والهواتف القابلة للطي، الهدف الأكثر شيوعًا لتطوير تطبيقات Android. يتوافق التنفيذ العادي لواجهة برمجة التطبيقات Credential Manager مع هذه الأجهزة التي تتضمّن عادةً شاشات تعمل باللمس ولوحات مفاتيح على الجهاز. وتشكّل تجربة المستخدم على هذا الشكل الأساس الذي تستند إليه في التكيّف مع الأشكال الأخرى. يجب أن تكون إجراءات المصادقة مناسبة لشكل الجهاز وأن تستخدم جميع إمكانات مساحة شاشة الجهاز وطرق الإدخال.
Wear OS
تتميّز أجهزة Wear OS بشاشاتها الصغيرة وإمكانية إدخال البيانات المحدودة على الجهاز. توفّر ميزة مفاتيح المرور في Credential Manager بيئة آمنة للمستخدمين لتسجيل الدخول إلى التطبيقات بدون الحاجة إلى هاتف مقترن ومتصل أو تذكُّر كلمة مرور.
تتطابق واجهة برمجة التطبيقات لنظام التشغيل Wear OS مع واجهة برمجة التطبيقات للأجهزة الجوّالة، لذا يمكنك إعادة استخدام عملية الدمج الحالية مع الأجهزة الجوّالة. بالإضافة إلى مفاتيح المرور و"تسجيل الدخول باستخدام Google" وكلمات المرور التي يوفّرها Credential Manager، يمكنك استخدام طرق مصادقة أخرى، مثل مشاركة الرموز المميزة في طبقة البيانات أو OAuth أو الحلول الحالية. ويمكن استخدامها كنسخ احتياطية أثناء نقل المستخدمين إلى "إدارة بيانات الاعتماد"، أو كحلّ طويل الأمد في حال مشاركة الرموز المميزة في "طبقة البيانات".
تكون واجهة المستخدم على أجهزة Wear OS على النحو التالي:


للحصول على إرشادات تفصيلية حول التنفيذ وأمثلة على الرموز البرمجية، اطّلِع على المراجع التالية:
- المصادقة على الأجهزة القابلة للارتداء
- اقتراحات بشأن تصميم واجهة المستخدم على Wear OS
- نموذج Wear Credential Manager
Android XR
باستخدام Android XR، الذي يشمل الواقع الافتراضي والواقع المعزّز، يتم عرض التطبيقات في مساحة ثلاثية الأبعاد. تختلف طريقة إدخال البيانات من المستخدم اختلافًا جذريًا عن تلك المتّبعة في أشكال الأجهزة الأخرى، إذ تعتمد على الإدخالات الطبيعية، مثل إيماءات اليد.
يتطلّب تكييف Credential Manager مع تجارب الواقع الممتد إعادة التفكير في واجهة مستخدم المصادقة، سواء باستخدام مفاتيح المرور أو كلمات المرور أو طُرق تسجيل الدخول الموحّدة، لتناسب المساحات الثلاثية الأبعاد. على سبيل المثال، تظهر طلبات المصادقة في لوحات عائمة، ويختار المستخدمون الخيارات باستخدام إيماءات اليد. عليك أيضًا مراعاة أي متطلبات أساسية خاصة بالأجهزة أو البرامج لأجهزة XR المستهدَفة.
من التحديات المهمة في التصميم إنشاء تجربة مصادقة سهلة الاستخدام وآمنة ضمن بيئة واقع افتراضي أو واقع معزّز. يجب أيضًا مراعاة كيفية إدارة الهوية في سيناريوهات الواقع الممتد التي تضم عدة مستخدمين، حيث قد يستخدم أشخاص مختلفون الجهاز نفسه.
لاستخدام Credential Manager API على أجهزة Android XR، يجب استيفاء المتطلبات التالية:
- الحد الأدنى لمستوى واجهة برمجة التطبيقات:
minSdkVersion
34 أو مستوى أعلى - إصدار "خدمات Google للأجهزة الجوّالة": هو نفسه الإصدار المطلوب للتطبيقات على الأجهزة الجوّالة
- المحاكي:
- الحد الأدنى لصورة نظام المحاكي:
- macOS: الإصدار 7 من صورة نظام Google Play XR ARM 64 v8a
- Windows: الإصدار 7 من صورة نظام Google Play XR Intel x86_64 Atom
- إصدارات المحاكي الأحدث من الإصدار الثابت 35.6.11
- الحد الأدنى لصورة نظام المحاكي:
قد تبدو تجربة تسجيل الدخول على الواقع الممتد على النحو التالي:

عمليات غير متوافقة مع الواقع الممتد
لا يتيح "مدير بيانات الاعتماد" في Android XR عمليات المصادقة التي تتطلّب أن يمسح جهاز آخر رمز استجابة سريعة ضوئيًا. يمكن ملاحظة ذلك أثناء عمليات تسجيل الدخول على سمّاعات رأس الواقع الممتد وعند الاختبار باستخدام المحاكي.
لمزيد من المعلومات عن الواقع الممتد، اطّلِع على Android XR.