Xcode@2 – Xcode Build v2 feladat

Cikk
07/02/2024

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

Syntax

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  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
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # 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.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

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 buildelést hajt végre. Tekintse meg az Apple: Building from the parancssori Xcode FAQ 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).

Xcode-projektet vagy -munkaterületet készít 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 a Felügyelt sémák az Xcode-ban területen). A munkaterület megadása 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 kóddal történő exportálásához tekintse át a Csomagbeállítások szakaszban található további bemeneteket.

packageTool - Csomag (IPA) létrehozása a használatával
string. Kötelező. Engedélyezett értékek: xcrun (xcrun (az Apple elavult)), xcodebuild (xcodebuild archív és exportálás). Alapértelmezett érték: xcodebuild.

Meghatározza az IPA létrehozásához használni kívánt eszközt.

archivePath - Archív elérési út
string. Választható. Használja a következőt: packageTool == xcodebuild.

Megadja azt a könyvtárat, ahol a létrehozott archívumok elhelyezve vannak.

exportPath - Elérési út exportálása
string. Választható. Használja a következőt: packageTool == xcodebuild. Alapértelmezett érték: output/$(SDK)/$(Configuration).

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

exportOptions - Exportálási beállítások
string. Választható. Használja a következőt: packageTool == xcodebuild. 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ása során.

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

Meghatározza, hogy az Xcode az archívum exportálásához használt metódust használja-e. 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.

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 számjegyű fejlesztői csapat azonosítóját. Erre akkor van szükség, ha több fejlesztőcsapat tagja.

signMethod - Felülbírálás használata
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. Hagyja üresen a megfelelő mezőket, ha nem szeretné felülbírálni az alapértelmezett buildbeállításokat.

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. Előfordulhat, 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 zárolásának 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 a P12-tanúsítványfájl jelszavát, ha meg van adva. 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.

useXctool - Az xctool használata
boolean.

A helyett a parancsot xcodebuildhasználjaxctool. Ügynök gazdagépekre kell telepíteni. További információ az xctoolról.
Megjegyzés:xctool elavult, és nem működik az Xcode 8-tal.

xctoolReporter - xctool test reporter format
string.

Teszteli a tesztművelet megadásakor használandó riporteri formátumot, és ellenőrzi az Xctool használata jelölőnégyzetet. Adja meg junit:output-file-path-here.xml , hogy a Teszteredmények közzététele feladattal kompatibilis fájlformátumot hozzon létre. Ha meg van adva, a rendszer automatikusan hozzáadja az egyszerű elemet. xctool ügynök gazdagépekre kell telepíteni. További információ az xctoolról.
Megjegyzés:xctool elavult, és nem működik az Xcode 8-tal.

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: