Skip to content

Commit 4340b18

Browse files
Improve docs about manual provisioning. Fixes #2901. (#3136)
* Improve docs about manual provisioning. Fixes #2901. Fixes #2901. * try fix tabs Updated manual provisioning instructions for .NET MAUI apps in Visual Studio and .NET CLI. * Try fix tabs harder * Add all tabs all the time. --------- Co-authored-by: Gerald Versluis <[email protected]> Co-authored-by: Gerald Versluis <[email protected]>
1 parent e90b05c commit 4340b18

File tree

1 file changed

+44
-1
lines changed

1 file changed

+44
-1
lines changed

docs/ios/device-provisioning/manual-provisioning.md

Lines changed: 44 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Manual provisioning for .NET MAUI iOS apps"
33
description: "Learn how to use manual provisioning to create development certificates and profiles for .NET MAUI iOS apps."
4-
ms.date: 11/25/2024
4+
ms.date: 12/12/2024
55
ms.custom: sfi-image-nochange
66
---
77

@@ -119,6 +119,12 @@ The provisioning profiles will be downloaded on Windows, and exported to your Ma
119119
# [Visual Studio Code](#tab/visual-studio-code)
120120
<!-- markdownlint-enable MD025 -->
121121

122+
Follow the instructions for .NET CLI.
123+
124+
<!-- markdownlint-disable MD025 -->
125+
# [.NET CLI](#tab/cli)
126+
<!-- markdownlint-enable MD025 -->
127+
122128
After creating a development provisioning profile in your Apple Developer Account, you will need to download it in Xcode so that it's available for signing your app:
123129

124130
1. Open the **Xcode** app.
@@ -132,6 +138,10 @@ After creating a development provisioning profile in your Apple Developer Accoun
132138

133139
## Enable manual provisioning
134140

141+
<!-- markdownlint-disable MD025 -->
142+
# [Visual Studio](#tab/vswin)
143+
<!-- markdownlint-enable MD025 -->
144+
135145
After manually creating the development provisioning profile, and installing it in Visual Studio, your .NET MAUI app project should be configured to use manual provisioning:
136146

137147
1. In **Solution Explorer** right-click on your .NET MAUI app project and select **Properties**. Then, navigate to the **MAUI Shared > General** tab and ensure that the value of the **Application ID** field corresponds to the format of the App ID you created earlier.
@@ -141,6 +151,39 @@ After manually creating the development provisioning profile, and installing it
141151

142152
1. In the **Bundle Signing** properties, select your **Signing identity** and **Provisioning profile**, or set both to **Automatic**. When **Signing identity** and **Provisioning profile** are both set to **Automatic**, Visual Studio will select the signing identity and provisioning profile based on the **Bundle identifier** in **Info.plist** (which is identical to the value of the **Application ID** property in your project file).
143153

154+
<!-- markdownlint-disable MD025 -->
155+
# [Visual Studio Code](#tab/visual-studio-code)
156+
<!-- markdownlint-enable MD025 -->
157+
158+
Follow the instructions for .NET CLI.
159+
160+
<!-- markdownlint-disable MD025 -->
161+
# [.NET CLI](#tab/cli)
162+
<!-- markdownlint-enable MD025 -->
163+
164+
After manually creating the development provisioning profile and downloading it, your .NET MAUI app project should be configured to use manual provisioning by setting the appropriate properties in your project file.
165+
166+
By default, if the `CodesignKey` and `CodesignProvision` properties are not set in your project file, the build will automatically select the appropriate certificate and provisioning profile. However, if the automatic selection is incorrect for your scenario, you can explicitly specify these properties:
167+
168+
1. Ensure that the `<ApplicationId>` property in your project file corresponds to the format of the App ID you created earlier.
169+
1. Add the following properties to a `<PropertyGroup>` in your project file (*.csproj):
170+
171+
```xml
172+
<PropertyGroup>
173+
<CodesignKey>Apple Development: Your Name (ABCDEFGH)</CodesignKey>
174+
<CodesignProvision>My Provisioning Profile</CodesignProvision>
175+
</PropertyGroup>
176+
```
177+
178+
Replace `Apple Development: Your Name (ABCDEFGH)` with the exact name of your signing certificate as it appears in Keychain Access, and `My Provisioning Profile` with the exact name of your provisioning profile.
179+
180+
> [!TIP]
181+
> To find your signing certificate name, open **Keychain Access** on your Mac and look in the **My Certificates** category. To find your provisioning profile name, check the name you assigned when creating the profile in your Apple Developer Account.
182+
183+
For more information about these properties, see [CodesignKey](/dotnet/ios/building-apps/build-properties#codesignkey) and [CodesignProvision](/dotnet/ios/building-apps/build-properties#codesignprovision).
184+
185+
---
186+
144187
[!INCLUDE [Deploy the app to your device](~/ios/includes/deploy.md)]
145188

146189
## Provisioning for application services

0 commit comments

Comments
 (0)