Information property list

An information property list file is an XML file encoded using Unicode UTF-8 that contains configuration information for your .NET Multi-platform App UI (.NET MAUI) app on iOS and Mac Catalyst. The root node of the file is a dictionary, which contains a set of keys and values that define your app configuration. The name of the information property list file is Info.plist, and is case sensitive. All .NET MAUI iOS and Mac Catalyst apps must contain an Info.plist file that describes the app.

.NET MAUI creates Info.plist files for iOS and Mac Catalyst when you create a .NET MAUI app from a project template. These files are located in the Platforms/iOS and Platforms/Mac Catalyst folders, and are populated with an initial list of property list keys.

When you build your app, .NET MAUI copies your Info.plist file into the compiled bundle, before code signing the bundle. During the copy operation, .NET MAUI uses build properties to perform some variable substitution. It can also insert additional keys representing configuration that's specified in other ways. Due to this, the information property list file that ships in your app bundle isn't identical to the source file in your project.

Edit the information property list in the editor

Double-clicking an Info.plist file will open it in Visual Studio's Info.plist editor.

Visual Studio

Visual Studio's Info.plist editor contains two views of the data:

• Application, which enables you to set common app properties:

  

  Note

  Values for the Application Name, Bundle Identifier, Version, and Build fields are retrieved from your app's project file. For more information, see Provide app info.

• Advanced, which enables you to specify supported document types, universal type identifiers (UTIs), and URL types:

  

Visual Studio for Mac

Note

Visual Studio for Mac is scheduled for retirement by August 31 2024 in accordance with Microsoft's Modern Lifecycle Policy. Visual Studio for Mac 17.6 will continue to be supported until August 31 2024, with servicing updates for security issues and updated platforms from Apple. For more information, including alternative options for developing on a Mac, see What's happening to Visual Studio for Mac?.

Visual Studio for Mac's Info.plist editor contains three views of the data:

• Source, which enables you to edit keys and values manually:

  

• Advanced, which enables you to specify supported document types, universal type identifiers (UTIs), and URL types:

  

• Application, which enables you to set common app properties:

  

  Note

  Values for the Application Name, Bundle Identifier, Version, and Build fields are retrieved from your app's project file. For more information, see Provide app info.

Edit the information property list source

The Info.plist file can also be opened in an external editor to edit its XML source. Keys and values to configure the app can be added for the following categories:

• Bundle configuration, to configure the basic characteristics of a bundle such as its name, type, and version. For more information, see Bundle configuration on developer.apple.com.
• User interface, to configure an app's scenes, icons, and fonts. For more information, see User interface on developer.apple.com.
• App execution, to configure app launch, execution, and termination. For more information, see App execution on developer.apple.com.
• Protected resources, to control an app's access to protected services and user data. For more information, see Protected resources on developer.apple.com.
• Data and storage, to configure your app's data management capabilities. For more information, see Data and storage on developer.apple.com.
• App services, to configure the services that your app provides. For more information, see App services on developer.apple.com.
• Kernel and drivers, to configure device drivers provided by your app. For more information, see Kernel and drivers on developer.apple.com.

Provide app info

The Info.plist editor retrieves basic app data from the app's project file, rather than storing it directly in the Info.plist file. At build time, .NET MAUI copies this data into the Info.plist file that ships in your app bundle.

Application name

The application name for a .NET MAUI app is stored in the app's project file as the ApplicationTitle build property:

Visual Studio

In Solution Explorer, right-click on your .NET MAUI app project and select Properties. Then, navigate to the MAUI Shared > General tab. The Application Title field lists the application name.

Visual Studio for Mac

Note

Visual Studio for Mac is scheduled for retirement by August 31 2024 in accordance with Microsoft's Modern Lifecycle Policy. Visual Studio for Mac 17.6 will continue to be supported until August 31 2024, with servicing updates for security issues and updated platforms from Apple. For more information, including alternative options for developing on a Mac, see What's happening to Visual Studio for Mac?.

In the Solution Window, right-click on your .NET MAUI app project and select Properties. Then, in the Project Properties window, select the Build > App Info tab. The Application Title field lists the application name.

When the value of the Application Title field is updated, the value of the Application Name field in the application view in the Info.plist file will be automatically updated.

Application ID

The bundle identifier for a .NET MAUI app is stored in the app's project file as the ApplicationId build property:

Visual Studio

In Solution Explorer, right-click on your .NET MAUI app project and select Properties. Then, navigate to the MAUI Shared > General tab. The Application ID field lists the bundle identifier.

Visual Studio for Mac

Note

Visual Studio for Mac is scheduled for retirement by August 31 2024 in accordance with Microsoft's Modern Lifecycle Policy. Visual Studio for Mac 17.6 will continue to be supported until August 31 2024, with servicing updates for security issues and updated platforms from Apple. For more information, including alternative options for developing on a Mac, see What's happening to Visual Studio for Mac?.

In the Solution Window, right-click on your .NET MAUI app project and select Properties. Then, in the Project Properties window, select the Build > App Info tab. The Application ID field lists the bundle identifier.

When the value of the Application ID field is updated, the value of the Bundle Identifier field in the application view in the Info.plist file will be automatically updated.

Application display version

The application display version for a .NET MAUI app is stored in the app's project file as the ApplicationDisplayVersion build property:

Visual Studio

In Solution Explorer, right-click on your .NET MAUI app project and select Properties. Then, navigate to the MAUI Shared > General tab. The Application Display Version field lists the application display version.

Visual Studio for Mac

Note

Visual Studio for Mac is scheduled for retirement by August 31 2024 in accordance with Microsoft's Modern Lifecycle Policy. Visual Studio for Mac 17.6 will continue to be supported until August 31 2024, with servicing updates for security issues and updated platforms from Apple. For more information, including alternative options for developing on a Mac, see What's happening to Visual Studio for Mac?.

In the Solution Window, right-click on your .NET MAUI app project and select Properties. Then, in the Project Properties window, select the Build > App Info tab. The Application Display Version field lists the application display version.

When the value of the Application Display Version field is updated, the value of the Version field in the application view in the Info.plist file will be automatically updated.

Application version

The application version for a .NET MAUI app is stored in the app's project file as the ApplicationVersion build property:

Visual Studio

In Solution Explorer, right-click on your .NET MAUI app project and select Properties. Then, navigate to the MAUI Shared > General tab. The Application Version field lists the application version.

Visual Studio for Mac

Note

Visual Studio for Mac is scheduled for retirement by August 31 2024 in accordance with Microsoft's Modern Lifecycle Policy. Visual Studio for Mac 17.6 will continue to be supported until August 31 2024, with servicing updates for security issues and updated platforms from Apple. For more information, including alternative options for developing on a Mac, see What's happening to Visual Studio for Mac?.

In the Solution Window, right-click on your .NET MAUI app project and select Properties. Then, in the Project Properties window, select the Build > App Info tab. The Application Version field lists the application version.

When the value of the Application Version field is updated, the value of the Build field in the application view in the Info.plist file will be automatically updated.

See also

• Information Property List on developer.apple.com