Build: Xamarin.Android

Last Update: 9/26/2016

Team Services | TFS 2017 | TFS 2015 | Previous versions: XAML Build, Release

Build an Android app with Xamarin

Demands

AndroidSDK, MSBuild, Xamarin.Android

Arguments

Argument Description
Project

If you want to build a single Xamarin.Android project, click the ... button and select the project.

If you want to build multiple projects, specify search criteria. You can use a single-folder wildcard (*) and recursive wildcards (**). For example, **/*.Android.csproj searches for all Android.csproj files in all subdirectories in your repo.

Note: The projects must have a PackageForAndroid target.

Target (Optional) Specify the project targets you want to build. Use a semicolon to separate multiple targets.
Output Directory Use a variable to specify the folder where you want the output files to go. For example: $(build.binariesdirectory)/$(BuildConfiguration)
Configuration

Specify the configuration you want to build such as debug or release.

Tip: Declare a build variable such as BuildConfiguration on the Variables tab (selecting Allow at Queue Time) and reference it here as $(BuildConfiguration). This way you can modify the platform when you queue the build and enable building multiple configurations.

MSBuild Options
MSBuild Location (Optional) Path to MSBuild (on Windows) or xbuild (on Mac). Default behavior is to search for the latest version.
Additional Arguments You can pass additional arguments to MSBuild (on Windows) or xbuild (on Mac). For syntax, see MSBuild Command-Line Reference.
JDK Options
Select JDK to use for the build Pick the JDK to be used during the build by selecting a JDK version that will be discovered during builds or by manually entering a JDK path.
  • JDK Version: Select the JDK version you want to use.
  • JDK Path: Specify the path to the JDK you want to use.
JDK Architecture Select x86 or x64.
Control options

Example

Build your Xamarin app

Q&A

Do I need an agent?

You need at least one agent to run your build or release. Get an agent.

I can't select a default agent queue and I can't queue my build or release. How do I fix this?

See queues.

I use Team Foundation Server on-premises and I don't see some of these features. Why not?

Some of these features are available only on Visual Studio Team Services and not yet available on-premises. Some features are available on-premises if you have upgraded to the latest version of TFS.