डेस्कटॉप अनुप्रयोगों को .NET कोर में पोर्ट करना

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

• यह पोस्ट एक साधारण मामला है । यह सरल निर्देशों और छोटे अनुप्रयोगों पर केंद्रित है और किसी अनुप्रयोग को .NET कोर में पोर्ट करने का सबसे आसान तरीका है।
• बाद में हम अधिक जटिल मामलों के लिए एक और पोस्ट प्रकाशित करेंगे । यह गैर-तुच्छ अनुप्रयोगों पर ध्यान केंद्रित करेगा, जैसे कि डब्ल्यूसीएफ पर निर्भरता के साथ एक डब्ल्यूपीएफ आवेदन और तीसरे पक्ष के यूआई पैकेज।

यदि आप पढ़ने के बजाय एक वीडियो देखना पसंद करते हैं, तो यहां एक वीडियो है जहां मैं नीचे वर्णित सब कुछ करता हूं।

चरण ० - पूर्वापेक्षाएँ

डेस्कटॉप एप्लिकेशन को कोर में स्थानांतरित करने के लिए, आपको .NET कोर 3 और विजुअल स्टूडियो 2019 की आवश्यकता होगी।

चरण 1 - पोर्टेबिलिटी विश्लेषक लॉन्च करें

पोर्ट करने से पहले, आपको यह जांचना चाहिए कि .NET कोर के साथ आपका एप्लिकेशन कितना संगत है। ऐसा करने के लिए, .NET पोर्टेबिलिटी एनालाइज़र को डाउनलोड करें और चलाएं।

• पहले टैब पर, पोर्टेबिलिटी सारांश, यदि .NET कोर कॉलम के सभी मान 100% हैं (सब कुछ हरे रंग में हाइलाइट किया गया है), आपका कोड पूरी तरह से संगत है, और आप चरण 2 पर जा सकते हैं।
• यदि आपके पास 100% से कम मूल्य हैं, तो पहले उन सभी विधानसभाओं को देखें जो आपके आवेदन का हिस्सा नहीं हैं। उनके लिए, आपको यह जांचने की आवश्यकता है कि क्या उनके लेखक .NET कोर या .NET मानक के लिए संस्करण प्रदान करते हैं।
• अब असेंबली के दूसरे भाग को देखें जो आपके कोड से आता है। यदि पोर्टेबिलिटी रिपोर्ट में कोई असेंबली निर्दिष्ट नहीं है, तो चरण 2 पर जाएं। एक बार ऐसा करने के बाद, विवरण टैब खोलें, असेंबली कॉलम पर क्लिक करके तालिका को फ़िल्टर करें और केवल उन पर ध्यान केंद्रित करें जो आपके आवेदन से संबंधित हैं। एपीआई का उपयोग बंद करने के लिए सूची या कोड के माध्यम से ब्राउज़ करें या .NET कोर विकल्पों के साथ एपीआई का उपयोग करके प्रतिस्थापित करें।

चरण 2 - माइग्रेट करना .csproj से SDK स्टाइल

समाधान एक्सप्लोरर में, अपनी परियोजना पर राइट-क्लिक करें (समाधान नहीं!)। क्या आप प्रोजेक्ट फ़ाइल संपादित करते हैं? यदि हां, तो आप पहले से ही एसडीके-स्टाइल प्रोजेक्ट फ़ाइल का उपयोग कर रहे हैं, इसलिए आपको चरण 3 पर जाना चाहिए। यदि नहीं, तो निम्न कार्य करें:

• यदि प्रोजेक्ट में पैकेज .config फ़ाइल है, तो समाधान एक्सप्लोरर में देखें। यदि यह नहीं है, तो कोई कार्रवाई की आवश्यकता नहीं है, लेकिन अगर यह है, तो संकुल पर राइट-क्लिक करें ।config और PackageReference के लिए Migrate package.config का चयन करें । फिर ओके पर क्लिक करें।
• प्रोजेक्ट पर राइट-क्लिक करके और अनलोड प्रोजेक्ट का चयन करके प्रोजेक्ट फ़ाइल खोलें। फिर प्रोजेक्ट पर राइट-क्लिक करें और Edit <your project name> .csproj चुनें ।
• उदाहरण के लिए, कहीं न कहीं, प्रोजेक्ट फ़ाइल की सामग्री को कॉपी करें, ताकि आप बाद में उसे खोज सकें।
• विज़ुअल स्टूडियो में खोले गए प्रोजेक्ट फ़ाइल से सब कुछ हटा दें (मुझे पता है कि यह आक्रामक लगता है, लेकिन हम केवल उस प्रतिलिपि से आवश्यक सामग्री जोड़ेंगे जो हमने कुछ चरणों में बनाई थी)। केवल हटाए गए पाठ के बजाय, निम्न कोड पेस्ट करें।
  
  WinForms पर एक आवेदन के लिए:
  
  

  <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop"> <PropertyGroup> <OutputType>WinExe</OutputType> <TargetFramework>net472</TargetFramework> <UseWindowsForms>true</UseWindowsForms> <GenerateAssemblyInfo>false</GenerateAssemblyInfo> </PropertyGroup> </Project> 

  
  एक WPF आवेदन के लिए:
  
  

   <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop"> <PropertyGroup> <OutputType>WinExe</OutputType> <TargetFramework>net472</TargetFramework> <UseWPF>true</UseWPF> <GenerateAssemblyInfo>false</GenerateAssemblyInfo> </PropertyGroup> </Project> 

• नोटपैड PackageReference खोजें। यदि आपको कुछ नहीं मिला है, तो आगे बढ़ें। यदि आप एक PackageReference पाते हैं, तो ऊपर दिए गए चरण में सम्मिलित लाइनों के ठीक नीचे, Visual Studio में खोले गए प्रोजेक्ट फ़ाइल में PackageReference वाले पूरे ItemGroup की प्रतिलिपि बनाएँ। प्रत्येक पैकेजप्रबंधन तत्व के लिए ऐसा करें जो आपको मिला था। कॉपी किए गए ब्लॉक को इस तरह दिखना चाहिए:
  
  

   <ItemGroup> <PackageReference Include="NUnit"> <Version>3.11.0</Version> </PackageReference> </ItemGroup> 

• अब ProjectReference के लिए ऊपर की तरह ही करें। यदि आपको कुछ नहीं मिला है, तो आगे बढ़ें। यदि आपको कोई ProjectReference तत्व मिलते हैं, तो वे इस तरह दिखाई देंगे:
  
  

   <ItemGroup> <ProjectReference Include="..\WindowsFormsApp1\WindowsFormsApp1.csproj"> <Project>{7bce0d50-17fe-4fda-b6b7-e7960aed8ac2}</Project> <Name>WindowsFormsApp1</Name> </ProjectReference> </ItemGroup> 

• आप प्रोजेक्ट और नाम गुणों के साथ लाइनें हटा सकते हैं, क्योंकि प्रोजेक्ट फ़ाइल की नई शैली में उनकी आवश्यकता नहीं है। तो प्रत्येक ProjectReference के लिए जो आपको मिला (यदि कोई हो), केवल ItemGroup और ProjectReference की प्रतिलिपि बनाएँ ।
  
  

   <ItemGroup> <ProjectReference Include="..\WindowsFormsApp1\WindowsFormsApp1.csproj" /> </ItemGroup> 

• यह सब बचाओ। Visual Studio में .csproj फ़ाइल बंद करें। समाधान एक्सप्लोरर में अपनी परियोजना को राइट-क्लिक करें और रीलोड प्रोजेक्ट चुनें। पुनर्निर्माण करें और सुनिश्चित करें कि कोई त्रुटि नहीं है।

बड़ी खबर है, आपने अपनी परियोजना फ़ाइल को एक नए एसडीके शैली में अपडेट किया है! प्रोजेक्ट अभी भी .NET फ्रेमवर्क पर लक्षित है, लेकिन अब आप इसे .NET कोर में फिर से कॉन्फ़िगर कर सकते हैं।

चरण 3 - .NET कोर पर रिटारगेट

समाधान एक्सप्लोरर में डबल क्लिक करके प्रोजेक्ट फ़ाइल खोलें। TargetFramework गुण ढूंढें और मान को netcoreapp3.0 में बदलें । आपकी प्रोजेक्ट फ़ाइल अब इस तरह दिखनी चाहिए:

 <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop"> <PropertyGroup> <OutputType>WinExe</OutputType> <TargetFramework>netcoreapp3.0</TargetFramework> ... </PropertyGroup> ... </Project> 

अपनी परियोजना बनाएं और चलाएं। बधाई हो, आपने इसे .NET कोर 3 में स्थानांतरित कर दिया है!

बग ठीक करना

यदि आप त्रुटियों की तरह सामना करते हैं

 The type or namespace <some name> could not be found 

या

 The name <some name> does not exist in the current context 

और यदि आपकी पोर्टेबिलिटी रिपोर्ट हरे रंग में प्रदर्शित होती है, तो आपको पता होना चाहिए कि उपयुक्त लाइब्रेरी के साथ केवल NuGet पैकेज जोड़कर उन्हें ठीक करना आसान है। यदि आप लापता पुस्तकालय के साथ NuGet पैकेज को खोजने में असमर्थ हैं, तो Microsoft.Windows.Compatibility से संपर्क करने का प्रयास करें। यह पैकेज .NET फ्रेमवर्क से ~ 21K .NET एपीआई जोड़ता है।

डिजाइनरों के साथ काम करें

यद्यपि एप्लिकेशन का उपयोगकर्ता इंटरफ़ेस कोड का उपयोग करके संपादित किया जा सकता है, डेवलपर्स आमतौर पर विज़ुअल कंस्ट्रक्टर का उपयोग करना पसंद करते हैं। .NET कोर के साथ, हमें .NET कोर परियोजनाओं के साथ डिजाइनरों के काम की वास्तुकला को बदलना पड़ा:

• WPF डिज़ाइनर पहले से पूर्वावलोकन मोड में है, और हम इसमें अतिरिक्त सुविधाएँ जोड़ने पर काम कर रहे हैं।
• .NET कोर के लिए WinForms डिज़ाइनर बाद में उपलब्ध होगा, इसलिए अभी के लिए, आप .NET फ्रेमवर्क के लिए WinForms डिज़ाइनर को वर्कअराउंड के रूप में उपयोग कर सकते हैं।

.NET फ्रेमवर्क के लिए WinForms कंस्ट्रक्टर का उपयोग कैसे करें:

1. .Csproj फ़ाइल की प्रतिलिपि बनाएँ (उदाहरण के लिए, MyProject.csproj ), इसे एक अलग नाम दें, उदाहरण के लिए, MyProject.NetFramework.csproj, और इसे मौजूदा प्रोजेक्ट फ़ाइल के बगल में रखें।
2. सुनिश्चित करें कि आपका प्रोजेक्ट Visual Studio में बंद है, एक नई परियोजना MyProject.NetFramework.csproj खोलें।
   समाधान एक्सप्लोरर में, अपनी परियोजना पर राइट-क्लिक करें और गुण चुनें। एप्लिकेशन टैब पर (डिफ़ॉल्ट रूप से खोलना चाहिए) असेंबली का नाम और डिफ़ॉल्ट नेमस्पेस को उन्हीं मानों के रूप में सेट करें, जैसे मूल (हटाएं ".NetFramework" नामों से)।
   अपने मौजूदा समाधान के आगे इस समाधान को सहेजें।
   
3. एक नई परियोजना फ़ाइल खोलें और TargetFramework को net472 में बदलें ।
4. अब आपको WinForms कंस्ट्रक्टर का उपयोग करने की आवश्यकता है, MyProject.NetFramework.csproj से अपना प्रोजेक्ट डाउनलोड करें और आप .NET फ्रेमवर्क कंस्ट्रक्टर के साथ काम करना शुरू कर सकते हैं। जब आप इसके साथ हो जाते हैं, तो .NET कोर प्रोजेक्ट फ़ाइल के साथ अपनी परियोजना को बंद करें और खोलें।
5. .NET कोर के लिए WinForms कंस्ट्रक्टर तैयार होने तक यह केवल एक समाधान है।

क्यों .NET कोर पर स्विच करें?

एक वीडियो देखें जहां स्कॉट हंटर और मैं .NET कोर 3 के सभी नवीनतम अपडेट के बारे में बात करते हैं। .NET कोर 3.0 पर माइग्रेट करना ।