👩🏻‍🤝‍👨🏾 ✌🏾 👩🏿‍🤝‍👨🏼 JIRA: प्लगइन्स बनाना। फ्रेमवर्क सुविधाएँ 😩 🍠 👨🏻‍⚕️

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

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

प्लगइन निर्माण

यह अपने स्थान (कमांड लाइन cd C: \ your_directory में ) के लिए निर्देशिका का चयन करके शुरू होता है, जिसके बाद प्लग-इन कंकाल एटलस-क्रिएट-जीरा-प्लगइन कमांड के साथ बनाया जाता है। सेटिंग्स का एक विकल्प की पेशकश की है। नाम, संस्करण, आदि चुनने के बाद ऐसे सरल ऑपरेशन के बाद, हम एक कंकाल के साथ समाप्त होते हैं। कंकाल में निम्नलिखित मुख्य भाग होते हैं:

Pom.xml फ़ाइल

प्लगइन की जड़ में स्थित है। इस xml फ़ाइल में नाम, प्लगइन का संस्करण, इसके बारे में जानकारी (डेवलपर, उदाहरण के लिए) और सबसे महत्वपूर्ण बात, आवश्यक पुस्तकालय हैं।
ऊपर उल्लिखित साइट पर ट्यूटोरियल में पर्याप्त उदाहरण हैं, हालांकि मैं कुछ समस्या क्षेत्रों को रेखांकित करूंगा।
यदि प्लगइन कमांड लाइन पर एटलस-मवन क्लीन पैकेज या एटलस-रन कमांड के साथ नहीं बनाया गया है, और सिंटैक्स त्रुटियों को प्रदर्शित नहीं करता है, तो यह pom.xml फ़ाइल में है।
सबसे सामान्य कमांड लाइन त्रुटियां:
1) जीरा-कोर निर्भरता को अनियंत्रित नहीं किया गया था, जो कि अधिकांश जीरा पुस्तकालयों तक पहुंच प्रदान करता है और आवश्यक है यदि आप कम से कम कुछ ऐसा करने जा रहे हैं जो न्यूनतम मानक कार्यक्षमता से परे जाता है।
2) pom.xml फ़ाइल में काफी त्रुटि नहीं है, लेकिन मेरा बहुत समय व्यतीत हुआ। यदि आपके पास घर पर / काम पर / जहां आप कोड करते हैं, उस जगह पर एक प्रॉक्सी है, तो मावेन कॉन्फ़िगरेशन फ़ाइल में प्रॉक्सी को सावधानीपूर्वक कॉन्फ़िगर करें । यह कैसे करें - एटलसियन वेबसाइट देखें।
3) आवश्यक पुस्तकालय पंजीकृत नहीं हैं। और यहां एक समस्या उत्पन्न हो सकती है: मावेन में बाहरी पुस्तकालयों की स्थापना मावेन वेबसाइट पर वर्णित है, हालांकि, यदि हम एटलसियन एसडीके के साथ काम कर रहे हैं, तो mvan इंस्टॉल चलाएं : mvn .bat फ़ाइल के लिए पूर्ण पथ के साथ स्थापित करें, जो निम्नानुसार है। : C: \ Atlassian \ atlassian-plugin-sdk \ Apache-maven \ bin \ mvn इंस्टॉल करें: स्थापित करें ..... , जिसके बाद आपको लाइब्रेरी को% Atlassian -HOME% \ atlassian-plugin-sdk पर स्थित Maven रिपॉजिटरी में जोड़ना होगा। \ _ भंडार

एटलसियन- plugin.xml फ़ाइल

Src / main / resource में स्थित है।
यह फ़ाइल सिस्टम और प्लगइन के बीच की स्थापना के समय बातचीत के लिए पूरी तरह से जिम्मेदार है। यह उन मॉड्यूल का वर्णन करता है जो प्लगइन में शामिल होंगे, घटक और संसाधन जो प्लगइन का उपयोग करता है (स्थानीयकरण फ़ाइलें, जावास्क्रिप्ट, सीएसएस, छवियां)। एटलसियन द्वारा सभी संभावित मॉड्यूल की पहचान की जाती है, पूरी सूची के लिए फिर से उसी स्थान पर । ये मॉड्यूल कार्यों के कार्यान्वयन के लिए पर्याप्त हैं। सहित, आप कुछ JIRA वर्गों को ओवरराइड कर सकते हैं।
इसके अलावा, एक चीज जो शुरुआती लोगों के लिए पूरी तरह से स्पष्ट नहीं है, वह इस फाइल में लिखी गई है: जावा कक्षाओं और वेग टेम्पलेट्स के बीच का संबंध। वेलोसिटी एक पेज टेम्प्लेट लैंग्वेज है जैसे jsp। पास्कल के समान इसका अपना सरल वाक्य विन्यास है। मुख्य कार्य - जावा कक्षाओं से इसे पारित करने वाले मापदंडों के आधार पर, आंशिक रूप से (हमारे मामले में) या पूरी तरह से पृष्ठ कोड उत्पन्न करते हैं। यह विभिन्न स्थितियों को सेट कर सकता है, चक्र आदि कर सकता है। इसके अलावा, वेग कोड HTML और जावास्क्रिप्ट दोनों के साथ संगत है, जो इसे एक शक्तिशाली उपकरण बनाता है।
Atlassian-plugin.xml में एक कस्टम फ़ील्ड मॉड्यूल बनाने के उदाहरण पर विचार करें, यह atlassian-plugin.xml फ़ाइल के निर्माण के सिद्धांतों को समझने के लिए सबसे अच्छा है, साथ ही साथ वेग टेम्पलेट्स। फिर हमारे पास निम्नलिखित कोड होंगे:

<customfield-type name="MyCF" i18n-name-key="my-first-cf" key="MyCf" class="com.example.cf"> <description key="field-desc">The new field</description> <resource name="view" type="velocity" location="/templates/view.vm"/> <resource name="edit" type="velocity" location="/templates/edit.vm"/> </customfield-type>

आइए इसे और अधिक विस्तार से विचार करें:
name - मॉड्यूल का नाम जिसे आप इंस्टॉल किए गए प्लगइन को देखते समय देखेंगे
i18n-name-key - वह कुंजी जिसके द्वारा JIRA मानव-पठनीय मॉड्यूल नाम .properties फ़ाइल (विशेष रूप से आंतरिककरण के लिए प्रासंगिक, अर्थात् कई भाषाओं में प्लगइन का अनुवाद) के लिए खोज करेगा।
वर्ग - जावा वर्ग जो क्षेत्र के व्यवहार को परिभाषित करता है। किसी क्षेत्र के मूल्य को देखने / संपादित करने का प्रयास करने पर कुछ तरीकों से इसे हर बार निष्पादित किया जाता है, कुछ मूल्य की वैधता की जांच करने के लिए। हालाँकि, यह एक अलग कहानी है।
विवरण - सब कुछ नाम के साथ है, केवल वर्णन के लिए
और, शायद, सबसे दिलचस्प, संसाधन । यहां, कस्टम फ़ील्ड्स के लिए वेग फ़ाइलों को हमेशा इंगित किया जाता है, जो विभिन्न स्थितियों में फ़ील्ड को प्रदर्शित करने के लिए ज़िम्मेदार होगा, जैसे कि फ़ील्ड को संपादित करना, फ़ील्ड को देखना, "क्वेरी के लिए खोज" में फ़ील्ड को देखना, फ़ील्ड को xml के रूप में आउटपुट करते समय देखना आदि।

वेग की फाइलें

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

.Properties फ़ाइलें

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

एक प्लगइन मॉड्यूल बनाना

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

ग्रहण में आयात के लिए एक परियोजना तैयार करना

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

अद्यतन: मैं Intellij IDEA में प्लगइन्स बनाने की कोशिश करने के बाद, मुझे एहसास हुआ कि IDEA मेरी पसंद है। .Pom फ़ाइलों में परिभाषित अधिकांश निर्भरताएँ स्वचालित रूप से (cmd में कमांड के बिना) लोड की जाती हैं, जो समय और तंत्रिकाओं को महत्वपूर्ण रूप से बचाता है।

फिनिश लाइन

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

JIRA: प्लगइन्स बनाना। फ्रेमवर्क सुविधाएँ