---
title: التثبيت
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/android/installation/
locale: ar
generated_by: markdown-export
---

- [/ar/](/ar/)
- [SDKs والأدوات](/ar/dual-api/developers/sdks-and-tools/overview)
- [Android SDK](/ar/dual-api/developers/sdks-and-tools/android/requirements)
- التثبيت

# التثبيت

لتهيئة SDK في مشروعك، اتبع الخطوات التالية:

**الخطوة 1** — إضافة مستودع Mavenيتم توزيع Android SDK من خلال مستودع Maven الخاص بـ Unico. أضفه إلى كتلة `repositories` في ملف البناء على مستوى **الجذر**:

- build.gradle.kts
- build.gradle

build.gradle.kts (project)```
allprojects {**  repositories {    google()    maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }  }}
```

build.gradle (project)```
allprojects {  repositories {    google()    maven { url "https://maven-sdk.unico.run/sdk-mobile" }  }}
```

**الخطوة 2** — تفعيل دعم AndroidX (عند الحاجة)أضف ما يلي إلى `gradle.properties` في جذر المشروع:gradle.properties```
android.useAndroidX=true
```

Jetifierبالنسبة لمشاريع AGP 8.6 والإصدارات الأحدث، يكون Jetifier معطّلاً افتراضياً. أضف `android.enableJetifier=true` فقط إذا كان مشروعك لا يزال يعتمد على مصنوعات `support-library` القديمة التي لم تنتقل إلى AndroidX — فتفعيله بلا داعٍ يزيد من وقت البناء.
**الخطوة 3** — إضافة تبعية SDKأضف `acessobio-android` إلى كتلة `dependencies` في ملف البناء على مستوى **الوحدة**. استبدل `<latest_version>` بالإصدار الحالي (**6.10.1**) — راجع [ملاحظات الإصدار](/ar/developers/sdks-and-tools/android/resources/release-notes) للاطلاع على الأحدث:build.gradle.ktsbuild.gradleapp/build.gradle.kts (module)```
dependencies {  implementation("com.acesso:acessobio-android:<latest_version>")}
```

app/build.gradle (module)```
dependencies {  implementation 'com.acesso:acessobio-android:<latest_version>'}
```

Legacy artifact namingتعكس مجموعة Maven `com.acesso` واسم المصنوع `acessobio-android` العلامة التجارية القديمة لـ Acesso Digital — وهذه هي معرّفات المصنوع المنشورة ولن تتغير لإصدار SDK هذا. يُشار إلى نفس SDK بـ **UnicoCheck** في مرجع API ومواد Unico الأخرى.
**الخطوة 4** — تعيين توافق Javaمطلوب للتوافق مع الحد الأدنى لمستوى API المدعوم في SDK (26). أضف ما يلي إلى `compileOptions` في ملف البناء على مستوى الوحدة نفسه:build.gradle.ktsbuild.gradleapp/build.gradle.kts (module)```
android {  compileOptions {    sourceCompatibility = JavaVersion.VERSION_1_8    targetCompatibility = JavaVersion.VERSION_1_8  }}
```

app/build.gradle (module)```
android {  compileOptions {    sourceCompatibility JavaVersion.VERSION_1_8    targetCompatibility JavaVersion.VERSION_1_8  }}
```

**الخطوة 5** — إضافة أذونات AndroidManifestأضف الأذونات المطلوبة كحد أدنى وإعلان ميزة الأجهزة إلى `AndroidManifest.xml`:AndroidManifest.xml```
<uses-feature android:name="android.hardware.camera" android:required="true" /><uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.CAMERA" />
```

تصفية التسليم في Play Storeيُشير إعلان `<uses-feature>` إلى متجر Play بأن التطبيق يتطلب كاميرا، مما يؤدي إلى تصفيته من الأجهزة التي تفتقر إليها. اضبط `android:required="false"` فقط إذا كان تطبيقك يحتوي على مسار بديل لا يستخدم الكاميرا.إذن وقت التشغيلتطبيقك مسؤول عن طلب إذن `CAMERA` من المستخدم في وقت التشغيل قبل فتح جلسة الالتقاط. بدون إذن ممنوح، لن يتمكن SDK من فتح الكاميرا.سيناريو WebViewتستخدم بعض التطبيقات الهجينة Android SDK الأصلي لتدفقات المقاييس الحيوية القياسية، بينما تعرض رحلات محددة (كتدفقات التأهيل المخصصة أو التجارب الخاصة بالمنطقة) عبر Web SDK داخل WebView. إذا كان تطبيقك يتبع هذا النمط، فستكون هناك حاجة إلى أذونات إضافية. راجع [دليل تكامل Web SDK](/ar/developers/sdks-and-tools/web) للاطلاع على القائمة الكاملة.آخر تحديث في 8 أكتوبر 2026**