---
title: حزم SDK والأدوات
description: نظرة عامة على حزم SDK وأدوات التكامل في IDCloud — Web SDK وAndroid SDK وiOS SDK وFlutter SDK وREST API.
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/overview
locale: ar
generated_by: markdown-export
---

تُدمج حزم SDK الخاصة بـ Unico مباشرةً في تطبيقك لإدارة تجربة الالتقاط على جانب العميل. عند الالتقاط الناجح، تُعيد حزمة SDK حمولةً مشفرة تُرسلها الواجهة الخلفية إلى محرك IDCloud للتحقق البيومتري للتحليل عبر REST API.

### حزم SDK المتاحة

  **Android SDK**

مكتبة أصيلة لتطبيقات Java وKotlin.

  **iOS SDK**

مكتبة أصيلة لتطبيقات Swift وObjective-C.

  **Flutter SDK**

إضافة مبنية فوق حزم SDK الأصيلة لـ Android وiOS.

  **Web SDK**

مكتبة JavaScript لتدفقات الالتقاط عبر المتصفح.

### إثباتات المفهوم (PoCs)

استكشف تطبيقات إثباتات المفهوم (PoCs) الرسمية لكل SDK قبل بدء عملية الدمج — تطبيقات مُتحقَّق منها ومُحدَّثة لتدفقات الالتقاط الرئيسية.

- [Android](/developers/sdks-and-tools/android/resources)
- [iOS](/developers/sdks-and-tools/ios/resources)
- [Flutter](/developers/sdks-and-tools/flutter/resources)
- [Web](/dual-api/developers/sdks-and-tools/web/web-sdk/resources)
- [تكامل تطبيق الويب (Journeys SDK)](/developers/sdks-and-tools/web)

**حزم SDK الأصلية**

| المنصة | التدفق | المستودع |
|---|---|---|
| Android | لايفنس | [GitHub — unico-sdk-poc-kotlin](https://github.com/unico-labs/unico-sdk-poc-kotlin) |
| Android | User Journeys | [GitHub — unico-sdks-poc-kotlin](https://github.com/unico-labs/unico-sdks-poc-kotlin) |
| iOS | لايفنس | [GitHub — unico-sdk-poc-ios-swift](https://github.com/unico-labs/unico-sdk-poc-ios-swift) |
| iOS | User Journeys | [GitHub — unico-sdks-poc-swift](https://github.com/unico-labs/unico-sdks-poc-swift) |
| Flutter | لايفنس | [GitHub — unico-sdk-poc-flutter](https://github.com/unico-labs/unico-sdk-poc-flutter) |
| Flutter | User Journeys | [GitHub — unico-sdks-flutter](https://github.com/unico-labs/unico-sdks-flutter) |

**تكامل تطبيق الويب (Journeys SDK)**

| اللغة / الإطار | المستودع |
|---|---|
| Angular | [GitHub — unico-cbu-poc-angular](https://github.com/unico-labs/unico-cbu-poc-angular) |
| JS Vanilla | [GitHub — unico-cbu-poc-js](https://github.com/unico-labs/unico-cbu-poc-js) |
| React | [GitHub — unico-cbu-poc-react](https://github.com/unico-labs/unico-cbu-poc-react) |
| Vue JS | [GitHub — unico-cbu-poc-vuejs](https://github.com/unico-labs/unico-cbu-poc-vuejs) |

**Web SDK**

| اللغة / الإطار | المستودع |
|---|---|
| Angular | [GitHub — unico-sdk-poc-angular](https://github.com/unico-labs/unico-sdk-poc-angular) |
| JS Vanilla | [GitHub — unico-sdk-poc-js-vanilla](https://github.com/unico-labs/unico-sdk-poc-js-vanilla) |
| Next.js | [GitHub — unico-sdk-poc-next-js](https://github.com/unico-labs/unico-sdk-poc-next-js) |
| React JS مع TypeScript | [GitHub — unico-webframe-poc-react](https://github.com/unico-labs/unico-webframe-poc-react) |
| React JS مع JavaScript | [GitHub — unico-sdk-poc-react-js](https://github.com/unico-labs/unico-sdk-poc-react-js) |
| React JS مع Webpack + Babel | SFTP — اطلب من مدير مشروعك |
| Vue JS | [GitHub — unico-sdk-poc-vuejs](https://github.com/unico-labs/unico-sdk-poc-vuejs) |

### الميزات الرئيسية

## التحقق من الحضور الحي

تتكامل حزم SDK مع إمكانية Liveness للتأكد من الحضور الفعلي للمستخدم لحظة الالتقاط. لا تكتمل جلسة الالتقاط إلا بعد التحقق من الحضور الحي، مما يحول دون محاولات الانتحال كالصور ومقاطع الفيديو والأقنعة.

## SmartFrames

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

### طبقات الأمان

تأتي كل حزمة SDK مزودة بضوابط أمنية متعددة تُطبَّق في وقت التشغيل:

- تشفير الحمولة بين العميل والواجهة الخلفية
- منع الحقن والتلاعب
- كشف الاحتيال عبر أوضاع الكاميرا المختلفة
- تشويش الكود البرمجي
- حظر المحاكيات
- التحقق من حزمة التطبيق

### آلية العمل

تتولى حزمة SDK (على جانب العميل) تبسيط التكامل مع منصة Unico، إذ تتعامل مع كامل تعقيدات التحكم في الكاميرا والتقاط الصور ورحلة المستخدم.

في حال نجاح الالتقاط، تُعيد حزمة SDK حمولةً مشفرة يجب إرسالها إلى واجهة برمجة تطبيقات المحرك البيومتري، وبذلك يكتمل التحقق البيومتري كما هو موضح في المخطط أدناه:

```mermaid
sequenceDiagram
    actor User
    participant App as Your App
    participant SDK as Unico SDK
    participant Server as Your App Backend Server
    participant Engine as Unico API

    User->>App: 1. Access Your Application
    App->>SDK: 2. Render Capture Component
    SDK-->>App: 3. [Capture Component]
    App->>App: 4. Capture Image (JWT)
    App->>Server: 5. Drop JWT to your server
    Server->>Engine: 6. Iterate with Unico API with jwt
    Engine->>Server: Biometry response
    Server->>App: Biometry response
    App->>User: Feedback
```

تتولى حزمة SDK تدفق الالتقاط الكامل على جانب العميل: الوصول إلى الكاميرا، والتحقق من الإطار، وفحص الحضور الحي، والتشفير. تتلقى الواجهة الخلفية الحمولة المشفرة وتُعيدها إلى محرك IDCloud للتحقق البيومتري — دون نقل أي صورة خام.

تُنتج حزم SDK هذه مخرجات لعقد Web & SDK (‏`POST /client/v1/process`). أما في عقد API، فيُعالَج الالتقاط على واجهتك الخاصة ويُرسل `imageBase64` مباشرةً.

## إدارة الإصدارات

تتبع إصدارات حزم SDK نظام الإصدار الدلالي (`MAJOR.MINOR.PATCH`). تعتمد مسؤولية تحديث حزمة SDK على نموذج التكامل المُعتمد. في تكاملات **by-Client**، يقع على عاتقك الحفاظ على تحديث حزمة SDK — فالإصدارات القديمة قد تفقد تغطية الأمان أو إمكانية الوصول إلى القدرات الجديدة. أما في تكاملات **by-Unico**، فتتولى Unico دفع التحديثات تلقائيًا.

- **الإصدار الرئيسي (MAJOR):** عند إجراء تغييرات غير متوافقة مع واجهة برمجة التطبيقات.
- **الإصدار الثانوي (MINOR):** عند إضافة وظائف مع الحفاظ على التوافق.
- **إصدار الإصلاح (PATCH):** عند إصلاح الأخطاء مع الحفاظ على التوافق.

:::warning[البيئات المدعومة]
المدعومة: Android الأصيل، وiOS الأصيل، وFlutter عبر إضافتنا. غير المدعومة: أي إطار عمل هجين أو متعدد المنصات، بما في ذلك على سبيل المثال لا الحصر React Native وIonic.
:::