Single project solution for Uno. Supported platforms:
- Mobile(iOS, macOS, MacCatalyst and Android)(
net8.0-maccatalyst;net8.0-android;net8.0-ios;net8.0-macos
) - Windows(
net8.0-windows10.0.19041.0
or any othernet8.0-windows10
) - WebAssembly(
net8.0-webassembly
) - Skia.Gkt(
net8.0-gtk
) - Skia.Wpf(
net8.0-windows
)(this is an implicit indication fornet8.0-windows7
) - Skia.Linux.Framebuffer(
net8.0-linux
) - Skia.Tizen(
net8.0-tizen
)(Untested)
Project Structure like MAUI:
- Platforms
- Android
- iOS
- MacСatalyst
- Windows
- Gtk
- Linux
- Wpf
- WebAssembly
- Resources
- Images
- Icons
- Splash
- Strings
- UnoProgram.cs
- App.xaml
- App.xaml.cs
Here are three possible uses:
- Use local SDK after installing workload (Recommended)
<Project Sdk="H.Uno.Sdk">
<PropertyGroup>
<TargetFrameworks>net8.0-maccatalyst;net8.0-android;net8.0-ios;net8.0-webassembly;net8.0-gtk;net8.0-linux;net8.0-windows</TargetFrameworks>
<TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net8.0-windows10.0.19041.0</TargetFrameworks>
</PropertyGroup>
</Project>
- Use SDK via NuGet. A small hack will be used here to disable the error message about missing workloads for webassembly/linux/gtk. But it's better if you install workload also.
<Project Sdk="H.Uno.Sdk/0.27.0">
<PropertyGroup>
<TargetFrameworks>net8.0-maccatalyst;net8.0-android;net8.0-ios;net8.0-webassembly;net8.0-gtk;net8.0-linux;net8.0-windows</TargetFrameworks>
<TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net8.0-windows10.0.19041.0</TargetFrameworks>
</PropertyGroup>
</Project>
Note: For some cases to restore correctly from NuGet you need to run this in a project where net8.0-webassembly;net8.0-gtk;net8.0-linux
is missing
- Use via
Microsoft.NET.Sdk
and<UseUno>true</UseUno>
after installing the workload (the most correct, but currently not supported due to the fact that WebAssembly requires Microsoft.NET.Sdk.Web which will not work with some target frameworks)
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFrameworks>net8.0-maccatalyst;net8.0-android;net8.0-ios;net8.0-webassembly;net8.0-gtk;net8.0-linux;net8.0-windows</TargetFrameworks>
<TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net8.0-windows10.0.19041.0</TargetFrameworks>
<UseUno>true</UseUno> <!-- or UseUnoUwp -->
</PropertyGroup>
</Project>
You can use https://github.com/HavenDV/Uno.Sdk.Example/ as a start point or just use templates:
dotnet new install H.Uno.Templates # If you don't have installed workload
mkdir SingleProjectSolution
cd SingleProjectSolution
dotnet new uno
dotnet build
dotnet run --framework net8.0-gtk
Although you don't have to do this for NuGet way, full support for the custom target frameworks requires installing the appropriate workload:
- On Linux / macOS:
curl -sSL https://raw.githubusercontent.com/HavenDV/Uno.Sdk/main/scripts/workload-install.sh | sudo bash
- On Windows:
Invoke-WebRequest 'https://raw.githubusercontent.com/HavenDV/Uno.Sdk/main/scripts/workload-install.ps1' -OutFile 'workload-install.ps1';
./workload-install.ps1
dotnet workload uninstall uno
The SDK is designed to assign default values only to properties that have not been explicitly set by the user. This way the user has full control over what the SDK does. Settings:
<UseUnoUwp>true</UseUnoUwp>
- will use Uno.UI packages instead of Uno.WinUI.<UnoVersion>5.0.0</UnoVersion
(and other versions, see here) - will change the versions of all implicit PackageReferences
Although this is a working solution, I have simplified some things regarding workload and manifest, which could theoretically cause problems (for example, when upgrading to a new sdk version).
Official documentation regarding the design of Workloads and Sdks:
- https://github.com/dotnet/sdk/tree/main/documentation/general/workloads
- https://github.com/dotnet/designs/blob/main/accepted/2020/workloads/workloads.md
- https://github.com/dotnet/designs/blob/main/accepted/2020/workloads/workload-resolvers.md
- https://github.com/dotnet/designs/blob/main/accepted/2020/workloads/workload-manifest.md
- https://github.com/dotnet/designs/blob/main/accepted/2021/workloads/workload-installation.md
- MAUI Workload - https://github.com/dotnet/maui/tree/main/src/Workload
- Tizen Workload - https://github.com/Samsung/Tizen.NET/tree/main/workload
- Uno Single Project Targets - https://github.com/unoplatform/uno/blob/master/build/nuget/uno.winui.single-project.targets
Priority place for bugs: https://github.com/HavenDV/Uno.Sdk/issues
Priority place for ideas and general questions: https://github.com/HavenDV/Uno.Sdk/discussions
Discord: https://discord.gg/g8u2t9dKgE
- Allows you to use [UnsupportedOSPlatform("gtk") attributes, which will replace the custom generator and custom attributes for unsupported methods