विनयूआई

WinUI 3 के साथ विकसित करने की तैयारी करें

पेज अद्यतन :
पेज निर्माण की तारीख :

परिचालन का वातावरण

विंडोज़
  • विंडोज 11
विजुअल स्टूडियो
  • विजुअल स्टूडियो 2022 संस्करण 17.9.3
।जाल
  • .नेट 6
  • (.नेट 8)
विनयूआई
  • विनयूआई 3
विंडोज ऐप एसडीके
  • 1.4.230913002

आवश्यकताएँ

कुछ मामलों में, निचले संस्करण भी काम कर सकते हैं।

विंडोज़
  • विंडोज 10
  • विंडोज 11
विजुअल स्टूडियो
  • Visual Studio 2022 संस्करण 17.9.3 या बाद का संस्करण
।जाल
  • .नेट 6
  • (.नेट 8)
विंडोज ऐप एसडीके
  • 1.4.230913002 या बाद का संस्करण

Visual Studio स्थापित करें और WinUI सेट करें

WinUI 3 विकास परियोजनाओं Visual Studio स्थापना के साथ जोड़ा जा सकता है। यह खंड Visual Studio स्थापना प्रक्रिया का एक सरलीकृत वर्णन प्रदान करता है। विस्तृत निर्देशों के लिए, कृपया निम्नलिखित युक्तियों को देखें।

इंटरनेट या मीडिया से विजुअल स्टूडियो 2022 इंस्टॉलर लॉन्च करें। यह समुदाय, व्यावसायिक या उच्चतर संस्करणों का समर्थन करता है।

कार्यभार चयन में, चुनें. नेट डेस्कटॉप विकास।

「. नेट डेस्कटॉप डेवलपमेंट और दाईं ओर इंस्टॉलेशन विवरण से विंडोज ऐप एसडीके सी # टेम्प्लेट की जांच करें।

अब बस स्थापना शुरू करें। अन्य स्क्रीन हैं, लेकिन जब तक वे कोई प्रोजेक्ट नहीं बनाते तब तक मैं उन्हें समझाऊंगा नहीं।

एक बार स्थापना पूर्ण हो जाने के बाद, एक नया प्रोजेक्ट बनाएं।

ऊपर दाईं ओर winui खोज आइटम में एक है, इसलिए जब आप इसे चुनते हैं, तो WinUI 3 प्रोजेक्ट टेम्पलेट प्रदर्शित किया जाएगा, इसलिए किसी भी टेम्पलेट का चयन करें और एक प्रोजेक्ट बनाएं।

अब आप WinUI 3 का उपयोग करके एप्लिकेशन विकसित कर सकते हैं।

अगर आपको ".NET का वह वर्शन लक्षित करना जो स्थापित नहीं है" दिखाई देता है

विजुअल स्टूडियो 2022 संस्करण 17.9.1 के अनुसार, WinUI 3 के लिए .NET .NET 6 को लक्षित करता है। यदि आप विजुअल स्टूडियो 2022 में किसी अतिरिक्त रनटाइम का चयन नहीं करते हैं, तो केवल .NET 8 रनटाइम स्थापित किया जाएगा, और आपको नीचे की तरह एक चेतावनी दिखाई दे सकती है।

यदि आप चिंतित हैं, तो आप .NET 6 रनटाइम स्थापित कर सकते हैं या चेतावनी को खारिज कर सकते हैं। डीबग करने के लिए आपको .NET 6 रनटाइम स्थापित करने की आवश्यकता नहीं है।

यदि आप बाद में WinUI 3 विकास वातावरण जोड़ना चाहते हैं

यदि आप पहले Visual Studio स्थापित हैं, तो आप बाद में एक WinUI 3 विकास वातावरण जोड़ सकते हैं।

Visual Studio प्रारंभ करें, और मेनू से उपकरण और सुविधाएँ प्राप्त करें > उपकरण का चयन करें।

जब आपने Visual Studio स्थापित किया था, तो उसी स्क्रीन को प्रदर्शित किया जाएगा, ताकि आप . सुनिश्चित करें कि ".NET डेस्कटॉप डेवलपमेंट" चेक किया गया है, और दाईं ओर "इंस्टॉलेशन विवरण" से "विंडोज ऐप एसडीके सी # टेम्पलेट" की जांच करें।

डेवलपर मोड सक्षम करें

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

यहां तक कि अगर आप विजुअल स्टूडियो का उपयोग नहीं कर रहे हैं, तो आप सेटिंग स्क्रीन से "डेवलपर मोड" को सक्षम या अक्षम भी कर सकते हैं। प्रारंभ मेनू से "सेटिंग" चुनें।

सिस्टम मेनू से, डेवलपर्स के लिए चुनें।

"डेवलपर्स के लिए" के लिए एक टॉगल है, इसलिए इसे "चालू" पर सेट करें। एक नोट प्रदर्शित किया जाएगा, इसलिए इसे सक्षम करने के लिए "हां" चुनें।

यदि आप .NET 8 में बदलना चाहते हैं

यदि आप इस टेम्पलेट के साथ कोई प्रोजेक्ट बनाते हैं, तो यह डिफ़ॉल्ट रूप से .NET 6 पर होगा। भले ही मैं प्रोजेक्ट गुणों से लक्ष्य ढांचे को .NET 8 में बदलता हूं, फिर भी बिल्ड त्रुटियों और चेतावनियों को दिखाता है। हालाँकि, 03/13/2024 के आसपास, Windows ऐप SDK को आधिकारिक तौर पर .NET 8 का समर्थन करने के लिए अपडेट किया जाएगा।

हालाँकि, टेम्पलेट अभी भी .NET 6 में है, इसलिए प्रोजेक्ट बनाने के बाद आपको .NET 8 पर काम करना होगा। ऐसी संभावना हो सकती है कि भविष्य के संस्करण के उन्नयन में इसका समर्थन किया जाएगा।

सबसे पहले, एक प्रोजेक्ट बनाएँ, और उसके बाद Windows अनुप्रयोग SDK से संबंधित संस्करणों को अद्यतन करने के लिए NuGet का उपयोग करें।

जब तक अन्यथा, सब कुछ अप टू डेट है। Microsoft.WindowsAppSDK कम से कम 1.5.XXXX होना चाहिए।

प्रोजेक्ट गुण से .NET 8 करने के लिए लक्ष्य ढाँचा परिवर्तित करें।

यहां तक कि अगर आप इस स्थिति में निर्माण करते हैं, तो एक त्रुटि प्रदर्शित की जाएगी क्योंकि प्रोजेक्ट सेटिंग्स पुरानी हैं।

प्रोजेक्ट फ़ाइल को कोड के रूप में खोलें।

RuntimeIdentifiers चूंकि एक पैरामीटर है, इसलिए निम्नानुसार Win10 के चरित्र को 10 हटा दें।

संशोधन से पहले

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

फिक्स के बाद

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

यह प्रोग्राम की प्रकाशन सेटिंग्स को भी फिर से लिखता है। प्रत्येक .pubxml फ़ाइल को गुण > PublishProfiles फ़ोल्डर में खोलें।

RuntimeIdentifier इसी तरह, के पैरामीटर में Win10 के चरित्र 10 को हटा दें।

उसके बाद, पुनर्निर्माण करें और सत्यापित करें कि कोई त्रुटि या चेतावनी नहीं है। .pubxml (फ़ाइल में एक चेतावनी होगी, लेकिन आपको इसके बारे में चिंता करने की ज़रूरत नहीं है क्योंकि यह इस मुद्दे से एक अलग सिंटैक्स है। )

हालाँकि, किसी कारण से, WinUI क्लास लाइब्रेरी चेतावनी देना जारी रखती है, भले ही आप ऊपर जैसा ही काम करें। कुछ समय के लिए, आप इसे चला सकते हैं, तो चलिए इसके ठीक होने तक प्रतीक्षा करते हैं।