एक से ज़्यादा APK बनाएं

हालांकि, जब भी संभव हो, अपने सभी टारगेट डिवाइसों के साथ काम करने वाला एक APK बनाना बेहतर होता है. हालांकि, ऐसा करने पर APK का साइज़ बहुत बड़ा हो सकता है. ऐसा इसलिए, क्योंकि इसमें कई ऐप्लिकेशन बाइनरी इंटरफ़ेस (एबीआई) के साथ काम करने वाली फ़ाइलें होती हैं. APK का साइज़ कम करने का एक तरीका यह है कि एक से ज़्यादा APK बनाएं. इनमें खास एबीआई के लिए फ़ाइलें शामिल होनी चाहिए.

Gradle, अलग-अलग APK बना सकता है. इनमें सिर्फ़ हर एबीआई के लिए खास कोड और संसाधन शामिल होते हैं. इस पेज पर, एक से ज़्यादा APK जनरेट करने के लिए, बिल्ड को कॉन्फ़िगर करने का तरीका बताया गया है. अगर आपको अपने ऐप्लिकेशन के ऐसे अलग-अलग वर्शन बनाने हैं जो एबीआई पर आधारित नहीं हैं, तो इसके बजाय बिल्ड के वैरिएंट का इस्तेमाल करें.

एक से ज़्यादा APK के लिए अपना बिल्ड कॉन्फ़िगर करना

एक से ज़्यादा APK के लिए अपना बिल्ड कॉन्फ़िगर करने के लिए, मॉड्यूल-लेवल की build.gradle फ़ाइल में splits ब्लॉक जोड़ें. splits ब्लॉक में, abi ब्लॉक दें. इससे यह तय होता है कि Gradle को हर एबीआई के लिए APK कैसे जनरेट करने हैं.

एबीआई के लिए कई APK कॉन्फ़िगर करना

अलग-अलग एबीआई के लिए अलग-अलग APK बनाने के लिए, अपने splits ब्लॉक में abi ब्लॉक जोड़ें. अपने abi ब्लॉक में, चुने गए एबीआई की सूची दें.

हर एबीआई के लिए कई APK कॉन्फ़िगर करने के लिए, Gradle DSL के इन विकल्पों का इस्तेमाल किया जाता है:

enable Groovy के लिए या isEnable Kotlin स्क्रिप्ट के लिए
अगर इस एलिमेंट को true पर सेट किया जाता है, तो Gradle आपके तय किए गए एबीआई के आधार पर कई APK जनरेट करता है. डिफ़ॉल्ट वैल्यू false है.
exclude
इससे कॉमा लगाकर अलग की गई उन एबीआई की सूची के बारे में पता चलता है जिनके लिए आपको Gradle से अलग-अलग APK जनरेट नहीं कराने हैं. exclude का इस्तेमाल तब करें, जब आपको ज़्यादातर एबीआई के लिए APK जनरेट करने हों, लेकिन कुछ ऐसे एबीआई को बाहर रखना हो जो आपके ऐप्लिकेशन के साथ काम नहीं करते.
reset()

यह एबीआई की डिफ़ॉल्ट सूची को हटा देता है. इसका इस्तेमाल सिर्फ़ तब करें, जब आपको जोड़े जाने वाले एबीआई की जानकारी देने के लिए, include एलिमेंट के साथ जोड़ा गया हो.

यहां दिया गया स्निपेट, एबीआई की सूची को सिर्फ़ x86 और x86_64 पर सेट करता है. इसके लिए, सूची को मिटाने के लिए reset() को कॉल किया जाता है. इसके बाद, include का इस्तेमाल किया जाता है:

reset()                 // Clears the default list from all ABIs to no ABIs.
include "x86", "x86_64" // Specifies the two ABIs we want to generate APKs for.
include

इसमें कॉमा लगाकर अलग की गई उन एबीआई की सूची दी जाती है जिनके लिए आपको Gradle से APK जनरेट कराने हैं. एबीआई की सटीक सूची तय करने के लिए, इसका इस्तेमाल सिर्फ़ reset() के साथ करें.

universalApk Groovy के लिए या isUniversalApk Kotlin स्क्रिप्ट के लिए

अगर true है, तो Gradle हर एबीआई के लिए APK के साथ-साथ एक यूनिवर्सल APK भी जनरेट करता है. यूनिवर्सल APK में, एक ही APK में सभी एबीआई के लिए कोड और संसाधन शामिल होते हैं. डिफ़ॉल्ट वैल्यू false है.

यहां दिए गए उदाहरण में, हर एबीआई के लिए एक अलग APK जनरेट किया गया है: x86 और x86_64. इसके लिए, reset() का इस्तेमाल करके एबीआई की खाली सूची से शुरुआत की जाती है. इसके बाद, include का इस्तेमाल करके एबीआई की सूची बनाई जाती है. इसमें हर एबीआई को एक APK मिलता है.

Groovy

android {
  ...
  splits {

    // Configures multiple APKs based on ABI.
    abi {

      // Enables building multiple APKs per ABI.
      enable true

      // By default all ABIs are included, so use reset() and include to specify that you only
      // want APKs for x86 and x86_64.

      // Resets the list of ABIs for Gradle to create APKs for to none.
      reset()

      // Specifies a list of ABIs for Gradle to create APKs for.
      include "x86", "x86_64"

      // Specifies that you don't want to also generate a universal APK that includes all ABIs.
      universalApk false
    }
  }
}

Kotlin

android {
  ...
  splits {

    // Configures multiple APKs based on ABI.
    abi {

      // Enables building multiple APKs per ABI.
      isEnable = true

      // By default all ABIs are included, so use reset() and include to specify that you only
      // want APKs for x86 and x86_64.

      // Resets the list of ABIs for Gradle to create APKs for to none.
      reset()

      // Specifies a list of ABIs for Gradle to create APKs for.
      include("x86", "x86_64")

      // Specifies that you don't want to also generate a universal APK that includes all ABIs.
      isUniversalApk = false
    }
  }
}

इस्तेमाल किए जा सकने वाले एबीआई की सूची देखने के लिए, इस्तेमाल किए जा सकने वाले एबीआई पर जाएं.

नेटिव/C++ कोड के बिना बनाए गए प्रोजेक्ट

बिना नेटिव/C++ कोड वाले प्रोजेक्ट के लिए, बिल्ड के वैरिएंट पैनल में दो कॉलम होते हैं: मॉड्यूल और ऐक्टिव बिल्ड वैरिएंट, जैसा कि इमेज 1 में दिखाया गया है.

नेटिव/C++ कोड के बिना बनाए गए प्रोजेक्ट के लिए, बिल्ड वैरिएंट पैनल में दो कॉलम होते हैं.
पहली इमेज. बिल्ड के वैरिएंट पैनल में, नेटिव/C++ कोड के बिना बनाए गए प्रोजेक्ट के लिए दो कॉलम होते हैं.

मॉड्यूल के लिए ऐक्टिव बिल्ड वैरिएंट की वैल्यू से, बिल्ड का वैरिएंट तय होता है. यह वैरिएंट, एडिटर में डिप्लॉय किया जाता है और दिखता है. एक वैरिएंट से दूसरे वैरिएंट पर स्विच करने के लिए, किसी मॉड्यूल के लिए Active Build Variant सेल पर क्लिक करें. इसके बाद, सूची वाले फ़ील्ड से अपना पसंदीदा वैरिएंट चुनें.

नेटिव/C++ कोड वाले प्रोजेक्ट

नेटिव/C++ कोड वाले प्रोजेक्ट के लिए, बिल्ड के वैरिएंट पैनल में तीन कॉलम होते हैं: मॉड्यूल, चालू बिल्ड वैरिएंट, और चालू एबीआई. इन्हें इमेज 2 में दिखाया गया है.

बिल्ड वैरिएंट पैनल, नेटिव/C++ कोड वाले प्रोजेक्ट के लिए, ऐक्टिव एबीआई कॉलम जोड़ता है.
दूसरी इमेज. बिल्ड के वैरिएंट पैनल, नेटिव/C++ कोड वाले प्रोजेक्ट के लिए ऐक्टिव एबीआई कॉलम जोड़ता है.

मॉड्यूल के लिए Active Build Variant की वैल्यू से, बिल्ड के वैरिएंट का पता चलता है. यह वैरिएंट, डिप्लॉय किया जाता है और एडिटर में दिखता है. नेटिव मॉड्यूल के लिए, ऐक्टिव एबीआई वैल्यू से यह तय होता है कि एडिटर किस एबीआई का इस्तेमाल करेगा. हालांकि, इससे डिप्लॉय किए गए मॉड्यूल पर कोई असर नहीं पड़ता.

बिल्ड टाइप या एबीआई बदलने के लिए:

  1. ऐक्टिव बिल्ड वैरिएंट या ऐक्टिव एबीआई कॉलम के लिए सेल पर क्लिक करें.
  2. सूची फ़ील्ड से, अपना चुना हुआ वैरिएंट या एबीआई चुनें. सिंक होने की नई प्रोसेस अपने-आप शुरू हो जाती है.

किसी ऐप्लिकेशन या लाइब्रेरी मॉड्यूल के लिए, इनमें से किसी भी कॉलम में बदलाव करने पर, वह बदलाव उस पर निर्भर सभी लाइनों पर लागू होता है.

वर्शनिंग कॉन्फ़िगर करना

डिफ़ॉल्ट रूप से, जब Gradle कई APK जनरेट करता है, तो हर APK में वर्शन की जानकारी एक जैसी होती है. यह जानकारी, मॉड्यूल-लेवल की build.gradle या build.gradle.kts फ़ाइल में दी गई जानकारी के मुताबिक होती है. Google Play Store, एक ही ऐप्लिकेशन के लिए ऐसे कई APK की अनुमति नहीं देता है जिनमें वर्शन की जानकारी एक जैसी हो. इसलिए, Play Store पर APK अपलोड करने से पहले, आपको यह पक्का करना होगा कि हर APK का versionCode यूनीक हो.

हर APK के लिए versionCode को बदलने के लिए, मॉड्यूल-लेवल की build.gradle फ़ाइल को कॉन्फ़िगर किया जा सकता है. एक ऐसी मैपिंग बनाकर जो हर उस एबीआई के लिए एक यूनीक न्यूमेरिक वैल्यू असाइन करती है जिसके लिए आपने कई APK कॉन्फ़िगर किए हैं, आउटपुट वर्शन कोड को ऐसी वैल्यू से बदला जा सकता है जो defaultConfig या productFlavors ब्लॉक में तय किए गए वर्शन कोड को एबीआई को असाइन की गई न्यूमेरिक वैल्यू के साथ जोड़ती है.

यहां दिए गए उदाहरण में, x86 एबीआई के लिए APK को 2004 का versionCode मिलता है. साथ ही, x86_64 एबीआई को 3004 का versionCode मिलता है.

वर्शन कोड को 1,000 जैसी बड़ी संख्या में बढ़ाने पर, बाद में ऐप्लिकेशन को अपडेट करने के लिए यूनीक वर्शन कोड असाइन किए जा सकते हैं. उदाहरण के लिए, अगर बाद के किसी अपडेट में defaultConfig.versionCode की वैल्यू 5 हो जाती है, तो Gradle, x86 APK को 2005 और x86_64 APK को 3005 का versionCode असाइन करता है.

Groovy

android {
  ...
  defaultConfig {
    ...
    versionCode 4
  }
  splits {
    ...
  }
}

// Map for the version code that gives each ABI a value.
ext.abiCodes = ['armeabi-v7a':1, x86:2, x86_64:3]

import com.android.build.OutputFile

// For each APK output variant, override versionCode with a combination of
// ext.abiCodes * 1000 + variant.versionCode. In this example, variant.versionCode
// is equal to defaultConfig.versionCode. If you configure product flavors that
// define their own versionCode, variant.versionCode uses that value instead.
android.applicationVariants.all { variant ->

  // Assigns a different version code for each output APK
  // other than the universal APK.
  variant.outputs.each { output ->

    // Stores the value of ext.abiCodes that is associated with the ABI for this variant.
    def baseAbiVersionCode =
            // Determines the ABI for this variant and returns the mapped value.
            project.ext.abiCodes.get(output.getFilter(OutputFile.ABI))

    // Because abiCodes.get() returns null for ABIs that are not mapped by ext.abiCodes,
    // the following code doesn't override the version code for universal APKs.
    // However, because you want universal APKs to have the lowest version code,
    // this outcome is desirable.
    if (baseAbiVersionCode != null) {

      // Assigns the new version code to versionCodeOverride, which changes the
      // version code for only the output APK, not for the variant itself. Skipping
      // this step causes Gradle to use the value of variant.versionCode for the APK.
      output.versionCodeOverride =
              baseAbiVersionCode * 1000 + variant.versionCode
    }
  }
}

Kotlin

android {
  ...
  defaultConfig {
    ...
    versionCode = 4
  }
  splits {
    ...
  }
}

// Map for the version code that gives each ABI a value.
val abiCodes = mapOf("armeabi-v7a" to 1, "x86" to 2, "x86_64" to 3)

import com.android.build.api.variant.FilterConfiguration.FilterType.*

// For each APK output variant, override versionCode with a combination of
// abiCodes * 1000 + variant.versionCode. In this example, variant.versionCode
// is equal to defaultConfig.versionCode. If you configure product flavors that
// define their own versionCode, variant.versionCode uses that value instead.
androidComponents {
    onVariants { variant ->

        // Assigns a different version code for each output APK
        // other than the universal APK.
        variant.outputs.forEach { output ->
            val name = output.filters.find { it.filterType == ABI }?.identifier

            // Stores the value of abiCodes that is associated with the ABI for this variant.
            val baseAbiCode = abiCodes[name]
            // Because abiCodes.get() returns null for ABIs that are not mapped by ext.abiCodes,
            // the following code doesn't override the version code for universal APKs.
            // However, because you want universal APKs to have the lowest version code,
            // this outcome is desirable.
            if (baseAbiCode != null) {
                // Assigns the new version code to output.versionCode, which changes the version code
                // for only the output APK, not for the variant itself.
                output.versionCode.set(baseAbiCode * 1000 + (output.versionCode.get() ?: 0))
            }
        }
    }
}

वर्शन कोड की अन्य स्कीम के ज़्यादा उदाहरणों के लिए, वर्शन कोड असाइन करना लेख पढ़ें.

एक से ज़्यादा APK बनाना

एक से ज़्यादा APK बनाने के लिए, मॉड्यूल-लेवल की build.gradle या build.gradle.kts फ़ाइल को कॉन्फ़िगर करने के बाद, प्रोजेक्ट पैनल में चुने गए मॉड्यूल के लिए सभी APK बनाएं. इसके लिए, बनाएं > APK बनाएं पर क्लिक करें. Gradle, प्रोजेक्ट की build/outputs/apk/ डायरेक्ट्री में हर एबीआई के लिए APK बनाता है.

Gradle, हर उस एबीआई के लिए एक APK बनाता है जिसके लिए आपने कई APK कॉन्फ़िगर किए हैं.

उदाहरण के लिए, यहां दिया गया build.gradle स्निपेट, x86 और x86_64 एबीआई के लिए कई APK बनाने की सुविधा चालू करता है:

Groovy

...
  splits {
    abi {
      enable true
      reset()
      include "x86", "x86_64"
    }
  }

Kotlin

...
  splits {
    abi {
      isEnable = true
      reset()
      include("x86", "x86_64")
    }
  }

उदाहरण के तौर पर दिए गए कॉन्फ़िगरेशन के आउटपुट में, ये चार APK शामिल हैं:

  • app-X86-release.apk: इसमें x86 एबीआई के लिए कोड और संसाधन शामिल हैं.
  • app-X86_64-release.apk: इसमें x86_64 एबीआई के लिए कोड और संसाधन शामिल हैं.

एबीआई के आधार पर कई APK बनाते समय, Gradle सिर्फ़ एक ऐसा APK जनरेट करता है जिसमें सभी एबीआई के लिए कोड और संसाधन शामिल होते हैं. ऐसा तब होता है, जब आपकी build.gradle फ़ाइल (Groovy के लिए) में splits.abi ब्लॉक में universalApk true या आपकी build.gradle.kts फ़ाइल (Kotlin स्क्रिप्ट के लिए) में splits.abi ब्लॉक में isUniversalApk = true की जानकारी दी गई हो.

APK फ़ाइल नाम का फ़ॉर्मैट

एक से ज़्यादा APK बनाते समय, Gradle इस स्कीम का इस्तेमाल करके APK के फ़ाइल नाम जनरेट करता है:

modulename-ABI-buildvariant.apk

इस स्कीम के कॉम्पोनेंट ये हैं:

modulename
इससे, बनाए जा रहे मॉड्यूल के नाम की जानकारी मिलती है.
ABI
अगर एबीआई के लिए कई APK चालू हैं, तो APK के लिए एबीआई तय करता है, जैसे कि x86.
buildvariant
इससे पता चलता है कि बिल्ड का कौनसा वैरिएंट बनाया जा रहा है, जैसे कि debug.