Xamarin Forms Azure DevOps build/release for Enterprise apps


Building blocks Building Blocks - Photo by Markus Spiske on Unsplash

In January last year, I wrote about building and deploying Xamarin iOS apps using Azure DevOps. I wanted to write about the Android process but never mustered the energy to do it. Nevertheless, today is the day I will.

Not a ton has changed since then. Perhaps, the most relevant change is that last time I showed how to deploy directly to the store and this time I want to show how to deploy as an Enterprise app. Also, the build will use the somewhat new yml build pipeline instead of the visual build.

Enough said, let’s get to it.


  • Since not much changed, check the original post) for the iOS requirements.
  • For Android, you need to create a keystore file to sign the apk. Follow instructions in this document to do it.
  • A website to publish the apk/ipa and any other necessary resources for distribution.

The Build

I broke the build pipeline in 2 jobs: iOS and Android. Furthermore, each job will build a QA version and a PRD version of the app. Building multiple versions is useful because you can change labels and icons during the build and prevent that special user from testing in PRD. Keep in mind that the cost of building multiple versions will be paid with a more complex pipeline and the risk of slight differences due to build time configuration that can cause issues in one environment but not the other.

Here is a heavily annotated build yml file:

The Release

There are a few ways to release an enterprise app, however, I’m most familiar with distribution through download from a website, so I will discuss that.

As usual, Android is easy. When the user lands on your website provide them a button/link to download the apk and they can open it to install after download completes. Note that the user will only be allowed to install the app if they enable install from unknown sources.

<a href="https://lpains.net/content/com.lpains.mobile.apk">
  Download my awesome Android app

For iOS, the user need to click on a special link that points to the plist file created during the build. If everything checks, iOS will offer to install the app. After installation, the user will need to trust the enterprise developer before the app can be used.

<a href="itms-services://?action=download-manifest&url=https://lpains.net/content/com.lpains.mobile.plist">
  Download my awesome iOS app

Android or iOS, it is very important that the user initiates the install action by interacting with your website. Do not redirect the user to the install links as that will fail due to security reasons.

Unfortunately, there is not much material out there on how to build a Xamarin Forms app for both iOS and Android. This post is mostly a bunch of notes I took while getting everything working for an app I build for work. Anyway, hope it helps.

Cheers, Lucas