Xcode@5 – Xcode v5 feladat

Ezzel a feladatsal Xcode-munkaterületet hozhat létre, tesztelhet vagy archiválhat macOS rendszeren, és igény szerint becsomagolhat egy alkalmazást.

Szinopszis

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

Bemenetek

actions - Műveletek
string. Szükséges. Alapértelmezett érték: build.

A műveletek szóközzel tagolt listáját adja meg. Néhány érvényes beállítás: build, clean, test, analyzeés archive. Példáulclean build tiszta buildet végez. Lásd: Apple: Building from the parancssor xcode FAQ.

configuration - konfigurációs
string. Alapértelmezett érték: $(Configuration).

Megadja a létrehozandó Xcode-projektet vagy munkaterület-konfigurációt. Változó használatakor adjon meg egy értéket (például Release) a Változók lapon.

sdk - SDK
string. Alapértelmezett érték: $(SDK).

Megadja az Xcode-projekt vagy -munkaterület létrehozásakor használni kívánt SDK-t. A macOS terminálalkalmazásban futtassa a xcodebuild -showsdks az SDK-k érvényes listájának megjelenítéséhez. Változó használatakor adjon meg egy értéket (például iphonesimulator) a Változók lapon.

munkaterület vagy projektútvonal xcWorkspacePath -
string. Alapértelmezett érték: **/*.xcodeproj/project.xcworkspace.

Opcionális. Relatív elérési utat ad meg az adattár gyökerétől az Xcode-munkaterületig vagy projektig. Például, MyApp/MyApp.xcworkspace vagy MyApp/MyApp.xcodeproj. Helyettesítő karakterek is használhatók. További információ fájlegyeztetési mintákról.

scheme - séma
string.

Opcionális. Xcode sémanevet ad meg. Megosztott séma kell lennie (az Xcode-ban Felügyelt sémák csoportban megosztott jelölőnégyzet). Ha nem ad meg sémát, és a megadott munkaterület egyetlen megosztott sémával rendelkezik, a rendszer a munkaterület-sémát fogja használni.

Xcode-verzió xcodeVersion -
string. Engedélyezett értékek: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Elérési út megadása). Alapértelmezett érték: default.

Az Xcode célverzióját adja meg. Válassza Default az Xcode alapértelmezett verziójának az ügynökgépen való használatához. A verziószám (például Xcode 9) megadása a verzió helyétől függ, amelyet az ügynökgép környezeti változói (például XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer) határoznak meg. Válassza ki a Specify path az Xcode fejlesztői könyvtár egy adott elérési útjának megadásához.

xcodeDeveloperDir - Xcode fejlesztői útvonal
string. Opcionális. Használja a xcodeVersion == specifyPath.

Egy adott Xcode fejlesztői könyvtár elérési útját adja meg (például /Applications/Xcode_9.0.0.app/Contents/Developer). Ez a bemenet akkor hasznos, ha az Xcode több verziója is telepítve van az ügynökgépen.

packageApp - Alkalmazáscsomag létrehozása
boolean. Alapértelmezett érték: false.

Megadja, hogy létrejön-e egy IPA-alkalmazáscsomagfájl a build részeként.

archivePath - Archív elérési út
string. Opcionális. Használja a packageApp == true.

Megadja azt a könyvtárat, amelybe a létrehozott archívumok kerülnek.

exportPath - Exportálási útvonal
string. Opcionális. Használja a packageApp == true. Alapértelmezett érték: output/$(SDK)/$(Configuration).

Megadja az archívumból exportált termék célját.

exportOptions - Exportálási beállítások
string. Opcionális. Használja a packageApp == true. Engedélyezett értékek: auto (Automatikus), plist, specify. Alapértelmezett érték: auto.

Megadja az archívum exportálási beállításait. Ha a Automatic alapértelmezett értéke van kiválasztva, a rendszer automatikusan észleli az exportálási módszert az archívumból. Az exportálási beállításokat tartalmazó plist fájl megadásához válassza a Plist lehetőséget. Válassza a Specify egy adott Exportálási módszer és csapatazonosítómegadásához.

exportMethod - exportálási módszer
string. exportOptions == specifyesetén kötelező. Alapértelmezett érték: development.

Megadja az Xcode által az archívum exportálásához használt metódust. Például: app-store, package, ad-hoc, enterprisevagy development.

exportTeamId - csapatazonosító
string. Opcionális. Használja a exportOptions == specify.

Megadja az Exportálás során használni kívánt 10 karakteres Apple Developer Portal csapatazonosítóját.

exportOptionsPlist - Exportálási lehetőségek
string. exportOptions == plistesetén kötelező.

Megadja a plist fájl elérési útját, amely az exportálás során használandó beállításokat tartalmazza.

exportArgs - Argumentumok exportálása
string. Opcionális. Használja a packageApp == true.

Az exportálás során használt további parancssori argumentumokat adja meg.

signingOption - aláírási stílus
string. Engedélyezett értékek: nosign (Ne kódjel), default (Project alapértelmezés), manual (Manuális aláírás), auto (Automatikus aláírás). Alapértelmezett érték: nosign.

Megadja a build aláírásának módját. Válassza a Do not code sign az aláírás letiltásához. Válassza a Project defaults, ha csak a projekt aláírási konfigurációját szeretné használni. Válassza a Manual signing a manuális aláírás kényszerítéséhez, és opcionálisan adjon meg egy aláírási identitást és egy kiépítési profilt. Válassza a Automatic signing az automatikus aláírás kényszerítéséhez, és opcionálisan adjon meg egy fejlesztői csapatazonosítót. Ha a projekt aláírást igényel, használja a Az Apple telepítése... feladatokkal telepíthet tanúsítványokat és kiépítési profilokat az Xcode build előtt.

signingIdentity - aláíró identitás
string. Opcionális. Használja a signingOption = manual.

Megadja az aláírási identitás felülbírálását, amellyel alá szeretné írni a buildet. Előfordulhat, hogy az ügynökgép alapértelmezett kulcsláncának zárolásának feloldására van szükség. Ha nem ad meg értéket, az Xcode-projekt beállítása lesz használva.

provisioningProfileUuid - Kiépítési profil UUID-
string. Opcionális. Használja a signingOption = manual.

Megadja a buildhez használt telepített kiépítési profil UUID azonosítóját. Különálló összeállítási feladatok használata különböző sémákkal vagy célokkal a kiépítési profilok cél szerinti megadásához egyetlen munkaterületen (iOS, tvOS, watchOS).

provisioningProfileName - Kiépítési profil neve
string. Opcionális. Használja a signingOption = manual.

Megadja a buildhez használt telepített kiépítési profil nevét. Ha meg van adva, ez elsőbbséget élvez a kiépítési profil UUID azonosítóval szemben. Különálló összeállítási feladatok használata különböző sémákkal vagy célokkal a kiépítési profilok cél szerinti megadásához egyetlen munkaterületen (iOS, tvOS, watchOS).

teamId - csapatazonosító
string. Opcionális. Használja a signingOption = auto.

Akkor szükséges, ha több fejlesztői csapat tagja. Megadja a 10 karakterből állhat a fejlesztői csapat azonosítóját.

destinationPlatformOption - Célplatform
string. Engedélyezett értékek: default, iOS (iOS és watchOS), tvOS, macOS, custom. Alapértelmezett érték: default.

Megadja a felhasználói felület teszteléséhez használt céleszköz platformját, ha az általános buildelési eszköz érvénytelen. A Custom listában nem szereplő platform megadásához válassza a Custom. Ha Default van kiválasztva, a rendszer nem céloz meg szimulátorokat vagy eszközöket.

destinationPlatform - egyéni célplatform
string. Opcionális. Használja a destinationPlatformOption == custom.

Megadja a felhasználói felület teszteléséhez használt céleszköz platformját, ha az általános buildelési eszköz érvénytelen. A Custom listában nem szereplő platform megadásához válassza a Custom. Ha Default van kiválasztva, a rendszer nem céloz meg szimulátorokat és eszközöket.

destinationTypeOption - Céltípus
string. Opcionális. Használja a destinationPlatformOption != default && destinationPlatformOption != macOS. Engedélyezett értékek: simulators (szimulátor), devices (csatlakoztatott eszköz). Alapértelmezett érték: simulators.

Megadja a felhasználói felület teszteléséhez használni kívánt céltípust. Az eszközöket kábel- vagy hálózati kapcsolaton keresztül kell csatlakoztatni a buildet végrehajtó Mac géphez. További információt az Xcode Eszközök és szimulátorok című témakörben talál.

destinationSimulators - szimulátor
string. Opcionális. Használja a destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Megadja a felhasználói felület teszteléséhez használt Xcode-szimulátor nevét. Például iPhone X (iOS és watchOS) vagy Apple TV 4K (tvOS). A választható cél operációsrendszer-verzió OS=<versionNumber>formátumban adható meg, például iPhone X,OS=11.1. További információért tekintse meg a üzemeltetett macOS--ügynök telepített szimulátorok listáját.

destinationDevices - eszköz
string. Opcionális. Használja a destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Megadja a felhasználói felület teszteléséhez használt eszköz nevét, például Raisa's iPad. Jelenleg csak egy eszköz támogatott. Vegye figyelembe, hogy az Apple nem engedélyezi az eszköznevekben az aposztrófokat ('). Ehelyett a jobb oldali idézőjelek (') használhatók.

args - argumentumok
string.

Opcionális. További parancssori argumentumokat ad meg, amelyekkel buildelhető. Ez a bemenet akkor hasznos, ha munkaterület/projekt és séma helyett -target vagy -project argumentumokat ad meg. Lásd: Apple: Building from the parancssor xcode FAQ.

workingDirectory - Munkakönyvtár
Bemeneti alias: cwd. string.

Opcionális. Azt a munkakönyvtárat adja meg, amelyben a buildet futtatni szeretné. Ha nem ad meg értéket, a rendszer az adattár gyökerét használja.

useXcpretty - Xcpretty használata
boolean. Alapértelmezett érték: true.

Megadja, hogy xcpretty kimenet formázásához használjon-e xcodebuild. xcpretty az ügynökgépre kell telepíteni (előre telepítve van az Azure Pipelines által üzemeltetett buildügynökökön). Ha xcpretty nincs telepítve, nyers xcodebuild kimenet jelenik meg. További információért lásd xcpretty.

Xcpretty argumentumok xcprettyArgs -
string. Opcionális. Használja a useXcpretty == true.

Ha a xcpretty engedélyezve van, ez a bemenet a xcprettyargumentumait adja meg. Lásd a GitHubxcpretty argumentumainak listáját.

publishJUnitResults - Teszteredmények közzététele az Azure Pipelines
boolean. Alapértelmezett érték: false.

Megadja, hogy közzétegye-e a JUnit-teszt eredményeit az Azure Pipelinesban. Ehhez engedélyezni kell xcpretty JUnit-teszteredmények létrehozásához.

testRunTitle - tesztelési cím
string. Opcionális. Használja a publishJUnitResults == true.

Ha engedélyezve van xcpretty és publishJUnitResults, megadhatja a tesztfuttatás címét.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlők és gyakori feladattulajdonságok.

Kimeneti változók

Nincs.

Megjegyzések

Ezzel a feladatsal Xcode-munkaterületet hozhat létre, tesztelhet vagy archiválhat macOS rendszeren, és igény szerint becsomagolhat egy alkalmazást.

Több kiépítési profil használata

Jelenleg nem támogatott több kiépítési profil az Xcode-feladathoz (például iOS-alkalmazásbővítményhez).

Példák

Xcode-alkalmazás létrehozása

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build
Futtatás bekapcsolva	Ügynök, DeploymentGroup
Követelmények	A saját üzemeltetésű ügynököknek képességekkel kell rendelkezniük, amelyek megfelelnek az alábbi követelményeknek, kell futtatniuk a feladatot használó feladatokat: xcode
képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
parancskorlátozások	Bármely
Változók beállítása	Bármely
Ügynök verziója	Minden támogatott ügynökverzió.
Tevékenységkategória	Épít