एंड्रॉइड स्टूडियो, ग्रैडल और एनडीके का एकीकरण

हाल के परिवर्तनों (27 दिसंबर, 2013 की रिलीज 0.7.3 से शुरू) के प्रकाश में, एनडीके का उपयोग करने वालों के लिए एंड्रॉइड के लिए नया बिल्ड सिस्टम बहुत दिलचस्प होता जा रहा है। अब आपकी विधानसभा में देशी पुस्तकालयों को एकीकृत करना और विभिन्न आर्किटेक्चर के लिए एपीके उत्पन्न करना, संस्करण कोड को सही ढंग से संभालना वास्तव में आसान हो गया है।

हम .so फ़ाइलों को APK में एकीकृत करते हैं

यदि आप एंड्रॉइड स्टूडियो का उपयोग करते हैं, तो आवेदन में मूल पुस्तकालयों को एकीकृत करने से पहले, आपको मावेन .AR .AR / .jar पैकेज सहित विभिन्न जटिल तरीकों का उपयोग करना होगा ... अच्छी खबर यह है कि अब इसकी आवश्यकता नहीं है।



आपको बस प्रत्येक समर्थित ABI (x86, mips, armeabi-v7a, armeabi) के नाम के लिए एक उपनिर्देशिका में jniLibs निर्देशिका में .so पुस्तकालयों को लगाने की आवश्यकता है - और यह बात है! अब सभी .so फ़ाइलों को बिल्ड के दौरान एपीके में एकीकृत किया जाएगा:



यदि jniLibs फ़ोल्डर नाम आपके अनुरूप नहीं है, तो आप build.gradle में एक अलग स्थान निर्दिष्ट कर सकते हैं:

android { ... sourceSets.main { jniLibs.srcDir 'src/main/libs' } } 

हम आर्किटेक्चर पर एक एपीके का निर्माण करते हैं और सफल होते हैं!

एबिफिल्टर संपत्ति का उपयोग करके प्रति आर्किटेक्चर एक एपीके का निर्माण बहुत सरल है।
डिफ़ॉल्ट रूप से, ndk.abiFilter (s) सभी के लिए सेट है। यह संपत्ति .so फ़ाइलों के एकीकरण को प्रभावित करती है, साथ ही ndk-build को कॉल करती है (हम पोस्ट के अंत में इस बारे में बात करेंगे)।
चलो build.gradle के लिए कुछ वास्तुशिल्प सुविधाएँ (कॉन्फ़िगरेशन) जोड़ें :

 android{ ... productFlavors { x86 { ndk { abiFilter "x86" } } mips { ndk { abiFilter "mips" } } armv7 { ndk { abiFilter "armeabi-v7a" } } arm { ndk { abiFilter "armeabi" } } fat } } 

और फिर प्रोजेक्ट को सिंक्रोनाइज़ फाइल्स के साथ सिंक्रोनाइज़ करें:



अब आप अपने पसंदीदा बिल्ड विकल्पों को चुनकर नई सुविधाओं का आनंद ले सकते हैं:



इनमें से प्रत्येक विकल्प आपको चयनित वास्तुकला के लिए एक एपीके देगा:



पूर्ण (रिलीज़ | डीबग) एपीके में अभी भी सभी पुस्तकालय होंगे, साथ ही इस पोस्ट की शुरुआत में उल्लिखित मानक पैकेज भी होगा।

लेकिन इस जगह पर पढ़ना बंद मत करो! वास्तुकला पर निर्भर APK विकास के लिए सुविधाजनक हैं, लेकिन यदि आप उनमें से कुछ को Google Play Store पर अपलोड करना चाहते हैं, तो आपको प्रत्येक के लिए एक अलग संस्करण स्थापित करने की आवश्यकता है। नवीनतम बिल्ड सिस्टम के साथ ऐसा करना बहुत आसान है।

ABI- निर्भर APK के लिए अलग-अलग संस्करण कोड स्वचालित रूप से सेट करें

Android.defaultConfig.versionCode गुण आपके अनुप्रयोग के लिए संस्करणकोड के लिए जिम्मेदार है। डिफ़ॉल्ट रूप से, यह -1 पर सेट है, और यदि आप इस मान को नहीं बदलते हैं, तो AndroidManifest.xml फ़ाइल में निर्दिष्ट संस्करणकोड का उपयोग किया जाएगा।
चूँकि हम अपने संस्करणकोड को गतिशील रूप से बदलना चाहते हैं, इसलिए हमें पहले इसे build.gradle के अंदर निर्दिष्ट करना होगा:

 android { ... defaultConfig{ versionName "1.1.0" versionCode 110 } } 

हालाँकि, इस परिवर्तन को अभी भी AndroidManifest.xml में संग्रहीत करना संभव है, यदि आप इसे बदलने से पहले इसे "मैन्युअल रूप से" प्राप्त करते हैं:

 import java.util.regex.Pattern android { ... defaultConfig{ versionCode getVersionCodeFromManifest() } ... } def getVersionCodeFromManifest() { def manifestFile = file(android.sourceSets.main.manifest.srcFile) def pattern = Pattern.compile("versionCode=\"(\\d+)\"") def matcher = pattern.matcher(manifestFile.getText()) matcher.find() return Integer.parseInt(matcher.group(1)) } 

अब आप विभिन्न संशोधक के साथ संस्करणकोड का उपयोग कर सकते हैं:

 android { ... productFlavors { x86 { versionCode Integer.parseInt("6" + defaultConfig.versionCode) ndk { abiFilter "x86" } } mips { versionCode Integer.parseInt("4" + defaultConfig.versionCode) ndk { abiFilter "mips" } } armv7 { versionCode Integer.parseInt("2" + defaultConfig.versionCode) ndk { abiFilter "armeabi-v7a" } } arm { versionCode Integer.parseInt("1" + defaultConfig.versionCode) ndk { abiFilter "armeabi" } } fat } } 

यहाँ हमने x86 के लिए उपसर्ग 6, mips के लिए 4, ARMv7 के लिए 2 और ARMv5 के लिए 1 रखा है।

एंड्रॉइड स्टूडियो में ndk के साथ काम करना

यदि प्रोजेक्ट स्रोत में कोई jni फ़ोल्डर है, तो बिल्ड सिस्टम ndk-build को स्वचालित रूप से कॉल करने का प्रयास करेगा।
वर्तमान कार्यान्वयन में, आपके Android.mk मेकफाइल्स को अनदेखा किया जाता है, इसके बजाय, मक्खी पर एक नया बनाया जाता है। यह छोटी परियोजनाओं के लिए वास्तव में सुविधाजनक है (आपको अब सभी फ़ाइलों की आवश्यकता नहीं है!), लेकिन बड़े लोगों में यह कष्टप्रद हो सकता है यदि आपको मेकफाइल्स द्वारा प्रदान की गई सभी विशेषताओं की आवश्यकता हो। बिल्ड.ग्रेड में इस गुण को अक्षम करना संभव है:

 android{ ... sourceSets.main.jni.srcDirs = [] //disable automatic ndk-build call } 

यदि आप ऑन-द-फ्लाई मेकफाइल का उपयोग करना चाहते हैं, तो आप इसे शुरू में ndk.moduleName संपत्ति सेट करके कॉन्फ़िगर कर सकते हैं, उदाहरण के लिए, इस तरह:

 android { ... defaultConfig { ndk { moduleName "hello-jni" } } } 

आप अन्य ndk गुण भी सेट कर सकते हैं:

• CFlags ,
• ldLibs ,
• stl (यानी: gnustl_sared , stlport_static ...),
• abiFilters (i.e .: "x86" , "armeabi-v7a" )।

डिबगिंग एपीके की पीढ़ी android.buildTypes.debug.jniDebugBild संपत्ति के लिए सही सेट करके प्राप्त की जाती है; इस स्थिति में ndk-build को NDK_DEBUG = 1 पास किया जाएगा।
यदि आप NDK से रेंडरस्क्रिप्ट का उपयोग कर रहे हैं, तो आपको defaultConfig.renderscriptNdkMode प्रॉपर्टी पर सही सेट करना होगा।
यदि आप ऑटो-जेनरेट किए गए मेकफाइल्स पर भरोसा करते हैं, तो आप मल्टी-आर्किटेक्चर एपीके का निर्माण करते समय अंतिम आर्किटेक्चर के आधार पर अलग-अलग cFlags निर्दिष्ट कर सकते हैं। इसलिए यदि आप पूरी तरह से प्रवणता पर भरोसा करना चाहते हैं, तो हम पहले वर्णित कॉन्फ़िगरेशन संशोधक का उपयोग करके आर्किटेक्चर के लिए विभिन्न APK बनाने की सलाह देते हैं:

  ... productFlavors { x86 { versionCode Integer.parseInt("6" + defaultConfig.versionCode) ndk { cFlags cFlags + " -mtune=atom -mssse3 -mfpmath=sse" abiFilter "x86" } } ... 

मेरा नमूना .gradle फ़ाइल

यह सब एक साथ रखते हुए, मैं build.gradle फ़ाइल लाता हूं, जिसे मैं खुद वर्तमान में उपयोग कर रहा हूं। इसमें विभिन्न समर्थित ABI के लिए संशोधक नहीं हैं, यह ndk-build के साथ एकीकरण का उपयोग नहीं करता है, इसलिए यह विंडोज वातावरण में काम करता है और इसे स्रोतों और पुस्तकालयों के सामान्य स्थानों, या मेरी .mk फ़ाइलों की सामग्री को बदलने की आवश्यकता नहीं होती है।

 import java.util.regex.Pattern buildscript { repositories { mavenCentral() } dependencies { classpath 'com.android.tools.build:gradle:0.9.0' } } apply plugin: 'android' android { compileSdkVersion 19 buildToolsVersion "19.0.3" defaultConfig{ versionCode getVersionCodeFromManifest() } sourceSets.main { jniLibs.srcDir 'src/main/libs' jni.srcDirs = [] //disable automatic ndk-build call } productFlavors { x86 { versionCode Integer.parseInt("6" + defaultConfig.versionCode) ndk { abiFilter "x86" } } mips { versionCode Integer.parseInt("4" + defaultConfig.versionCode) ndk { abiFilter "mips" } } armv7 { versionCode Integer.parseInt("2" + defaultConfig.versionCode) ndk { abiFilter "armeabi-v7a" } } arm { versionCode Integer.parseInt("1" + defaultConfig.versionCode) ndk { abiFilter "armeabi" } } fat } } def getVersionCodeFromManifest() { def manifestFile = file(android.sourceSets.main.manifest.srcFile) def pattern = Pattern.compile("versionCode=\"(\\d+)\"") def matcher = pattern.matcher(manifestFile.getText()) matcher.find() return Integer.parseInt(matcher.group(1)) } 

समस्या निवारण

NDK कॉन्फ़िगर नहीं है

यदि आपको कोई त्रुटि मिलती है:

 Execution failed for task ':app:compileX86ReleaseNdk'. > NDK not configured 

इसका मतलब है कि उपकरण NDK निर्देशिका में नहीं मिले थे। दो तरीके हैं: अपने NDK निर्देशिका के अनुसार ANDROID_NDK_HOME चर सेट करें और local.properties को हटा दें या इसे स्थानीय रूप से अंदर ही सेट करें।

 ndk.dir=C\:\\Android\\ndk 

लक्ष्य बनाने के लिए कोई नियम नहीं है

यदि आपको कोई त्रुटि मिलती है:

 make.exe: *** No rule to make target ...\src\main\jni 

इसका कारण विंडोज के लिए NDK में एक मौजूदा त्रुटि हो सकती है जब संकलन के लिए केवल एक स्रोत फ़ाइल है। एक और खाली फ़ाइल जोड़ें और सब कुछ काम करेगा।

अन्य मामले

आप Google समूह adt-dev में अपने प्रश्नों के उत्तर पा सकते हैं।

NDK एकीकरण जानकारी प्राप्त करना

अधिक जानकारी खोजने के लिए सबसे अच्छी जगह आधिकारिक परियोजना पृष्ठ है ।
परिवर्तनों की सूची देखें और, यदि आप इसकी संपूर्णता में स्क्रॉल करते हैं, तो आपको नवीनतम gradle-samples-XXX.zip अभिलेखागार के भीतर NDK एकीकरण से संबंधित परियोजनाओं के उदाहरण मिलेंगे।

नीचे दिए गए वीडियो में दिखाया गया है कि एंड्रॉइड स्टूडियो से एनडीके स्रोतों के साथ एक परियोजना कैसे स्थापित की जाए।