--- title: التثبيت description: قم بتكوين CSP، وتثبيت حزمة Web SDK، وتنزيل ملفات الموارد المطلوبة لالتقاط لايفنس. canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/web/web-sdk/installation/ locale: ar generated_by: markdown-export --- ## إضافة التبعية وتكوين مدير الحزم ****الخطوة 1** — تكوين سياسة أمان المحتوى (CSP)** يستخدم Web SDK عمال الويب (Web Workers) للأمان والأداء. أضف التكوين التالي إلى CSP الخاص بك: ```html ``` :::warning إذا كان تطبيقك يستخدم CSP، فهذا التكوين إلزامي لضمان عمل SDK بشكل صحيح. ::: :::info[لماذا كل توجيه مطلوب] - **`'unsafe-eval'`** (script-src) — مطلوب من محرك كشف الحيوية لتجميع WebAssembly وتقييم روتينات الأمان ديناميكيًا في وقت التشغيل. - **`'unsafe-inline'`** (style-src, script-src-elem) — مطلوب بسبب الأنماط المضمّنة وتحميل البرامج النصية المضمّنة في SDK. حذفه يتسبب في تعطل واجهة الالتقاط. - **`*.acesso.io`** — نطاق البنية التحتية القديمة لـ Unico، ولا يزال ضروريًا للأصول واستدعاءات API. - **`*.unico.run` / `*.unico.io` / `*.unico.app`** — نطاقات خدمة Unico الحالية (CDN وAPI والنطاقات الفرعية للتطبيقات). - **`*.googleapis.com`** (script-src, style-src, script-src-elem, connect-src) — مطلوب لتحميل ورقة أنماط Google Fonts (CSS `@font-face` عبر `fonts.googleapis.com`) وموارد Google API الأخرى التي تستخدمها واجهة الالتقاط. - **`fonts.gstatic.com`** (font-src) — يوفر ملفات الخطوط الثنائية من Google Fonts المشار إليها في ورقة الأنماط المحمّلة من `fonts.googleapis.com`. - **`*.sentry.io`** — تستخدم Unico Sentry لتتبع أخطاء SDK. مطلوب في `script-src` و`connect-src` للسماح باستدعاءات تقارير الأخطاء. - **`*.launchdarkly.com`** — تستخدم Unico LaunchDarkly لتقييم أعلام الميزات التي تتحكم في سلوك SDK (مثل اختيار محرك الكاميرا). مطلوب في `script-src` و`connect-src` للسماح بتدفق الأعلام واستدعاءات التقييم. - **`*.newrelic.com` / `bam.nr-data.net`** — تستخدم Unico New Relic Browser لمراقبة أداء SDK. مطلوب في `script-src` (النص البرمجي للوكيل) و`connect-src` (استدعاءات beacon). - **`blob:`** (worker-src, child-src, script-src-elem) — مطلوب لأن Web Workers وبعض الموارد الفرعية لـ SDK تُنشأ كعناوين URL من نوع Blob في وقت التشغيل. ::: ****الخطوة 2** — تثبيت الحزمة** يُتاح Web SDK عبر حزمة npm أو CDN. ### npm ```bash npm install unico-webframe ``` ### yarn ```bash yarn add unico-webframe ``` ### CDN قم بتنزيل SDK واستيراده إلى مشروعك: - [تنزيل الإصدار `3.23.7`](https://cdn.unico.io/sdk/check/bio/unico-webframe-3.23.7.zip) ****الخطوة 3** — استيراد SDK** بعد التثبيت، استورد SDK إلى مشروعك. ### من npm ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'unico-webframe' ``` ### من CDN ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'UnicoCheckBuilder.min.js' ``` ****الخطوة 4** — تنزيل ملفات الموارد الإضافية** تُعدّ ملفات الموارد الإضافية ضرورية لإجراء التقاط Liveness. قم بتنزيل الملف المطابق لإصدار SDK الخاص بك وأدرجه في مشروعك: :::warning[قائمة التحقق عند الترقية] ملفات الموارد مرتبطة بإصدار SDK. في كل مرة تقوم فيها برفع إصدار `unico-webframe`، **يجب** إعادة تنزيل الموارد المطابقة من الجدول أدناه — استخدام إصدارات غير متطابقة يتسبب في خطأ في وقت التشغيل أثناء التقاط Liveness. **بدلاً من ذلك**، منذ SDK 3.18.0 يمكن للـ SDK جلب هذه الملفات تلقائيًا عند التهيئة، مما يُلغي خطوة التنزيل اليدوي. راجع [التهيئة](/dual-api/developers/sdks-and-tools/web/web-sdk/initialization) للاطلاع على خيار `setResourceDirectory`. ::: | إصدار SDK | موارد FaceTec | |---|---| | 3.23.7 | [9.7.114](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.114/resources.zip) | | 3.23.3 → 3.23.6 | [9.7.107](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.107/resources.zip) | | 3.23.0 → 3.23.1 | [9.7.102](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.102/resources.zip) | | 3.22.6 → 3.22.7 | [9.7.100](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.100/resources.zip) | | 3.22.5 | [9.7.99](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.99/resources.zip) | | 3.22.3 → 3.22.4 | [9.7.98](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.98/resources.zip) | | 3.22.2 | [9.7.96](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.96/resources.zip) | | 3.22.1 | [9.7.93](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.93/resources.zip) | | 3.22.0 | [9.7.90](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.90/resources.zip) | | 3.21.3 → 3.21.4 | [9.7.85](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.85/resources.zip) | | 3.21.2 | [9.7.82](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.82/resources.zip) | | 3.21.1 | [9.7.80](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.80/resources.zip) | | 3.20.10 → 3.21.0 | [9.7.76](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.76/resources.zip) | | 3.20.9 | [9.7.75](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.75/resources.zip) | | 3.20.8 | [9.7.73](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.73/resources.zip) | | 3.20.7 | [9.7.68](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.68/resources.zip) | | 3.20.5 → 3.20.6 | [9.7.65](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.65/resources.zip) | | 3.20.3 → 3.20.4 | [9.7.64](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.64/resources.zip) | | 3.20.2 | [9.7.63](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.63/resources.zip) | | 3.20.1 | [9.7.61](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.61/resources.zip) | | 3.20.0 | [9.7.55](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.55/resources.zip) | | 3.19.0 → 3.19.3 | [9.7.45 → 9.7.51](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.51/resources.zip) | | 3.18.x | 9.6.92 → 9.7.41 (انظر الجدول القديم) | قم أيضًا بتنزيل **ملفات الذكاء الاصطناعي** الخاصة بـ SDK: [models.zip](https://cdn.unico.io/sdk/check/bio/models.zip). :::warning[المسار العام] يجب استضافة جميع الملفات الإضافية في موقع عام مرئي للويب داخل مشروعك. :::