-
Notifications
You must be signed in to change notification settings - Fork 860
docs: Add comprehensive NuGet packages reference page #22330
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. Weβll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Closed
Closed
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,288 @@ | ||
| --- | ||
| uid: Uno.Development.NuGetPackages | ||
| --- | ||
|
|
||
| # Uno Platform NuGet Packages | ||
|
|
||
| This article provides a comprehensive list of all first-party NuGet packages published by Uno Platform. These packages enable you to build cross-platform applications targeting Windows, macOS, Linux, iOS, Android, and WebAssembly. | ||
|
|
||
| ## Core Packages | ||
|
|
||
| ### Uno.SDK | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.Sdk/) | ||
|
|
||
| The Uno SDK is a modern MSBuild SDK that simplifies project structure and package management. It's the recommended way to create new Uno Platform projects. | ||
|
|
||
| - **Description**: Build system SDK that provides streamlined project configuration | ||
| - **Documentation**: [Using the Uno.SDK](xref:Uno.Features.Uno.Sdk) | ||
| - **When to use**: All new Uno Platform projects (5.1+) | ||
|
|
||
| ### Uno.WinUI / Uno.UI | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI/) | ||
| [](https://www.nuget.org/packages/Uno.UI/) | ||
|
|
||
| The main UI framework packages that implement the WinUI 3 and UWP APIs across all platforms. | ||
|
|
||
| - **Uno.WinUI**: WinUI 3 API implementation for cross-platform development | ||
| - **Uno.UI**: Legacy UWP API implementation (for existing projects) | ||
| - **Description**: Build Mobile, Desktop and WebAssembly apps with C# and XAML | ||
| - **Documentation**: [Uno and WinUI 3](uwp-vs-winui3.md) | ||
| - **When to use**: Core framework for all Uno Platform applications | ||
|
|
||
| ### Uno.WinRT | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinRT/) | ||
|
|
||
| Provides Windows Runtime (WinRT) API implementations across platforms. | ||
|
|
||
| - **Description**: Cross-platform implementation of Windows Runtime APIs | ||
| - **Documentation**: [Uno.WinRT](xref:uno.features.uno.winrt) | ||
| - **When to use**: Automatically included as a dependency of Uno.WinUI/Uno.UI | ||
|
|
||
| ### Uno.Foundation | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.Foundation/) | ||
|
|
||
| Foundation types and core functionality shared across Uno Platform. | ||
|
|
||
| - **Description**: Core types and utilities for Uno Platform | ||
| - **When to use**: Automatically included as a dependency of Uno.WinUI/Uno.UI | ||
|
|
||
| ## Platform-Specific Packages | ||
|
|
||
| ### Uno.WinUI.WebAssembly | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.WebAssembly/) | ||
|
|
||
| WebAssembly-specific implementation and bootstrapper. | ||
|
|
||
| - **Description**: Enables running Uno Platform apps in web browsers via WebAssembly | ||
| - **Documentation**: [Publishing for WebAssembly](xref:uno.publishing.webassembly) | ||
|
|
||
| ### Uno.WinUI.Skia.Gtk | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Skia.Gtk/) | ||
|
|
||
| Skia-based rendering for Linux desktop using GTK. | ||
|
|
||
| - **Description**: Linux desktop support using Skia rendering and GTK | ||
| - **Documentation**: [Skia Desktop](xref:Uno.Skia.Desktop) | ||
|
|
||
| ### Uno.WinUI.Skia.Wpf | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Skia.Wpf/) | ||
|
|
||
| Skia-based rendering for Windows desktop using WPF. | ||
|
|
||
| - **Description**: Windows desktop support using Skia rendering and WPF | ||
| - **Documentation**: [Skia Desktop](xref:Uno.Skia.Desktop) | ||
|
|
||
| ### Uno.WinUI.Skia.MacOS | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Skia.MacOS/) | ||
|
|
||
| Skia-based rendering for macOS desktop. | ||
|
|
||
| - **Description**: macOS desktop support using Skia rendering | ||
| - **Documentation**: [Using Skia Desktop (macOS)](xref:Uno.Skia.macOS) | ||
|
|
||
| ### Uno.WinUI.Skia.Linux.FrameBuffer | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Skia.Linux.FrameBuffer/) | ||
|
|
||
| Framebuffer rendering for Linux embedded systems. | ||
|
|
||
| - **Description**: Run Uno apps directly on Linux framebuffer without X11/Wayland | ||
| - **Documentation**: [Linux Framebuffer](features/using-linux-framebuffer.md) | ||
|
|
||
| ### Uno.WinUI.Skia.X11 | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Skia.X11/) | ||
|
|
||
| X11-based rendering for Linux desktop. | ||
|
|
||
| - **Description**: Linux desktop support using direct X11 rendering | ||
|
|
||
| ## UI Enhancement Packages | ||
|
|
||
| ### Uno.WinUI.Graphics2DSK | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Graphics2DSK/) | ||
|
|
||
| SkiaSharp integration for 2D graphics rendering. | ||
|
|
||
| - **Description**: Provides SKCanvasElement for SkiaSharp-based custom rendering | ||
| - **Documentation**: [SKCanvasElement](xref:Uno.Controls.SKCanvasElement) | ||
| - **When to use**: When you need custom 2D graphics using SkiaSharp | ||
|
|
||
| ### Uno.WinUI.Lottie | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Lottie/) | ||
|
|
||
| Support for Lottie animations. | ||
|
|
||
| - **Description**: Display and control Lottie animation files | ||
| - **Documentation**: [Lottie animations](features/Lottie.md) | ||
| - **When to use**: To display vector animations from Adobe After Effects | ||
|
|
||
| ### Uno.WinUI.Svg | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Svg/) | ||
|
|
||
| SVG image support. | ||
|
|
||
| - **Description**: Enhanced SVG rendering capabilities | ||
| - **Documentation**: [Using SVG images](features/svg.md) | ||
| - **When to use**: For advanced SVG image support | ||
|
|
||
| ### Uno.WinUI.MSAL | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.MSAL/) | ||
|
|
||
| Microsoft Authentication Library (MSAL) integration. | ||
|
|
||
| - **Description**: Azure AD/Microsoft authentication support | ||
| - **Documentation**: [MSAL for Azure Authentication](xref:Uno.Interop.MSAL) | ||
| - **When to use**: To implement Microsoft identity platform authentication | ||
|
|
||
| ### Uno.WinUI.Maps | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.Maps/) | ||
|
|
||
| Map control implementation. | ||
|
|
||
| - **Description**: Interactive map support using native map controls | ||
| - **Documentation**: [MapControl](controls/map-control-support.md) | ||
| - **When to use**: To display interactive maps in your application | ||
|
|
||
| ### Uno.WinUI.MediaPlayerElement | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.MediaPlayerElement/) | ||
|
|
||
| Media playback control. | ||
|
|
||
| - **Description**: Video and audio playback using native media players | ||
| - **Documentation**: [MediaPlayerElement](controls/MediaPlayerElement.md) | ||
| - **When to use**: To play video or audio content | ||
|
|
||
| ## Developer Tools | ||
|
|
||
| ### Uno.WinUI.DevServer | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.DevServer/) | ||
|
|
||
| Development server for enhanced debugging. | ||
|
|
||
| - **Description**: Hot reload and debugging support | ||
| - **Documentation**: [Hot Reload](xref:Uno.Features.HotReload) | ||
| - **When to use**: Automatically included in debug builds | ||
|
|
||
| ### Uno.Resizetizer | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.Resizetizer/) | ||
|
|
||
| Image and asset resizing tool. | ||
|
|
||
| - **Description**: Automatically generates app icons and splash screens from SVG files | ||
| - **Documentation**: [Splash Screen](xref:Uno.Development.SplashScreen) | ||
| - **When to use**: Included by default in Uno Platform 4.8+ projects | ||
|
|
||
| ### Uno.UITest | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.UITest/) | ||
|
|
||
| UI testing framework. | ||
|
|
||
| - **Description**: Cross-platform UI testing based on Xamarin.UITest | ||
| - **Documentation**: [Creating UI Tests](uno-development/creating-ui-tests.md) | ||
| - **When to use**: To create automated UI tests | ||
|
|
||
| ## WPF Integration | ||
|
|
||
| ### Uno.WinUI.XamlHost | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.XamlHost/) | ||
|
|
||
| Host Uno Platform controls in WPF applications. | ||
|
|
||
| - **Description**: Embed Uno Platform UI in WPF applications | ||
| - **Documentation**: [Uno Platform in WPF](guides/uno-islands.md) | ||
| - **When to use**: To modernize existing WPF applications | ||
|
|
||
| ### Uno.WinUI.XamlHost.Skia.Wpf | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.WinUI.XamlHost.Skia.Wpf/) | ||
|
|
||
| Skia-based XAML hosting for WPF. | ||
|
|
||
| - **Description**: Skia renderer version of XamlHost for WPF | ||
| - **Documentation**: [Uno Platform in WPF](guides/uno-islands.md) | ||
|
|
||
| ## Supporting Packages | ||
|
|
||
| ### Uno.Fonts.Fluent | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.Fonts.Fluent/) | ||
|
|
||
| Fluent icon font. | ||
|
|
||
| - **Description**: Microsoft Fluent icon font for UI icons | ||
| - **Documentation**: [Fluent icon font](uno-fluent-assets.md) | ||
| - **When to use**: Automatically included with Uno.WinUI/Uno.UI | ||
|
|
||
| ### Uno.Foundation.Logging | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.Foundation.Logging/) | ||
|
|
||
| Logging infrastructure. | ||
|
|
||
| - **Description**: Core logging interfaces and utilities | ||
| - **Documentation**: [Logging](logging.md) | ||
| - **When to use**: Automatically included as a dependency | ||
|
|
||
| ### Uno.Diagnostics.Eventing | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.Diagnostics.Eventing/) | ||
|
|
||
| Event tracing support. | ||
|
|
||
| - **Description**: Performance monitoring and diagnostics | ||
| - **When to use**: Automatically included as a dependency | ||
|
|
||
| ### Uno.Core | ||
|
|
||
| [](https://www.nuget.org/packages/Uno.Core/) | ||
|
|
||
| Core utilities and extensions. | ||
|
|
||
| - **Description**: Common utilities used across Uno Platform packages | ||
| - **When to use**: For advanced scenarios and internal utilities | ||
|
|
||
| ## Additional Ecosystems | ||
|
|
||
| For packages related to Uno Platform extensions, themes, and toolkits, see: | ||
|
|
||
| - **[Uno.Extensions](https://aka.platform.uno/uno-extensions-docs)** - MVUX, Navigation, Dependency Injection, Configuration, HTTP, Authentication, and more | ||
| - **[Uno.Toolkit](https://aka.platform.uno/uno-toolkit-docs)** - Additional UI controls and behaviors | ||
| - **[Uno.Themes](https://aka.platform.uno/uno-themes-docs)** - Material and Cupertino design system implementations | ||
| - **[Uno.Check](https://www.nuget.org/packages/Uno.Check/)** - Environment setup and validation tool | ||
|
|
||
| ## Related Resources | ||
|
|
||
| - [How to upgrade Uno Platform NuGet Packages](xref:Uno.Development.UpgradeUnoNuget) | ||
| - [Supported 3rd-party libraries](xref:Uno.Development.SupportedLibraries) | ||
| - [.NET Version Support](net-version-support.md) | ||
| - [Using the Uno.SDK](xref:Uno.Features.Uno.Sdk) | ||
|
|
||
| ## Package Versioning | ||
|
|
||
| All core Uno Platform packages follow semantic versioning and are released in sync. When upgrading, ensure you update all Uno packages to the same version to avoid compatibility issues. | ||
|
|
||
| For projects using Uno.Sdk, the SDK version controls all underlying package versions automatically. | ||
|
|
||
| --- | ||
|
|
||
| > [!TIP] | ||
| > If you find a package is missing from this list or have suggestions for improvements, please [create an issue](https://github.com/unoplatform/uno/issues/new/choose) or [submit a pull request](https://github.com/unoplatform/uno/blob/master/doc/articles/nuget-packages.md). | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.