MsBuild न्यूनतम परियोजना

संभवतः, MsBuild प्रोजेक्ट बिल्डिंग सिस्टम से परिचित हर प्रोग्रामर को मौजूदा बिल्डिंग प्रक्रिया का विस्तार नहीं करने का विचार था, लेकिन खरोंच से इसके साथ आ रहा था। दूसरे शब्दों में, मौजूदा प्रकार के प्रोजेक्ट्स में एक और प्रकार जोड़ें। csproj (C # प्रोजेक्ट) और .vbproj (VB.NET प्रोजेक्ट) (उदाहरण के लिए, .myproj या just .proj)। और किसी ने, शायद इस विचार को भी लागू करने की कोशिश की।

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

इस लेख में, मैं इस विषय पर अपने स्वयं के शोध प्रस्तुत करता हूं।

समस्या का बयान

विज़ुअल स्टूडियो 2008 परियोजनाओं की समझ में "साधारण" पर लगाए गए न्यूनतम आवश्यकताओं को निर्धारित करने के लिए, एक परियोजना बनाएं:

• निर्माण प्रक्रिया में कोई कार्रवाई नहीं करता है;
• विजुअल स्टूडियो 2008 में सही ढंग से खुलता और प्रदर्शित होता है;
• अन्य परियोजनाओं के लिए निर्भरता की सूची में जोड़ा जा सकता है;
• कई फाइलें शामिल हैं;
• सभी प्रोजेक्ट फ़ाइलों को आउटपुट माना जाता है, अर्थात आश्रित परियोजनाओं के आउटपुट निर्देशिकाओं में कॉपी किया जाना चाहिए।

निर्णय प्रक्रिया

इस समस्या को हल करने की प्रक्रिया काफी जटिल है, और इसलिए इस लेख के दायरे से परे है। मैं केवल यह कह सकता हूं कि निर्णय प्रक्रिया में निम्नलिखित उपकरणों का उपयोग किया गया था:

1. MSDN पर MsBuild संदर्भ ;
2. पाठ संपादक;
3. फ़ाइल% विंडर% \ Microsoft.NET \ Framework \ v3.5 \ Microsoft.Common.targets की सामग्री;
4. विकल्प / v: d और / v: msbuild.exe प्रोग्राम का आरेख;
5. cygwin बंडल से grep.exe प्रोग्राम।

निर्णय

निम्न प्रोजेक्ट फ़ाइल सभी आवश्यकताओं को पूरा करती है (और आगे के विस्तार के लिए उपयुक्त है):

<?xml version="1.0" encoding="utf-8"?> <Project ToolsVersion="3.5" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> <PropertyGroup> <ProjectGuid>{F4279D30-8B96-4217-B811-D2912FAD2C71}</ProjectGuid> </PropertyGroup> <ItemGroup> <BuiltProjectOutputGroupKeyOutput Include="SuperLibrary.dll" /> </ItemGroup> <ItemGroup> <Content Include="logo.bmp" /> <Content Include="help.html" /> </ItemGroup> <Target Name="Build" Outputs="" /> <Target Name="Rebuild" /> <Target Name="Clean" /> <Target Name="GetTargetPath" Outputs="" /> <Target Name="GetNativeManifest" Outputs="" /> <Target Name="GetCopyToOutputDirectoryItems" Outputs="@(_Content)"> <ItemGroup> <Content Include="@(BuiltProjectOutputGroupKeyOutput)" /> <_Content Include="@(Content->'%(FullPath)')"> <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory> <TargetPath>%(Filename)%(Extension)</TargetPath> </_Content> </ItemGroup> </Target> </Project> 

निष्कर्ष

उपरोक्त परियोजना फ़ाइल पर काम करने की प्रक्रिया में, हमने सभी प्रोजेक्ट फाइलों पर विजुअल स्टूडियो 2008 द्वारा लगाए गए निम्नलिखित आवश्यकताओं का पता लगाया:

1. प्रोजेक्ट फ़ाइल में उन भाषाओं से संबंधित एक्सटेंशन होना चाहिए जो MsBuild, यानी .csproj या .vbproj का उपयोग करती हैं, लेकिन किसी भी तरह से .myproj नहीं;
2. ProjectGuid गुण प्रोजेक्ट फ़ाइल में मौजूद होना चाहिए;
3. परियोजना में एक तत्व होना चाहिए। अंतर्निहित ProProputOutputGroupKeyOutput के साथ एक्सटेंशन .dll या .exe (यह तत्व आयात किया जा सकता है);
4. प्रोजेक्ट फ़ाइल में निर्दिष्ट सभी तत्व (लेकिन अन्य फ़ाइलों से आयातित नहीं हैं!) समाधान एक्सप्लोरर में प्रदर्शित किए जाते हैं और डिस्क पर मौजूद होना चाहिए (अन्य फ़ाइलों से आयातित तत्व जीयूआई में प्रदर्शित नहीं होते हैं);
5. प्रोजेक्ट में बिल्ड, रीबिल्ड और क्लीन गोल होने के साथ-साथ GetTargetPath, GetNativeManifest और GetCopyToOutputDirectoryItem फ़ंक्शन लक्ष्य होने चाहिए;
6. बिल्ड और GetTargetPath लक्ष्यों को परियोजना की प्राथमिक आउटपुट फ़ाइल के आउटपुट को इंगित करना चाहिए (लेकिन अगर कोई प्राथमिक उत्पाद नहीं है तो कुछ भी वापस नहीं किया जा सकता है);
7. GetNativeManifest का लक्ष्य परियोजना के प्रकट होने पर वापस लौटना है;
8. GetCopyToOutputDirectoryItems का लक्ष्य उन फ़ाइलों की सूची वापस करना है जो परियोजना के लिए आउटपुट हैं;
9. फ़ंक्शन लक्ष्य (बिल्ड सहित) द्वारा लौटाए गए सभी तत्वों के लिए, आपको विशेष रूप से पूर्ण पथ (चूंकि इन तत्वों को परियोजनाओं के बीच स्थानांतरित किया जाता है) का उपयोग करना चाहिए;
10. GetCopyToOutputDirectoryItems लक्ष्य द्वारा लौटाए गए सभी तत्वों में हमेशा या संरक्षित करने के लिए CopyToOutputDirectory मेटाडेटा सेट होना चाहिए;
11. GetCopyToOutputDirectoryItems लक्ष्य द्वारा लौटाए गए सभी तत्वों के लिए, TargetPath मेटाडेटा को निर्दिष्ट किया जाना चाहिए, जिसका अर्थ फ़ाइल के नाम के सापेक्ष है जब इसे किसी अन्य प्रोजेक्ट के आउटपुट निर्देशिका में कॉपी किया जाता है (एक अच्छा डिफ़ॉल्ट% है) (Filename)% (एक्सटेंशन), ​​अर्थात, स्रोत तत्व का नाम और विस्तार)।

मैं पुष्टि करता हूं कि इन आवश्यकताओं को पूरा करने वाला कोई भी प्रोजेक्ट विजुअल स्टूडियो 2008 में खोला जा सकता है, अन्य परियोजनाओं के साथ-साथ किसी अन्य परियोजना की निर्भरता सूची में जोड़ा जा सकता है।