الانتقال إلى المحتوى الرئيسي

التثبيت

Markdown

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

الخطوة 1 — إضافة مستودع Maven

يتم توزيع Android SDK من خلال مستودع Maven الخاص بـ Unico. أضفه إلى كتلة dependencyResolutionManagement في ملف settings.gradle:

settings.gradle.kts
dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven("https://maven-sdk.unico.run/sdk-mobile")
  }
}
المشاريع القديمة

إذا كنت لا تزال تستخدم build.gradle/build.gradle.kts على مستوى الجذر لتعريف المستودعات، فأضف مستودع Unico إلى كتلة allprojects بدلاً من ذلك:

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    mavenCentral()
    maven("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

أضف io.unico:capture إلى كتلة dependencies في ملف البناء على مستوى الوحدة. استبدل <latest_version> بالإصدار الحالي (6.13.0) — راجع ملاحظات الإصدار للاطلاع على الأحدث:

app/build.gradle.kts (module)
dependencies {
  implementation("io.unico:capture:<latest_version>")
}
تسمية الحزمة القديمة

تعكس حزمة Java/Kotlin com.acesso.acessobio_android العلامة التجارية القديمة لـ Acesso Digital ولن تتغير لإصدار SDK هذا. يُشار إلى نفس SDK بـ UnicoCheck في مرجع API ومواد Unico الأخرى.

الخطوة 4 — تعيين توافق Java

مطلوب للتوافق مع الحد الأدنى لمستوى API المدعوم في SDK (26). أضف ما يلي إلى compileOptions في ملف البناء على مستوى الوحدة نفسه:

app/build.gradle.kts (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 للاطلاع على القائمة الكاملة.

آخر تحديث في