Προετοιμαστείτε για ανάπτυξη με το WinUI 3

Περιβάλλον λειτουργίας

παράθυρα

• Παράθυρα 11

Οπτικό στούντιο

• Visual Studio 2022 Έκδοση 17.9.3

.ΔΊΧΤΥ

• .NET 6
• (.NET 8)

WinUI

• WinUI 3

SDK εφαρμογών των Windows

• 1.4.230913002

Προϋποθέσεις

Σε ορισμένες περιπτώσεις, ενδέχεται επίσης να λειτουργούν χαμηλότερες εκδόσεις.

παράθυρα

• Παράθυρα 10
• Παράθυρα 11

Οπτικό στούντιο

• 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

Εκκινήστε το πρόγραμμα εγκατάστασης του Visual Studio 2022 από το διαδίκτυο ή το μέσο. Υποστηρίζει κοινοτικές, επαγγελματικές ή νεότερες εκδόσεις.

Στην επιλογή φόρτου εργασίας, επιλέξτε . NET Ανάπτυξη επιφάνειας εργασίας.

「. NET Desktop Development και ελέγξτε τα πρότυπα C# του Windows App SDK από τις Λεπτομέρειες εγκατάστασης στα δεξιά.

Τώρα απλά ξεκινήστε την εγκατάσταση. Υπάρχουν και άλλες οθόνες, αλλά δεν θα τις εξηγήσω μέχρι να δημιουργήσουν ένα έργο.

Μόλις ολοκληρωθεί η εγκατάσταση, δημιουργήστε ένα νέο έργο.

Υπάρχει ένα στοιχείο αναζήτησης επάνω winui δεξιά, οπότε όταν το επιλέξετε, θα εμφανιστεί το πρότυπο έργου WinUI 3, επομένως επιλέξτε οποιοδήποτε πρότυπο και δημιουργήστε ένα έργο.

Τώρα μπορείτε να αναπτύξετε εφαρμογές χρησιμοποιώντας το WinUI 3.

Εάν δείτε "Στόχευση μιας έκδοσης του .NET που δεν είναι εγκατεστημένη"

Από την έκδοση 17.9.1 του Visual Studio 2022 , το .NET for 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" από το "Installation Details" στα δεξιά.

Ενεργοποίηση λειτουργίας προγραμματιστή

Οι εφαρμογές WinUI εκτελούνται σε περιβάλλον ενισχυμένης ασφάλειας σε αντίθεση με άλλες εφαρμογές επιφάνειας εργασίας. Επομένως, δεν μπορεί να εκτελεστεί ως έχει. Όταν προσπαθείτε να το εκτελέσετε, θα δείτε ένα παράθυρο διαλόγου όπως το παρακάτω και θα σας ζητηθεί να ενεργοποιήσετε τη "Λειτουργία προγραμματιστή". Εάν κάνετε κλικ στον σύνδεσμο, θα εμφανιστεί η οθόνη ρυθμίσεων, επομένως ενεργοποιήστε τη "Λειτουργία προγραμματιστή".

Ακόμα κι αν δεν χρησιμοποιείτε το Visual Studio, μπορείτε επίσης να ενεργοποιήσετε ή να απενεργοποιήσετε τη "Λειτουργία προγραμματιστή" από την οθόνη ρυθμίσεων. Επιλέξτε "Ρυθμίσεις" από το μενού Έναρξη.

Από το μενού Σύστημα, επιλέξτε Για προγραμματιστές.

Υπάρχει μια εναλλαγή για "Για προγραμματιστές", οπότε ορίστε την σε "Ενεργό". Θα εμφανιστεί μια σημείωση, οπότε επιλέξτε "Ναι" για να την ενεργοποιήσετε.

Εάν θέλετε να αλλάξετε σε .NET 8

Εάν δημιουργήσετε ένα έργο με αυτό το πρότυπο, θα είναι από προεπιλογή .NET 6. Ακόμα κι αν αλλάξω το πλαίσιο προορισμού σε .NET 8 από τις ιδιότητες του έργου, το build εξακολουθεί να εμφανίζει σφάλματα και προειδοποιήσεις. Ωστόσο, γύρω στις 13/03/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 αρχείο στο φάκελο Ιδιότητες > PublishProfiles.

RuntimeIdentifier Ομοίως , αφαιρέστε το χαρακτήρα του 10 στην Win10 παράμετρο του .

Μετά από αυτό, δημιουργήστε ξανά και βεβαιωθείτε ότι δεν υπάρχουν σφάλματα ή προειδοποιήσεις. .pubxml (Θα υπάρχει μια προειδοποίηση στο αρχείο, αλλά δεν χρειάζεται να ανησυχείτε για αυτό, επειδή είναι διαφορετική σύνταξη από αυτό το ζήτημα.) )

Ωστόσο, για κάποιο λόγο, η βιβλιοθήκη κλάσεων WinUI συνεχίζει να προειδοποιεί ακόμα και αν κάνετε το ίδιο πράγμα όπως παραπάνω. Προς το παρόν, μπορείτε να το εκτελέσετε, οπότε ας περιμένουμε μέχρι να διορθωθεί.