XamariniOS@2 - Xamarin.iOS v2-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 v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  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: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

Invoerwaarden

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

Hiermee geeft u het relatieve pad van de hoofdmap van de opslagplaats van de Xamarin.iOS oplossing of het csproj-project 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: false.

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 om te bouwen.

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.

mdtoolFile - Pad naar hulpprogramma voor bouwen
Invoeralias: buildToolLocation | 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.

signingIdentity - Handtekeningidentiteit
Invoeralias: iosSigningIdentity. string.

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

signingProvisioningProfileID - UUID van inrichtingsprofiel
Invoeralias: provProfileUuid. string.

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

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

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.

Wat is er nieuw in deze taakversie

De iOS-registratie is verwijderd uit de taak. Gebruiken Secure Files met ondersteunende taken Install Apple Certificate en Install Apple Provisioning Profile om ondertekening in te stellen. Bijgewerkte opties om beter te werken met Visual Studio for Mac.

Voorbeelden

Uw Xamarin-app bouwen

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

Delen via