XamariniOS@1 – Xamarin.iOS v1-uppgift

Artikel
03/24/2025

Använd den här uppgiften i en pipeline för att skapa en iOS-app med Xamarin på macOS. Mer information finns i Xamarin-vägledningen och Sign your app during CI.

Syntax

# Xamarin.iOS v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

Ingångar

solutionFile - Lösning
Indataalias: solution. string. Obligatoriskt. Standardvärde: **/*.sln.

Anger den relativa sökvägen från lagringsplatsens rot för den Xamarin.iOS lösningen till bygget. Kan innehålla jokertecken.

configuration - Konfiguration
string. Obligatoriskt. Standardvärde: Release.

Anger konfigurationen. Standardkonfigurationer är Ad-Hoc, AppStore, Debug och Release.

clean - Rensa
boolean. Standardvärde: false.

Valfritt. Kör en ren version (/t:clean) före bygget.

packageApp - Skapa
boolean. Standardvärde: true.

Om värdet är inställt på truegenererar en IPA som en del av bygget.

buildForSimulator - Build for iOS Simulator
Indataalias: forSimulator. boolean. Standardvärde: false.

Valfritt. Versioner för iOS-simulatorn i stället för fysiska iOS-enheter.

runNugetRestore - Kör NuGet-återställning
boolean. Standardvärde: true.

Kör nuget restore på Xamarin iOS-lösningen för att installera alla refererade paket före bygget. Verktyget nuget i SÖKVÄGEN för byggagentdatorn används. Om du vill använda en annan version av NuGet eller ange ytterligare argument använder du NuGet Installer Task.

args - argument
string.

Valfritt. Anger ytterligare kommandoradsargument som används för bygget.

workingDirectory - Arbetskatalog
Indataalias: cwd. string.

Valfritt. Anger arbetskatalogen där byggen ska köras. Om värdet är tomt används lagringsplatsens rot.

buildToolOption - Build-verktyget
Indataalias: buildTool. string. Tillåtna värden: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio för Mac)). Standardvärde: xbuild.

Anger de byggverktyg som aktiviteten ska använda.

mdtoolFile - Skapa verktygssökväg
Indataalias: mdtoolLocation. string.

Valfritt. Tillhandahåller sökvägen till xbuild (verktyget Xamarin Studio mono build) eller MSBuild (Visual Studio för Mac-byggverktyget). Om värdet är tomt används standardsökvägen xbuild eller MSBuild.

signingOption - åsidosättning med hjälp av
Indataalias: signMethod. string. Tillåtna värden: file (filinnehåll), id (identifierare). Standardvärde: file.

Använd dessa indata om bygget använder en signerings- eller etableringsmetod som skiljer sig från standardvärdet. Välj file för att använda ett P12-certifikat och en etableringsprofil. Välj id för att hämta signeringsinställningar från standardprofilerna nyckelring och förinstallerade. Lämna motsvarande fält tomma om du inte vill åsidosätta standardinställningarna för bygget.

signingIdentity - signeringsidentitet
Indataalias: iosSigningIdentity. string. Valfritt. Använd när signMethod = id.

Åsidosätter signeringsidentiteten som ska användas för att signera bygget. Om värdet är tomt används inställningen i Xcode-projektet. Du kan behöva välja signingUnlockDefaultKeychain om du använder det här alternativet.

signingUnlockDefaultKeychain - Lås upp standardnyckelringen
Indataalias: unlockDefaultKeychain. boolean. Valfritt. Använd när signMethod = id. Standardvärde: false.

Löser felen "Användarinteraktion tillåts inte" genom att låsa upp standardnyckelringen.

signingDefaultKeychainPassword - Standardnyckelringslösenord
Indataalias: defaultKeychainPassword. string. Valfritt. Använd när signMethod = id.

Anger lösenordet för att låsa upp standardnyckelringen när signingUnlockDefaultKeychain har angetts.

signingProvisioningProfileID - Etableringsprofil UUID
Indataalias: provProfileUuid. string. Valfritt. Använd när signMethod = id.

Anger UUID för en installerad etableringsprofil som ska användas för den här versionen.

signingP12File - P12-certifikatfil
Indataalias: p12. string. Valfritt. Använd när signMethod = file.

Anger den relativa sökvägen till en PKCS12-formaterad P12-certifikatfil som innehåller ett signeringscertifikat som ska användas för den här versionen.

signingP12Password - P12-lösenord
Indataalias: p12pwd. string. Valfritt. Använd när signMethod = file.

Anger lösenordet till P12-certifikatfilen. Använd en byggvariabel för att kryptera det här värdet.

signingProvisioningProfileFile - Etableringsprofilfil
Indataalias: provProfile. string. Valfritt. Använd när signMethod = file.

Anger UUID för en installerad åsidosättning av etableringsprofil som ska användas för den här versionen.

signingRemoveProfile - Ta bort profil efter
Indataalias: removeProfile. boolean. Valfritt. Använd när signMethod = file. Standardvärde: false.

Anger att innehållet i etableringsprofilfilen ska tas bort från byggagenten när bygget är klart. Aktivera endast detta om du kör en agent per användare..

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Lokalt installerade agenter måste ha funktioner som matchar följande kräver för att köra jobb som använder den här uppgiften: Xamarin.iOS
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	Alla agentversioner som stöds.
Aktivitetskategori	Skapa

Dela via