XamariniOS@1 – úloha Xamarin.iOS v1

Článek
07/02/2024

Tuto úlohu použijte v kanálu k vytvoření aplikace pro iOS pomocí Xamarinu v macOS. Další informace najdete v doprovodných materiálech pro Xamarin a v tématu Podepsání aplikace během 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.

Vstupy

solutionFile - Řešení
Alias vstupu: solution. string. Povinná hodnota. Výchozí hodnota: **/*.sln.

Určuje relativní cestu od kořenového Xamarin.iOS adresáře úložiště řešení k sestavení. Může obsahovat zástupné é kóty.

configuration - Konfigurace
string. Povinná hodnota. Výchozí hodnota: Release.

Určuje konfiguraci. Standardní konfigurace jsou Ad-Hoc, AppStore, Debug a Release.

clean - Čisté
boolean. Výchozí hodnota: false.

Nepovinný parametr. Spustí čisté sestavení (/t:clean) před sestavením.

packageApp - Vytvoření balíčku aplikace
boolean. Výchozí hodnota: true.

Pokud je nastavená hodnota true, vygeneruje ipa jako součást sestavení.

buildForSimulator - Sestavení pro simulátor iOS
Alias vstupu: forSimulator. boolean. Výchozí hodnota: false.

Nepovinný parametr. Buildy pro simulátor iOS místo fyzických zařízení s iOSem.

runNugetRestore - Spuštění obnovení NuGet
boolean. Výchozí hodnota: true.

Spustí nuget restore se v řešení Xamarin iOS a před sestavením nainstaluje všechny odkazované balíčky. Použije se nuget nástroj v cestě k počítači agenta sestavení. Pokud chcete použít jinou verzi NuGetu nebo nastavit další argumenty, použijte úlohu instalačního programu NuGet.

args - Argumenty
string.

Nepovinný parametr. Určuje další argumenty příkazového řádku, které se použijí k sestavení.

workingDirectory - Pracovní adresář
Alias vstupu: cwd. string.

Nepovinný parametr. Určuje pracovní adresář, ve kterém se budou spouštět sestavení. Pokud je hodnota prázdná, použije se kořen úložiště.

buildToolOption - Nástroj sestavení
Alias vstupu: buildTool. string. Povolené hodnoty: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio pro Mac)). Výchozí hodnota: xbuild.

Určuje nástroje sestavení, které bude úloha používat.

mdtoolFile - Cesta k nástroji sestavení
Alias vstupu: mdtoolLocation. string.

Nepovinný parametr. Poskytuje cestu k xbuildu (nástroj pro sestavení mono Xamarin Studio) nebo MSBuild (nástroj pro sestavení Visual Studio pro Mac). Pokud je hodnota prázdná, použije se výchozí cesta xbuild nebo MSBuild.

signingOption - Přepsat pomocí
Alias vstupu: signMethod. string. Povolené hodnoty: file (Obsah souboru), id (Identifikátory). Výchozí hodnota: file.

Tento vstup použijte, pokud sestavení používá metodu podepisování nebo zřizování, která se liší od výchozího nastavení. Zvolte file , jestli chcete použít certifikát P12 a profil zřizování. Zvolte id načtení nastavení podepisování z výchozího klíčenky a předinstalovaného profilu. Pokud nechcete přepsat výchozí nastavení sestavení, nechte odpovídající pole prázdná.

signingIdentity - Podpisová identita
Alias vstupu: iosSigningIdentity. string. Nepovinný parametr. Použijte, když signMethod = id.

Přepíše podpisovací identitu, která se použije k podepsání sestavení. Pokud je hodnota prázdná, použije se nastavení v projektu Xcode. Pokud použijete tuto možnost, budete možná muset vybrat signingUnlockDefaultKeychain možnost .

signingUnlockDefaultKeychain - Odemknutí výchozího řetězce klíčů
Alias vstupu: unlockDefaultKeychain. boolean. Nepovinný parametr. Použijte, když signMethod = id. Výchozí hodnota: false.

Řeší chyby "Interakce uživatele není povolená" odemknutím výchozího řetězce klíčů.

signingDefaultKeychainPassword - Výchozí heslo řetězce klíčů
Alias vstupu: defaultKeychainPassword. string. Nepovinný parametr. Použijte, když signMethod = id.

Určuje heslo pro odemknutí výchozího řetězce klíčů při signingUnlockDefaultKeychain nastavení.

signingProvisioningProfileID - UUID zřizovacího profilu
Alias vstupu: provProfileUuid. string. Nepovinný parametr. Použijte, když signMethod = id.

Určuje UUID nainstalovaného zřizovacího profilu, který se má použít pro toto sestavení.

signingP12File - Soubor certifikátu P12
Alias vstupu: p12. string. Nepovinný parametr. Použijte, když signMethod = file.

Určuje relativní cestu k souboru certifikátu P12 ve formátu PKCS12 obsahujícího podpisový certifikát, který se má použít pro toto sestavení.

signingP12Password - Heslo P12
Alias vstupu: p12pwd. string. Nepovinný parametr. Použijte, když signMethod = file.

Určuje heslo k souboru certifikátu P12. K zašifrování této hodnoty použijte proměnnou sestavení.

signingProvisioningProfileFile - Soubor profilu zřizování
Alias vstupu: provProfile. string. Nepovinný parametr. Použijte, když signMethod = file.

Určuje UUID přepsání nainstalovaného zřizovacího profilu, které se má použít pro toto sestavení.

signingRemoveProfile - Odebrat profil po sestavení
Alias vstupu: removeProfile. boolean. Nepovinný parametr. Použijte, když signMethod = file. Výchozí hodnota: false.

Určuje, že po dokončení sestavení se má z agenta sestavení odebrat obsah souboru profilu zřizování. Tuto možnost povolte pouze v případě, že používáte jednoho agenta na uživatele.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů i možnosti řízení. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build
Běží na	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na spouštění úloh, které používají tuto úlohu: Xamarin.iOS
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	Všechny podporované verze agenta.
Kategorie úloh	Sestavení

Sdílet prostřednictvím