Instant Games Asset Upload

This extension provides the functionality for Azure to upload a file as an application asset to Facebook for use when developing a game with the Facebook Instant Games API.

Pre-Requisites

To use this extension, you should have an application created within the Facebook developers center configured for use as an Instant Game.

Installation

Within your Azure organization, select 'Organization Settings' from the root namespace.

Select 'Extensions' and locate the Instant Games Asset Upload extension.

Within Azure, create a release pipeline. The flow of your pipeline is entirely upto you.

Once you have determined at which stage you would like to upload an asset to Facebook Instant Games, open the stage tasks. On the Agent Job panel, click the '+' icon to add a new task.

In the search box, enter the word 'Instant' to filter the available tasks. You should see the extension listed, click the 'Add' button to add the task to your pipeline stage.

Configuration

Once the extension has been added as a task to your pipeline, you must configure it for use by Azure. Select the task in the available list to gain access to the configuration panel.

First, you must retrieve your application identifier from Facebook. Navigate to your Facebook Applications and select the application you wish to upload to. The application identifier can be found within the application page at the top of the display, labelled "App ID".

Second you will require an asset upload access token, this provides the plugin with the credentials necessary to upload an asset package to Facebook on your behalf. To obtain this token, expand the "Instant Games" section located within the side-panel of the Facebook applications developer page and select the "Web Hosting" sub-category.

The right hand pane will change to display your applications hosted assets. At the top of the displayed panel, you will see a button labelled "Get Asset Upload Access Token".

Click this button to obtain a token and copy it to the clipboard, you may paste this string directly into the "Access Token" section of the Instant Games plugin.

Finally, you must provide the plugin with the package file you wish to upload. This file is usually a product of your build pipeline.

Usage

You may have several instances of the plugin within your release pipeline, each configured separately. This allows you to deploy to a staging application for review before the pipeline continues to the production stage.