VSTS Build Tasks: Mobile Center Build

I’ve been hacking a fair bit on Visual Studio Mobile Center lately. The feature set is iterating pretty fast and recently the introduction of the ability to link Mobile Center to VSTS was added. Along with that, a couple of build tasks appeared in the vsts-tasks Github repository:

These new tasks enabled VSTS build or release definitions to trigger tests and upload build outputs for distribution through Mobile Center.

Since Mobile Center has been built API-first, I started wondering if I could make my own build task to actually trigger a build. Seems it isn’t too difficult.

buildtask.png

I first started with an awesome post from Mitch Meunster where he used a Zamboni build tasks to upload builds to Mobile Center. If you want to learn how to configure Mobile Center and hack against the API then check it out.

With that knowledge under my belt I’ve written a build task and posted the code on GitHub. Let’s run through what I had to do to build the task and what you have to do in order to use it…

TLDR: You can either read the whole thing (which I recommend) or jump to the build/use sections:

  1. How did I build it?
  2. How do you use it?

Let’s have closer look…

How did I build it?

First step was to hit up Donovan Brown’s blog on creating Node.js build tasks. In this post Donovan shows how to create the basic scaffolding of the build tasks and even unit test them with code coverage.

I followed Donovan’s instructions and installed all of the required dependencies. I then used tfx-cli to create the task shell. Once this was in place I added the required parameters I needed for the build task to the task.json:

Mobile Center Connection: The service endpoint for Mobile Center including the API token for the subscription.

App Slug: This is where you enter the specific info that Identifies who you are and what app you want to push for. You will find this info in the URL of your app in Mobile Center.

The Mobile Center Connection allows you to configure a proper service connection in a similar way to Azure and then reuse this connection in several different build tasks. The connection details can be retrieved in Node.JS using code like so:

In order to kick off a build and retrieve the output I needed to hit a few methods of the Mobile Center API.

startbuild

First I call a POST to start a build and retrieve an identifier that I can use to retrieve the status of the build.

checkbuild

I then loop repeatedly and check for the status, waiting for the build to complete.

downloadbuild

Once the build is complete I download the output and save it to the current working directory.

In order to make the REST calls I use request-promise as I like the more structured fashion of working with promises. The code looks like this:

Looking into the waiting for completion code we use promises to delay for a wait amount and recursively call the wait method until the build is complete:

Once we’re complete we simply download the build output and save it to the working directory:

This does everything I want to do in order to retrieve the build output but next I wanted to put together some continuous integration for the actual build task and get some unit testing / code coverage in place. Enter VSTS.

buildsetup

My goal was to configure a build pipeline to show code coverage and support my lofty goal for 100% coverage. In order to do that I used instanbul as discussed in Donovan Brown’s post and was able to execute that locally. That produces a beautiful html based report to show coverage.

coverage

filecoverage

I also wanted to see the coverage in the VSTS build pipeline so I put another script in the package.json to allow the production of a Cobertura formatted coverage results that VSTS understands.

With that in place I could upload the results using the native VSTS task and show the results in the build output.

buildresults.png

100% code coverage here we come!!!

How do you use it?

First we need to grab the build task code from my Github and upload it to VSTS. Clone the repository and open a console.

If tfx-cli isn’t installed then do that first:

npm install -g tfx-cli

Upload the task to VSTS:

tfx build tasks upload

You will need to provide a Personal Access Token and the address of your VSTS instance to do this. Once you’ve done this you can add it to a new build definition like so:

builddefinition

The first step requires the configuration of a service endpoint for Mobile Center. Configure it with your API key created in Mobile Center.

endpoint

We need to configure the mobile center build step with the service endpoint and appslug:

buildtaskparams

The output of the build will downloaded into the workspace to a file called mobile-center-artifacts.zip. This I copied to the staging location so I could publish it as an artifact of the build.

copyfiles

From there the native publish task could attach the build output against a build in VSTS and you have the potential to do anything with it.

buildartifacts

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s