dotnet-maui-aot

Configure .NET MAUI projects for Native AOT compilation on iOS and Mac Catalyst.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/rudironsoni/dotnet-agent-harness --skill dotnet-maui-aot-rudironsoni
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotnet-maui-aot
Source: https://github.com/rudironsoni/dotnet-agent-harness/tree/main/.rulesync/skills/dotnet-maui-aot
Command: npx skills add https://github.com/rudironsoni/dotnet-agent-harness --skill dotnet-maui-aot-rudironsoni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the need to significantly reduce the size and improve the startup performance of .NET MAUI applications when deploying to iOS and Mac Catalyst platforms.

Core Features & Use Cases

  • Native AOT Compilation: Leverages the Native Ahead-of-Time (AOT) compilation pipeline for .NET MAUI on iOS and Mac Catalyst.
  • Performance Gains: Achieves up to 50% app size reduction and up to 50% faster startup times.
  • Compatibility Guidance: Details library gaps, opt-out mechanisms, and trimming interplay.
  • Use Case: Deploying a .NET MAUI app to the App Store with the smallest possible footprint and fastest possible launch.

Quick Start

Configure your MAUI project to use Native AOT for iOS by setting PublishAot to true in your .csproj file.

Frequently Asked Questions about dotnet-maui-aot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce MAUI app size for iOS deployment?

To reduce .NET MAUI app size for iOS, enable Native AOT compilation. This optimizes the publish profile and trimming configurations, achieving up to a 50% reduction in application footprint.

Can I improve MAUI startup performance on Mac Catalyst?

You can improve MAUI startup performance on Mac Catalyst using Native AOT compilation. By configuring ahead-of-time compilation in your publish profile, you can achieve up to 50% faster launch times.

What .NET version is required for MAUI Native AOT compilation?

MAUI Native AOT compilation requires .NET 8.0 or later. This prerequisite version provides the necessary compilation pipelines and publishing infrastructure to target iOS and Mac Catalyst platforms effectively.

How do I configure MAUI Native AOT in my project file?

To configure MAUI Native AOT, set the PublishAot property to true in your .csproj file. This enables the native ahead-of-time compilation pipeline for your iOS and Mac Catalyst deployment profiles.

Are there library compatibility issues with MAUI Native AOT?

Yes, MAUI Native AOT introduces library compatibility gaps due to trimming configurations. You may need to use opt-out mechanisms for incompatible libraries to ensure successful compilation for iOS and Mac Catalyst.