View on GitHub

pipeline_templates

Templates for use in build and release pipelines

Windows (UWP) Build Template

Use this template to build Windows (UWP) applications from a Visual Studio Solution file.

YAML snippet

# Windows (UWP) Build Template
# Template for building a Windows (UWP) application
stages:
- template:  azure/mobile/build-xamarin-windows.yml@builttoroam_templates
  parameters:
    solution_filename:
    windows_cert_securefiles_filename:
    #stage_name:  # Optional 
    #depends_on:  # Optional 
    #build_windows_enabled:  # Optional 
    #build_number:  # Optional 
    #full_version_number:  # Optional 
    #solution_build_configuration:  # Optional 
    #solution_target_platform:  # Optional
    #uwpPackagePlatforms:  # Optional
    #windows_package_manifest_filename:  # Optional 
    #windows_cert_password:  # Optional 
    #artifact_name:  # Optional 
    #artifact_folder:  # Optional
    #application_package:  # Optional 
    #windows_upload_name:  # Optional 
    #onStart:  # Optional 
    #preBuild:  # Optional
    #postBuild:  # Optional 
    #prePublish:  # Optional
    #onEnd:  # Optional 
    #windows_nuget_version:  # Optional 

Arguments

ArgumentDescription
stage_name(Optional) The name of the stage, so that it can be referenced elsewhere (eg for dependsOn property). Defaults to 'Build_Windows'
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_windows_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 'x86'
uwpPackagePlatforms(Optional) The platforms the the application package will include. Defaults to 'x86|x64|ARM'
windows_package_manifest_filename(Optional) The relative path to the package.appxmanifest file that defines the application manifest. If not specified, template will search for package.appxmanifest file
windows_cert_securefiles_filename(Required) The certificate file used to sign the application. This is the name of the certificate in Secure Files
windows_cert_password(Optional) The password to unlock the certificate so it can be used. This is required if the certificate has a password set
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
windows_upload_name(Optional) The name of the upload package that can be submitted to the Microsoft Store
onStart(Optional) Steps to be executed before stage starts
preBuild(Optional) Steps to be executed before the build starts
postBuild(Optional) Steps to be executed after the build has been invoked
prePublish(Optional) Steps to be executed before application package is published to artifact
onEnd(Optional) Steps to be executed at the end of the stage
windows_nuget_version(Optional) Use to override the NuGet version (defaults to 5.9.1)

Open source

This template is open source on GitHub. Feedback and contributions are welcome.