बिल्ड डिपेंडेंसी जोड़ना

Android Studio का Gradle बिल्ड सिस्टम आपको बाहरी सोर्स को शामिल करने देता है डिपेंडेंसी के तौर पर आपके बिल्ड में बाइनरी या अन्य लाइब्रेरी मॉड्यूल. कॉन्टेंट बनाने डिपेंडेंसी आपकी मशीन या रिमोट रिपॉज़िटरी में मौजूद हो सकती हैं. इसके अलावा, डेवलपर की ओर से तय की गई ट्रांज़िटिव डिपेंडेंसी भी अपने-आप शामिल हो जाती हैं. इस पेज में बताया गया है कि अपने Android प्रोजेक्ट के साथ डिपेंडेंसी इस्तेमाल कैसे करें. इसमें यह जानकारी भी शामिल है उन व्यवहार और कॉन्फ़िगरेशन के बारे में जानकारी जो खास तौर पर काम करते हैं तो Android Gradle प्लग इन (AGP) का इस्तेमाल किया जाएगा. Gradle को कॉन्सेप्ट के बारे में बेहतर जानकारी देने वाली गाइड निर्भरता के दौरान, आपको डिपेंडेंसी मैनेजमेंट के लिए Gradle गाइड —लेकिन याद रखें कि आपके Android प्रोजेक्ट को इस पेज पर बताए गए डिपेंडेंसी कॉन्फ़िगरेशन.

कोई लाइब्रेरी या प्लगिन डिपेंडेंसी जोड़ना

बिल्ड डिपेंडेंसी जोड़ने और मैनेज करने का सबसे अच्छा तरीका, वर्शन कैटलॉग, वह तरीका है जिसे नए प्रोजेक्ट डिफ़ॉल्ट रूप से इस्तेमाल करते हैं. इस सेक्शन में, सबसे आम Android प्रोजेक्ट के लिए इस्तेमाल किए जाने वाले कॉन्फ़िगरेशन के टाइप; यह देखें Gredle से जुड़ा दस्तावेज़ देखें. वर्शन कैटलॉग का इस्तेमाल करने वाले ऐप्लिकेशन के उदाहरण के लिए, देखें अब Android में. अगर आपने पहले से ही बिल्ड डिपेंडेंसी सेट अप की हुई है और मल्टी-मॉड्यूल प्रोजेक्ट के बिना वर्शन कैटलॉग के नहीं हैं, तो हमारा सुझाव है कि माइग्रेट करने की सुविधा.

नेटिव डिपेंडेंसी (सामान्य नहीं) को जोड़ने और मैनेज करने के बारे में दिशा-निर्देश पाने के लिए, यहां देखें नेटिव डिपेंडेंसी.

नीचे दिए गए उदाहरण में, हमने रिमोट बाइनरी डिपेंडेंसी (Jetpack मैक्रोबेंचमार्क लाइब्रेरी), लोकल लाइब्रेरी मॉड्यूल डिपेंडेंसी (myLibrary), और एक प्लगिन निर्भरता (Android Gradle प्लग इन) को लागू किया जाता है. यहां सामान्य अपने प्रोजेक्ट में ये डिपेंडेंसी जोड़ने का तरीका:

1. डिपेंडेंसी के उस वर्शन के लिए उपनाम जोड़ें जिसे आपको इसमें जोड़ना है वर्शन कैटलॉग फ़ाइल का [versions] सेक्शन, जिसे libs.versions.toml (इसमें gradle डायरेक्ट्री के तहत Android व्यू में प्रोजेक्ट व्यू या ग्रेडल स्क्रिप्ट):

   [versions]
   agp = "8.3.0"
   androidx-macro-benchmark = "1.2.2"
   my-library = "1.4"
   
   [libraries]
   ...
   
   [plugins]
   ...
   

   उपनाम में डैश या अंडरस्कोर शामिल हो सकते हैं. ये उपनाम, नेस्ट की गई वैल्यू जनरेट करते हैं आप बिल्ड स्क्रिप्ट में संदर्भ दे सकते हैं. संदर्भ कैटलॉग, libs.versions.toml का libs हिस्सा है. टास्क कब शुरू होगा सिंगल वर्शन कैटलॉग का इस्तेमाल करते हैं, तो हमारा सुझाव है कि आप "libs."

2. [libraries] में डिपेंडेंसी के लिए कोई उपनाम जोड़ें (इसके लिए रिमोट बाइनरी या लोकल लाइब्रेरी मॉड्यूल) या [plugins] (के लिए प्लगिन) सेक्शन libs.versions.toml फ़ाइल में जोड़ें.

   [versions]
   ...
   
   [libraries]
   androidx-benchmark-macro = { group = "androidx.benchmark", name = "benchmark-macro-junit4", version.ref = "androidx-macro-benchmark" }
   my-library = { group = "com.myapplication", name = "mylibrary", version.ref = "my-library" }
   
   [plugins]
   androidApplication = { id = "com.android.application", version.ref = "agp" }
   

   कुछ लाइब्रेरी, पब्लिश किए गए उस बिल ऑफ़ मटीरियल (बीओएम) में उपलब्ध हैं जो लाइब्रेरी के परिवारों और उनके वर्शन का समूह है. आप अपने वर्शन कैटलॉग बनाने और फ़ाइलें बनाने की अनुमति देता है. साथ ही, इसे आपके लिए उन वर्शन को मैनेज करने देता है. यहां जाएं: ज़्यादा जानकारी के लिए, बिल ऑफ़ मटीरियल का इस्तेमाल करना.

3. इसकी बिल्ड स्क्रिप्ट में डिपेंडेंसी एलियास का रेफ़रंस जोड़ें मॉड्यूल जिनके लिए डिपेंडेंसी की ज़रूरत होती है. उपनाम को बदलें' अंडरस्कोर और डैश डॉट तक ले जाता है. हमारी मॉड्यूल-लेवल बिल्ड स्क्रिप्ट ऐसा दिखेगा:

   Kotlin

   plugins {
     alias(libs.plugins.androidApplication)
   }
   
   dependencies {
     implementation(libs.androidx.benchmark.macro)
     implementation(libs.my.library)
   }
   

   ग्रूवी

   plugins {
     alias 'libs.plugins.androidApplication'
   }
   
   dependencies {
     implementation libs.androidx.benchmark.macro
     implementation libs.my.library
   }
   

   प्लग इन के रेफ़रंस में, कैटलॉग के नाम के बाद plugins शामिल होता है और वर्शन के रेफ़रंस में कैटलॉग के नाम (वर्शन) के बाद versions शामिल होता है रेफ़रंस असामान्य हैं; डिपेंडेंसी देखें वर्शन रेफ़रंस के उदाहरणों के लिए, एक जैसे वर्शन नंबर इस्तेमाल करें. लाइब्रेरी रेफ़रंस में libraries क्वालीफ़ायर शामिल नहीं है. इसलिए, इसका इस्तेमाल नहीं किया जा सकता लाइब्रेरी की शुरुआत में, versions या plugins उपनाम.

डिपेंडेंसी कॉन्फ़िगर करें

dependencies ब्लॉक में, किसी एक का इस्तेमाल करके लाइब्रेरी डिपेंडेंसी का एलान किया जा सकता है कई अलग-अलग डिपेंडेंसी कॉन्फ़िगरेशन में से (जैसे, implementation दिखाया गया) ) में शामिल किया गया है. हर डिपेंडेंसी कॉन्फ़िगरेशन, Gradle को अलग-अलग डिपेंडेंसी इस्तेमाल करने के तरीके से जुड़े निर्देश. नीचे दी गई टेबल में, कॉन्फ़िगरेशन के बारे में ज़्यादा जानकारी मौजूद है.

dependencies {
  // Executes lint checks from the ":checks" project at build time.
  lintChecks(project(":checks"))
  // Compiles lint checks from the ":checks-to-publish" into a
  // lint.jar file and publishes it to your Android library.
  lintPublish(project(":checks-to-publish"))
}

dependencies {
  // Executes lint checks from the ':checks' project at build time.
  lintChecks project(':checks')
  // Compiles lint checks from the ':checks-to-publish' into a
  // lint.jar file and publishes it to your Android library.
  lintPublish project(':checks-to-publish')
}

बिल्ड के किसी खास वैरिएंट के लिए डिपेंडेंसी कॉन्फ़िगर करना

पिछले सभी कॉन्फ़िगरेशन, बिल्ड के सभी वैरिएंट पर डिपेंडेंसी लागू करते हैं. अगर आपने आपको किसी खास बिल्ड के लिए डिपेंडेंसी का एलान करना हो वैरिएंट सोर्स सेट या टेस्टिंग सोर्स के लिए सेट है, तो आपको कॉन्फ़िगरेशन में कैपिटल लेटर का इस्तेमाल करना होगा नाम और प्रीफ़िक्स के तौर पर बिल्ड वैरिएंट या टेस्टिंग सोर्स सेट का नाम जोड़ें.

उदाहरण के लिए, रिमोट बाइनरी डिपेंडेंसी को सिर्फ़ "मुफ़्त" में जोड़ने के लिए प्रॉडक्ट फ़्लेवर की जानकारी देने के लिए implementation कॉन्फ़िगरेशन का इस्तेमाल करें, इसका इस्तेमाल करें:

dependencies {
    freeImplementation("com.google.firebase:firebase-ads:21.5.1")
}

dependencies {
    freeImplementation 'com.google.firebase:firebase-ads:21.5.1'
}

हालांकि, अगर आपको प्रॉडक्ट को जोड़ने वाले वैरिएंट के लिए डिपेंडेंसी जोड़नी है फ़्लेवर और बिल्ड टाइप है, तो आपको कॉन्फ़िगरेशन का नाम शुरू करना होगा:

// Initializes a placeholder for the freeDebugImplementation dependency configuration.
val freeDebugImplementation by configurations.creating

dependencies {
    freeDebugImplementation(project(":free-support"))
}

configurations {
    // Initializes a placeholder for the freeDebugImplementation dependency configuration.
    freeDebugImplementation {}
}

dependencies {
    freeDebugImplementation project(":free-support")
}

अपने लोकल टेस्ट और इंस्ट्रुमेंट्ड टेस्ट के लिए, implementation डिपेंडेंसी जोड़ने के लिए , तो यह इस तरह दिखेगा:

dependencies {
    // Adds a remote binary dependency only for local tests.
    testImplementation("junit:junit:4.12")

    // Adds a remote binary dependency only for the instrumented test APK.
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
}

dependencies {
    // Adds a remote binary dependency only for local tests.
    testImplementation 'junit:junit:4.12'

    // Adds a remote binary dependency only for the instrumented test APK.
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

हालांकि, इस स्थिति में कुछ कॉन्फ़िगरेशन का कोई मतलब नहीं निकलता. उदाहरण के लिए, ऐसा इसलिए होता है, क्योंकि अन्य मॉड्यूल androidTest पर निर्भर नहीं हो सकते. इसलिए, आपको ये मिलते हैं androidTestApi कॉन्फ़िगरेशन का इस्तेमाल करने पर चेतावनी:

WARNING: Configuration 'androidTestApi' is obsolete and has been replaced with
'androidTestImplementation'.

डिपेंडेंसी ऑर्डर

अपनी डिपेंडेंसी के क्रम से पता चलता है कि हर एक की प्राथमिकता किस क्रम में है: पहली लाइब्रेरी की प्राथमिकता दूसरी से ज़्यादा है और दूसरी लाइब्रेरी ज़्यादा है प्राथमिकता तय करते समय तीसरी प्राथमिकता दी जाएगी. यह क्रम तब अहम होता है, जब संसाधनों को मर्ज कर दिया जाता है या मेनिफ़ेस्ट एलिमेंट मर्ज कर दिए गए हैं लाइब्रेरी से आपके ऐप्लिकेशन में अपडेट करने की सुविधा मिलती है.

उदाहरण के लिए, अगर आपका प्रोजेक्ट इनके बारे में एलान करता है:

• LIB_A और LIB_B पर निर्भरता (इस क्रम में)
• LIB_A, LIB_C और LIB_D पर निर्भर करता है (इस क्रम में)
• LIB_B, LIB_C पर भी निर्भर करता है

फिर, फ़्लैट डिपेंडेंसी ऑर्डर इस तरह होगा:

1. LIB_A
2. LIB_D
3. LIB_B
4. LIB_C

इससे पक्का होता है कि LIB_A और LIB_B, दोनों को बदला जा सकता है LIB_C; और LIB_D अब भी इससे ज़्यादा प्राथमिकता है LIB_B की वजह से LIB_A (जो इस पर निर्भर करता है) की प्राथमिकता LIB_B से ज़्यादा है.

अलग-अलग प्रोजेक्ट के मेनिफ़ेस्ट कैसे किए जाते हैं, इस बारे में ज़्यादा जानकारी पाने के लिए सोर्स/डिपेंडेंसी मर्ज की गई हों, तो एक से ज़्यादा मेनिफ़ेस्ट फ़ाइलें मर्ज करना.

Play Console पर डिपेंडेंसी से जुड़ी जानकारी

आपका ऐप्लिकेशन बनाते समय, एजीपी में लाइब्रेरी की जानकारी देने वाला मेटाडेटा शामिल किया जाता है डिपेंडेंसी जो आपके ऐप्लिकेशन में इकट्ठा की जाती हैं. आपका ऐप्लिकेशन अपलोड करते समय, Play Console, इस मेटाडेटा की जांच करता है, ताकि SDK टूल से जुड़ी सामान्य समस्याओं के बारे में चेतावनी दी जा सके और आपका ऐप्लिकेशन किन डिपेंडेंसी का इस्तेमाल करता है और कुछ मामलों में, कार्रवाई करने लायक सुझाव देता है, ताकि उन समस्याओं को हल करें.

डेटा को कंप्रेस किया जाता है, Google Play के साइनिंग पासकोड से एन्क्रिप्ट (सुरक्षित) किया जाता है, और आपके रिलीज़ ऐप्लिकेशन का साइनिंग ब्लॉक. हमारा सुझाव है कि इन डिपेंडेंसी को बनाए रखें फ़ाइल को सुरक्षित और सकारात्मक उपयोगकर्ता अनुभव देने के लिए डिज़ाइन किया गया है. आप फ़ॉलो किया जा रहा है dependenciesInfo ब्लॉक को अपने मॉड्यूल की build.gradle.kts फ़ाइल में रखें.

android {
    dependenciesInfo {
        // Disables dependency metadata when building APKs.
        includeInApk = false
        // Disables dependency metadata when building Android App Bundles.
        includeInBundle = false
    }
}

हमारी नीतियों और डिपेंडेंसी से जुड़ी संभावित समस्याओं के बारे में ज़्यादा जानने के लिए, यहां देखें पर हमारा सहायता पेज अपने ऐप्लिकेशन में तीसरे पक्ष के SDK टूल का इस्तेमाल करके.

SDK टूल की अहम जानकारी

Android Studio, वर्शन कैटलॉग फ़ाइल और प्रोजेक्ट में लिंट से जुड़ी चेतावनियां दिखाता है स्ट्रक्चर्ड डायलॉग Google Play SDK Index, जब ये समस्याएं लागू होती हैं:

• एसडीके टूल को उनके लेखकों ने पुराने वर्शन के तौर पर मार्क किया है.
• SDK टूल, Google Play की नीतियों का उल्लंघन करते हैं.

चेतावनियां ऐसे सिग्नल हैं जिनसे आपको उन डिपेंडेंसी को अपडेट करना चाहिए, क्योंकि ऐप्लिकेशन के पुराने वर्शन का इस्तेमाल करने से, हो सकता है कि आप Google Play पर ऐप्लिकेशन पब्लिश न कर पाएं आने वाले समय में कंसोल.

वर्शन कैटलॉग के बिना बिल्ड डिपेंडेंसी जोड़ना

हमारा सुझाव है कि डिपेंडेंसी जोड़ने और मैनेज करने के लिए, वर्शन कैटलॉग का इस्तेमाल करें. हालांकि, यह इस्तेमाल में आसान है शायद प्रोजेक्ट को उनकी ज़रूरत न हो. यहां बिल्ड फ़ाइल का उदाहरण दिया गया है, जो वर्शन कैटलॉग:

plugins {
    id("com.android.application")
}

android { ... }

dependencies {
    // Dependency on a remote binary
    implementation("com.example.android:app-magic:12.3")
    // Dependency on a local library module
    implementation(project(":mylibrary"))
}

plugins {
    id 'com.android.application'
}

android { ... }

dependencies {
    // Dependency on a remote binary
    implementation 'com.example.android:app-magic:12.3'
    // Dependency on a local library module
    implementation project(':mylibrary')
}

यह बिल्ड फ़ाइल, "app-magic" के 12.3 वर्शन पर डिपेंडेंसी का एलान करती है लाइब्रेरी, "com.example.android" में नेमस्पेस ग्रुप. रिमोट बाइनरी डिपेंडेंसी का एलान इनके लिए शॉर्टहैंड है:

implementation(group = "com.example.android", name = "app-magic", version = "12.3")

implementation group: 'com.example.android', name: 'app-magic', version: '12.3'

बिल्ड फ़ाइल, नाम वाले Android लाइब्रेरी मॉड्यूल पर निर्भर होने के बारे में भी बताती है "mylibrary"; यह नाम include: से तय किए गए लाइब्रेरी नाम से मेल खाना चाहिए आपकी settings.gradle.kts फ़ाइल. ऐप्लिकेशन बनाते समय, बिल्ड सिस्टम यह लाइब्रेरी मॉड्यूल को इकट्ठा करता है और इससे इकट्ठा किए गए कॉन्टेंट को है.

बिल्ड फ़ाइल, 'Android Gradle प्लग इन' पर डिपेंडेंसी का एलान भी करती है (com.application.android). अगर आपके पास एक ही मॉड्यूल का इस्तेमाल करने वाले कई मॉड्यूल हैं प्लगिन नहीं है, तो आपके पास बिल्ड क्लासपाथ पर प्लगिन का सिर्फ़ एक वर्शन हो सकता है सभी मॉड्यूल में उपलब्ध है. हर मॉड्यूल में वर्शन तय करने के बजाय बिल्ड स्क्रिप्ट, आपको रूट बिल्ड स्क्रिप्ट में प्लगिन डिपेंडेंसी शामिल करनी चाहिए बदलाव करें और इसे लागू न करने का संकेत दें. apply false जोड़ने से यह पता चलता है Gradle, ताकि प्लगिन के वर्शन को नोट किया जा सके, लेकिन रूट बिल्ड में उसका इस्तेमाल न किया जा सके. आम तौर पर, रूट बिल्ड स्क्रिप्ट सिर्फ़ plugins ब्लॉक के अलावा खाली होती है.

plugins {
    id("org.jetbrains.kotlin.android") version "1.9.0" apply false
}

plugins {
    id ‘com.android.application’ version ‘8.3.0-rc02’ apply false
}

अगर आपके पास सिंगल-मॉड्यूल प्रोजेक्ट है, तो आप वर्शन को साफ़ तौर पर इसमें बता सकते हैं को मॉड्यूल-लेवल की बिल्ड स्क्रिप्ट में डालें और प्रोजेक्ट-लेवल की बिल्ड स्क्रिप्ट को खाली छोड़ दें:

plugins {
    id("com.android.application") version "8.3.0"
}

plugins {
    id 'com.android.application' version '8.3.0-rc02'
}