Skip to content

Latest commit

 

History

History
77 lines (56 loc) · 3.27 KB

DEVELOPMENT.md

File metadata and controls

77 lines (56 loc) · 3.27 KB
Raw

Development Guide

This page contains steps to build and run the .NET MAUI repository from source. If you are looking to build apps with .NET MAUI please head over to the links in the README to get started.

Initial setup

Windows

  • Install VS 17.12 or newer
  • If building iOS with pair to Mac: Install current stable Xcode on your Mac. Install from the App Store or Apple Developer portal
  • If you're missing any of the Android SDKs, Visual Studio should prompt you to install them. If it doesn't prompt you then use the Android SDK Manager to install the necessary SDKs.
  • Install Open JDK 17

Mac

Building the Build Tasks

Before opening the solution in Visual Studio / VS Code you MUST build the build tasks.

  1. Open a command prompt/terminal/shell window
  2. Navigate to the location of your cloned dotnet/maui repo, for example: 
    cd \repos\maui
  3. Run these commands: 
    dotnet tool restore
dotnet build ./Microsoft.Maui.BuildTasks.slnf

Windows

Open the Microsoft.Maui-windows.slnf file in Visual Studio from the root of the repo.

Mac

Open the root folder of the repository in VS Code.

NOTE: IntelliSense takes a decent amount of time to fully process your solution. It will eventually work through all the necessary tasks. If you are having IntelliSense issues, usually unloading/reloading the maui.core and maui.controls projects will resolve.

What branch should I use?

As a general rule:

Use ‘main’ for bug fixes that don’t require API changes. For new features and changes to public APIs, you must use the branch of the next .NET version.

Sample projects

Samples

├── Controls 
│   ├── samples
│   │   ├── Maui.Controls.Sample
│   │   ├── Maui.Controls.Sample.Sandbox
├── Essentials 
│   ├── samples
│   │   ├── Essentials.Sample
├── BlazorWebView 
│   ├── samples
│   │   ├── BlazorWinFormsApp
│   │   ├── BlazorWpfApp
  • Maui.Controls.Sample: Full gallery sample with all of the controls and features of .NET MAUI
  • Maui.Controls.Sample.Sandbox: Empty project useful for testing reproductions or use cases
  • Essentials.Sample: Full gallery demonstrating the library previously known as Essentials. These are all the non UI related MAUI APIs.

Testing

Stats