Skip to content

Commit 43bdb2c

Browse files
Merge pull request #51345 from chatasweetie/winui-101-review-new
Updates based on @AnnaMHuff review
2 parents 38d0bae + 6b00317 commit 43bdb2c

File tree

9 files changed

+387
-392
lines changed

9 files changed

+387
-392
lines changed

learn-pr/windows/winui-101/includes/11-summary.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
You completed this module and build a strong foundation for Windows development skills.
22

3-
Here's what you achieve in this module:
3+
Here's what you achieved in this module:
44

55
- You understand the role of the Windows App SDK and WinUI in creating modern and high-performance Windows applications.
66
- You set up the development environment by enabling Developer Mode and installing Visual Studio.
7-
- You create a WinUI project, update essential packages, and organize the project by following best practices.
8-
- You use XAML for UI design and learn about the purpose of code-behind files.
7+
- You created a WinUI project, update essential packages, and organize the project by following best practices.
8+
- You used XAML for UI design and learned about the purpose of code-behind files.
99
- You implemented two ways of binding data (`{x:Bind}` and `{Binding}`).
1010
- You understand how to use resource dictionaries for styling.
11-
- You can dynamically add data or update images to the View.
11+
- You added dynamically add data or updated images to the View.
1212
- You set up navigation in your future apps.
1313

1414
These skills help you as you continue to develop Windows applications. Keep practicing and exploring new features. The world of Windows development offers many opportunities, and you're ready to learn more

learn-pr/windows/winui-101/includes/2-dev-set-up.md

Lines changed: 44 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Windows has a special mode for developers that adjusts security settings to let
77
To enable Developer Mode:
88

99
1. Open Windows Settings and navigate to the **System** > **For developers** page.
10-
2. Toggle the Developer Mode switch to **On** and confirm your choice in the confirmation dialog.
10+
1. Toggle the Developer Mode switch to **On** and confirm your choice in the confirmation dialog.
1111

1212
## Install Visual Studio
1313

@@ -16,16 +16,16 @@ You use [Visual Studio](https://github.com/MicrosoftDocs/windows-dev-docs/blob/d
1616
> [!NOTE]
1717
> Before installing these tools, ensure your development computer meets the [system requirements for Windows app development](https://github.com/MicrosoftDocs/windows-dev-docs/blob/docs/hub/apps/windows-app-sdk/system-requirements.md).
1818
19-
3. Go to the Visual Studio page to download and install the latest Visual Studio. You can use the free Visual Studio Community Edition.
19+
1. Go to the Visual Studio page to download and install the latest Visual Studio. You can use the free Visual Studio Community Edition.
2020

21-
> [!NOTE]
22-
> The installer guides you through the steps, but if you need detailed instructions, see [Install Visual Studio](https://github.com/MicrosoftDocs/windows-dev-docs/blob/docs/visualstudio/install/install-visual-studio).
21+
> [!NOTE]
22+
> The installer guides you through the steps, but if you need detailed instructions, see [Install Visual Studio](https://github.com/MicrosoftDocs/windows-dev-docs/blob/docs/visualstudio/install/install-visual-studio).
2323
24-
While installing Visual Studio, you need to install the workloads and components required for developing with WinUI and the Windows App SDK.
24+
While installing Visual Studio, you need to install the workloads and components required for developing with WinUI and the Windows App SDK.
2525

26-
4. Open the Visual Studio Installer app
27-
5. Select **Modify** to add workloads and components.
28-
6. On the **Workloads** tab of the Visual Studio Installer app, select the following workloads and components:
26+
1. Open the Visual Studio Installer app
27+
1. Select **Modify** to add workloads and components.
28+
1. On the **Workloads** tab of the Visual Studio Installer app, select the following workloads and components:
2929

3030
- [Visual Studio 2022 version 17.10 and later](https://github.com/MicrosoftDocs/windows-dev-docs/blob/docs/hub/apps/get-started/start-here.md#tab/vs-2022-17-10)
3131

@@ -41,15 +41,15 @@ While installing Visual Studio, you need to install the workloads and components
4141

4242
To create a new project using the WinUI C# Blank App project template:
4343

44-
7. Open Visual Studio and select **Create a new project** from the launch page. (If Visual Studio is already open to the editor, select **File** > **New**> **Project**)
45-
8. Search for **WinUI** and select the **Blank App, Packaged (WinUI 3 in Desktop)** project template
46-
9. Click **Next**
47-
10. Name your project: **SnowPal**
44+
1. Open Visual Studio and select **Create a new project** from the launch page. (If Visual Studio is already open to the editor, select **File** > **New**> **Project**)
45+
1. Search for **WinUI** and select the **Blank App, Packaged (WinUI 3 in Desktop)** project template
46+
1. Click **Next**
47+
1. Name your project: **SnowPal**
4848

49-
> [!IMPORTANT]
50-
> The Project Name and Solution Name must be SnowPal. Visual Studio creates namespaces using this information. If it's something different, the code you copy and paste from this tutorial can cause build errors.
49+
> [!IMPORTANT]
50+
> The Project Name and Solution Name must be SnowPal. Visual Studio creates namespaces using this information. If it's something different, the code you copy and paste from this tutorial can cause build errors.
5151
52-
11. Select **Create**.
52+
1. Select **Create**.
5353

5454
## Update & Install Packages
5555

@@ -60,25 +60,25 @@ The Windows App SDK (including WinUI) and tools like the Community Toolkit are d
6060
6161
To update the Windows App SDK NuGet package for your project:
6262

63-
12. In Visual Studio, with your project loaded, select **Tools** > **NuGet Package Manager** > **Manage NuGet Packages for Solution....**
63+
1. In Visual Studio, with your project loaded, select **Tools** > **NuGet Package Manager** > **Manage NuGet Packages for Solution....**
6464

65-
> [!IMPORTANT]
66-
> Projects must not be running in order to access the "Manage Nuget packages" option in the drop-down
65+
> [!IMPORTANT]
66+
> Projects must not be running in order to access the "Manage Nuget packages" option in the drop-down
6767
68-
:::image type="content" source="../media/2-dev-set-up/package-source.png" alt-text="Screenshot of Visual Studio.":::
68+
:::image type="content" source="../media/2-dev-set-up/package-source.png" alt-text="Screenshot of Visual Studio.":::
6969

70-
13. Confirm that it's set to `nuget.org`
70+
1. Confirm that it's set to `nuget.org`
7171
- if it isn't, follow [these](/nuget/consume-packages/install-use-packages-visual-studio#package-sources) instructions.
72-
14. Click on the **Installed** tab.
73-
15. Click on **Microsoft.WindowsAppSDK**
74-
16. Select the **Checkbox** to Include prelease
75-
17. On the right panel:
72+
1. Click on the **Installed** tab.
73+
1. Click on **Microsoft.WindowsAppSDK**
74+
1. Select the **Checkbox** to Include prelease
75+
1. On the right panel:
7676
1. select the **checkbox** of the **Project**
77-
1. Select from the dropdown **1.7.250401001**
77+
1. Select from the dropdown **1.7.250401001**
7878
1. Click **install**
7979
1. On the Preview Changes Popup, **Click Apply**.
8080
1. On the License Acceptance Popup, **Click I Accept**.
81-
18. To install the CommunityToolkit NuGet package for your project:
81+
1. To install the CommunityToolkit NuGet package for your project:
8282
1. Still in the Manage NuGet Packages for Solution, Click on the **Browse** tab.
8383
1. Enter **`CommunityToolkit.Mvvm`** in the search bar
8484
1. **Click to select** `CommunityToolkit.Mvvm`
@@ -88,22 +88,22 @@ To update the Windows App SDK NuGet package for your project:
8888
1. Click **Install**.
8989
1. On the Preview Changes Popup, **Click Apply**.
9090
1. On the License Acceptance Popup, **Click I Accept**.
91-
19. **Close** the NuGet Package Manager
91+
1. **Close** the NuGet Package Manager
9292

93-
The Community Toolkit.Mvvm uses features that are ahead of the standard C# language version that your project is configured to use by default. You need to update the project's configuration:
93+
The Community Toolkit.Mvvm uses features that are ahead of the standard C# language version that your project is configured to use by default. You need to update the project's configuration:
9494

95-
20. If Solution Explorer isn't already open, you can open it by selecting **View** > **Solution Explorer** from the top menu.
96-
21. In the Solution Explorer, you see a tree structure representing your solution and its projects. Look for the project node named **SnowPal**. This node is usually a folder icon with the project name next to it.
97-
22. **Right-click** on the project node (**SnowPal**) and select **Edit Project File**. This action opens the .csproj file in the editor.
95+
1. If Solution Explorer isn't already open, you can open it by selecting **View** > **Solution Explorer** from the top menu.
96+
1. In the Solution Explorer, you see a tree structure representing your solution and its projects. Look for the project node named **SnowPal**. This node is usually a folder icon with the project name next to it.
97+
1. **Right-click** on the project node (**SnowPal**) and select **Edit Project File**. This action opens the .csproj file in the editor.
9898

99-
:::image type="content" source="../media/2-dev-set-up/edit-project-file.png" alt-text="Screenshot of Edit Project.":::
99+
:::image type="content" source="../media/2-dev-set-up/edit-project-file.png" alt-text="Screenshot of Edit Project.":::
100100

101-
23. **Locate** the first `PropertyGroup` element in the file
102-
24. **Add** `<LangVersion>preview</LangVersion>`
101+
1. **Locate** the first `PropertyGroup` element in the file
102+
1. **Add** `<LangVersion>preview</LangVersion>`
103103

104-
:::image type="content" source="../media/2-dev-set-up/language-version.png" alt-text="Screenshot of file with added LangVersion element.":::
104+
:::image type="content" source="../media/2-dev-set-up/language-version.png" alt-text="Screenshot of file with added LangVersion element.":::
105105

106-
25. **Save and Close** the file
106+
1. **Save and Close** the file
107107

108108
Adding Preview is a way to unlock experimental language features required by advanced tools like Community Toolkit.Mvvm, enabling developers to use cutting-edge capabilities in their projects.
109109

@@ -113,11 +113,11 @@ Now your project is using the latest WinUI features that are available.
113113

114114
You can run this blank project:
115115

116-
26. On the title bar, **Click** on **Debug** > **Start Debugging** OR on your keyboard press **F5** key
116+
1. On the title bar, **Click** on **Debug** > **Start Debugging** OR on your keyboard press **F5** key
117117

118-
:::image type="content" source="../media/2-dev-set-up/start-debug.png" alt-text="Screenshot of visual studio's Debug.":::
118+
:::image type="content" source="../media/2-dev-set-up/start-debug.png" alt-text="Screenshot of visual studio's Debug.":::
119119

120-
27. To stop debugging, **Close** the app window, or **Click** the debug "Stop" button in Visual Studio.
120+
1. To stop debugging, **Close** the app window, or **Click** the debug "Stop" button in Visual Studio.
121121

122122
## The project's file structure
123123

@@ -136,13 +136,13 @@ To improve maintainability, you create two new folders for organizing your proje
136136

137137
### Steps to Create Folders
138138

139-
28. In Solution Explorer, **right-click** on your project.
140-
29. Select **Add** > **New Folder**.
139+
1. In Solution Explorer, **right-click** on your project.
140+
1. Select **Add** > **New Folder**.
141141

142-
:::image type="content" source="../media/2-dev-set-up/add-new-folder.png" alt-text="Screenshot of visual studio's add new folder.":::
142+
:::image type="content" source="../media/2-dev-set-up/add-new-folder.png" alt-text="Screenshot of visual studio's add new folder.":::
143143

144-
30. Name the new folder `Models`.
145-
31. Repeat steps 1–3 and name the second folder `Pages`.
144+
1. Name the new folder `Models`.
145+
1. Repeat steps 1–3 and name the second folder `Pages`.
146146

147147
### Why Name It "Pages" Instead of "Views"?
148148

0 commit comments

Comments
 (0)