View on GitHub

pipeline_templates

Templates for use in build and release pipelines

Xamarin iOS Build Template

Use this template to build iOS applications from a Visual Studio Solution file (ie Xamarin).

YAML snippet

# Xamarin iOS Build Template
# Template for building a Xamarin iOS application
stages:
- template:  azure/mobile/build-xamarin-ios.yml@builttoroam_templates
  parameters:
    solution_filename:
    ios_provisioning_profile_securefiles_filename:
    ios_cert_securefiles_filename:
    #stage_name:  # Optional
    #depends_on:  # Optional
    #build_ios_enabled:  # Optional 
    #build_number:  # Optional 
    #full_version_number:  # Optional 
    #solution_build_configuration:  # Optional 
    #ios_plist_filename:  # Optional 
    #ios_cert_password:  # Optional 
    #ios_signing_identity:  # Optional 
    #ios_provisioning_profile_id:  # Optional 
    #artifact_name:  # Optional 
    #artifact_folder:  # Optional
    #application_package:  # Optional
    #onStart:  # Optional 
    #preBuild:  # Optional 
    #postBuild:  # Optional 
    #prePublish:  # Optional 
    #onEnd:  # Optional 
    #ios_nuget_version:  # Optional
    #net_core_version:  # Optional
    #xamarin_sdk_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_iOS'
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_ios_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
ios_plist_filename(Optional) The Info.plist file that contains the application information such as bundle id and version information. If not specified, template will locate the first Info.plist automatically.
ios_cert_securefiles_filename(Required) The certificate file used to sign the application. This is the name of the certificate in Secure Files
ios_cert_password(Optional) The password to unlock the certificate so it can be used. This is required if the certificate has a password set
ios_provisioning_profile_securefiles_filename(Required) The provisioning profile to use when signing the application. This is the name of the provisioning profile in Secure Files
ios_signing_identity(Optional) The signing identity that maps to the signing certificate. If not provided, the template will use the value extracted during the certificate installation process.
ios_provisioning_profile_id(Optional) The id of the provisioning profile. If not provided, the template will use the value extracted during the installation of the provisioning profile
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(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
ios_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)
xamarin_sdk_version(Optional) Use to override the Xamarin SDK version (defaults to 6.4.0)

Open source

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