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

Xcode@4 – Xcode v4 feladat

  • Cikk

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

Syntax

# Xcode v4
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@4
  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' | '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. 
    #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: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #outputPattern: # string. Output directory. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish test results 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áulclean build 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).

Meghatározza az Xcode-projekt vagy -munkaterület létrehozásakor használni kívánt SDK-t. A macOS terminálalkalmazásban futtassa a parancsot 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.


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

Választható. Relatív elérési utat ad meg az adattár gyökerétől az Xcode-munkaterületig vagy projektig. Ha értéket ad meg, meg kell adnia a sémát is. Ne adjon meg értéket, ha speciális argumentumokat ad meg -target flag . Például MyApp/MyApp.xcworkspace vagy MyApp/MyApp.xcodeproj.


scheme - Rendszer
string.

Választható. Xcode-sémanevet ad meg. Megosztott sémának kell lennie (megosztott jelölőnégyzet a Felügyelt sémák az Xcode-ban területen). 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.


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

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


xcodeDeveloperDir - Xcode fejlesztői útvonal
string. Választható. Használja a következőt: 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épre.


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

Meghatározza, hogy létre kell-e hozni egy IPA-alkalmazáscsomagfájlt a build részeként.


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

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: packageApp == true. 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: packageApp == true. Engedélyezett értékek: auto (Automatikus), plist, specify. Alapértelmezett érték: auto.

Megadja az archívum exportálásának lehetőségeit. Ha az alapértelmezett érték Automatic 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 lehetőséget Plist . Válassza a Specify lehetőséget egy adott exportálási módszer és csoportazonosító megadásához.


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

Meghatározza azt a metódust, amelyet az Xcode az archívum exportálásához használ. Például: , , , , enterprisevagy development. ad-hocpackageapp-store


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

Megadja az Apple Developer Portal 10 karakteres csapatazonosítóját, amelyet az exportálás során használni szeretne.


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

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


exportArgs - Argumentumok exportálása
string. Választható. Használja a következőt: 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 defaults), 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 lehetőséget Do not code sign az aláírás letiltásához. Válassza ki Project defaults , hogy csak a projekt aláírási konfigurációját használja. Válassza a Manual signing manuális aláírás kényszerítéséhez, és opcionálisan megadhatja az aláíró identitást és a kiépítési profilt. Válassza ki 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 projekthez aláírásra van szükség, az Apple telepítése... feladatokkal telepítse a tanúsítványokat és a kiépítési profilokat az Xcode build előtt.


signingIdentity - Identitás aláírása
string. Választható. Használja a következőt: signingOption = manual.

Meghatározza az aláíró identitás felülbírálását, amellyel alá kell írnia a buildet. Előfordulhat, hogy az ügynökgépen az alapértelmezett kulcskarika zárolásának feloldására van szükség. Ha nincs megadva érték, az Xcode-projekt beállítása lesz használva.


provisioningProfileUuid - Kiépítési profil UUID azonosítója
string. Választható. Használja a következőt: 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 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, tvOS, watchOS).


teamId - Csapatazonosító
string. Választható. Használja a következőt: 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 buildeszköz érvénytelen. Válasszon Custom ki egy olyan platformot, amely nem szerepel a listában. Ha Default be van jelölve, a rendszer nem céloz meg szimulátorokat vagy eszközöket.


destinationPlatform - Egyéni célplatform
string. Választható. Használja a következőt: destinationPlatformOption == custom.

Meghatározza a céleszköz platformját, amelyet a felhasználói felület teszteléséhez használnak, ha az általános buildeszköz érvénytelen.


destinationTypeOption - Cél típusa
string. Választható. Használja a következőt: destinationPlatformOption != default && destinationPlatformOption != macOS. Engedélyezett értékek: simulators (Szimulátor), devices (Csatlakoztatott eszköz). Alapértelmezett érték: simulators.

A felhasználói felület teszteléséhez használt céltípust adja meg. Az eszközöket kábel- vagy hálózati kapcsolaton keresztül kell csatlakoztatni a összeállítást végző Mac géphez. További információ: Eszközök és szimulátorok az Xcode-ban.


destinationSimulators - Szimulátor
string. Választható. Használja a következőt: destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Alapértelmezett érték: iPhone 7.

A felhasználói felület teszteléséhez használt Xcode-szimulátornevet adja meg. Például iPhone X (iOS és watchOS) vagy Apple TV 4K (tvOS). A cél operációs rendszer nem kötelező verziója a következő formátumban OS=<versionNumber>adható meg: .iPhone X,OS=11.1 További információ a telepített szimulátorokról a üzemeltetett macOS Előzetes verziós ügynökön.


destinationDevices - Eszköz
string. Választható. Használja a következőt: 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: .


args - Érvek
string.

Választható. További parancssori argumentumokat ad meg, amelyekkel buildelhet. Ez a bemenet munkaterület/projekt és séma helyett megadható -target vagy -project argumentumokat is megadhat. 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.


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

Választható. Megadja azt a munkakönyvtárat, amelyben futtatni szeretné a buildet. Ha nem ad meg értéket, a rendszer az adattár gyökerét használja.


outputPattern - Kimeneti könyvtár
string.

Választható. Megadja annak a munkakönyvtárnak a relatív elérési útját, amelybe a buildkimenet (bináris fájlok) kerülnek. Például: output/$(SDK)/$(Configuration) vagy output/$(TestSDK)/$(TestConfiguration). Az archiválási és exportálási útvonalak külön vannak konfigurálva. Adja meg az értékeket a Változók lapon.


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

Megadja, hogy használható-e xcpretty a kimenet formázására xcodebuild , és JUnit-teszteredményeket hoz létre. xcpretty Telepíteni kell az ügynökgépre (előre telepítve van a VSTS által üzemeltetett buildügynökökön). További információért lásd: xcpretty .


publishJUnitResults - Teszteredmények közzététele a VSTS-ben/TFS-ben
boolean. Alapértelmezett érték: false.

Ha xcpretty engedélyezve van, ez a bemenet határozza meg, hogy közzé kell-e tenni a JUnit-teszt eredményeit a VSTS/TFS-ben.


Tevékenységvezérlési beállítások

A tevékenységbemeneteken kívül minden tevékenység rendelkezik vezérlési lehetőségekkel. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

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

Példák

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 Létrehozás