Chuẩn bị phát triển cùng WinUI 3
Môi trường hoạt động
- Windows
-
- cửa sổ 11
- Visual Studio
-
- Visual Studio 2022 Phiên bản 17.9.3
- .MẠNG
-
- .NET 6
- (.NET 8)
- WinUI
-
- WinUI 3
- SDK ứng dụng Windows
-
- 1.4.230913002
Điều kiện tiên quyết
Trong một số trường hợp, các phiên bản thấp hơn cũng có thể hoạt động.
- Windows
-
- cửa sổ 10
- cửa sổ 11
- Visual Studio
-
- Visual Studio 2022 phiên bản 17.9.3 trở lên
- .MẠNG
-
- .NET 6
- (.NET 8)
- SDK ứng dụng Windows
-
- 1.4.230913002 trở lên
Cài đặt Visual Studio và thiết lập WinUI
Các dự án phát triển WinUI 3 có thể được thêm vào với cài đặt Visual Studio. Phần này cung cấp một mô tả đơn giản về quá trình cài đặt Visual Studio. Để được hướng dẫn chi tiết, vui lòng tham khảo các Mẹo sau.
Khởi chạy trình cài đặt Visual Studio 2022 từ internet hoặc phương tiện. Nó hỗ trợ các phiên bản Cộng đồng, Chuyên nghiệp hoặc cao hơn.
Trong lựa chọn khối lượng công việc, chọn . Phát triển máy tính để bàn NET.
「. NET Desktop Development và kiểm tra Windows App SDK C# Templates từ Installation Details ở bên phải.
Bây giờ chỉ cần bắt đầu cài đặt. Có những màn hình khác, nhưng tôi sẽ không giải thích chúng cho đến khi chúng tạo ra một dự án.
Sau khi cài đặt hoàn tất, hãy tạo một dự án mới.
Có một trong mục tìm kiếm ở phía winui trên bên phải, vì vậy khi bạn chọn nó, mẫu dự án WinUI 3 sẽ được hiển thị, vì vậy hãy chọn bất kỳ mẫu nào và tạo một dự án.
Bây giờ bạn có thể phát triển các ứng dụng bằng WinUI 3.
Nếu bạn thấy "Nhắm mục tiêu phiên bản .NET chưa được cài đặt"
Kể từ phiên bản 17.9.1 Visual Studio 2022 , .NET cho WinUI 3 nhắm mục tiêu .NET 6.
Nếu bạn không chọn bất kỳ thời gian chạy bổ sung nào trong Visual Studio 2022, chỉ thời gian chạy .NET 8 sẽ được cài đặt và bạn có thể thấy cảnh báo như cảnh báo bên dưới.
Nếu bạn lo lắng, bạn có thể cài đặt thời gian chạy .NET 6 hoặc chỉ cần loại bỏ cảnh báo. Bạn không cần cài đặt thời gian chạy .NET 6 để gỡ lỗi.
Nếu bạn muốn thêm môi trường phát triển WinUI 3 sau này
Nếu bạn cài đặt Visual Studio trước, bạn có thể thêm môi trường phát triển WinUI 3 sau.
Khởi động Visual Studio và chọn Công cụ > Tải Công cụ và Tính năng từ menu.
Màn hình tương tự như khi bạn cài đặt Visual Studio sẽ được hiển thị, vì vậy bạn có thể sử dụng tệp . Đảm bảo chọn ".NET Desktop Development" và chọn "Windows App SDK C# Template" từ "Installation Details" ở bên phải.
Bật chế độ nhà phát triển
Các ứng dụng WinUI chạy trong môi trường tăng cường bảo mật không giống như các ứng dụng máy tính để bàn khác. Do đó, nó không thể được chạy như hiện tại. Khi bạn cố gắng chạy nó, bạn sẽ thấy một hộp thoại như bên dưới và bạn sẽ được nhắc bật "Chế độ nhà phát triển". Nếu bạn nhấp vào liên kết, màn hình cài đặt sẽ được hiển thị, vì vậy vui lòng bật "Chế độ nhà phát triển".
Ngay cả khi bạn không sử dụng Visual Studio, bạn cũng có thể bật hoặc tắt "Chế độ nhà phát triển" từ màn hình cài đặt. Chọn "Cài đặt" từ menu Bắt đầu.
Từ menu Hệ thống, chọn Dành cho nhà phát triển.
Có một nút chuyển đổi cho "Dành cho nhà phát triển", vì vậy hãy đặt nó thành "Bật". Một ghi chú sẽ được hiển thị, vì vậy hãy chọn "Có" để bật nó.
Nếu bạn muốn thay đổi thành .NET 8
Nếu bạn tạo một dự án với mẫu này, nó sẽ mặc định là .NET 6. Ngay cả khi tôi thay đổi khung mục tiêu thành .NET 8 từ thuộc tính dự án, bản dựng vẫn hiển thị lỗi và cảnh báo. Tuy nhiên, vào khoảng ngày 13/03/2024, Windows App SDK sẽ được cập nhật để chính thức hỗ trợ .NET 8.
Tuy nhiên, mẫu vẫn còn trong .NET 6, vì vậy bạn sẽ cần phải làm việc trên .NET 8 sau khi bạn đã tạo dự án. Có thể có khả năng nó sẽ được hỗ trợ trong các bản nâng cấp phiên bản trong tương lai.
Trước tiên, tạo một dự án, và sau đó sử dụng NuGet để cập nhật các phiên bản liên quan đến Windows App SDK.
Trừ khi khác, mọi thứ đều được cập nhật. Microsoft.WindowsAppSDK phải có ít nhất 1.5.XXXX.
Thay đổi khung đích thành .NET 8 từ thuộc tính dự án.
Ngay cả khi bạn xây dựng ở trạng thái này, một lỗi sẽ được hiển thị vì cài đặt dự án đã lỗi thời.
Mở tệp dự án dưới dạng mã.
RuntimeIdentifiersVì có một tham số, loại bỏ ký tự như 10 sau Win10 .
Trước khi sửa đổi
<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
↓
Sau khi sửa chữa
<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
Nó cũng viết lại cài đặt xuất bản của chương trình.
Mở từng .pubxml tệp trong thư mục Thuộc tính > PublishProfiles.
RuntimeIdentifier Tương tự, loại bỏ ký tự của 10 trong tham Win10 số của .
Sau đó, xây dựng lại và xác minh rằng không có lỗi hoặc cảnh báo.
.pubxml (Sẽ có một cảnh báo trong tệp, nhưng bạn không phải lo lắng về nó vì đó là một cú pháp khác với vấn đề này.) )
Tuy nhiên, vì một số lý do, thư viện lớp WinUI tiếp tục cảnh báo ngay cả khi bạn làm điều tương tự như trên. Hiện tại, bạn có thể chạy nó, vì vậy hãy đợi cho đến khi điều này được khắc phục.