🚾 🌲 🤽🏽 जेनकिंस + ग्रैडल का उपयोग करके एंड्रॉइड के लिए निरंतर एकीकरण 💃🏼 👩‍👧‍👧 ♥️

मैं Android अनुप्रयोगों के स्वचालित संयोजन पर अपनी सर्वोत्तम प्रथाओं को साझा करना चाहता हूं। इस लेख में मैं दो प्रकार के अनुप्रयोगों के लिए असेंबली का एक उदाहरण दूंगा, पहला एक अलग फ़ोल्डर में इकाई परीक्षणों से युक्त एक सरल अनुप्रयोग है, दूसरा एंड्रॉइड लाइब्रेरी प्रोजेक्ट का उपयोग करके एक एप्लिकेशन है।

अंत में, हम पूर्ण परीक्षणों के साथ-साथ एक हस्ताक्षरित apk फ़ाइल पर एक रिपोर्ट प्राप्त करेंगे, जेनकिंस बिल्ड कलाकृतियों से डाउनलोड के लिए उपलब्ध है।

स्वचालित असेंबली स्थापित करने के लिए आवश्यकताएँ

जेनकिंस आवश्यक प्लगइन्स
- Android एमुलेटर प्लगिन
- Git Plugin (यदि आप git का उपयोग करते हैं)
- एकाधिक SCMs प्लगइन (कई रिपॉजिटरी के साथ काम करने की क्षमता के लिए)
- Xvnc प्लगइन (एम सर्वर पर एक्स सर्वर स्थापित नहीं होने पर एमुलेटर चलाने की क्षमता के लिए)
Android एसडीके
यहाँ से डाउनलोड करें । अन्य प्लेटफ़ॉर्म के लिए धारा डाउनलोड -> एसडीके उपकरण केवल
Gradle
यहां संग्रह डाउनलोड करना बेहतर है (gradle - ** - bin.zip) और इसे / usr / local / lib पर अनज़िप करें
पर्यावरण चर
ANDROID_HOME = / usr / स्थानीय / lib / android / sdk
GRADLE_HOME = / usr / स्थानीय / lib / gradle-1.8
JAVA_HOME = / usr / lib / jvm / jdk1.7.0_03
पथ = $ पथ: $ ANDROID_HOME / उपकरण: $ ANDROID_HOME / प्लेटफ़ॉर्म-उपकरण: $ JAVA_HOME / बिन: $ GRADLE_HOME / बिन
एमुलेटर चलाने के लिए लाइब्रेरी
यदि जेनकिंस 64-बिट OS पर चलता है, तो आपको ia32-lib लाइब्रेरी को जोड़ना होगा, अन्यथा एमुलेटर शुरू नहीं होगा
sudo apt-get install ia32-libs

जब सभी आवश्यकताएं पूरी हो जाएं, तो सेटअप पर जाएं

अपने काम में मैं एक्लिप्स का उपयोग करता हूं, इसलिए परियोजनाएं हैं, इसलिए बोलने के लिए, एक पुरानी संरचना जो कि ढाल परियोजनाओं के लिए विशिष्ट नहीं है (जैसे कि androidStudio बनाता है)। परियोजना इस तरह दिखती है, इसके आधार पर आगे के उदाहरण दिए जाएंगे:

  परियोजना
  | -से
  | -src
  | -सेट्स
  | -लिब्स
  | -स्टेस्ट (इकाई परीक्षण के साथ परियोजना वाले फ़ोल्डर)
      | -src
      | -से
      | -अंदरोइडमैनिफेस्ट.एक्सएमएल
  | -अंदरोइडमैनिफेस्ट.एक्सएमएल
  | -build.gradle
  | -ग्रेडल .प्रतिस्पर्धाएँ

समायोजन

सबसे पहले, एक नियमित परियोजना स्थापित करें। प्रोजेक्ट की जड़ में build.gradle फ़ाइल बनाने के लिए पहला कदम है

buile.gradle

buildscript { repositories { mavenCentral() } dependencies { classpath 'com.android.tools.build:gradle:0.6+' } } apply plugin: 'android' android { compileSdkVersion 18 buildToolsVersion "18.1.1" defaultConfig { minSdkVersion 8 targetSdkVersion 18 testPackageName "com.project.tests" testInstrumentationRunner "android.test.InstrumentationTestRunner" } sourceSets { main { manifest.srcFile file('AndroidManifest.xml') java.srcDirs = ['src'] resources.srcDirs = ['src'] res.srcDirs = ['res'] assets.srcDirs = ['assets'] } instrumentTest { java.srcDirs = ['tests/src'] manifest.srcFile file('tests/AndroidManifest.xml') java.srcDirs = ['tests/src'] resources.srcDirs = ['tests/src'] res.srcDirs = ['tests/res'] assets.srcDirs = ['tests/assets'] } } dependencies { compile fileTree(dir: 'libs', include: '*.jar') } //     if(project.hasProperty("debugSigningPropertiesPath") && project.hasProperty("releaseSigningPropertiesPath")) { //       File debugPropsFile = new File(System.getenv('HOME') + "/" + project.property("debugSigningPropertiesPath")) File releasePropsFile = new File(System.getenv('HOME') + "/" + project.property("releaseSigningPropertiesPath")) if(debugPropsFile.exists() && releasePropsFile.exists()) { Properties debugProps = new Properties() debugProps.load(new FileInputStream(debugPropsFile)) Properties releaseProps = new Properties() releaseProps.load(new FileInputStream(releasePropsFile)) //     signingConfigs { debug { storeFile file(debugPropsFile.getParent() + "/" + debugProps['keystore']) storePassword debugProps['keystore.password'] keyAlias debugProps['keyAlias'] keyPassword debugProps['keyPassword'] } release { storeFile file(releasePropsFile.getParent() + "/" + releaseProps['keystore']) storePassword releaseProps['keystore.password'] keyAlias releaseProps['keyAlias'] keyPassword releaseProps['keyPassword'] } } buildTypes { debug { signingConfig signingConfigs.debug } release { signingConfig signingConfigs.release } } } } }

परीक्षणों को चलाने के लिए, यह android.sourceSets में लिखत अनुभाग को निर्दिष्ट करने के लिए पर्याप्त है, जिसमें परीक्षण परियोजना में फ़ोल्डर पथ इंगित किए जाएंगे। जब मैंने ग्रैडल के साथ निपटा, तो मैंने एक से अधिक लेख देखा जिसमें यह लिखा था कि यूनिट परीक्षणों को चलाने के लिए आपको एक अलग कार्य बनाने की आवश्यकता है, इसके लिए स्रोतसेट में एक अलग प्रविष्टि बनाएं और इसके आधार पर जूनिट जोड़ें। सामान्य तौर पर, मैंने इस पर अपना समय बर्बाद किया, सब कुछ बहुत सरल है।
कॉन्फ़िगरेशन का वह हिस्सा जो एप्लिकेशन पर हस्ताक्षर करने के लिए जिम्मेदार है, नीचे वर्णित किया जाएगा। कॉन्फ़िगरेशन बनाने के बाद, जेनकिंस को कॉन्फ़िगर करने के लिए आगे बढ़ें।

जेनकींस सेटअप

पहला कदम परियोजना के साथ भंडार को निर्दिष्ट करना है। फिर आपको बिल्ड के दौरान एक एंड्रॉइड एमुलेटर का चयन करने की आवश्यकता है जिसमें आपको दो विकल्पों में से एक को चुनने की आवश्यकता है - या तो एक मौजूदा एमुलेटर का नाम निर्दिष्ट करें, या एक नया लॉन्च करने के लिए पैरामीटर निर्दिष्ट करें। उसी समय आइटम एमुलेटर विंडो पर एक टिक छोड़ दें
अगला चरण इनवोक ग्रैडल स्क्रिप्ट असेंबली चरण को जोड़ना है और ग्रैडल के लिए आवश्यक कमांड निर्दिष्ट करना है। परीक्षण बनाने और चलाने के लिए, केवल बिल्ड और कनेक्ट चेक निर्दिष्ट करें

अंतिम बात आपको विधानसभा के बाद किए गए कार्यों को जोड़ना होगा।
1. प्रकाशित JUnit परीक्षा परिणाम रिपोर्ट (हम इकाई परीक्षणों के निष्पादन पर रिपोर्ट प्रकाशित करते हैं)। पूर्ण परीक्षणों पर रिपोर्ट के साथ, xml फ़ाइल के लिए लाइन में, निम्न पथ लिखना आवश्यक है:
**/build/instrumentTest-results/*/*.xml
ग्रैडल 2 प्रकार की रिपोर्ट बनाता है - html और xml। HTML रिपोर्ट बिल्ड / रिपोर्ट / इंस्ट्रूमेंट / कनेक्ट / फ़ोल्डर में पाई जा सकती हैं, लेकिन जेनकिंस के लिए आपको एक xml रिपोर्ट निर्दिष्ट करनी होगी।
2. पुरालेख कलाकृतियों (हम सीधे कलाकृतियों से संकलित हस्ताक्षरित एप्लिकेशन डाउनलोड करने का अवसर देते हैं)। संग्रह के लिए फ़ाइल पथ:
**/build/apk/workspace-release.apk
अब आवेदन पर हस्ताक्षर करने के लिए वापस

आवेदन हस्ताक्षर

किसी एप्लिकेशन पर हस्ताक्षर करने के लिए, आपके पास कुंजीटूल उपयोगिता का उपयोग करके बनाई गई एक कुंजी होनी चाहिए, जो एप्लिकेशन डेवलपर के बारे में डेटा संग्रहीत करेगी। बनाने के लिए मानक आदेश है:
keytool -genkey -v -alias appAlias -keyalg RSA -keysize 2048 -keystore release.keystore -validity 10000
प्रत्येक आवेदन के लिए उपनाम पैरामीटर का उपयोग किया जाना चाहिए, फिर आवेदन पर हस्ताक्षर करते समय इसे निर्दिष्ट करने की आवश्यकता होगी।

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

 releaseSigningPropertiesPath=.androidSigning/releaseProperties debugSigningPropertiesPath=.androidSigning/debugProperties

जारी करने का मान .SigningPropertiesPath पथ को इंगित करता है (घर निर्देशिका के सापेक्ष, ~ / .androidSigning /) जिसके साथ कुंजी (पासवर्ड और उपनाम) के लिए पैरामीटर के साथ फ़ाइल स्थित है। एक परियोजना के लिए, इस फ़ोल्डर में 4 फाइलें संग्रहीत की जानी चाहिए:
release.keystore - रिलीज़ बिल्ड एप्लिकेशन के लिए कुंजी
रिलीज़प्रोपरेटी - रिलीज़ कुंजी के लिए पैरामीटर
debug.keystore - अनुप्रयोग बनाने के लिए डीबग की कुंजी
debugProperties - डीबग कुंजी के लिए पैरामीटर

प्रत्येक * गुण फ़ाइलों में निम्न संरचना होनी चाहिए:

 keystore=- (   ) keystore.password=    keyAlias=alias     keyPassword=

एक उदाहरण:

 keystore=release.keystore keystore.password=mypassword keyAlias=appAlias keyPassword=mypassword

कुंजी बनाते समय इन सभी मापदंडों को निर्दिष्ट किया जाता है।

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

एंड्रॉइड-लाइब्रेरी का उपयोग करके एक एप्लिकेशन का निर्माण करना

मेरे मामले में, परियोजना और परियोजना पुस्तकालय विभिन्न रिपॉजिटरी में हैं। जेनकिंस के लिए कई रिपॉजिटरी के साथ काम करने में सक्षम होने के लिए, आपको मल्टीपल SCMs प्लगइन प्लगइन इंस्टॉल करना होगा। पहली बात फिर से ग्रेडिंग के लिए कॉन्फ़िगरेशन बनाना है। पहली फ़ाइल लाइब्रेरी प्रोजेक्ट में है

पुस्तकालय build.gradle

 buildscript { repositories { mavenCentral() } dependencies { classpath 'com.android.tools.build:gradle:0.6.3' } } apply plugin: 'android-library' android { compileSdkVersion 18 buildToolsVersion "19.0.0" defaultConfig { minSdkVersion 8 targetSdkVersion 18 testPackageName "com.project.tests" testInstrumentationRunner "android.test.InstrumentationTestRunner" } sourceSets { main { manifest.srcFile file('AndroidManifest.xml') java.srcDirs = ['src'] resources.srcDirs = ['src'] res.srcDirs = ['res'] assets.srcDirs = ['assets'] } instrumentTest { manifest.srcFile file('tests/AndroidManifest.xml') java.srcDirs = ['tests/src'] resources.srcDirs = ['tests/src'] res.srcDirs = ['tests/res'] assets.srcDirs = ['tests/assets'] } } dependencies { compile fileTree(dir: 'libs', include: '*.jar') } }

प्रोजेक्ट लाइब्रेरी का मुख्य अंतर लागू प्लगइन है: प्लगइन लागू करें: 'एंड्रॉइड-लाइब्रेरी'

दूसरा कॉन्फ़िगरेशन पहले से ही प्रोजेक्ट के अंदर है

परियोजना build.gradle

 buildscript { repositories { mavenCentral() } dependencies { classpath 'com.android.tools.build:gradle:0.6.3' } } apply plugin: 'android' android { compileSdkVersion 18 buildToolsVersion "19.0.0" defaultConfig { minSdkVersion 8 targetSdkVersion 18 } sourceSets { main { manifest.srcFile file('AndroidManifest.xml') java.srcDirs = ['src'] resources.srcDirs = ['src'] res.srcDirs = ['res'] assets.srcDirs = ['assets'] } } dependencies { compile fileTree(dir: 'libs', include: '*.jar') compile project(':MyLibrary') } //     if(project.hasProperty("debugSigningPropertiesPath") && project.hasProperty("releaseSigningPropertiesPath")) { //       File debugPropsFile = new File(System.getenv('HOME') + "/" + project.property("debugSigningPropertiesPath")) File releasePropsFile = new File(System.getenv('HOME') + "/" + project.property("releaseSigningPropertiesPath")) if(debugPropsFile.exists() && releasePropsFile.exists()) { Properties debugProps = new Properties() debugProps.load(new FileInputStream(debugPropsFile)) Properties releaseProps = new Properties() releaseProps.load(new FileInputStream(releasePropsFile)) //     signingConfigs { debug { storeFile file(debugPropsFile.getParent() + "/" + debugProps['keystore']) storePassword debugProps['keystore.password'] keyAlias debugProps['keyAlias'] keyPassword debugProps['keyPassword'] } release { storeFile file(releasePropsFile.getParent() + "/" + releaseProps['keystore']) storePassword releaseProps['keystore.password'] keyAlias releaseProps['keyAlias'] keyPassword releaseProps['keyPassword'] } } buildTypes { debug { signingConfig signingConfigs.debug } release { signingConfig signingConfigs.release } } } } }

अब आपको जेनकिंस में रिपॉजिटरी को सही ढंग से निर्दिष्ट करने की आवश्यकता है।
पिछले उदाहरण के विपरीत, इस मामले में, "स्रोत नियंत्रण" अनुभाग में, कुछ विशिष्ट संस्करण नियंत्रण प्रणाली नहीं बल्कि "मल्टीपल SCMs" का चयन करना आवश्यक है। जिसके बाद आपके सिस्टम को जोड़ना और रिपॉजिटरी को पथ निर्दिष्ट करना संभव होगा। पहला प्रोजेक्ट के साथ रिपॉजिटरी को निर्दिष्ट करने के लिए है, दूसरा लाइब्रेरी के साथ है, जबकि लाइब्रेरी के साथ रिपॉजिटरी के लिए आपको अतिरिक्त सेटिंग "एक उप-निर्देशिका की जाँच करें" निर्दिष्ट करना चाहिए, जिसमें उस फ़ोल्डर का नाम होगा जिसमें कोड स्थित होगा। इस फ़ोल्डर का नाम उस प्रोजेक्ट के नाम से मेल खाना चाहिए जिसे हमने build.gradle फ़ाइल के अंदर निर्भरताओं में निर्दिष्ट किया है (उदाहरण में, यह MyLibrary है)
compile project(':MyLibrary')
इस प्रकार, कामकाजी निर्देशिका एक सामान्य परियोजना की तरह दिखाई देगी, जिसमें केवल एक अतिरिक्त MyLibrary फ़ोल्डर होगा जिसमें पुस्तकालय स्थित होगा।

अन्य सभी सेटिंग्स एक नियमित परियोजना के लिए बिल्कुल वैसी ही हैं।

बोनस के रूप में

मेरी परियोजना में मुझे विभिन्न वातावरणों के साथ काम करना है। उदाहरण के लिए, एप्लिकेशन के परीक्षण संस्करण के लिए, स्थानीय सर्वर पर, विकास प्रक्रिया के दौरान, किसी भी डेटा को प्राप्त करने के लिए, अनुरोध भेजने के लिए आवश्यक है। इस प्रकार, 3 विशिष्ट वातावरण देव, मंच और ठेस को प्रतिष्ठित किया जा सकता है। रिज़ॉल्यूशन / मान / environment.xml फ़ाइल में मैंने एप्लिकेशन संसाधनों में पर्यावरण के आधार पर सेटिंग की है, इसमें वह URL है जिस पर आपको डेटा के लिए आवेदन करने की आवश्यकता है। मैंने विशिष्ट वातावरण के लिए सेटिंग्स फ़ाइलों को एक अलग पर्यावरण फ़ोल्डर में रखा है, जिसमें 3 सेटिंग्स फाइलें हैं: dev.xml, stage.xml और prod.xml। आवश्यक पर्यावरण के साथ काम करने के लिए आवेदन के लिए, आपको पर्यावरण की जगह इन फ़ाइलों में से किसी एक को प्रतिस्थापित करने की आवश्यकता है। xml।
जेनकिंस में ऐसा करने के लिए, आपको शेल कमांड लॉन्च को विधानसभा में पहले चरण के रूप में जोड़ने और निम्नलिखित को निर्दिष्ट करने की आवश्यकता है:
cp $WORKSPACE/environment/prod.xml $WORKSPACE/res/values/environment.xml

उपयोगी लिंक
www.gradle.org/docs/current/javadoc - ग्रेड दस्तावेज़
tools.android.com/tech-docs/new-build-system/user-guide तकनीकी दस्तावेज
tools.android.com/recent/updatingsdkfromcommand-line - एंड्रॉइड एसडीके को कंसोल के माध्यम से अपडेट करें (यदि कोई एक्स नहीं हैं तो)
vimeo.com/34436402 - ग्रेडल रैपर के काम की व्याख्या करने वाला वीडियो