मुख्य सामग्री पर जाएं

इंस्टॉलेशन

Markdown

अपने प्रोजेक्ट में SDK कॉन्फ़िगर करने के लिए, इन चरणों का पालन करें:

चरण 1 — Maven रिपोजिटरी जोड़ें

Android SDK Unico की अपनी Maven रिपोजिटरी के माध्यम से वितरित किया जाता है। इसे अपनी settings.gradle फ़ाइल के dependencyResolutionManagement ब्लॉक में जोड़ें:

settings.gradle.kts
dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven("https://maven-sdk.unico.run/sdk-mobile")
  }
}
पुराने प्रोजेक्ट्स

यदि आप अभी भी रिपॉजिटरी घोषित करने के लिए root-level 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 केवल तभी जोड़ें यदि आपका प्रोजेक्ट अभी भी legacy support-library artifacts पर निर्भर है जो AndroidX में माइग्रेट नहीं हुए हैं — इसे अनावश्यक रूप से सक्षम करने से बिल्ड समय बढ़ता है।

चरण 3 — SDK dependency जोड़ें

अपनी module-level build फ़ाइल के dependencies ब्लॉक में io.unico:capture जोड़ें। <latest_version> को वर्तमान संस्करण (6.13.0) से बदलें — नवीनतम के लिए Release Notes देखें:

app/build.gradle.kts (module)
dependencies {
  implementation("io.unico:capture:<latest_version>")
}
लेगेसी पैकेज नामकरण

Java/Kotlin पैकेज com.acesso.acessobio_android legacy Acesso Digital branding को दर्शाता है और यह इस SDK संस्करण के लिए नहीं बदलेगा। इसी SDK को API Reference और अन्य Unico सामग्री में UnicoCheck के रूप में संदर्भित किया जाता है।

चरण 4 — Java compatibility सेट करें

SDK के न्यूनतम समर्थित API लेवल (26) के साथ compatibility के लिए आवश्यक है। उसी module-level build फ़ाइल में compileOptions में निम्नलिखित जोड़ें:

app/build.gradle.kts (module)
android {
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
  }
}
चरण 5 — AndroidManifest permissions जोड़ें

अपने AndroidManifest.xml में न्यूनतम आवश्यक permissions और hardware feature declaration जोड़ें:

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 delivery filtering

<uses-feature> declaration Play Store को संकेत देता है कि ऐप को कैमरे की आवश्यकता है, जिससे यह उन डिवाइसों के लिए फ़िल्टर हो जाता है जिनमें कैमरा नहीं है। android:required="false" केवल तभी सेट करें जब आपके ऐप में camera-free fallback path हो।

Runtime permission

आपका ऐप कैप्चर सत्र खोलने से पहले runtime पर उपयोगकर्ता से CAMERA permission अनुरोध करने के लिए ज़िम्मेदार है। अनुमति प्रदान किए बिना, SDK कैमरा नहीं खोल पाएगा।

WebView परिदृश्य

कुछ hybrid apps मानक biometric flows के लिए native Android SDK का उपयोग करते हैं, जबकि विशिष्ट यात्राएं (जैसे custom onboarding flows या क्षेत्र-विशिष्ट अनुभव) WebView के अंदर Web SDK के माध्यम से render करते हैं। यदि आपका ऐप इस pattern का पालन करता है, तो अतिरिक्त permissions आवश्यक हैं। पूरी सूची के लिए Web SDK integration guide देखें।

अंतिम अपडेट को