وينيو آي

استعد للتطوير باستخدام WinUI 3

تحديث الصفحة :
تاريخ إنشاء الصفحة :

بيئة التشغيل

نوافذ
  • ويندوز ١١
فيجوال ستوديو
  • فيجوال ستوديو 2022 الإصدار 17.9.3
.صافي
  • .NET 6
  • (.NET 8)
وينيو آي
  • واجهة المستخدم WinUI 3
ويندوز التطبيق SDK
  • 1.4.230913002

المتطلبات المسبقه

في بعض الحالات ، قد تعمل الإصدارات الأقل أيضا.

نوافذ
  • ويندوز ١٠
  • ويندوز ١١
فيجوال ستوديو
  • Visual Studio 2022 الإصدار 17.9.3 أو أحدث
.صافي
  • .NET 6
  • (.NET 8)
ويندوز التطبيق SDK
  • 1.4.230913002 أو أحدث

تثبيت Visual Studio وإعداد WinUI

يمكن إضافة مشاريع تطوير WinUI 3 مع تثبيت Visual Studio. يوفر هذا القسم وصفا مبسطا لعملية تثبيت Visual Studio. للحصول على تعليمات مفصلة ، يرجى الرجوع إلى النصائح التالية.

قم بتشغيل مثبت Visual Studio 2022 من الإنترنت أو الوسائط. وهو يدعم المجتمع أو الإصدارات الاحترافية أو الإصدارات الأعلى.

في تحديد حمل العمل، حدد . صافي تطوير سطح المكتب.

「. NET Desktop Development وتحقق من قوالب Windows App SDK C # من تفاصيل التثبيت على اليمين.

الآن فقط ابدأ التثبيت. هناك شاشات أخرى ، لكنني لن أشرحها حتى ينشئوا مشروعا.

بمجرد اكتمال التثبيت ، قم بإنشاء مشروع جديد.

يوجد عنصر بحث في winui الجزء العلوي الأيمن ، لذلك عند تحديده ، سيتم عرض قالب مشروع WinUI 3 ، لذا حدد أي قالب وقم بإنشاء مشروع.

يمكنك الآن تطوير التطبيقات باستخدام WinUI 3.

إذا رأيت "استهداف إصدار .NET غير مثبت"

اعتبارا من إصدار 17.9.1 Visual Studio 2022 ، يستهدف .NET ل WinUI 3 .NET 6. إذا لم تحدد أي أوقات تشغيل إضافية في Visual Studio 2022 ، تثبيت وقت تشغيل .NET 8 فقط ، وقد ترى تحذيرا مثل التحذير أدناه.

إذا كنت قلقا ، فيمكنك تثبيت وقت تشغيل .NET 6 أو مجرد تجاهل التحذير. لا تحتاج إلى تثبيت وقت تشغيل .NET 6 لتصحيح الأخطاء.

إذا كنت ترغب في إضافة بيئة تطوير WinUI 3 لاحقا

إذا قمت بتثبيت Visual Studio أولا ، يمكنك إضافة بيئة تطوير WinUI 3 لاحقا.

ابدأ تشغيل Visual Studio وحدد أدوات > الحصول على الأدوات والميزات من القائمة.

سيتم عرض نفس الشاشة عند تثبيت Visual Studio ، بحيث يمكنك استخدام ملف. تأكد من تحديد "تطوير سطح المكتب .NET" ، وتحقق من "قالب Windows App SDK C #" من "تفاصيل التثبيت" على اليمين.

تمكين وضع المطور

تعمل تطبيقات WinUI في بيئة محسنة الأمان على عكس تطبيقات سطح المكتب الأخرى. لذلك ، لا يمكن تشغيله كما هو. عند محاولة تشغيله ، سترى مربع حوار مثل الحوار أدناه وسيطلب منك تمكين "وضع المطور". إذا قمت بالنقر فوق الارتباط ، عرض شاشة الإعداد ، لذا يرجى تمكين "وضع المطور".

حتى إذا كنت لا تستخدم Visual Studio ، يمكنك أيضا تمكين أو تعطيل "وضع المطور" من شاشة الإعدادات. حدد "الإعدادات" من قائمة ابدأ.

من قائمة النظام، حدد للمطورين.

يوجد مفتاح تبديل ل "للمطورين" ، لذا اضبطه على "تشغيل". سيتم عرض ملاحظة ، لذا حدد "نعم" لتمكينها.

إذا كنت تريد التغيير إلى .NET 8

إذا قمت بإنشاء مشروع باستخدام هذا القالب ، تعيينه افتراضيا على .NET 6. حتى إذا قمت بتغيير إطار العمل الهدف إلى .NET 8 من خصائص المشروع ، فلا يزال البناء يعرض الأخطاء والتحذيرات. ومع ذلك ، في حوالي 03/13/2024 ، سيتم تحديث Windows App SDK لدعم .NET 8 رسميا.

ومع ذلك ، لا يزال القالب في .NET 6 ، لذلك ستحتاج إلى العمل على .NET 8 بمجرد إنشاء المشروع. قد يكون هناك احتمال أن يتم دعمه في ترقيات الإصدار المستقبلية.

أولا ، قم بإنشاء مشروع ، ثم استخدم NuGet لتحديث الإصدارات المتعلقة ب Windows App SDK.

ما لم يكن خلاف ذلك ، كل شيء محدث. Microsoft.WindowsAppSDK يجب أن يكون على الأقل 1.5.XXXX.

تغيير إطار العمل الهدف إلى .NET 8 من خصائص المشروع.

حتى إذا قمت بالبناء في هذه الحالة ، عرض خطأ لأن إعدادات المشروع قديمة.

افتح ملف المشروع كرمز.

RuntimeIdentifiersنظرا لوجود معلمة ، قم بإزالة حرف 10 كما يلي Win10 .

قبل التعديل

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

↓

بعد الإصلاح

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

كما أنه يعيد كتابة إعدادات نشر البرنامج. افتح كل .pubxml ملف في المجلد خصائص > PublishFiles.

RuntimeIdentifier وبالمثل ، قم بإزالة حرف 10 في Win10 المعلمة .

بعد ذلك ، أعد الإنشاء وتحقق من عدم وجود أخطاء أو تحذيرات. .pubxml (سيكون هناك تحذير في الملف ، ولكن لا داعي للقلق بشأنه لأنه بناء جملة مختلف عن هذه المشكلة.) )

ومع ذلك ، لسبب ما ، تستمر مكتبة فئة WinUI في التحذير حتى إذا فعلت نفس الشيء على النحو الوارد أعلاه. في الوقت الحالي ، يمكنك تشغيله ، لذلك دعونا ننتظر حتى يتم إصلاح ذلك.