Uno Platform WebAssembly Renderers for Xamarin.Forms

This repository is the home of the Uno.Xamarin.Forms.Platform package, which provides a set of Xamarin.Forms renderers to provide WebAssembly support through the Uno Platform.

You can read about the Uno Platform https://platform.uno, and about Xamarin.Forms at https://www.xamarin.com/forms.

Build Status

Getting Started

• Require VS 2019 for Windows (16.5 or later) with ASP.NET Web Development and .NET Core cross-platform Workloads.

1. Create a Xamarin.Forms project
   1. Check Place project and solution in the same directory
   2. Check Windows (UWP)
2. Using a VS Developer Command Prompt, navigate to the folder containing the solution
3. Type the following to install the latest template:

   dotnet new -i Uno.ProjectTemplates.Dotnet::3.1.6
   

4. Then type the following to create the new WebAssembly project:

   dotnet new wasmxfhead
   

5. Open or Reload the solution in Visual Studio
6. Set the Wasm project as the startup project
7. Open the Nuget Package manager for the Wasm project and update the Uno.Xamarin.Forms.Platform project to the latest stable package
8. Run the app and you’re good to go!

Building the renderers

• Using Visual Studio 2019 (16.2 or later)
• Open the Uno.Xamarin.Forms.Platform.sln solution
• Build the Xamarin.Forms.ControlGallery.Uno.Wasm project
• Run it using F5

Coding Style

We follow the style used by the .NET Foundation, with a few exceptions:

• We do not use the private keyword as it is the default accessibility level in C#.
• We use hard tabs over spaces. You can change this setting in Visual Studio for Windows via Tools > Options and navigating to Text Editor > C# and selecting the "Keep tabs" radio option. In Visual Studio for Mac it's set via preferences in Source Code > Code Formatting > C# source code and disabling the checkbox for Convert tabs to spaces.
• Lines should be limited to a max of 120 characters (or as close as possible within reason). This may be set in Visual Studio for Mac via preferences in Source Code > Code Formatting > C# source code and changing the Desired file width to 120.

Contributing

• How to Contribute

Reporting Bugs

We use GitHub Issues to track issues.