Xamarin Android Build Template
Use this template to build Android applications from a Visual Studio Solution file (ie Xamarin).
YAML snippet
# Xamarin Android Build Template
# Template for building a Xamarin Android application
stages:
- template: azure/mobile/build-xamarin-android.yml@builttoroam_templates
parameters:
solution_filename:
secure_file_keystore_filename:
keystore_alias:
keystore_password:
#stage_name: # Optional
#depends_on: # Optional
#build_android_enabled: # Optional
#build_number: # Optional
#full_version_number: # Optional
#solution_build_configuration: # Optional
#solution_target_platform: # Optional
#android_manifest_filename: # Optional
#artifact_name: # Optional
#artifact_folder: # Optional
#application_package: # Optional
#onStart: # Optional
#preBuild: # Optional
#postBuild: # Optional
#prePublish: # Optional
#onEnd: # Optional
#android_nuget_version: # Optional
#net_core_version: # Optional
Arguments
Argument | Description |
---|---|
stage_name | (Optional) The name of the stage, so that it can be referenced elsewhere (eg for dependsOn property). Defaults to 'Build_Android' |
depends_on | (Optional) The array of stages that this stage depends on. Default is that this stage does not depend on any other stage |
build_android_enabled | (Optional) Whether this stages should be executed. Note that setting this to false won't completely cancel the stage, it will merely skip most of the stages. The stage will appear to complete successfully, so any stages that depend on this stage will attempt to execute |
build_number | (Optional) The build number to be applied to the application. Defaults to Build.BuildId built in variable |
full_version_number | (Optional) The full application version number. Defaults to 1.0.XXX where XXX is the same as the build_number |
solution_filename | (Required) The relative path to the solution file that should be built |
solution_build_configuration | (Optional) The build configuration within the solution that should be invoked. Default is Release but can be overwritten if you want to do say a Debug build |
solution_target_platform | (Optional) The target platform that the solution build will use. Defaults to Any CPU |
android_manifest_filename | (Optional) The relative path to the AndroidManifest.xml file that defines the application manifest. If not specified, template will search for AndroidManifest.xml file |
secure_file_keystore_filename | (Required) The keystore file used to sign the application. This is the name of the keystore in Secure Files |
keystore_alias | (Required) The alias of the keystore. |
keystore_password | (Required) The password to access the keystore |
artifact_name | (Optional) The name of the artifact to copy application to |
artifact_folder | (Optional) The name of the folder to copy application to in the artifact |
application_package | (Optional) The name of the application package to output |
onStart | Steps to be executed before stage starts |
preBuild | Steps to be executed before the build starts |
postBuild | Steps to be executed after the build has been invoked |
prePublish | Steps to be executed before application package is published to artifact |
onEnd | Steps to be executed at the end of the stage |
android_nuget_version | (Optional) Use to override the NuGet version (defaults to 5.9.1) |
net_core_version | (Optional) Use to override the .NET Core version (defaults to 3.0.x) |
Open source
This template is open source on GitHub. Feedback and contributions are welcome.