--- title: أفضل الممارسات لتطبيق SDK canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/best-practices-for-sdk-implementation locale: ar generated_by: markdown-export --- - [/ar/](/ar/) - [SDKs والأدوات](/ar/dual-api/developers/sdks-and-tools/overview) - أفضل الممارسات لتطبيق SDK **في هذه الصفحة# أفضل الممارسات لتطبيق SDK تجمع هذه الصفحة أهم الإرشادات لدمج SDKs الخاصة بـ Unico والحفاظ عليها. يُقلل اتباع هذه الممارسات من أخطاء الدمج، ويمنع الحوادث الأمنية، ويضمن إطلاقًا سلسًا في بيئة الإنتاج. ### البدء​ استخدم PoC لتسهيل تطبيقك تقدم Unico إثباتات المفهوم (PoCs) مع أمثلة كود وظيفية عبر جميع اللغات المدعومة. وتوضح هذه الأمثلة تسلسلات الأساليب المتوقعة وأنماط الدمج. يمكنك الوصول إلى PoCs المتاحة من خلال نظام تذاكر الدعم في بوابة العميل. احرص دائمًا على تحديث SDKs الخاصة بك تتطور SDKs باستمرار لتوفير أمان أكبر وميزات جديدة. يُعد تطبيق التحديثات بسرعة — ولا سيما الحرجة منها — أمرًا ضروريًا. راجع [سياسة التحديث](/ar/dual-api/developers/sdks-and-tools/update-policy) للاطلاع على الجداول الزمنية والالتزامات. تعرّف على أحدث إصدار متاح تحقق من الإصدار الحالي لكل منصة من خلال ملاحظات الإصدار الخاصة بها: [ملاحظات إصدار Android](/ar/developers/sdks-and-tools/android/resources/release-notes) [ملاحظات إصدار iOS](/ar/developers/sdks-and-tools/ios/resources/release-notes) [ملاحظات إصدار Flutter](/ar/developers/sdks-and-tools/flutter/resources/release-notes) [ملاحظات إصدار Web](/ar/dual-api/developers/sdks-and-tools/web/web-sdk/resources/release-notes) ### استراتيجية التحديث​ تجنب تحديث SDK ومكونات أخرى في آنٍ واحد من المرجح أن تطبيقك يُحمّل مكتبات متعددة إلى جانب Unico SDK. يُصعّب ترقية عدة تبعيات في آنٍ واحد تحديدَ السبب الجذري للأعطال. قم بتحديث SDK بصورة منفصلة وتحقق منه في [بيئة التدريج](#perform-tests-in-unicos-staging-environment) قبل دمجه مع تغييرات أخرى. الحصول على المساعدة في تحديث SDK عند فتح تذكرة دعم لمشاكل التحديث، أدرج ما يلي: لغة SDK ونوع التطبيق (أصلي أو هجين) إطار العمل المُستخدَم الإصدار الحالي والإصدار المستهدف مفتاح API وصف التغييرات وخطوات إعادة الإنتاج النتائج والأخطاء والسجلات ولقطات الشاشة أو مقاطع الفيديو ### أمان JWT​ لا تتلاعب بكائن JWT لا تفتح أو تعدّل JWT المشفّرإن JWT الذي يُعاد بعد التقاط ناجح **مشفَّر**. لا تفتحه أو تُحلله أو تُسلسله. قد تتغير بنيته الداخلية دون إشعار مسبق. استخدمه حصرًا عند إرسال الصور إلى واجهات برمجة تطبيقات Unico. لمعاينة الصور، استخدم خاصية Base64 المُقدَّمة إلى جانب JWT — ولا تفك تشفير JWT نفسه أبدًا. أرسل JWT في غضون 10 دقائق تحذيرلأسباب أمنية، يجب إرسال JWT إلى الخلفية الخاصة بـ Unico في غضون **10 دقائق** من الالتقاط. تُعدّ الحزم المُرسَلة بعد هذه المهلة غير صالحة. أرسل JWT مرة واحدة فقط تحذيريجب إرسال JWT **مرة واحدة فقط**. إذا حدث خطأ أثناء الإرسال، يجب إجراء التقاط بيومتري جديد — لا تُعيد استخدام نفس JWT. ### إرشادات الاختبار​ لا تستخدم المحاكاة الافتراضية أو المحاكيات يُشغّل تشغيل SDK في الأجهزة الافتراضية أو المحاكيات رموز خطأ أمنية (`73006`، `73600`، `73400`). اختبر دائمًا على **أجهزة فعلية** لتجنب تحديد الأخطاء بشكل خاطئ والعمل الزائد غير الضروري. لا تبقِ DevTools مفتوحًا أثناء عمليات التقاط الويب يكتشف Web SDK حالة فتح DevTools كإشارة احتيال محتملة ويُبطل الإرسال. أغلق DevTools قبل إجراء اختبارات الالتقاط الشاملة. ### أجرِ اختبارات في بيئة التدريج الخاصة بـ Unico​ قبل الانتقال إلى الإنتاج، أجرِ اختبارات شاملة في بيئة التدريج الخاصة بـ Unico مع سيناريوهات واقعية. استخدم مفاتيح API وإعدادات خاصة ببيئة التدريج — ولا تستخدم بيانات اعتماد الإنتاج في الاختبارات أبدًا. ### إرشادات خاصة بالمنصة​ Flutter: استخدم مكوّن Flutter الإضافي الخاص بـ Unico لا تحاول ربط SDKs الأصلية لـ Android أو iOS داخل تطبيق Flutter. تُنتج الجسور الأصلية في الغالب أخطاءً غير مُعيَّنة. استخدم دائمًا مكوّن Flutter الإضافي المخصص من Unico. Web: احذف ملفات الموارد القديمة عند تحديث الإصدارات عند ترقية Web SDK، احذف ملفات الموارد القديمة من مجلد `public` الخاص بك قبل إدراج الجديدة. لن يتم استبدال الملفات ذات الأسماء المتطابقة تلقائيًا وقد تُسبب تعارضات في الإصدارات. Mobile: امسح ذاكرة التخزين المؤقت قبل بناء إصدارات جديدة يمكن أن تُسبب مخرجات البناء من إصدارات SDK السابقة أخطاء في التبعيات بعد التحديث. قبل بناء إصدار جديد: **Flutter:** احذف `pubspec.lock` وشغّل `flutter pub get` **iOS:** شغّل `pod cache clean --all` و`pod install` **Android:** شغّل `./gradlew clean` إعدادات التعتيم استثنِ كود Unico SDK من تهيئة التعتيم الخاصة بك. كثيرًا ما يُسبب تعتيم SDK أعطالًا في إصدارات الإنتاج لا تظهر في إصدارات التصحيح. راجع الوثائق الخاصة بالمنصة للاطلاع على قواعد الإبقاء المطلوبة. ### تجربة المستخدم والأداء​ افصل تدفق الإعداد وفتح الكاميرا إلى خطوتين هيكل تدفق SDK في مرحلتين متمايزتين: **الإعداد** — تهيئة SDK أثناء تحميل الصفحة (قبل تفاعل المستخدم). **الفتح** — تشغيل الكاميرا فقط عندما يُشغّل المستخدم الإجراء صراحةً. يُقلل إعداد SDK مسبقًا من زمن الاستجابة المُدرَك ويُحسّن تجربة المستخدم بشكل ملحوظ. ### إطلاق الإنتاج​ أنشئ قائمة مراجعة آمنة لإطلاق الإنتاج قبل النشر في الإنتاج، تحقق مما يلي: مفاتيح API للإنتاج وإعدادات البيئة صحيحة خطة التراجع مُعرَّفة ومختبرة بروتوكول جمع السجلات جاهز إجراءات تذاكر الدعم مُوثَّقة للتعامل مع الأعطال اجتازت جميع عمليات التحقق في بيئة التدريج آخر تحديث في 8 أكتوبر 2026**