Skip to content

maxPaiin/MAUITraining

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A small .NET MAUI sample/test project that demonstrates basic UI, platform support, and integration scenarios for Android, iOS, macOS (Mac Catalyst), and Windows. This repository is intended for experimentation, learning, and automated tests of MAUI features. Contents / Intent

Lightweight sample app used for verifying .NET MAUI setup, building, and running on supported platforms.
Minimal UI and example pages that exercise navigation, controls, and platform-specific behavior.
Optionally contains unit/integration tests (if a test project is present).

Supported platforms

Android
iOS (device/simulator — requires a macOS build host and Xcode)
macOS (Mac Catalyst)
Windows

Prerequisites

.NET SDK (recommended: current supported .NET version that includes MAUI; install the latest supported SDK)
.NET MAUI workloads:
    Install via: dotnet workload install maui
Platform-specific tooling:
    Android: Android SDK & emulator or device (Android SDK, Android SDK Command-line Tools, and an emulator)
    iOS/macOS: Xcode (macOS only)
    Windows: Visual Studio with MAUI support or the appropriate MSVC toolchain
Recommended IDEs:
    Visual Studio 2022/2023 (Windows) with Mobile development and .NET MAUI workload
    Visual Studio for Mac (macOS)
    Or use the .NET CLI for command-line builds

For full setup instructions and troubleshooting, see the official docs: https://learn.microsoft.com/dotnet/maui Quick start — using Visual Studio (recommended)

Open the solution (*.sln) in Visual Studio.
Restore packages automatically (Visual Studio does this on load).
Select a target platform (Android emulator, iOS simulator, macOS, or Windows).
Build and run (F5) or deploy to a device/emulator.

Quick start — using the CLI

Restore dependencies:
    dotnet restore
Build:
    dotnet build -c Debug
To run or deploy, use Visual Studio or platform-specific publish/launch commands. Example publish (Android):
    dotnet publish -f net.0-android -c Release -o ./publish/android Replace <n> with the target .NET major version used by this project (e.g., net7.0 or net8.0) as configured in the project files.

Note: dotnet run is not always supported for all MAUI targets via the CLI; Visual Studio provides the easiest deploy experience. Running tests

If the repository includes test projects:

Run unit tests with:
    dotnet test
Or open the test project in Visual Studio and run tests via Test Explorer.

Project structure (typical)

src/ or MAUITraining/ — main MAUI app (App.xaml, MainPage.xaml, platform folders)
tests/ — unit and integration tests (if present)
README.md — this file

Adjust directories above to match this repo's layout. Common issues & troubleshooting

"Missing workload" errors: run dotnet workload install maui.
Android emulator or device not found: ensure Android SDK and platform tools are installed, and an emulator is running (or a device is connected and authorized).
iOS/macOS build errors: builds for Apple platforms require Xcode and a macOS environment.
NuGet package restore failures: verify network access and run dotnet restore --no-cache if needed.

Contributing

Create issues for bugs or feature requests.
Open pull requests for fixes or improvements. Keep changes small and include a short description of what and why.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors