मावेन परियोजनाओं में वर्जनिंग को आसान बनाने के लिए फ्लैटन-मावेन-प्लगइन का उपयोग करने का अनुभव

हमारे बारे में

1 सी में, हम न केवल 1 सी: एंटरप्राइज प्लेटफॉर्म को सी ++ और जावास्क्रिप्ट में विकसित करते हैं, बल्कि जावा एप्लिकेशन भी - विशेष रूप से, एक्लिप्स पर आधारित नया एंटरप्राइज डेवलपमेंट टूल्स डेवलपमेंट वातावरण और मैसेंजर प्लेटफॉर्म - इंटरेक्शन सिस्टम के साथ गहराई से एकीकृत एक सर्वर।

प्रविष्टि

सबसे अधिक बार, हम जावा अनुप्रयोगों को असेंबल करने के लिए सिस्टम के रूप में मावेन का उपयोग करते हैं, और इस छोटे से लेख में हम उन समस्याओं में से एक के बारे में बात करना चाहते हैं जिन्हें हमें विकास प्रक्रिया के दौरान और उस दृष्टिकोण से निपटना था जिसने हमें इस समस्या को दूर करने की अनुमति दी थी।

पृष्ठभूमि और वर्कफ़्लो

हमारी मावेन-परियोजनाओं में विकास की बारीकियों के कारण, हम बहुत सारे मॉड्यूल, निर्भरता और बाल परियोजनाओं का उपयोग करते हैं। एक पेड़ में पोम-फाइलों की संख्या दसियों या सैकड़ों भी हो सकती है।



ऐसा लगता है: यह ठीक है, एक बार बनाया और भूल गया। यदि आपको एक साथ सभी फ़ाइलों में कुछ बदलने या जोड़ने की आवश्यकता है, तो संपादकों और आईडीई में कई सुविधाजनक उपकरण हैं। और pom.xml में सबसे आम नियमित परिवर्तन क्या है? हम मानते हैं कि बदलते प्रोजेक्ट संस्करण और निर्भरताएँ। हो सकता है कि कोई इसके साथ बहस करना चाहता हो, लेकिन हमारे साथ ऐसा ही है। कारण यह है कि, कर्नेल के साथ, हम एक साथ अपने स्वयं के कई पुस्तकालयों को विकसित कर रहे हैं, और विधानसभा और परीक्षण परिणामों के निरंतर प्रतिलिपि प्रस्तुत करने के लिए, स्नैपशॉट का उपयोग हमें एक सुविधाजनक दृष्टिकोण नहीं लगता है। इस कारण से, प्रत्येक विधानसभा में परियोजनाओं में संस्करण संख्या को बढ़ाना आवश्यक है।

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

प्रारंभिक निर्णय

इस तरह के लगातार और कई संस्करण परिवर्तनों के साथ, CI के भीतर प्रक्रिया सरल और स्वचालित होना चाहती है। यहां सुविधाजनक प्रसिद्ध संस्करण-मावेन-प्लगइन प्लगइन बचाव के लिए आता है - हम इसे प्लग इन करते हैं और चलाते हैं

mvn -N संस्करण: सेट -DnewVersion = 2.0.1

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

नई सुविधाएँ

थोड़ी देर के लिए, हम शांत हो गए और शांति से रहने लगे, जब तक कि मावेन अपाचे परियोजना के लोग मावेन में शामिल नहीं थे, संस्करण 3.5.0-बीटा -1 से शुरू होकर, संस्करणों (प्लेसहोल्डर्स) के तथाकथित "प्लेसहोल्डर्स" के लिए समर्थन करते हैं। इन विकल्पों का सार यह है कि pom.xml प्रोजेक्ट संस्करण को निर्दिष्ट करने के बजाय चर {{संशोधन} , $ {sha1} और $ {changelist} चर का उपयोग करता है। इन गुणों के मूल्य स्वयं < गुण > तत्व में सेट किए गए हैं, या उन्हें सिस्टम गुण के माध्यम से परिभाषित किया जा सकता है

mvan -Drevision = 2.0.0 स्वच्छ पैकेज

सिस्टम गुण मान < गुण > में परिभाषित मानों से अधिक पूर्वता लेते हैं।

जनक
<परियोजना>
<modelVersion> 4.0.0 </ modelVersion>
<माता पिता>
<groupId> org.apache </ groupId>
<विरूपण साक्ष्य> अपाचे </ विरूपण साक्ष्य>
<संस्करण> 18 </ संस्करण>
</ माता पिता>
<groupId> org.apache.maven.ci </ groupId>
<विरूपण साक्ष्य> सीआई-अभिभावक </ विरूपण साक्ष्य>
<name> फर्स्ट CI फ्रेंडली </ name>
<version> $ {revision} $ {sha1} $ {changelist} </ version>
...
<गुण>
<संशोधन> 1.3.1 </ संशोधन>
<changelist> -SNAPSHOT </ changelist>
<sha1 />
</ गुण>
</ परियोजना>

वंशज
<परियोजना>
<modelVersion> 4.0.0 </ modelVersion>
<माता पिता>
<groupId> org.apache.maven.ci </ groupId>
<विरूपण साक्ष्य> सीआई-अभिभावक </ विरूपण साक्ष्य>
<version> $ {revision} $ {sha1} $ {changelist} </ version>
</ माता पिता>
<groupId> org.apache.maven.ci </ groupId>
<विरूपण साक्ष्य> ci-child </ विरूपण साक्ष्य>
...
</ परियोजना>


यदि आप संस्करण 2.0.0-स्नैपशॉट का निर्माण करना चाहते हैं, तो बस उपयोग करें

mvan -Drevision = 2.0.0 स्वच्छ पैकेज

यदि आप एक रिलीज़ करना चाहते हैं, तो बस स्नैपशॉट को शून्य करें

mvn -Dchangelist = स्वच्छ पैकेज

* ऊपर दिए गए उदाहरण मावेन अपाचे परियोजना की वेबसाइट पर एक लेख से लिए गए हैं

हर्ष वास्तविकता

सब कुछ अच्छा और स्वस्थ है, यह संतुष्टि की भावना का अनुभव करने का समय है, लेकिन नहीं। यह पता चला है कि स्थापित करने और तैनात करने के लिए यह विधि काम नहीं करेगी, क्योंकि रिपॉजिटरी और मावेन में प्रकाशित कलाकृतियों के विवरण में $ {पुनरीक्षण} को इसके मूल्य से नहीं बदला जाएगा और यह समझ में नहीं आएगा कि यह सब क्या है।

<माता पिता>
<groupId> org.apache </ groupId>
<विरूपण साक्ष्य> अपाचे </ विरूपण साक्ष्य>
<संस्करण> $ {संशोधन} </ संस्करण>
</ माता पिता>

सुरंग के अंत में प्रकाश

हमें समस्या के समाधान की तलाश करनी चाहिए। स्थिति को सपाट-मावेन-प्लगइन द्वारा बचाया जा सकता था। यह प्लगइन सभी वेरिएबल्स को pom में अनुमति देता है, लेकिन साथ ही यह अन्य जानकारी का एक टन काट देता है, जो केवल असेंबली के दौरान आवश्यक होती है और अन्य प्रोजेक्ट के लिए प्रकाशित कलाकृतियों को आयात करते समय इसकी आवश्यकता नहीं होती है। इसके अलावा, प्लगइन सभी माता-पिता की निर्भरता को "स्ट्रेटेंस" करता है, और इसके परिणामस्वरूप हमें फ्लैट पोम मिलता है, जिसमें वह सब कुछ शामिल है जो आपको चाहिए। असुविधा यह थी कि वह "बहुत अधिक" बहुत अधिक काटता था, जो हमें बिल्कुल भी सूट नहीं करता था। इस प्लगइन को विकसित करने के बारे में जानकारी का अध्ययन करने के बाद, यह पता चला कि हम ब्रह्मांड में केवल एक ही नहीं हैं, और अगस्त 2018 में वापस प्लगइन रिपॉजिटरी में जीथब पर पुल-रिक्वेस्ट बनाई गई थी, जो इसे स्वतंत्र रूप से "बिगाड़ने" pom.xml को कैसे निर्धारित करना चाहते हैं। डेवलपर्स ने पीड़ितों की आवाज़ें सुनीं, और पहले से ही दिसंबर में, नए संस्करण 1.1.0 की रिहाई के साथ, एक नया संकल्पCiFriendliesOnly मोड फ्लैट-मावेन-प्लगइन में दिखाई दिया, जो पहले की तरह ही था - यह pom.xml छोड़ता है, जैसा कि <संस्करण> तत्व को छोड़कर और $ अनुमति देता है। {संशोधन} , $ {sha1} और $ {changelist} ।

प्रोजेक्ट में एक प्लगइन जोड़ें

<प्लगइन्स>
<प्लगइन>
<groupId> org.codehaus.mojo </ groupId>
<विरूपण साक्ष्य> फ्लैटन-मावेन-प्लगइन </ विरूपण साक्ष्य>
<संस्करण> 1.1.0 </ संस्करण>
<विन्यास>
<updatePomFile> true </ updatePomFile>
<flattenMode> resolutionCiFriendliesOnly </ flattenMode>
</ विन्यास>
<फांसी>
<निष्पादन>
<id> चपटा </ id>
<चरण> प्रक्रिया-संसाधन </ चरण>
<लक्ष्यों>
<लक्ष्य> समतल करें </ लक्ष्य>
</ लक्ष्यों>
</ निष्पादन>
<निष्पादन>
<id> flatten.clean </ id>
<चरण> स्वच्छ </ चरण>
<लक्ष्यों>
<लक्ष्य> स्वच्छ </ लक्ष्य>
</ लक्ष्यों>
</ निष्पादन>
</ फांसी>
</ प्लगइन>
</ प्लगइन्स>


हो गया!

सुखद अंत

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