XamariniOS@1 - Xamarin.iOS v1-taak

Artikel
07/02/2024

Gebruik deze taak in een pijplijn om een iOS-app te bouwen met Xamarin in macOS. Zie de Xamarin-richtlijnen en Uw app ondertekenen tijdens CI voor meer informatie.

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.

Invoerwaarden

solutionFile - Oplossing
Invoeralias: solution. string. Vereist. Standaardwaarde: **/*.sln.

Hiermee geeft u het relatieve pad van de opslagplaatshoofdmap van de Xamarin.iOS oplossing naar de build. Kan jokertekens bevatten.

configuration - Configuratie
string. Vereist. Standaardwaarde: Release.

Hiermee geeft u de configuratie. Standaardconfiguraties zijn Ad-Hoc, AppStore, Foutopsporing en Release.

clean - Schoon
boolean. Standaardwaarde: false.

Optioneel. Voert een schone build (/t:clean) uit vóór de build.

packageApp - App-pakket maken
boolean. Standaardwaarde: true.

Als dit is ingesteld op true, genereert een IPA als onderdeel van de build.

buildForSimulator - Bouwen voor iOS-simulator
Invoeralias: forSimulator. boolean. Standaardwaarde: false.

Optioneel. Builds voor de iOS-simulator in plaats van fysieke iOS-apparaten.

runNugetRestore - NuGet-herstel uitvoeren
boolean. Standaardwaarde: true.

Wordt uitgevoerd nuget restore op de Xamarin iOS-oplossing om alle pakketten waarnaar wordt verwezen vóór de build te installeren. Het nuget hulpprogramma in het PAD van de buildagentmachine wordt gebruikt. Als u een andere versie van NuGet wilt gebruiken of als u aanvullende argumenten wilt instellen, gebruikt u de Taak van het NuGet-installatieprogramma.

args - Argumenten
string.

Optioneel. Hiermee geeft u aanvullende opdrachtregelargumenten die worden gebruikt voor de build.

workingDirectory - Werkmap
Invoeralias: cwd. string.

Optioneel. Hiermee geeft u de werkmap waarin builds worden uitgevoerd. Als de waarde leeg is, wordt de hoofdmap van de opslagplaats gebruikt.

buildToolOption - Build-hulpprogramma
Invoeralias: buildTool. string. Toegestane waarden: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio voor Mac)). Standaardwaarde: xbuild.

Hiermee geeft u de buildhulpprogramma's die de taak gebruikt.

mdtoolFile - Pad naar hulpprogramma voor bouwen
Invoeralias: mdtoolLocation. string.

Optioneel. Levert het pad naar xbuild (het Xamarin Studio mono-build-hulpprogramma) of MSBuild (het Visual Studio voor Mac build-hulpprogramma). Als de waarde leeg is, wordt het standaardpad xbuild of MSBuild gebruikt.

signingOption - Overschrijven met
Invoeralias: signMethod. string. Toegestane waarden: file (Bestandsinhoud), id (Id's). Standaardwaarde: file.

Gebruik deze invoer als de build een ondertekenings- of inrichtingsmethode gebruikt die anders is dan de standaardmethode. Kies ervoor file om een P12-certificaat en inrichtingsprofiel te gebruiken. Kies ervoor id om ondertekeningsinstellingen op te halen uit de standaardsleutelhanger en vooraf geïnstalleerde profielen. Laat de bijbehorende velden leeg als u de standaard build-instellingen niet wilt overschrijven.

signingIdentity - Handtekeningidentiteit
Invoeralias: iosSigningIdentity. string. Optioneel. Gebruik wanneer signMethod = id.

Overschrijft de ondertekeningsidentiteit die wordt gebruikt om de build te ondertekenen. Als de waarde leeg is, wordt de instelling in het Xcode-project gebruikt. Mogelijk moet u selecteren signingUnlockDefaultKeychain of u deze optie gebruikt.

signingUnlockDefaultKeychain - Standaardsleutelhanger ontgrendelen
Invoeralias: unlockDefaultKeychain. boolean. Optioneel. Gebruik wanneer signMethod = id. Standaardwaarde: false.

Lost fouten met 'Gebruikersinteractie is niet toegestaan' op door de standaardsleutelhanger te ontgrendelen.

signingDefaultKeychainPassword - Standaardsleutelhangerwachtwoord
Invoeralias: defaultKeychainPassword. string. Optioneel. Gebruik wanneer signMethod = id.

Hiermee geeft u het wachtwoord voor het ontgrendelen van de standaardsleutelhanger wanneer signingUnlockDefaultKeychain is ingesteld.

signingProvisioningProfileID - UUID van inrichtingsprofiel
Invoeralias: provProfileUuid. string. Optioneel. Gebruik wanneer signMethod = id.

Hiermee geeft u de UUID van een geïnstalleerd inrichtingsprofiel moet worden gebruikt voor deze build.

signingP12File - P12-certificaatbestand
Invoeralias: p12. string. Optioneel. Gebruik wanneer signMethod = file.

Hiermee geeft u het relatieve pad naar een P12-certificaatbestand met PKCS12-indeling met een handtekeningcertificaat dat moet worden gebruikt voor deze build.

signingP12Password - P12-wachtwoord
Invoeralias: p12pwd. string. Optioneel. Gebruik wanneer signMethod = file.

Hiermee geeft u het wachtwoord voor het P12-certificaatbestand. Gebruik een buildvariabele om deze waarde te versleutelen.

signingProvisioningProfileFile - Inrichtingsprofielbestand
Invoeralias: provProfile. string. Optioneel. Gebruik wanneer signMethod = file.

Hiermee geeft u de UUID van een geïnstalleerde inrichtingsprofiel overschrijving moet worden gebruikt voor deze build.

signingRemoveProfile - Profiel verwijderen na build
Invoeralias: removeProfile. boolean. Optioneel. Gebruik wanneer signMethod = file. Standaardwaarde: false.

Hiermee geeft u op dat de inhoud van het inrichtingsprofielbestand moet worden verwijderd uit de buildagent nadat de build is voltooid. Schakel dit alleen in als u één agent per gebruiker uitvoert.

Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: Xamarin.iOS
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Build

Share via