ms.topic | ms.date |
---|---|
include |
03/23/2023 |
An App ID is required to identify the app that you are distributing. An App ID is similar to a reverse-DNS string, that uniquely identifies an app, and should be identical to the bundle identifier for your app. You can use the same App ID that you used when deploying your app to a device for testing.
There are two types of App ID:
- Wildcard. A wildcard App ID allows you to use a single App ID to match multiple apps, and typically takes the form
com.domainname.*
. A wildcard App ID can be used to distribute multiple apps, and should be used for apps that do not enable app-specific capabilities. - Explicit. An explicit App ID is unique to a single app, and typically takes the form
com.domainname.myid
. An explicit App ID allows the distribution of one app, with a matching bundle identifier. Explicit App IDs are typically used for apps that enable app-specific capabilities such as Apple Pay, or Game Center. For more information about capabilities, see Capabilities.
To create a new App ID:
-
In your Apple Developer Account, navigate to Certificates, IDs & Profiles.
-
On the Certificates, Identifiers & Profiles page, select the Identifiers tab.
-
On the Identifiers page, select the + button to create a new App ID.
-
On the Register a new identifier page, select the App IDs radio button before selecting the Continue button:
:::image type="content" source="../deployment/media/create-app-id.png" alt-text="Create an App ID.":::
-
On the Register a new identifier page, select App before selecting the Continue button:
:::image type="content" source="../deployment/media/register-identifier.png" alt-text="Register an App ID.":::
-
On the Register an App ID page, enter a description, and select either the Explicit or Wildcard Bundle ID radio button. Then, enter the Bundle ID for your app in reverse DS format:
:::image type="content" source="../deployment/media/specify-bundle-id.png" alt-text="Specify the bundle identifier for the app.":::
[!IMPORTANT] The Bundle ID you enter must correspond to the Bundle identifier in the Info.plist file in your app project.
The bundle identifier for a .NET MAUI app is stored in the project file as the Application ID property:
- In 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.
- In 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 in the Info.plist will be automatically updated.
-
On the Register an App ID page, select any capabilities that the app uses. Any capabilities must be configured both on this page and in the Entitlements.plist file in your app project. For more information see Capabilities and Entitlements.
-
On the Register an App ID page, select the Continue button.
-
On the Confirm your App ID page, select the Register button.