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

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

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

प्रवेश

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

पूर्वापेक्षाएँ और कार्यप्रवाह

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

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

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

प्रारंभिक समाधान

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

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

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

नई सुविधाएँ

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

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

सिस्टम संपत्ति मूल्यों को परिभाषित मूल्यों पर प्राथमिकता दी जाती हैगुण>.

माता-पिता

  4.0.0
  
    org.apache
    अमरीका की एक मूल जनजाति
    18 है
  
  org.apache.maven.ci
  ci-parent
  पहला सीआई फ्रेंडली
  ${संशोधन}${sha1}${परिवर्तन सूची}
  ...
  
    1.3.1
    -स्नैपशॉट
    
  


वंशज

  4.0.0
  
    org.apache.maven.ci
    ci-parent
    ${संशोधन}${sha1}${परिवर्तन सूची}
  
  org.apache.maven.ci
  ci-बच्चा
   ...

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

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

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

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

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

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

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

    org.apache
    अमरीका की एक मूल जनजाति
    ${संशोधन}

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

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

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

  
    org.codehaus.mojo
    फ़्लैटन-मेवेन-प्लगइन
    1.1.0 है
    
      सत्य
      केवलResolutionCiFriendlies
    
    
      
        समतल
        प्रक्रिया-संसाधन
        
          समतल
        
      
      
        चपटा.साफ़
        साफ
        
          साफ
        
      
    
  

हो गया!

सुखांत

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

स्रोत: www.habr.com