XamariniOS@1 - Xamarin.iOS v1-taak

Artikel
03/24/2025

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 CIvoor meer informatie.

Syntaxis

# 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.

Invoer

solutionFile - Solution
Invoeralias: solution. string. Verplicht. Standaardwaarde: **/*.sln.

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

configuration - configuratie
string. Verplicht. Standaardwaarde: Release.

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

clean - opschonen
boolean. Standaardwaarde: false.

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

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

Als deze optie is ingesteld op true, genereert u een IPA als onderdeel van de build.

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

Facultatief. Bouwt voor de iOS-simulator in plaats van fysieke iOS-apparaten.

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

Voert nuget restore uit op de Xamarin iOS-oplossing om alle pakketten waarnaar wordt verwezen vóór de build te installeren. Het hulpprogramma nuget in het PAD van de buildagentmachine wordt gebruikt. Als u een andere versie van NuGet wilt gebruiken of extra argumenten wilt instellen, gebruikt u de NuGet Installer Task.

args - argumenten
string.

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

workingDirectory - werkmap
Invoeralias: cwd. string.

Facultatief. 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 op die door de taak worden gebruikt.

mdtoolFile - hulpprogrammapad maken
Invoeralias: mdtoolLocation. string.

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

signingOption - overschrijven met behulp van
Invoeralias: signMethod. string. Toegestane waarden: file (bestandsinhoud), id (id's). Standaardwaarde: file.

Gebruik deze invoer als de build gebruikmaakt van een ondertekenings- of inrichtingsmethode die anders is dan de standaardwaarde. Kies file om een P12-certificaat en inrichtingsprofiel te gebruiken. Kies 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. Facultatief. Gebruiken wanneer signMethod = id.

Hiermee overschrijft u 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 signingUnlockDefaultKeychain selecteren als u deze optie gebruikt.

signingUnlockDefaultKeychain - Standaardsleutelhanger ontgrendelen
Invoeralias: unlockDefaultKeychain. boolean. Facultatief. Gebruiken wanneer signMethod = id. Standaardwaarde: false.

Hiermee worden fouten 'Gebruikersinteractie is niet toegestaan' opgelost door de standaardsleutelhanger te ontgrendelen.

signingDefaultKeychainPassword - standaardsleutelhangerwachtwoord
Invoeralias: defaultKeychainPassword. string. Facultatief. Gebruiken wanneer signMethod = id.

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

signingProvisioningProfileID - UUID- voor inrichtingsprofiel
Invoeralias: provProfileUuid. string. Facultatief. Gebruiken 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. Facultatief. Gebruiken wanneer signMethod = file.

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

signingP12Password - P12-wachtwoord
Invoeralias: p12pwd. string. Facultatief. Gebruiken wanneer signMethod = file.

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

signingProvisioningProfileFile - profielbestand inrichten
Invoeralias: provProfile. string. Facultatief. Gebruiken wanneer signMethod = file.

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

signingRemoveProfile - Profiel verwijderen na de build
Invoeralias: removeProfile. boolean. Facultatief. Gebruiken 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 besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: Xamarin.iOS
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Bouwen

Delen via