Skip to content

Commit b1e4f6c

Browse files
committed
docs: updates from feedback
1 parent 1e091ec commit b1e4f6c

File tree

3 files changed

+29
-42
lines changed

3 files changed

+29
-42
lines changed

hub/apps/get-started/uno-simple-photo-viewer.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ After you've [created](/hub/apps/get-started/simple-photo-viewer-winui3.md) a st
2626
- .NET desktop development installed (for Gtk, Wpf, and Linux Framebuffer development)
2727
:::image type="content" source="../images/uno/uno-vs-install-dotnet.png" alt-text="dotnet desktop workload in VS":::
2828

29-
[!INCLUDE [uno-setup.md](./uno-setup.md)]
29+
[!INCLUDE [uno-setup.md](/hub/includes/uno-setup.md)]
3030

3131
## Install the Uno Platform solution templates
3232

@@ -77,7 +77,7 @@ Your app will need some images to display. You can use the same images from the
7777

7878
In the `UnoSimplePhotos` project, create a new folder named `Assets` and copy the JPG image files to a `Samples` subfolder. The `Assets` folder structure should now look like this:
7979

80-
:::image type="content" source="images/uno/screenshot3.png" alt-text="dotnet mobile workload in VS":::
80+
:::image type="content" source="images/uno/screenshot3.png" alt-text="Solution explorer pane in Visual Studio":::
8181

8282
For more information on creating the `Assets` folder and adding images to it, see the Uno Platform documentation about [Assets and image display](https://platform.uno/docs/articles/features/working-with-assets.html).
8383

hub/apps/how-tos/uno-multiplatform.md

Lines changed: 27 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Once you've [created](hello-world-winui3.md) a starter Hello World WinUI 3 app,
2929
- .NET desktop development installed (for Gtk, Wpf, and Linux Framebuffer development)
3030
:::image type="content" source="../images/uno/uno-vs-install-dotnet.png" alt-text=".net desktop workload in VS":::
3131

32-
[!INCLUDE [uno-setup.md](../get-started/uno-setup.md)]
32+
[!INCLUDE [uno-setup.md](/hub/includes/uno-setup.md)]
3333

3434
## Install the Uno Platform solution templates
3535

@@ -61,7 +61,7 @@ Specify a project name, solution name, and directory. In this example, our Hello
6161

6262
Create a new C# solution using the **Uno Platform App** type from Visual Studio's **Start Page**. To avoid conflicting with the code from the previous tutorial, we'll give this solution a different name, "Hello World Uno".
6363

64-
Now you'll choose a base template to take your Hello World application multi-platform. The Uno Platform App template comes with two preset options that allow you to quickly get started with either a Blank solution or the Default configuration which includes references to the Uno.Material and Uno.Toolkit libraries. The Default configuration also includes Uno.Extensions which is used for dependency injection, configuration, navigation, and logging, and it uses MVUX in place of MVVM, making it a great starting point for rapidly building real-world applications.
64+
Now you'll choose a base template to take your Hello World application multi-platform. The Uno Platform App template comes with two preset options that allow you to quickly get started with either a Blank solution or the Default configuration which includes references to the Uno.Material and Uno.Toolkit libraries. The Default configuration also includes Uno.Extensions which is used for dependency injection, configuration, navigation, and logging, and it uses MVUX in place of MVVM, making it a great starting point for rapidly building real-world applications.
6565

6666
:::image type="content" source="../images/uno/uno-vsix-new-project-options.png" alt-text="Uno solution template for project startup type":::
6767

@@ -82,13 +82,13 @@ Make sure Visual Studio has your WinUI 3 project open, then copy the child XAML
8282

8383
```xml
8484
<Page x:Class="HelloWorld.MainPage"
85-
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
86-
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
87-
xmlns:local="using:HelloWorld"
88-
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
89-
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
90-
mc:Ignorable="d"
91-
Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
85+
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
86+
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
87+
xmlns:local="using:HelloWorld"
88+
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
89+
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
90+
mc:Ignorable="d"
91+
Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
9292

9393
<!-- Below is the code you copied from MainWindow: -->
9494
<StackPanel Orientation="Horizontal"
@@ -105,32 +105,30 @@ Launch the HelloWorld.Windows target. Observe that this WinUI app is identical t
105105

106106
You can now build and run your app on any of the supported platforms. To do so, you can use the debug toolbar drop-down to select a target platform to deploy:
107107

108-
* To run the **WebAssembly** (Wasm) head:
109-
- Right-click on the `HelloWorld.Wasm` project, select **Set as startup project**
110-
- Press the `HelloWorld.Wasm` button to deploy the app
111-
- If desired, you can use the `HelloWorld.Server` project as an alternative
112-
* To debug for **iOS**:
113-
- Right-click on the `HelloWorld.Mobile` project, select **Set as startup project**
114-
- In the debug toolbar drop-down, select an active iOS device or the simulator. You'll need to be paired with a Mac for this to work.
108+
- To run the **WebAssembly** (Wasm) head:
109+
- Right-click on the `HelloWorld.Wasm` project, select **Set as startup project**
110+
- Press the `HelloWorld.Wasm` button to deploy the app
111+
- If desired, you can use the `HelloWorld.Server` project as an alternative
112+
- To debug for **iOS**:
113+
- Right-click on the `HelloWorld.Mobile` project, select **Set as startup project**
114+
- In the debug toolbar drop-down, select an active iOS device or the simulator. You'll need to be paired with a Mac for this to work.
115115

116116
:::image type="content" source="../images/uno/uno-mobile-debug.png" alt-text="Visual Studio dropdown to select a target framework to deploy":::
117117

118-
* To debug for **Mac Catalyst**:
119-
- Right-click on the `HelloWorld.Mobile` project, select **Set as startup project**
120-
- In the debug toolbar drop-down, select a remote macOS device. You'll need to be paired with one for this to work.
121-
* To debug the **Android** platform:
122-
- Right-click on the `HelloWorld.Mobile` project, select **Set as startup project**
123-
- In the debug toolbar drop-down, select either an active Android device or the emulator
124-
- Select an active device in the "Device" sub-menu
125-
* To debug on **Linux** with **Skia GTK**:
126-
- Right-click on the `HelloWorld.Skia.Gtk` project, and select **Set as startup project**
127-
- Press the `HelloWorld.Skia.Gtk` button to deploy the app
128-
118+
- To debug for **Mac Catalyst**:
119+
- Right-click on the `HelloWorld.Mobile` project, select **Set as startup project**
120+
- In the debug toolbar drop-down, select a remote macOS device. You'll need to be paired with one for this to work.
121+
- To debug the **Android** platform:
122+
- Right-click on the `HelloWorld.Mobile` project, select **Set as startup project**
123+
- In the debug toolbar drop-down, select either an active Android device or the emulator
124+
- Select an active device in the "Device" sub-menu
125+
- To debug on **Linux** with **Skia GTK**:
126+
- Right-click on the `HelloWorld.Skia.Gtk` project, and select **Set as startup project**
127+
- Press the `HelloWorld.Skia.Gtk` button to deploy the app
129128

130129
Now you're ready to start building your multi-platform application!
131130

132-
133131
## See also
134132

135133
- [Uno Platform documentation](https://platform.uno/docs/articles/intro.html)
136-
- [Uno Extensions features](https://platform.uno/docs/articles/external/uno.extensions/doc/ExtensionsOverview.html#learn-about-unoextensions-features)
134+
- [Uno Extensions features](https://platform.uno/docs/articles/external/uno.extensions/doc/ExtensionsOverview.html#learn-about-unoextensions-features)

hub/apps/get-started/uno-setup.md renamed to hub/includes/uno-setup.md

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,3 @@
1-
---
2-
title: Uno Setup Guide
3-
description: Learn how to reach users on other platforms like Web, iOS, Android, and Linux with minimal changes to the C#/WinUI 3 simple photo viewer built in the previous tutorial. We'll use Uno Platform to create a new multi-platform app, which we can move code from the existing desktop project to.
4-
ms.topic: article
5-
ms.date: 05/21/2023
6-
keywords: Windows, App, SDK, WinUI 3, WinUI, photo, viewer, Windows 11, Windows 10, XAML, C#, uno platform, uno
7-
ms.author: aashcraft
8-
author: alvinashcraft
9-
ms.localizationpriority: medium
10-
---
11-
121
## Finalize your environment
132

143
1. Open a command-line prompt, Windows Terminal if you have it installed, or else Command Prompt or Windows Powershell from the Start Menu.

0 commit comments

Comments
 (0)