Xcode@3 – Xcode Build v3 feladat

Cikk
07/02/2024

Ezzel a feladatdal Xcode-munkaterületet hozhat létre macOS rendszeren.

Syntax

# Xcode Build v3
# Build an Xcode workspace on macOS.
- task: Xcode@3
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    #archivePath: # string. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. 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. Export Arguments. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.

Bevitelek

actions - Műveletek
string. Kötelező. Alapértelmezett érték: build.

A műveletek szóközzel tagolt listáját adja meg. Az érvényes lehetőségek a következők: build, clean, test, analyzeés archive. Például: build clean tiszta buildet hajt végre. Tekintse meg az Apple: Building from the command line with Xcode FAQ (Az Apple: építés a parancssorból Xcode gyikkel) című témakört.

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

Létrehoz egy Xcode-projektet vagy -munkaterületet a megadott SDK-val. Futtassa a parancsot xcodebuild -showsdks az SDK-k érvényes listájának megtekintéséhez.

xcWorkspacePath - Munkaterület/projekt elérési útja
string. Alapértelmezett érték: **/*.xcodeproj/*.xcworkspace.

Választható. Megadja az adattár gyökerétől az Xcode-munkaterületig vagy projektig vezető relatív útvonalat. Például: MyApp/MyApp.xcworkspace vagy MyApp/MyApp.xcworkspace/MyApp.xcodeproj. Hagyja üresen, ha a Speciális argumentumok területen kívánja használni-target flag.

scheme - Rendszer
string.

Választható. Megadja az Xcode-séma nevét. Megosztott sémának kell lennie (megosztott jelölőnégyzet az Xcode Felügyelt sémák területén). Munkaterület megadása esetén kötelező.

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

Meghatározza, hogy létrejön-e IPA a build részeként. Az archívumok Xcode 7 és Xcode 8 használatával történő exportálásához tekintse át a Csomagbeállítások szakaszban található további bemeneteket.

archivePath - Archív elérési út
string.

Választható. Megadja azt a könyvtárat, ahová a létrehozott archívumok kerülnek.

exportPath - Elérési út exportálása
string. Alapértelmezett érték: output/$(SDK)/$(Configuration).

Választható. Meghatározza az archívumból exportált termék célját.

exportOptions - Exportálási beállítások
string. Engedélyezett értékek: auto, plist, specify. Alapértelmezett érték: auto.

Megadja az exportálási beállítások átadásának módját az archívum exportálásakor.

exportMethod - Exportálási módszer
string. Akkor szükséges, ha exportOptions == specify. Alapértelmezett érték: development.

Az Xcode által az archívum exportálásához használt módszert adja meg. Például, app-store, package, ad-hoc, enterprisevagy development.

exportTeamId - Csapatazonosító
string. Választható. Használja a következőt: exportOptions == specify.

Megadja az exportáláshoz használandó 10 jegyű Apple Fejlesztői portál csapatazonosítóját.

exportOptionsPlist - Exportálási beállítások – Plist
string. Akkor szükséges, ha exportOptions == plist.

Megadja az archív exportálást konfiguráló plist-fájl elérési útját.

exportArgs - Argumentumok exportálása
string.

Az exportáláshoz használt további parancssori argumentumokat adja meg.

xcode8AutomaticSigning - Automatikus aláírás
boolean. Alapértelmezett érték: false.

Ezt a bemenetet akkor használja, ha az automatikus aláíráshoz Xcode 8 vagy Xcode 9 projekt van konfigurálva.

teamId - Csapatazonosító
string. Választható. Használja a következőt: xcode8AutomaticSigning = true.

Megadja a 10 jegyű fejlesztői csapat azonosítóját. Erre akkor van szükség, ha több fejlesztői csapat tagja.

signMethod - Felülbírálás a használatával
string. Engedélyezett értékek: file (Fájl tartalma), id (Azonosítók). Alapértelmezett érték: file.

Ezt a bemenetet akkor használja, ha a build az alapértelmezettnél eltérő aláírási vagy kiépítési módszert használ. Válassza a File Contents P12-tanúsítvány és a kiépítési profil használatát. Válassza ki Identifiers , hogy lekéri az aláírási beállításokat az alapértelmezett kulcskarikáról és az előre telepített profilokból. Ha nem szeretné felülírni az alapértelmezett buildbeállításokat, hagyja üresen a megfelelő mezőket.

iosSigningIdentity - Aláíró identitás
string. Választható. Használja a következőt: signMethod = id.

Megadja a build aláírásához használt aláíróidentitás-felülbírálást. Alapértelmezés szerint az Xcode projektbeállítás. Lehetséges, hogy ki kell választani az alapértelmezett kulcskarika zárolásának feloldását.

unlockDefaultKeychain - Alapértelmezett kulcskarika zárolásának feloldása
boolean. Választható. Használja a következőt: signMethod = id. Alapértelmezett érték: false.

Az alapértelmezett kulcskarika feloldásával elhárítja a felhasználói beavatkozás nem engedélyezett hibáit.

defaultKeychainPassword - Alapértelmezett kulcskarikajelszó
string. Választható. Használja a következőt: signMethod = id.

Megadja az alapértelmezett kulcskarika feloldásához tartozó jelszót.

provProfileUuid - Kiépítési profil UUID azonosítója
string. Választható. Használja a következőt: signMethod = id.

Megadja a buildhez használandó telepített kiépítési profil UUID azonosítóját. Különálló összeállítási feladatokat használhat 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, WatchKit, tvOS).

p12 - P12 tanúsítványfájl
string. Választható. Használja a következőt: signMethod = file.

Megadja a buildhez használandó aláíró tanúsítványt tartalmazó PKCS12 formátumú P12-tanúsítványfájl relatív elérési útját.

p12pwd - P12 jelszó
string. Választható. Használja a következőt: signMethod = file.

Megadja egy P12-tanúsítványfájl jelszavát. Használjon buildváltozót a titkosításhoz.

provProfile - Kiépítési profilfájl
string. Választható. Használja a következőt: signMethod = file.

Megadja a buildhez használandó kiépítési profil felülbírálását tartalmazó fájl relatív elérési útját. Különálló összeállítási feladatokat használhat 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, WatchKit, tvOS).

removeProfile - Profil eltávolítása buildelés után
boolean. Választható. Használja a következőt: signMethod = file. Alapértelmezett érték: false.

Eltávolítja a kiépítési profilfájl tartalmát a buildügynökből a buildelés befejezése után. Felhasználónként csak egy ügynököt futtat.

args - Érvek
string.

A buildeléshez használt további parancssori argumentumokat adja meg. Ez a bemenet akkor hasznos, ha munkaterületet és sémát szeretne használni -target vagy -project nem.

cwd - Munkakönyvtár
string.

A buildfuttatások munkakönyvtárát adja meg. Alapértelmezés szerint az adattár gyökere.

outputPattern - Kimeneti könyvtár
string. Kötelező. Alapértelmezett érték: output/$(SDK)/$(Configuration).

Megadja azt a relatív útvonalat, ahová a buildkimenet (bináris fájlok) kerülnek.

xcodeDeveloperDir - Xcode fejlesztői útvonal
string.

Választható. Megadja az Xcode Developer mappa elérési útját, ha nem ez az alapértelmezett rendszer. Akkor használható, ha az Xcode több verziója is telepítve van egy rendszeren. Példa: /Applications/Xcode 7.app/Contents/Developer.

useXcpretty - Az xcpretty használata
boolean. Alapértelmezett érték: false.

Formázja xcodebuild a kimenetet, és létrehoz egy JUnit-teszteredmény-jelentést. Ügynök gazdagépekre kell telepíteni. További információ az xcpretty-ről.

publishJUnitResults - Közzététel a VSTS-ben/TFS-ben
boolean. Alapértelmezett érték: false.

A használatával xctool létrehozott JUnit-teszteredmények közzé vannak téve a VSTS-ben/TFS-ben.

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ési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build
Futtatás:	Ügynök, DeploymentGroup
Igények	A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: 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ármelyik
Változók beállítása	Bármelyik
Ügynök verziója	Minden támogatott ügynökverzió.
Feladatkategória	Build

Megosztás a következőn keresztül: