In this tutorial I m going to show you how to build and sign your Xamarin.Android application and distribute it to your users through App Center. So let’s go to Azure DevOps to start!

Inside the Pipelines tab create a New pipeline and follow the 4 steps to get the source code from the correct repository. Azure DevOps will automatically create a new azure-pipelines.yml at the root of your project folder. This is where the job definition will be defined and then interpreted by Azure DevOps.

Create your variable group

This job will need multiple variables like folder path, environnement variables and passwords. So to manage all of it let’s create a variables group. If you are not familiar with this you can look at my previous tutorial about it.

For this tutorial, the variable group will be called android-pipeline.

Create the build

Let’s start by loading the variable group and restore the Nugets packages like this:

trigger:
- master

pool:
  vmImage: 'macos-latest'

variables:
  - group: android-pipeline

steps:

- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    restoreSolution: '**/*.sln'

Now we can add the build task as below:

- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*droid*.csproj'
    outputDirectory: '$(outputDirectory)'
    configuration: '$(buildConfiguration)'

The outputDirectory and buildConfiguration variables are defined in the variable groups with these values:

Variable groups

Now if you run your job for the first time you will get an error message that ask you to give access to your variable groups:

Variable groups

Accept it by clicking on Authorize resources, restart the build and you are good to go.

Sign your application

Now we need to sign our application with a keystore. Create it and uploaded to the Pipelines > Library > Secure files tab, so it will be accessible inside the Signing job. In this tutorial the keystore will be named production.jks.

Then we need to provide the alias key and password and the keystore password. For security reasons let’s add these informations to our variables group. So now we have all of these variables:

Variable groups

With all variables and the keystore setup we are ready to configure our AndroidSigning@3 task to sign our Xamarin.Android application. So let’s add the following task:

- task: AndroidSigning@3
  inputs:
    apkFiles: '**/*.apk' 
    apksign: true
    apksignerKeystoreFile: 'production.jks'
    apksignerKeystorePassword: $(keystore.password)
    apksignerKeystoreAlias: $(key.alias)
    apksignerKeyPassword: $(key.password)
    apksignerArguments: --out $(outputDirectory)/app.release.apk
    zipalign: true

The --out option from apksignerArguments allow us to specify a name to the output apk file just signed.

Deploy to App Center

Now we have our apk signed and ready to be send to our users. My favorite tool for that is App Center, you can share your application with different group of testers before publish it to a store and that’s really useful.

Create a service connection

To connect App Center to Azure DevOps we need to authorize Azure DevOps to be able to publish our apk. To do that, go to App Center and inside your Profile > Account Settings > API Tokens, create a New API Token and be sure to give your key the Full Access. Copy the API token key, you will need it for the next step.

Go back to Azure DevOps and inside Project Settings > Service connections create a new Visual Studio App Center connection, give it a name, for this tutorial it will be called: VSAC and use the API token key you already have.

VSAC

Now inside App Center, create a new Xamarin.Android application.

Get the app slug by concatenating your username and application identifier separated by / for example the slug for: https://appcenter.ms/users/damienaicheh/apps/XamAndroidPipeline will be: damienaicheh/XamAndroidPipeline.

Then in your application create a distribution group. This will allow you to share your app to a specific list of users. To do that, inside Distribute > Groups create a new group and in the group settings panel, bellow the group name, copy the group ID:

Group settings

Add your app slug and distribution group ID to the variables group like this:

Variable groups

Finally we can add the final task to deploy our apk to App Center:

- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: 'VSAC'
    appSlug: '$(appSlug)'
    appFile: '$(outputDirectory)/app.release.apk'
    releaseNotesOption: 'input'
    releaseNotesInput: 'New version'
    destinationType: 'groups'
    distributionGroupId: '$(distributionGroupId)'

If you run your build now, you will be able to see your apk deployed into App Center for the correct group.

Package delivered

You can now download it to an Android device and test it!

Sources:

You will find full source code in this Github repository.

Happy coding !

You liked this tutorial ? Leave a star in the associated Github repository !