وین یو ای

آماده شدن برای توسعه با WinUI 3

صفحه به روز شده :
تاریخ ایجاد صفحه :

محیط عملیاتی

ویندوز
  • ویندوز 11
ویژوال استودیو
  • ویژوال استودیو 2022 نسخه 17.9.3
.خالص
  • دات نت 6
  • (دات نت 8)
WinUI
  • WinUI - بخش 3
Windows App SDK
  • 1.4.230913002

پیش نیازها

در برخی موارد، نسخه های پایین تر نیز ممکن است کار کنند.

ویندوز
  • ویندوز 10
  • ویندوز 11
ویژوال استودیو
  • ویژوال استودیو 2022 نسخه 17.9.3 یا بالاتر
.خالص
  • دات نت 6
  • (دات نت 8)
Windows App SDK
  • 1.4.230913002 یا بالاتر

نصب ویژوال استودیو و راه اندازی WinUI

پروژه های توسعه WinUI 3 را می توان با نصب ویژوال استودیو اضافه کرد. این بخش شرح ساده ای از فرآیند نصب ویژوال استودیو ارائه می دهد. برای دستورالعمل های دقیق، لطفا به نکات زیر مراجعه کنید.

نصب کننده ویژوال استودیو 2022 را از اینترنت یا رسانه راه اندازی کنید. از نسخه های انجمن، حرفه ای یا بالاتر پشتیبانی می کند.

در انتخاب حجم کار، انتخاب کنید. توسعه دسکتاپ NET.

「. NET Desktop Development و الگوهای Windows App SDK C# را از جزئیات نصب در سمت راست بررسی کنید.

حالا فقط نصب را شروع کنید. صفحه نمایش های دیگری نیز وجود دارد، اما تا زمانی که پروژه ای ایجاد نکنند، آنها را توضیح نمی دهم.

پس از اتمام نصب، یک پروژه جدید ایجاد کنید.

در مورد جستجو در winui بالا سمت راست وجود دارد، بنابراین وقتی آن را انتخاب می کنید، الگوی پروژه WinUI 3 نمایش داده می شود، بنابراین هر الگویی را انتخاب کنید و یک پروژه ایجاد کنید.

اکنون می توانید اپلیکیشن ها را با استفاده از WinUI 3 توسعه دهید.

اگر «هدف قرار دادن نسخه ای از دات نت که نصب نشده است» را مشاهده کردید

از نسخه 17.9.1 ویژوال استودیو 2022، دات نت برای WinUI 3 دات نت 6 را هدف قرار می دهد. اگر هیچ زمان اجرا اضافی را در ویژوال استودیو 2022 انتخاب نکنید، فقط زمان اجرا دات نت 8 نصب می شود و ممکن است هشداری مانند هشداری زیر مشاهده کنید.

اگر نگران هستید، می توانید زمان اجرا دات نت 6 را نصب کنید یا فقط هشدار را رد کنید. برای اشکال زدایی نیازی به نصب زمان اجرا دات نت 6 ندارید.

اگر می خواهید بعدا یک محیط توسعه WinUI 3 اضافه کنید

اگر ابتدا ویژوال استودیو را نصب کنید، می توانید بعدا یک محیط توسعه WinUI 3 اضافه کنید.

ویژوال استودیو را راه اندازی کنید و Tools > Get Tools and Features را از منو انتخاب کنید.

همان صفحه ای که ویژوال استودیو را نصب کردید نمایش داده می شود، بنابراین می توانید از صفحه . مطمئن شوید که ".NET Desktop Development" تیک خورده است و "Windows App SDK C# Template" را از "جزئیات نصب" در سمت راست علامت بزنید.

حالت توسعه دهنده را فعال کنید

برنامه های WinUI برخلاف سایر برنامه های دسکتاپ در یک محیط امنیتی پیشرفته اجرا می شوند. بنابراین، نمی توان آن را همانطور که هست اجرا کرد. هنگامی که می خواهید آن را اجرا کنید، گفتگویی مانند مورد زیر را مشاهده خواهید کرد و از شما خواسته می شود «حالت توسعه دهنده» را فعال کنید. اگر روی پیوند کلیک کنید، صفحه تنظیمات نمایش داده می شود، بنابراین لطفا "حالت توسعه دهنده" را فعال کنید.

حتی اگر از ویژوال استودیو استفاده نمی کنید، می توانید "Developer Mode" را از صفحه تنظیمات نیز فعال یا غیرفعال کنید. "تنظیمات" را از منوی استارت انتخاب کنید.

از منوی سیستم، برای توسعه دهندگان انتخاب کنید.

یک کلید برای "For developers" وجود دارد، بنابراین آن را روی "روشن" تنظیم کنید. یک یادداشت نمایش داده می شود، بنابراین برای فعال کردن آن "بله" را انتخاب کنید.

اگر می خواهید به دات نت 8 تغییر دهید.

اگر پروژه ای را با این الگو ایجاد کنید، به طور پیش فرض روی دات نت 6 خواهد بود. حتی اگر چارچوب هدف را از ویژگی های پروژه به دات نت 8 تغییر دهم، بیلد همچنان خطاها و هشدارها را نشان می دهد. با این حال، در حدود 03/13/2024، Windows App SDK برای پشتیبانی رسمی از دات نت 8 به روز می شود.

با این حال، الگو هنوز در دات نت 6 است، بنابراین پس از ایجاد پروژه، باید روی دات نت 8 کار کنید. ممکن است این احتمال وجود داشته باشد که در ارتقاء نسخه های بعدی پشتیبانی شود.

ابتدا یک پروژه ایجاد کنید و سپس از NuGet برای به روز رسانی نسخه های مرتبط با Windows App SDK استفاده کنید.

مگر اینکه خلاف آن باشد، همه چیز به روز است. Microsoft.WindowsAppSDK باید حداقل 1.5.XXXX باشد.

چارچوب هدف را از ویژگی های پروژه به دات نت 8 تغییر دهید.

حتی اگر در این حالت بسازید، خطایی نمایش داده می شود زیرا تنظیمات پروژه قدیمی است.

فایل پروژه را به عنوان کد باز کنید.

RuntimeIdentifiersاز آنجایی که یک پارامتر وجود دارد، کاراکتر 10 زیر Win10 را حذف کنید.

قبل از اصلاح

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

↓

بعد از تعمیر

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

همچنین تنظیمات انتشار برنامه را بازنویسی می کند. هر .pubxml فایل را در پوشه Properties > PublishProfiles باز کنید.

به طور مشابه RuntimeIdentifier ، کاراکتر را حذف 10 کنید در Win10 پارامتر .

پس از آن، بازسازی کنید و بررسی کنید که هیچ خطا یا هشداری وجود ندارد. .pubxml (یک هشدار در فایل وجود خواهد داشت، اما لازم نیست نگران آن باشید زیرا نحو آن با این مشکل متفاوت است.) )

با این حال، به دلایلی، کتابخانه کلاس WinUI همچنان هشدار می دهد حتی اگر همان کار بالا را انجام دهید. در حال حاضر، می توانید آن را اجرا کنید، پس بیایید منتظر بمانیم تا این مشکل برطرف شود.