First step: Add a Cocoa App project. Right now, Xamarin.Forms template doesn’t have a Cocoa App initially. So, what you would do is to start Visual Studio for Mac or Xamarin Studio and open your existing Xamarin.Forms solution. Then, add a project into the solution by right-clicking the solution and selecting Add Add New Existing Project. Files UWP Preview is the modern Files Explorer app you always wanted. The app is still in its early stages and some features have not been implemented, but the app is already packed with features such as fluent design, tabs, layout modes, and much more. Uwp app download file File access permissions,Locations that UWP apps can access.
This guide will walk you through the set-up process for building cross-platform apps with Uno.
Choose your IDE
Use Uno with your favorite tools.
Visual Studio
Prerequisites
Visual Studio 2019 16.3 or later, with:
- Universal Windows Platform workload installed.
- Mobile development with .NET (Xamarin) workload installed.
- the iOS Remote Simulator installed (for iOS development)
- A working Mac with Visual Studio for Mac, XCode 8.2 or later installed (for iOS development)
- Google's Android x86 emulators or a physical Android device (for Android development)
- ASP.NET and web workload installed, along with .NET Core 2.2 or later (for WASM development)
For more information about these prerequisites, see Installing Xamarin. For information about connecting Visual Studio to a Mac build host, see Pair to Mac for Xamarin.iOS development.
Installing the Uno Platform Solution Templates with Visual Studio
Launch Visual Studio, then click
Continue without code
. ClickExtensions
->Manage Extensions
from the Menu Bar.In the Extension Manager expand the Online node and search for
Uno Platform Templates
, install theUno Platform Solution Templates
extension or download it from the Visual Studio Marketplace extension, then restart Visual Studio.
Create an application from the solution template
To easily create a multi-platform application:
- Create a new C# solution using the Cross-Platform App (Uno Platform) template, from Visual Studio's Start Page:
- Update to the latest NuGet package named
Uno.UI
. To get the very latest features, check thepre-release
box. - To debug the iOS head, select the
Debug|iPhoneSimulator
configuration - To debug the Android head, select the
Debug|AnyCPU
configuration - To debug the UWP head, select the
Debug|x86
configuration - To run the WebAssembly (Wasm) head, select IIS Express and press Ctrl+F5 or choose 'Start without debugging' from the menu. Note that F5 will not work because Visual Studio debugging isn't supported. See here for debugging instructions through Chrome.
Make sure XAML Intellisense is enabled
Intellisense is supported in XAML when the UWP head is active:
If XAML Intellisense isn't working on a freshly-created project, try the following steps:
- Build the UWP head.
- Close all XAML documents.
- Close and reopen Visual Studio.
- Reopen XAML documents.
Video Tutorial
VS Code
This guide will walk you through the set-up process for building WebAssembly apps with Uno, under Windows, Linux or macOS.
Prerequisites
Create an Uno Platform project
- Launch Code, then in the terminal type the following to install the Uno Platform templates:
- In the terminal type the following to create a new project:
This will create a solution that only contains the WebAssembly platform support.
Prepare the WebAssembly application for debugging
- Install the C# extension and the JavaScript Debugger (Nightly) extension with the
debug.javascript.usePreview
setting set to true (File / Preference / Settings, search forUse preview
). - Open Code using
- Visual Studio Code will ask to restore the NuGet packages.
Modify the template
Uwp App
- In
MainPage.xaml
, replace the Grid's content with the following: - In your
MainPage.xaml.cs
, add the following method:
Run and Debug the application
- Starting the app with the WebAssembly debugger is a two-step process:
- Start the app first using the “.NET Core Launch (Uno Platform App)” launch configuration
- Then start the browser using the “.NET Core Debug Uno Platform WebAssembly in Chrome” launch configuration (requires Chrome). To use the latest stable release of Edge instead of Chrome, change the type of the launch configuration in
.vscode/launch.json
frompwa-chrome
topwa-msedge
- Place a breakpoint in the OnClick method
- Click the button in the app, and the breakpoint will hit
Updating an existing application to work with VS Code
If you already have an Uno application, you can add some some missing support files for VS Code to recognize your project.
Here's how to do this:
- Use the same command line above to create a project with the same name as your current project, in a different location.
- Once created, copy the generated
.vscode
folder next to your.sln
file - Update the
Uno.UI
package version to the latest stable version - Update the
Uno.Wasm.Bootstrap
package to 1.2.0 or later version - Add a reference to
Uno.Wasm.Bootstrap.DevServer
version 1.2 or later. - In your Wasm project file, if you had a
<DotNetCliToolReference />
line, remove it
You should now be in the same configuration as the generated template files.
Video Tutorial
Visual Studio For Mac
While it is easier to create apps using Uno on Windows, you can also create all but UWP apps on your Mac.
Prerequisites
- Xcode 10.0 or higher
- An Apple ID
- .NET Core 3.1 or higher
Modifying Existing Uno App
Open project in Visual Studio for MacOnce open, you should see your folder structure set up like this:
If you have a warning symbol on your iOS project, make sure you have the minimum version of XCode.
To update, go toVisual Studio > Preferences > Projects > SDK Locations > Apple
and select XCode 10.0 or higher.Restart Visual Studio.You can now run on iOS, Android, and WebAssembly by setting your startup project and running.
Note: You will not be able to build the UWP project on a Mac. All changes to this project must be made on Windows.
Build for WASM
Building for WebAssembly takes a few more steps than iOS and Android:
- Set yourProject.Wasm to startup project
- Build the project
- In the terminal, navigate to your build output. This will typically be:
yourProject.Wasm > bin > Debug > netstandard2.0 > dist > server.py
Run theserver.py
program. - In your browser, open localhost:8000.
Video Tutorial
JetBrains Rider
Prerequisites
Creating a new Uno project
At this time, there isn't a template for the Rider IDE like there is for Visual Studio, so you can create a new projectby following these steps:
In your terminal, navigate to the folder that contains your Rider solutions.
Run these commands:
Installs Uno template:
Creates a new project:
You should now have a folder structure that looks like this:
Android
- Remove the following line from the
.csproj
file:<Target Name='GenerateBuild' DependsOnTargets='SignAndroidPackage' AfterTargets='Build' Condition='$(BuildingInsideVisualStudio)'' />
- Set Android as your startup project. Run.
Note: Whether you're using a physical device or the emulator, the app will install but will not automatically open.You will have to manually open.
Wasm
- Select Wasm as your startup project. Run.
A new browser window will automatically run your application.
Note: There is no debugging for Wasm within Rider, but you debug using the built in Chrome tools.
iOS and MacOS
You will be able to build the iOS project, however, there is currently no support for a simulator to begin debugging.
Alternatively, you can use a tool like VNC to run the simulator on a mac.
UWP
You will be able to build the UWP project, however, Rider currenly does not support debugging or deploying for UWP.
Video Tutorial
Next:
Build apps that work on all Windows 10 devices, or enhance your existing apps with new and updated features.
Learn about Windows 10 Apps
Windows 10 and the Universal Windows Platform let you build apps that work and look great across all Windows device types, or update existing apps with modern features.
What's a Windows app?
Design and UI
Get set up
Visual Studio Community and the Windows 10 SDK give you everything you need to build great apps – and they're free.
Download the tools and SDK
Start coding
Whether you're an experienced dev or just building your first app, get hands-on experience with the Windows 10 platform and docs.
Start coding
API Reference
Tutorials
Looking for a guided learning experience? These tutorials will help.
UI Basics
Data binding
Custom styles
Samples
Get firsthand experience with the Windows 10 platform and see APIs in action.
Using Windows app samples
Customer Orders Database
Quiz Game (Project Rome)
Windows code samples portal
What's new
Expand your horizons and explore the latest additions to Windows 10.
What's cool in the latest version of Windows 10
Uwp Application Id
Uwp App In C#
What's new in Windows 10 for developersWhat Is Uwp
Developer tools
Windows Template StudioWindows Community Toolkit
Virtual machines
Bash on Ubuntu on Windows
Explore related docs
C# GuideVisual Studio