Features
Start a free trial

Visual Studio App Center

Visual Studio App Center is a Microsoft product that allows you to build your mobile apps in the cloud.
Simply connect your repository and App Center will build your app on every commit.

This integration allows you to test builds generated by App Center on our mobile device cloud.

In this guide we'll show you:

  • How to connect to the Visual Studio App Center API.
  • Fetch the public link to the latest build.
  • Upload the build to TestingBot Storage for testing.

Retrieve API Token

To get started, you'll need to log into Visual Studio App Center and generate an API key.

  • Sign into your App Center account.
  • Go to Account Settings and choose User API Tokens.
  • Click the New API Token button.
  • Add a description for your token, for example TestingBot-Token.
  • Give the token Read Only access.
  • Generate and copy the API Token.
Visual Studio App Center API Token

List All App Projects

Now that we have an API token, we can use it to fetch all app projects:

Copy code
curl -sX GET  "https://api.appcenter.ms/v0.1/apps" \
 -H "Content-Type: application/json" \
 -H "X-Api-Token: [YOUR-API-TOKEN]"

The response should be similar to this:

Copy code
[
 {
 	"id":"9c22426b-e23e-4389-9f4a-08ec2eb9e656",
 	"app_secret":"3da37025-4548-4abe-8979-c0f097816e51",
 	"description":null,
 	"display_name":"testingbot-demo",
 	"name":"testingbot-demo",
 	"os":"Android",
 	"platform":"React-Native",
 	"origin":"appcenter",
 	"icon_url":null,
 	"created_at":"2020-08-19T08:39:21.000Z",
 	"updated_at":"2020-08-19T08:39:21.000Z",
 	"release_type":null,
 	"owner":{
 	  "id":"4a05e941-f5be-4cfe-8b25-3887a768578f",
 	  "avatar_url":null,
 	  "display_name":"TestingBot",
 	  "email":"...",
 	  "name":"testingbot",
 	  "type":"user"
 	},
 	"azure_subscription":null,
 	"member_permissions":["manager"]
 }, {
 ...
}]

Fetch build info from API

Now we can fetch the build information from the App Center API.
We'll need the name and owner.name from the previous response:

If you want to fetch the build of the latest release, please use:

Copy code
curl -sX GET  "https://api.appcenter.ms/v0.1/apps/[owner.name]/[name]/releases/latest" \
-H "Content-Type: application/json" \
-H "X-Api-Token: [YOUR-API-TOKEN]"

If you are looking to fetch the latest build (not necessarly released yet), please use:

Copy code
curl -sX GET  "https://api.appcenter.ms/v0.1/apps/[owner.name]/[name]/branches/master/builds" \
-H "Content-Type: application/json" \
-H "X-Api-Token: [YOUR-API-TOKEN]"

Then copy the build id and use:

Copy code
curl -sX GET  "https://api.appcenter.ms/v0.1/apps/[owner.name]/[name]/builds/[build-id]/downloads/build" \
-H "Content-Type: application/json" \
-H "X-Api-Token: [YOUR-API-TOKEN]"

The response should contain a URL which points to the build, similar to this example:

Copy code
{"uri":"https://build.appcenter.ms/v0.1/public/apps/9c22426b-e23e-4389-9f4a-oefkoe/downloads?token=6663fc99b13e70dsfds856c8a302e9d7398fkjecfc72b0c133bcf4035"}

Upload build

Now that you've retrieved the build URL, you can upload this build to TestingBot Storage.

Copy code
curl -X POST "https://api.testingbot.com/v1/storage" \
-u key:secret -d "url=[BUILD-URL]"

This will return a unique URL {"app_url": "tb://..."} which you can use with your tests.

Simply add the tb://... as an app capability to run your tests: more information.