.NET MAUI iOS Free Provisioning

Contrary to popular belief, it is possible to run an iOS application on your iPhone/iPad without paying the $99 USD fee per year to Apple for a developer program account. Through a process called free provisioning we can gain this freedom. It is a relatively simple task to accomplish and only involves some clicking around Xcode. There is no jailbreaking involved and it is supported by Apple. It does have some limitations that we will get into, but for those learning mobile development in Apple’s walled garden of a platform, it is a great way to get started without the added expense.

We will demonstrate how free provisioning gets us started running code on our iOS device, through the lens of the relatively new .NET MAUI platform. For those unaware, .NET MAUI is a solution that allows us to write a single UI using XAML or Blazor based controls that will run across iOS, Android, Mac and Windows. There are also capabilities to call into platform specific code as needs dictate, for instance to access sensors or platform specific APIs like those provided for in-app purchases. A simulator does exist for iOS on the Mac and Visual Studio provides some great tooling around remoting to your simulator from Windows environments. However, there is no substitute for running your software on physical hardware while developing. Frankly, it is a faster experience and a lot closer to how your customers will use your application.

Requirements

  • Visual Studio 2022 17.3.0 or above with the .NET MAUI workload installed
  • A Mac to compile and plug your iPhone/iPad device into
  • Xcode latest version installed on your Mac
  • An Apple ID not connected to Apple Developer Program

Xcode Steps

Begin by opening Xcode on your Mac and navigating via the menu bar to Xcode > Preferences. Under the Accounts tab, click the plus button to add your Apple ID account to Xcode using your user name and password.

Xcode Add Account Dialog
Xcode Account Display

Close the dialog and proceed to create a new App project. Make sure to note your exact bundle identifier (in my case com.maui.FreeProv) and choose the team “Your Name (Personal Team)” created when you added your Apple ID to Xcode.

Xcode New Project
Once Xcode is done doing its thing, plug your iOS device into the Mac and unlock your phone so you can confirm you trust the mac to access your device, example below:

iPhone Trust Dialog

You will also need to enable Developer Mode on your phone by visiting Settings > Privacy and Security > Developer Mode and enabling the setting with the toggle. Note, your device will need to restart at this point and you must confirm that you want to turn developer mode on after the phone is unlocked.

Back in Xcode, at the top of your App project’s window, you will find a bread crumb control beside the project name. It is mostly likely pointing at an iPhone (model) value. Click that and choose your device in the dropdown under the iOS Device heading.

Xcode debug target dropdown

Next we have to configure the project settings to get our bundle identity signed. To do this click on the left side of the Xcode window in the project navigator on the top level node, in my case the FreeProv project. This will open the project properties tab. Verify the bundle identifier from earlier (remember I had you note this value) it must be exactly the same as the value you saw when creating the project. This is an important time to call out the profile we create is only for this identifier. When we setup some configuration in Visual Studio it will have to match this value exactly yet again. Set the Display Name while we are working in this section. Another value to note is the Minimum Deployments setting. This value must match or be lower than the iOS version running on the device you are using.

Xcode General Project Settings

Finally, switch tabs in the project settings dialog to Signing & Capabilities and choose to Automatically manage signing with the Your Name (Personal Team) value selected.

Xcode Signing Project Settings

If you click on the information icon next to the words Xcode Managed Profile you will see what was generated. You will also see the biggest limitation of this free provisioning process. The provisioning profile is only good for six days! Thankfully, you can just renew this value using an abbreviated version of the process discussed thus far. Please note though, signing identities will expire after a year.

At this point you can optionally deploy the sample application from Xcode to your device if you want to verify it is working as expected. Simply click the run button. It probably failed at this point saying it was an untrusted developer who built the app. Once again visit Settings and go to General > VPN & Device Management. There will be a developer app setting with your email there it says “Not Trusted” underneath. Click it and press the Trust “Apple Development: (your email) button. Finally, confirm in the dialog that you trust yourself (unless you really don’t 😏). Run the app again and things should go more smoothly this time.

App Running on Device from Xcode

Visual Studio Steps

Leave your iOS device connected to the Mac. Connect to your Mac from Visual Studio. Instructions can be found here if needed. On your new MAUI project (I did the .NET MAUI Blazor App for fun) navigate to your project properties in the solution explorer. Scroll down to the iOS settings block on the left hand side and click Bundle Signing. Here you need to ensure the scheme is set to Manual Provisioning and signing identity is Developer (Automatic).

Visual Studio Project Settings (Bundle Signing iOS)

Finally, open up the Info.plist file via your solution explorer and ensure the Bundle Identifier is set to the exact value I had you note before. This effectively links the VS project to the profile created on the connected Mac.

Info.plist

With a little luck, you should be able to choose your device from the iOS Remote Device menu of the Visual Studio run tool. This will compile the iOS app and ship it to your device for launch.

App Running on Device from Visual Studio

Conclusion

To summarize, it is possible for devs getting started to run their code on an iOS device without paying the yearly “Apple tax”. However, it is not the most intuitive process and only buys you a small window of time while developing before the process needs to be repeated. Most application services will not be available with free provisioning as well including Apple Pay, iCloud and In-App Purchasing just to name a few. While disappointing, at least this gives potential iOS developers a chance to experiment before committing to an Apple project with their wallets.

comments powered by Disqus