xamarin-macios/dotnet/DefaultCompilationIncludes.md

Default complication includes in iOS, tvOS, macOS and Mac Catalyst projects

Default compilation includes for .NET Core projects is explained here: Default compilation includes in .NET Core projects

This document explains how default compilation includes is implemented for iOS, tvOS, macOS, and Mac Catalyst projects.

Default inclusion can be completely disabled by setting EnableDefaultItems=false. It can also be disabled per-platform by setting the platform-specific variables EnableDefaultiOSItems=false, EnableDefaulttvOSItems=false, EnableDefaultMacCatalystItems=false, or EnableDefaultmacOSItems=false.

Property lists

All *.plist files in the root directory are included by default (as None items).

SceneKit Assets

All *.scnassets directories anywhere in the project directory or any subdirectory are included by default (as SceneKitAsset items).

Storyboards

All *.storyboard and *.xib files in the project directory or any subdirectory are included by default (as InterfaceDefinition items).

Asset catalogs

All *.pdf, *.jpg, *.png and *.json files inside asset catalogs (*.xcassets) in the project directory or any subdirectory are included by default (as ImageAsset items).

Atlas Textures

All *.png files inside *.atlas directories in the project directory or any subdirectory are included by default (as AtlasTexture items).

Core ML Models

All *.mlmodel files anywhere in the project directory or any subdirectory are included by default (as CoreMLModel items).

Metal

All *.metal files anywhere in the project directory or any subdirectory are included by default (as Metal items).

All other files in the Resources/ subdirectory

All files in the Resources/ subdirectory except the ones mentioned above (*.scnassets, *.storyboard, *.xib, *.xcassets, *.atlas, *.mlmodel, *.metal) are included by default (as BundleResource items).