maven परियोजनाहरूमा संस्करण सरल बनाउन flatten-maven-plugin प्रयोग गर्ने अनुभव गर्नुहोस्

О нас

1C मा हामी प्लेटफर्म मात्र विकास गर्दैनौं 1C: उद्यम मा C ++ и जाभास्क्रिप्ट, तर जाभा अनुप्रयोगहरू पनि - विशेष गरी नयाँ विकास वातावरण उद्यम विकास उपकरणहरू ग्रहण र प्लेटफर्मसँग गहिरो रूपमा एकीकृत मेसेन्जर सर्भरमा आधारित - अन्तरक्रिया प्रणाली.

प्रवेश

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

पूर्वतयारी र कार्यप्रवाह

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

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

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

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

यस्तो बारम्बार र बहु ​​संस्करण परिवर्तन संग, म CI भित्र प्रक्रिया सरल र स्वचालित गर्न चाहन्छु। यो जहाँ एक सुविधाजनक, प्रसिद्ध प्लगइन उद्धार गर्न आउँछ। संस्करणहरू-maven-प्लगइन - यसलाई जडान गर्नुहोस् र यसलाई सुरु गर्नुहोस्

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

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

नयाँ सुविधाहरू

केही समयको लागि हामी शान्त भयौं र राजीनामा दियौं, हामी त्यसरी नै बस्यौं जबसम्म केटाहरू आएनन् Maven Apache परियोजना संस्करण 3.5.0-beta-1 बाट सुरु गर्दै, माभेनले तथाकथित "प्लेसहोल्डरहरू" को लागि समर्थन समावेश गरेन। यी विकल्पहरूको सार यो हो pom.xML परियोजना संस्करण को एक विशिष्ट संकेत को सट्टा, चर प्रयोग गरिन्छ ${संशोधन}, ${sha1} и ${परिवर्तनवादी}। यी गुणहरूको मानहरू या त तत्वमा सेट गरिएका छन्गुण>, वा तिनीहरू प्रणाली गुण मार्फत परिभाषित गर्न सकिन्छ

mvn -Drevision=2.0.0 सफा प्याकेज

प्रणाली गुण मानहरू मा परिभाषित मानहरूमा प्राथमिकता लिन्छगुण>.

अभिभावक

  ४.०.०
  
    org.apache
    apache
    १८
  
  org.apache.maven.ci
  ci-अभिभावक
  पहिलो CI मैत्री
  ${संशोधन}${sha1}${changelist}
  ...
  
    1.3.1
    - स्न्यापशट
    
  


वंशज

  ४.०.०
  
    org.apache.maven.ci
    ci-अभिभावक
    ${संशोधन}${sha1}${changelist}
  
  org.apache.maven.ci
  ci-बच्चा
   ...

यदि तपाइँ संस्करण 2.0.0-SNAPSHOT निर्माण गर्न चाहनुहुन्छ भने, त्यसपछि मात्र प्रयोग गर्नुहोस्

    mvn -Drevision=2.0.0 सफा प्याकेज

यदि तपाइँ रिलीज गर्न चाहनुहुन्छ भने, त्यसपछि मात्र स्न्यापशट रिसेट गर्नुहोस्

    mvn -Dchangelist = सफा प्याकेज

* माथिका उदाहरणहरूबाट लिइएको हो लेख Maven Apache परियोजना वेबसाइटमा

कठोर वास्तविकता

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

    org.apache
    apache
    ${संशोधन}

सुरुङको अन्त्यमा बत्ती

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

परियोजनामा ​​प्लगइन थप्दै

  
    org.codehaus.mojo
    flatten-maven-plugin
    १८
    
      सत्य
      समाधानCiFriendlies मात्र
    
    
      
        समतल
        प्रक्रिया-स्रोतहरू
        
          समतल
        
      
      
        flatten.clean
        सफा
        
          सफा
        
      
    
  

भयो!

सुखत अन्त्य

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

स्रोत: www.habr.com