WinUI

הכנה לפיתוח באמצעות WinUI 3

עודכן דף :
תאריך יצירת דף :

סביבת הפעלה

חלונות
  • חלונות 11
Visual Studio
  • Visual Studio 2022 גרסה 17.9.3
.רשת
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
ערכת SDK של אפליקציית Windows
  • 1.4.230913002

דרישות מוקדמות

במקרים מסוימים, גירסאות נמוכות יותר עשויות גם לעבוד.

חלונות
  • חלונות 10
  • חלונות 11
Visual Studio
  • Visual Studio 2022 גירסה 17.9.3 ואילך
.רשת
  • .NET 6
  • (.NET 8)
ערכת SDK של אפליקציית Windows
  • 1.4.230913002 ואילך

התקנת Visual Studio והגדרת WinUI

ניתן להוסיף פרויקטי פיתוח של WinUI 3 באמצעות התקנת Visual Studio. סעיף זה מספק תיאור פשוט של תהליך ההתקנה של Visual Studio. לקבלת הוראות מפורטות, עיין בעצות הבאות.

הפעל את תוכנית ההתקנה של Visual Studio 2022 מהאינטרנט או מהמדיה. הוא תומך במהדורות Community, Professional ומעלה.

בבחירת עומס העבודה, בחר . פיתוח שולחן עבודה נטו.

「. NET Desktop Development ובדוק את Windows App SDK C# Templates מתוך פרטי ההתקנה משמאל.

עכשיו פשוט להתחיל את ההתקנה. יש מסכים אחרים, אבל אני לא אסביר אותם עד שהם יוצרים פרויקט.

לאחר השלמת ההתקנה, צור פרוייקט חדש.

יש פריט חיפוש בפינה 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 Desktop Development" מסומנת, וסמן את "Windows App SDK C# Template" מתוך "פרטי התקנה" משמאל.

הפוך מצב מפתח לזמין

יישומי WinUI פועלים בסביבה מאובטחת משופרת, בניגוד ליישומי שולחן עבודה אחרים. לכן, זה לא יכול להיות מופעל כפי שהוא. כאשר תנסה להפעיל אותו, תראה תיבת דו-שיח כמו זו שלהלן ותתבקש להפעיל את "מצב מפתח". אם תלחץ על הקישור, יוצג מסך ההגדרה, לכן הפעל את "מצב מפתח".

גם אם אינך משתמש ב- Visual Studio, באפשרותך גם להפעיל או להשבית את "מצב מפתח" ממסך ההגדרות. בחר "הגדרות" מתפריט התחלה.

בתפריט מערכת, בחר For Developers.

יש מתג עבור "עבור מפתחים", אז להגדיר אותו "מופעל". תוצג הערה, לכן בחר "כן" כדי להפעיל אותה.

אם ברצונך לשנות ל- .NET 8

אם תיצור פרוייקט באמצעות תבנית זו, ברירת המחדל שלו תהיה .NET 6. גם אם אשנה את מסגרת היעד ל- .NET 8 ממאפייני הפרוייקט, גירסת ה- build עדיין תציג שגיאות ואזהרות. עם זאת, בסביבות ה-13/03/2024, ה-SDK של אפליקציית Windows יעודכן לתמיכה רשמית ב-.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 קובץ בתיקייה Properties > PublishProfiles.

RuntimeIdentifier באופן דומה , הסר את התו של 10 בפרמטר Win10 של .

לאחר מכן, בנה מחדש וודא שאין שגיאות או אזהרות. .pubxml (תהיה אזהרה בקובץ, אך אינך צריך לדאוג לגביה מכיוון שזהו תחביר שונה מבעיה זו.) )

עם זאת, מסיבה כלשהי, ספריית המחלקה של WinUI ממשיכה להזהיר גם אם אתה עושה את אותה פעולה כמו לעיל. לעת עתה, אתה יכול להפעיל אותו, אז בואו נחכה עד שזה יתוקן.