डेस्कटॉप ऐप्स को .NET कोर में पोर्ट करना

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

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

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

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

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

चरण 1 - पोर्टेबिलिटी विश्लेषक चलाएँ

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

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

चरण 2 - एसडीके-शैली के लिए माइग्रेट करें। csproj

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

• यदि आपके प्रोजेक्ट में एक packages.config फ़ाइल है, तो समाधान एक्सप्लोरर में देखें। यदि आप नहीं करते हैं, तो किसी भी कार्रवाई की आवश्यकता नहीं है, यदि आप करते हैं, तो package.config पर राइट-क्लिक करें और PackageReference के लिए संकुल को माइग्रेट करें ।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 मिला है, तो पूरे <ItemGroup> को अपनी प्रोजेक्ट फ़ाइल में PackageReference करें, जो Visual Studio में खोली गई है, जो ऊपर दिए गए चरण में आपके द्वारा चिपकाए गए लाइनों के ठीक नीचे है। यह आपके द्वारा पाए गए PackageReference की प्रत्येक घटना के लिए करें। कॉपी किए गए ब्लॉक को इस तरह दिखना चाहिए।
  
  

   <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> 

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

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

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

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

  
  

  स्टेप 3 - .NET Core को रिटारगेट करें

  
  

  समाधान एक्सप्लोरर में अपनी परियोजना पर डबल-क्लिक करके अपनी परियोजना फ़ाइल खोलें। संपत्ति का पता लगाएं <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.0 के लिए .NET कोर 3 पोर्टिंग के साथ आने वाली सभी नई चीजों के बारे में बात कर रहे हैं।