Uno Toolkit Cupertino Library
The Uno.Toolkit.Cupertino library is available as NuGet packages that can be added to any new or existing Uno solution.
Installation
Note
As of Uno Platform 4.7, the solution template of the Uno app has changed. There is no longer a Shared project (.shproj), it has been replaced with a regular cross-platform library containing all user code files, referred to as the App Code Library project. This also implies that package references can be included in a single location without the previous need to include those in all project heads.
Open an existing Uno project, or create a new Uno project using the
Multi-Platform App (Uno Platform)
template.In the Solution Explorer panel, right-click on your app's App Code Library project (
PROJECT_NAME.csproj
) and selectManage NuGet Packages...
Install the
Uno.Toolkit.WinUI.Cupertino
packageAdd the resources to
AppResources.xaml
:<ResourceDictionary> <ResourceDictionary.MergedDictionaries> <!-- Load Cupertino resources --> <CupertinoColors xmlns="using:Uno.Cupertino" /> <CupertinoFonts xmlns="using:Uno.Cupertino" /> <CupertinoResources xmlns="using:Uno.Cupertino" /> <!-- Load Cupertino Toolkit resources --> <ToolkitResources xmlns="using:Uno.Toolkit.UI" /> <CupertinoToolkitResources xmlns="using:Uno.Toolkit.UI.Cupertino" /> <!-- Load custom application resources --> <!-- ... --> </ResourceDictionary.MergedDictionaries> </ResourceDictionary>
Installing the Cupertino Toolkit on previous versions of Uno Platform
If your application is based on the older solution template that includes a shared project (.shproj), follow these steps:
Open your existing Uno project
In the Solution Explorer panel, right-click on your solution name and select
Manage NuGet Packages for Solution ...
. Choose either:- The
Uno.Toolkit.UI.Cupertino
package when targetting Xamarin/UWP - The
Uno.Toolkit.WinUI.Cupertino
package when targetting net6.0+/WinUI
- The
Select the following projects for installation:
PROJECT_NAME.Wasm.csproj
PROJECT_NAME.Mobile.csproj
(orPROJECT_NAME.iOS.csproj
,PROJECT_NAME.Droid.csproj
,PROJECT_NAME.macOS.csproj
if you have an existing project)PROJECT_NAME.Skia.Gtk.csproj
PROJECT_NAME.Skia.WPF.csproj
PROJECT_NAME.Windows.csproj
(orPROJECT_NAME.UWP.csproj
for existing projects)
Add the resources to
App.xaml
:<Application ...> <Application.Resources> <ResourceDictionary> <ResourceDictionary.MergedDictionaries> <!-- Load WinUI resources --> <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls" /> <!-- Load Cupertino resources --> <CupertinoColors xmlns="using:Uno.Cupertino" /> <CupertinoFonts xmlns="using:Uno.Cupertino" /> <CupertinoResources xmlns="using:Uno.Cupertino" /> <!-- Load Cupertino Toolkit resources --> <ToolkitResources xmlns="using:Uno.Toolkit.UI" /> <CupertinoToolkitResources xmlns="using:Uno.Toolkit.UI.Cupertino" /> <!-- Load custom application resources --> <!-- ... --> </ResourceDictionary.MergedDictionaries> </ResourceDictionary> </Application.Resources> </Application>
Customization
For instructions on changing the default color palette or the font family, please refer to this guide.