मावेन प्रकल्पांमध्ये आवृत्ती सुलभ करण्यासाठी flatten-maven-plugin वापरण्याचा अनुभव घ्या

ओह

1C वर आम्ही केवळ एक प्लॅटफॉर्म विकसित करत नाही 1C: Enterprise वर क ++ и जावास्क्रिप्ट, पण Java ऍप्लिकेशन्स - विशेषतः नवीन विकास वातावरण उद्यम विकास साधने Eclipse वर आधारित आणि प्लॅटफॉर्मशी सखोलपणे एकत्रित केलेला मेसेंजर सर्व्हर - परस्परसंवाद प्रणाली.

नोंद

आम्ही बर्‍याचदा जावा ऍप्लिकेशन्ससाठी बिल्ड सिस्टीम म्हणून मॅवेन वापरतो आणि या छोट्या लेखात आम्हाला विकास आयोजित करण्याच्या प्रक्रियेत ज्या समस्यांना तोंड द्यावे लागले त्याबद्दल आणि आम्हाला यावर मात करण्यास अनुमती दिलेल्या दृष्टिकोनाबद्दल बोलू इच्छितो. समस्या.

पूर्वतयारी आणि कार्यप्रवाह

आमच्या मॅव्हन प्रकल्पांमधील विकासाच्या वैशिष्ट्यांमुळे, आम्ही बरेच मॉड्यूल, अवलंबित्व आणि बाल प्रकल्प वापरतो. एका झाडातील पोम फाइल्सची संख्या दहापट किंवा शेकडो असू शकते.

असे दिसते: काही मोठी गोष्ट नाही, त्यांनी ते एकदा तयार केले आणि त्याबद्दल विसरले. तुम्हाला सर्व फायलींमध्ये एकाच वेळी काहीतरी बदलण्याची किंवा जोडण्याची आवश्यकता असल्यास, संपादक आणि IDE मध्ये बरीच सोयीस्कर साधने आहेत. pom.xml मध्ये सर्वात सामान्य नियमित बदल कोणता आहे? आमचा विश्वास आहे की प्रकल्प आवृत्त्या आणि अवलंबनांमध्ये बदल. कदाचित कोणीतरी यासह वाद घालू इच्छित असेल, परंतु आपल्या बाबतीत हीच परिस्थिती आहे. याचे कारण हे आहे की, कर्नलसह, आम्ही एकाच वेळी आमच्या स्वतःच्या अनेक लायब्ररी विकसित करत आहोत, आणि परिणामांच्या निर्मिती आणि चाचणीच्या निरंतर पुनरुत्पादनासाठी, स्नॅपशॉट्स वापरणे आम्हाला सोयीस्कर वाटत नाही. या कारणास्तव, प्रत्येक बिल्डसह प्रकल्पांमध्ये आवृत्ती क्रमांक वाढवणे आवश्यक आहे.

तसेच, वेळोवेळी, विकसकाने लायब्ररीची स्वतःची शाखा तयार करणे आणि सर्व अवलंबनांवर त्याची कार्यक्षमता तपासणे आवश्यक आहे, ज्यासाठी त्याला त्या सर्वांची आवृत्ती व्यक्तिचलितपणे बदलावी लागेल.

प्रारंभिक उपाय

अशा वारंवार आणि एकाधिक आवृत्ती बदलांसह, मला CI मध्ये प्रक्रिया सुलभ आणि स्वयंचलित करायची आहे. येथेच एक सोयीस्कर, सुप्रसिद्ध प्लगइन बचावासाठी येतो. आवृत्ती-maven-प्लगइन - ते कनेक्ट करा आणि लॉन्च करा

mvn -N आवृत्त्या:सेट -DnewVersion=2.0.1

आणि मॅवेन सर्वकाही जसे पाहिजे तसे करेल: ते वरपासून खालपर्यंत पदानुक्रमाने चालेल, सर्व आवृत्त्या पुनर्स्थित करेल - सौंदर्य! आता फक्त एक पुल विनंती वाढवणे बाकी आहे, सहकारी बदलांचे पुनरावलोकन करतील आणि तुम्ही त्वरीत ट्रंकमध्ये सामील होऊ शकता. पटकन? ते कसेही असो. शंभर दोन pom.xML पुनरावलोकनासाठी, आणि हे कोड मोजत नाही. याव्यतिरिक्त, एवढ्या मोठ्या संख्येने बदललेल्या फायलींसह विलीन संघर्षांपासून कोणीही सुरक्षित नाही. येथे हे लक्षात घेतले पाहिजे की CI प्रक्रियेत, आवृत्ती बदल कार्यक्षमतेतील बदलांसह आपोआप होतात, आणि वेगळ्या प्रकारे नाही.

नवीन वैशिष्ट्ये

थोडावेळ आम्ही शांत झालो आणि स्वतःचा राजीनामा देऊन आम्ही असेच जगलो. मावेन अपाचे प्रकल्प आवृत्ती 3.5.0-बीटा-1 पासून प्रारंभ करून, मावेनने तथाकथित "प्लेसहोल्डर्स" साठी समर्थन समाविष्ट केले नाही. या पर्यायांचे सार हे आहे pom.xML प्रोजेक्ट आवृत्तीच्या विशिष्ट संकेताऐवजी, व्हेरिएबल्स वापरली जातात ${पुनरावृत्ती}, ${sha1} и ${चेंजलिस्ट}. या गुणधर्मांची मूल्ये स्वतः एकतर घटकामध्ये सेट केली जातातगुणधर्म>, किंवा ते सिस्टम गुणधर्माद्वारे परिभाषित केले जाऊ शकतात

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

मध्ये परिभाषित केलेल्या मूल्यांपेक्षा सिस्टम गुणधर्म मूल्ये प्राधान्य घेतातगुणधर्म>.

पालक

  ४.०.०
  
    org.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= स्वच्छ पॅकेज

*वरील उदाहरणे वरून घेतली आहेत लेख मावेन अपाचे प्रकल्प वेबसाइटवर

कटू वास्तव

सर्व काही चांगले आणि निरोगी आहे, समाधानाची भावना अनुभवण्याची वेळ आली आहे, परंतु नाही. हे दिसून येते की ही पद्धत स्थापित आणि उपयोजित करण्यासाठी कार्य करणार नाही, कारण ती रेपॉजिटरीमध्ये प्रकाशित केलेल्या कलाकृतींच्या वर्णनांमध्ये बदलली जाणार नाही. ${पुनरावृत्ती} त्याचा अर्थ आणि मावेन यापुढे हे काय आहे हे समजणार नाही.

    org.apache
    अपाचे
    ${पुनरावृत्ती}

बोगद्याच्या शेवटी एक प्रकाश

समस्येवर उपाय शोधायला हवा. परिस्थिती सावरता आली असती flatten-maven-plugin. हे प्लगइन पोममधील सर्व व्हेरिएबल्सचे निराकरण करते, परंतु त्याच वेळी इतर बरीच माहिती कापते जी केवळ असेंब्ली दरम्यान आवश्यक असते आणि इतर प्रकल्पांमध्ये प्रकाशित कलाकृती आयात करताना आवश्यक नसते. प्लगइन सर्व पालक-मुलांचे अवलंबित्व देखील "सरळ करते" आणि परिणामी, तुम्हाला एक फ्लॅट पोम मिळेल ज्यामध्ये तुम्हाला आवश्यक असलेल्या सर्व गोष्टींचा समावेश आहे. गैरसोय अशी होती की ते खूप "अतिरिक्त" कापते, जे आम्हाला अजिबात अनुकूल नव्हते. या प्लगइनच्या विकासाच्या माहितीचा अभ्यास केल्यानंतर, असे दिसून आले की विश्वात आपण एकटेच नाही आहोत आणि ऑगस्ट 2018 मध्ये, प्लगइन रिपॉझिटरीमध्ये गिथबवर एक पुल-विनंती तयार केली गेली होती जी हे शक्य करण्याच्या इच्छेने होते. pom.xml कसे “बिघडवायचे” हे स्वतः ठरवण्यासाठी. विकसकांनी पीडित लोकांचे आवाज ऐकले आणि आधीच डिसेंबरमध्ये, नवीन आवृत्ती 1.1.0 च्या रिलीझसह, फ्लॅटन-मेव्हन-प्लगइनमध्ये एक नवीन मोड, संकल्पसिफ्रेंडलीज ओन्ली दिसला, जो पूर्वीपेक्षा अधिक योग्य होता - तो निघून गेला. pom.xml घटक वगळता आणि परवानगी देते ${पुनरावृत्ती}, ${sha1} и ${चेंजलिस्ट}.

प्रकल्पात प्लगइन जोडत आहे

  
    org.codehaus.mojo
    flatten-maven-plugin
    १८
    
      खरे
      फक्त मैत्रीपूर्ण निराकरण करा
    
    
      
        सपाट करणे
        प्रक्रिया संसाधने
        
          सपाट करणे
        
      
      
        सपाट.स्वच्छ
        स्वच्छ
        
          स्वच्छ
        
      
    
  

झाले!

आनंदी शेवट

आतापासून, संपूर्ण प्रकल्पाची आवृत्ती बदलण्यासाठी आणि सर्व अवलंबनांना त्याबद्दल माहिती देण्यासाठी, आम्हाला फक्त घटक संपादित करणे आवश्यक आहेपुनरावृत्ती> फक्त रूट मध्ये pom.xML. समान बदल असलेल्या यापैकी शंभर-दोन फायली पुनरावलोकनात येतात, परंतु एक. बरं, वापरण्याची गरज नाही आवृत्ती-maven-प्लगइन.

स्त्रोत: www.habr.com