इंस्टॉलेशन
अपने प्रोजेक्ट में SDK कॉन्फ़िगर करने के लिए, इन चरणों का पालन करें:
चरण 1 — Maven रिपोजिटरी जोड़ें
Android SDK Unico की अपनी Maven रिपोजिटरी के माध्यम से वितरित किया जाता है। इसे अपनी root-level build फ़ाइल के repositories ब्लॉक में जोड़ें:
- build.gradle.kts
- build.gradle
allprojects {
repositories {
google()
maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }
}
}
allprojects {
repositories {
google()
maven { url "https://maven-sdk.unico.run/sdk-mobile" }
}
}
चरण 2 — AndroidX सपोर्ट सक्षम करें (यदि आवश्यक हो)
प्रोजेक्ट रूट पर gradle.properties में निम्नलिखित जोड़ें:
android.useAndroidX=true
AGP 8.6+ प्रोजेक्ट्स में, Jetifier डिफ़ॉल्ट रूप से अक्षम होता है। android.enableJetifier=true केवल तभी जोड़ें यदि आपका प्रोजेक्ट अभी भी legacy support-library artifacts पर निर्भर है जो AndroidX में माइग्रेट नहीं हुए हैं — इसे अनावश्यक रूप से सक्षम करने से बिल्ड समय बढ़ता है।
चरण 3 — SDK dependency जोड़ें
अपनी module-level build फ़ाइल के dependencies ब्लॉक में acessobio-android जोड़ें। <latest_version> को वर्तमान संस्करण (6.5.0) से बदलें — नवीनतम के लिए Release Notes देखें:
- build.gradle.kts
- build.gradle
dependencies {
implementation("com.acesso:acessobio-android:<latest_version>")
}
dependencies {
implementation 'com.acesso:acessobio-android:<latest_version>'
}
Maven group com.acesso और artifact name acessobio-android legacy Acesso Digital branding को दर्शाते हैं — ये प्रकाशित artifact identifiers हैं और इस SDK संस्करण के लिए नहीं बदलेंगे। इसी SDK को API Reference और अन्य Unico सामग्री में UnicoCheck के रूप में संदर्भित किया जाता है।
चरण 4 — Java compatibility सेट करें
SDK के न्यूनतम समर्थित API लेवल (26) के साथ compatibility के लिए आवश्यक है। उसी module-level build फ़ाइल में compileOptions में निम्नलिखित जोड़ें:
- build.gradle.kts
- build.gradle
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
}
}
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
चरण 5 — AndroidManifest permissions जोड़ें
अपने AndroidManifest.xml में न्यूनतम आवश्यक permissions और hardware feature declaration जोड़ें:
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature> declaration Play Store को संकेत देता है कि ऐप को कैमरे की आवश्यकता है, जिससे यह उन डिवाइसों के लिए फ़िल्टर हो जाता है जिनमें कैमरा नहीं है। android:required="false" केवल तभी सेट करें जब आपके ऐप में camera-free fallback path हो।
आपका ऐप कैप्चर सत्र खोलने से पहले runtime पर उपयोगकर्ता से CAMERA permission अनुरोध करने के लिए ज़िम्मेदार है। अनुमति प्रदान किए बिना, SDK कैमरा नहीं खोल पाए गा।
कुछ hybrid apps मानक biometric flows के लिए native Android SDK का उपयोग करते हैं, जबकि विशिष्ट यात्राएं (जैसे legacy onboarding flows या क्षेत्र-विशिष्ट अनुभव) WebView के अंदर Web SDK के माध्यम से render करते हैं। यदि आपका ऐप इस pattern का पालन करता है, तो अतिरिक्त permissions आवश्यक हैं। पूरी सूची के लिए Web SDK integration guide देखें।