Build: Xamarin.iOS

Azure Pipelines | TFS 2018 | TFS 2017 | TFS 2015

Build an iOS app with Xamarin on macOS



YAML snippet

# Xamarin.iOS
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
    #solutionFile: '**/*.sln' 
    #configuration: 'Release' 
    #clean: false # Optional
    #buildForSimulator: false # Optional
    #runNugetRestore: false 
    #args: # Optional
    #workingDirectory: # Optional
    #mdtoolFile: # Optional
    #signingIdentity: # Optional
    #signingProvisioningProfileID: # Optional


Argument Description
Solution Click the ... button and select your solution.
Configuration Specify a configuration such as Ad-Hoc, AppStore, Debug, or Release
Create App Package Select if you want to create an .IPA app package file.
Build for iOS Simulator Select if you want to build for the iOS Simulator instead of for physical iOS devices.
(Optional) Signing & Provisioning
Override Using (Optional)

If the build should use a signing or provisioning method that is different than the default, choose that method here.

Choose File Contents to use a P12 certificate and provisioning profile. Choose Identifiers to retrieve signing settings from the default Keychain and pre-installed profiles.

Leave the corresponding fields blank if you do not wish to override default build settings.

P12 Certificate File Relative path to a PKCS12-formatted .p12 certificate file that contains a signing certificate to be used for this build.
P12 Password Password to the .p12 file.
Important: Use a secret variable to avoid exposing this value.
Provisioning Profile File Relative path to .mobileprovision file that contains the provisioning profile override to be used for this build.
Remove Profile After Build Select if you want the contents of the provisioning profile file to be removed from the build agent after the build is complete.
Important: Select only if you are running one agent per user.
Arguments (Optional) Specify additional command-line arguments for this build.
Working Directory Working directory for the build. If you leave it blank, it is the root of the repo.
Xbuild Path (Optional) Specify the path to xbuild. If you leave it blank, the default xbuild path is used.
Control options


Build your Xamarin app

Open source

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

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 pool and I can't queue my build or release. How do I fix this?

See Agent pools.

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

Some of these features are available only on Azure Pipelines and not yet available on-premises. Some features are available on-premises if you have upgraded to the latest version of TFS.