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

التثبيت

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

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

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

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    maven { url = uri("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.5.0) — راجع ملاحظات الإصدار للاطلاع على الأحدث:

app/build.gradle.kts (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 في ملف البناء على مستوى الوحدة نفسه:

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 للاطلاع على القائمة الكاملة.

آخر تحديث في