लेख का उद्देश्य MSBuild के बारे में थोड़ा बताना है, यह दिखाना है कि MSBuild में क्या लक्ष्य और कार्य हैं, .csproj फ़ाइल के साथ काम करना सीखें, और उपयोगी लिंक प्रदान करें। यदि आपके पास लेख के लिए अधिक उपयुक्त शीर्षक है, तो मुझे टिप्पणियों में चर्चा करने में खुशी होगी।

मेन्यू

बुनियादी अवधारणाएँ - MSBuild में लक्ष्य और कार्य क्या है
MSBuild Build Lifecycle - लक्ष्य कॉलिंग अनुक्रम क्या है?
उदाहरण के लिए पर्यावरण तैयार करना
MSBuild में लक्ष्यीकरण - कुछ MSBuild लक्ष्य का उपयोग करने का एक उदाहरण
अपना खुद का MSBuild लक्ष्य बनाना
MSBuild में कार्य - कुछ MSBuild कार्यों के उपयोग का एक उदाहरण
चर और मैक्रोज़ .csproj
संदर्भ

बुनियादी अवधारणाएँ ( मेनू )

MSBuild इस तरह से डिज़ाइन किया गया है कि परियोजना की विधानसभा को कई चरणों में विभाजित किया गया है।

लक्ष्य एक निश्चित चरण (घटना) है जो किसी परियोजना की असेंबली के दौरान होता है। आप मानक लक्ष्यों का उपयोग कर सकते हैं, या अपने स्वयं के परिभाषित कर सकते हैं।

टास्क एक ऐसा कार्य है जिसे एक निश्चित अवस्था में किया जा सकता है। आप मानक कार्यों का उपयोग कर सकते हैं या अपना खुद का बना सकते हैं।

लक्ष्यीकरण दस्तावेज़ से उद्धरण ( https://docs.microsoft.com/en-us/visualstudio/msbuild/msbuild-targets ):

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

MSBuild बिल्ड जीवनचक्र ( मेनू )

MSBuild के लिए, Microsoft ने कई मानक लक्ष्य निर्धारित किए हैं (फ़ाइलों में Microsoft.Common.targets, Microsoft.CSharp.targets, आदि)। बड़ी संख्या में विभिन्न लक्ष्यों को परिभाषित किया गया है, लेकिन इस लेख में हम इस पर विस्तार से ध्यान नहीं देंगे। कुछ मानक लक्ष्य (आदेशित):

लक्ष्य सूची (स्पॉयलर)

BeforeRebuild
स्वच्छ
BeforeBuild
BuildOnlySettings
PrepareForBuild
PreBuildEvent
ResolveReferences
PrepareResources
ResolveKeySource
संकलन
UnmanagedUnregistration
GenerateSerializationAssemblies
CreateSatelliteAssemblies
GenerateManifests
GetTargetPath
PrepareForRun
UnmanagedRegistration
IncrementalClean
PostBuildEvent
AfterBuild
AfterRebuild

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

लक्ष्य की सूची के अधिक विस्तृत दृश्य के लिए, आप / pp: विकल्प का उपयोग कर सकते हैं। इस पैरामीटर के लिए धन्यवाद, एक फ़ाइल उत्पन्न होगी जिसमें सभी आयात शामिल होंगे (.targets फ़ाइलें सहित)। आप इसमें कई लक्ष्य और चर पा सकते हैं (धन्यवाद टिप के लिए aikixd )।

उदाहरण के लिए वातावरण तैयार करना ( मेनू )

उदाहरण के लिए, आपको चाहिए:

विजुअल स्टूडियो इंस्टॉल्ड डेवलपमेंट एनवायरनमेंट
MSBuildExample नाम के कंसोल एप्लिकेशन का एक प्रोजेक्ट बनाएं
प्रोजेक्ट फ़ोल्डर खोलें और वहां MSBuildExample.csproj फ़ाइल ढूंढें
नोटपैड या किसी अन्य संपादक में MSBuildExample.csproj फ़ाइल खोलें

इस आलेख में सभी उदाहरणों में, आपको MSBuildExample.csproj फ़ाइल को संपादित करने की आवश्यकता होगी। प्रत्येक उदाहरण में पिछले उदाहरण से कोड को निकालना और एक नया जोड़ना शामिल है। कोड को अंतिम प्रोजेक्ट टैग में अंतिम पंक्ति में .csproj फ़ाइल के अंत में जोड़ा जाना चाहिए।

चेतावनी! .Csproj फ़ाइल में, केस महत्वपूर्ण है ।
उदाहरण को चलाने के लिए, आपको Visual Studio विकास वातावरण में बिल्ड चलाना चाहिए। कुछ उदाहरणों के लिए, आपको समाधान कॉन्फ़िगरेशन चुनने की आवश्यकता होगी।

परिणाम विजुअल स्टूडियो (नीचे) में आउटपुट विंडो में प्रदर्शित किया जाएगा। यदि यह नहीं है, तो इसे मेनू आइटम देखें => आउटपुट के माध्यम से खोलें।

MSBuild में लक्षित ( मेनू )

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

लक्ष्य उपयोग उदाहरण (बिगाड़ने वाला)

उदाहरण कोड:

<Target Name="AfterBuild"> <Message Text="AfterBuild event" Importance="high"></Message> </Target> <Target Name="BeforeBuild"> <Message Text="BeforeBuild event" Importance="high"></Message> </Target>

निष्पादन परिणाम (अनावश्यक बाहर रखा गया):

...
घटना से पहले
...
घटना के बाद
...

जैसा कि आप देख सकते हैं, टास्क संदेश निष्पादित किया गया था, जो हमने Visual Studio में आउटपुट विंडो में FirstBuild और AfterBuild के समय निर्दिष्ट पाठ प्रदर्शित किया था।
एक ही नाम के साथ एक लक्ष्य को परिभाषित करते समय, यह ओवरराइट किया जाता है!

लक्ष्य पुनर्लेखन उदाहरण (स्पॉइलर)

उदाहरण कोड:

 <Target Name="BeforeBuild"> <Message Text="First message" Importance="high"></Message> </Target> <Target Name="BeforeBuild"> <Message Text="Second message" Importance="high"></Message> </Target>

निष्पादन परिणाम (अनावश्यक बाहर रखा गया):

...
दूसरा संदेश
...

केवल दूसरा संदेश प्रदर्शित किया गया था, क्योंकि वे एक ही नाम के साथ लक्ष्य का उपयोग करते थे और इसे दूसरे मूल्य से अधिलेखित कर दिया गया था।

अपना खुद का MSBuild लक्ष्य ( मेनू ) बनाना

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

अपने स्वयं के लक्ष्यों (बिगाड़ने) को परिभाषित करने का उदाहरण

उदाहरण कोड:

  <Target Name="BeforeBuild"> <Message Text="BeforeBuild event" Importance="high"></Message> </Target> <Target Name="MyCustomBeforeTarget" BeforeTargets="BeforeBuild"> <Message Text="MyCustomBeforeTarget event" Importance="high"></Message> </Target> <Target Name="MyCustomAfterTarget" AfterTargets="BeforeBuild"> <Message Text="MyCustomAfterTarget event" Importance="high"></Message> </Target>

निष्पादन परिणाम (अनावश्यक बाहर रखा गया):

...
MyCustomBeforeTarget ईवेंट
घटना से पहले
MyCustomAfterTarget ईवेंट
...

दो कस्टम लक्ष्य परिभाषित किए गए थे - MyCustomBeforeTarget और MyCustomAfterTarget।
MyCustomBeforeTarget लक्ष्य को पहले दिए गए लक्ष्य से पहले निष्पादित किया जाता है क्योंकि हमने निर्दिष्ट किया था:

 BeforeTargets="BeforeBuild"

MyCustomAfterTarget लक्ष्य को प्राथमिकता के बाद निष्पादित किया जाता है क्योंकि हमने निर्दिष्ट किया था:

 AfterTargets="BeforeBuild"

MSBuild में मेनू ( मेनू )

यह आलेख चर्चा नहीं करता है कि आप अपने कार्यों को कैसे लिख सकते हैं, लेकिन कार्य लिखने से पहले , Microsoft द्वारा प्रदान किए गए कार्यों की सूची देखें।

आइए टास्क और मैक्रोज़ का उपयोग करने के कुछ उदाहरण देखें।

हालत पैरामीटर (बिगाड़ने वाला)

हालत पैरामीटर सभी कार्यों में मौजूद है। दस्तावेज़ से उद्धरण docs.microsoft.com/en-us/visualstudio/msbuild/msbuild-task-reference :

एक बूलियन अभिव्यक्ति जो MSBuild इंजन यह निर्धारित करने के लिए उपयोग करती है कि क्या यह कार्य निष्पादित किया जाएगा।

उदाहरण कोड:

 <Target Name="BeforeBuild"> <Message Text="Current configuration is Debug" Condition="'$(Configuration)' == 'Debug'" Importance="high"></Message> <Message Text="Current configuration is Release" Condition="'$(Configuration)' == 'Release'" Importance="high"></Message> </Target>

यदि डिबग कॉन्फ़िगरेशन समाधान का चयन किया जाता है, तो परिणाम इस तरह दिखेगा (अनावश्यक अपवर्जित):

...
वर्तमान कॉन्फ़िगरेशन डीबग है
...

यदि समाधान कॉन्फ़िगरेशन रिलीज़ चयनित है, तो परिणाम इस तरह दिखाई देगा (अनावश्यक बहिष्कृत):

...
वर्तमान कॉन्फ़िगरेशन रिलीज़ है
...

आप .csproj में चर और मैक्रोज़ अनुभाग में $ (कॉन्फ़िगरेशन) मैक्रो और अन्य मैक्रो के बारे में जानकारी पा सकते हैं।

शर्तों के सिंटैक्स पर जानकारी वहां देखी जा सकती है https://docs.microsoft.com/en-us/visualstudio/msbuild/msbuild-conditions

Csproj (स्पॉइलर) में परिवर्तनीय परिभाषा

ऊपर के उदाहरण में, हमारे पास पाठ है जो एकीकृत हो सकता है। दोहराव से बचने के लिए, हम संदेश पाठ को एक अलग चर में रखेंगे।

उदाहरण कोड:

 <PropertyGroup> <MessageText>Current configuration is $(Configuration)</MessageText> </PropertyGroup> <Target Name="BeforeBuild"> <Message Text="$(MessageText)" Condition="'$(Configuration)' == 'Debug'" Importance="high"></Message> <Message Text="$(MessageText)" Condition="'$(Configuration)' == 'Release'" Importance="high"></Message> </Target>

अपने स्वयं के चर को परिभाषित करने के लिए, संपत्ति समूह तत्व का उपयोग करें।

फ़ाइल के अस्तित्व की जाँच करना, एक त्रुटि जारी करना (बिगाड़ना)

इस उदाहरण में, हम एक कार्य करते हैं जो यह जाँचता है कि क्या App.Debug.config फ़ाइल बनाई गई है। यदि यह नहीं बनाया जाता है, तो हम एक त्रुटि फेंकते हैं। एक त्रुटि के मामले में, बिल्ड को रोक दिया जाएगा और त्रुटि सूची विंडो में संकलन त्रुटियों के रूप में प्रदर्शित की जाएगी।
हम त्रुटि कार्य और स्थिति पैरामीटर का उपयोग करते हैं जो पहले से ही हमारे परिचित हैं।

उदाहरण कोड:

 <Target Name="BeforeBuild"> <Error Condition="!Exists('App.Debug.config')" Text="File App.Debug.config not found"></Error> </Target>

परिणाम:

एक्ज़िस्ट क्लॉज़ उस फ़ोल्डर से संबंधित पथ का उपयोग करता है जिसमें .csproj फ़ाइल स्थित होती है। वर्तमान एक से ऊपर के फ़ोल्डर का उपयोग करने के लिए '../' का उपयोग करें। यदि आपको सबफ़ोल्डर तक पहुंचने की आवश्यकता है, तो '[DirectoryName] /App.Debug.config' प्रारूप का उपयोग करें।

फ़ाइलें कॉपी करना (बिगाड़ना)

इस उदाहरण में, हम कॉपी कार्य का उपयोग करेंगे। कार्य का उपयोग करते हुए, App.config फ़ाइल को बिन / [कॉन्फ़िगरेशन] / कॉन्फ़िगरेशन फ़ोल्डर में दो App.config और App.test.config फ़ाइलों में कॉपी करें।

उदाहरण कोड:

 <Target Name="BeforeBuild"> <Copy SourceFiles="App.config;App.config" DestinationFiles="$(OutputPath)/Test/App.config;$(OutputPath)/Test/App.test.config"></Copy> </Target>

SourceFiles संपत्ति डाउनलोड की जाने वाली फ़ाइलों की एक सरणी है। उद्धरण चिह्नों के बिना संकेत, अर्धविराम द्वारा अलग किए गए।

डेस्टिनेशनफाइल्स प्रॉपर्टी फाइलों की एक ऐसी श्रेणी है जहां फाइलों की नकल की जाएगी। उद्धरण चिह्नों के बिना संकेत, अर्धविराम द्वारा अलग किए गए।

वेरिएबल्स और मैक्रोज़ इन .csproj पर अनुभाग में $ (आउटपुटपाथ) मैक्रो के बारे में अधिक पढ़ें।

चर और मैक्रोज़ .csproj ( मेनू )

.Csproj फ़ाइल में कई मानक मैक्रोज़ का उपयोग किया जा सकता है, उनमें से एक सूची https://msdn.microsoft.com/en-us/library/c02as0cs.aspx पर देखी जा सकती है और यहाँ https://msdn.microsoft.com/en-us/ पुस्तकालय / bb629394.aspx । कुछ उपयोगी मैक्रोज़ पर विचार करें:

$ (MSBuildToolsPath) - MSBuild फ़ोल्डर के लिए पथ को इंगित करता है। उदाहरण के लिए, C: \ Program Files (x86) \ MSBuild \ 14.0 \ Bin। पथ का संयोजन करते समय, इस मैक्रो का उपयोग स्लैश के साथ करें। उदाहरण के लिए, $ (MSBuildToolsPath) \ Microsoft.eb.Publishing.Tasks.dll। अन्यथा, यह गलत तरीके से पथ बना सकता है और एक त्रुटि दे सकता है जो फ़ाइल नहीं मिली।
$ (आउटपुटपाथ) - आउटपुट फ़ोल्डर के सापेक्ष पथ। उदाहरण के लिए, बिन \ स्टेज। इस मैक्रो का उपयोग स्लैश के साथ करें, उदाहरण के लिए, $ (OutputPath) \ $ (TargetFileName) .config।
$ (TargetFileName) - एक्सटेंशन के साथ आउटपुट फ़ाइल का नाम। उदाहरण के लिए, MSBuildExample.exe। आउटपुट फ़ाइल नाम का विस्तार और प्रारूप विभिन्न प्रकार की परियोजनाओं से भिन्न हो सकते हैं। इस मैक्रो का उपयोग करके, आप सुरक्षित रूप से निर्धारित कर सकते हैं कि कॉन्फ़िगरेशन फ़ाइल का नाम क्या होगा। यह विन्यास परिवर्तनों के लिए उपयोगी हो सकता है।
$ (कॉन्फ़िगरेशन) वर्तमान कॉन्फ़िगरेशन का नाम है। उदाहरण के लिए, रिलीज़, डीबग
$ (IntermediateOutputPath) - obj फ़ोल्डर का पथ। उदाहरण के लिए, obj \ स्टेज।

अपने स्वयं के मापदंडों को परिभाषित करने के लिए, संपत्ति समूह का उपयोग करें। अपने स्वयं के चर को परिभाषित करने का एक उदाहरण MSBuild में कार्य अनुभाग में पाया जा सकता है।

MSBuild के साथ निर्माण प्रक्रिया का विस्तार

मेन्यू

बुनियादी अवधारणाएँ ( मेनू )

MSBuild बिल्ड जीवनचक्र ( मेनू )

उदाहरण के लिए वातावरण तैयार करना ( मेनू )

MSBuild में लक्षित ( मेनू )

अपना खुद का MSBuild लक्ष्य ( मेनू ) बनाना

MSBuild में मेनू ( मेनू )

चर और मैक्रोज़ .csproj ( मेनू )

लिंक ( मेनू )

More articles: