Xcode@2 - Xcode Build v2 작업
이 작업을 사용하여 macOS에서 Xcode 작업 영역을 빌드합니다.
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.
입력
actions
- 작업
string
. 필수 요소. 기본값은 build
입니다.
공백으로 구분된 작업 목록을 지정합니다. 유효한 옵션은 build
, clean
, test
, analyze
및 archive
입니다. 예를 들어 는 build clean
클린 빌드를 수행합니다. Xcode FAQ를 사용하여 명령줄에서 Apple: Building을 참조하세요.
configuration
- 구성
string
. 기본값은 $(Configuration)
입니다.
빌드할 Xcode 프로젝트 또는 작업 영역 구성을 지정합니다. 변수를 사용하는 경우 변수 탭에서 값(예: Release
) 을 지정합니다 .
sdk
- Sdk
string
. 기본값은 $(SDK)
입니다.
지정된 SDK에 대해 Xcode 프로젝트 또는 작업 영역을 빌드합니다. 를 실행 xcodebuild -showsdks
하여 유효한 SDK 목록을 확인합니다.
xcWorkspacePath
- 작업 영역/프로젝트 경로
string
. 기본값은 **/*.xcodeproj/*.xcworkspace
입니다.
선택 사항입니다. 리포지토리 루트에서 Xcode 작업 영역 또는 프로젝트로의 상대 경로를 지정합니다. 예를 들어 MyApp/MyApp.xcworkspace
또는 MyApp/MyApp.xcworkspace/MyApp.xcodeproj
입니다.
고급 인수에서 사용 -target flag
하려는 경우 비워 둡니다.
scheme
- 구성표
string
.
선택 사항입니다. Xcode 스키마 이름을 지정합니다. 공유 스키마여야 합니다 (Xcode 의 관리 체계 아래 공유 확인란). 작업 영역을 지정하는 경우 필수입니다.
packageApp
- 앱 패키지 만들기
boolean
. 기본값은 true
입니다.
IPA가 빌드의 일부로 생성되는지 여부를 지정합니다. Xcode 7 및 Xcode 8을 사용하여 보관 파일을 내보내려면 패키지 옵션 섹션에서 추가 입력을 검토합니다.
packageTool
- 를 사용하여 IPA(패키지 만들기)
string
. 필수 요소. 허용되는 값: xcrun
(xcrun(Apple에서 사용되지 않음), xcodebuild
(xcodebuild 보관 및 내보내기). 기본값은 xcodebuild
입니다.
IPA를 생성하는 데 사용할 도구를 지정합니다.
archivePath
- 보관 경로
string
. 선택 사항입니다. 을 사용할 때 packageTool == xcodebuild
사용합니다.
만든 보관 파일이 배치되는 디렉터리를 지정합니다.
exportPath
- 경로 내보내기
string
. 선택 사항입니다. 을 사용할 때 packageTool == xcodebuild
사용합니다. 기본값은 output/$(SDK)/$(Configuration)
입니다.
보관에서 내보낸 제품의 대상을 지정합니다.
exportOptions
- 내보내기 옵션
string
. 선택 사항입니다. 을 사용할 때 packageTool == xcodebuild
사용합니다. 허용되는 값: auto
, plist
, specify
. 기본값은 auto
입니다.
보관 파일을 내보낼 때 내보내기 옵션을 전달하는 방법을 지정합니다.
exportMethod
- 내보내기 메서드
string
. 필요한 경우 exportOptions == specify
입니다. 기본값은 development
입니다.
Xcode에서 보관 파일을 내보내는 데 사용하는 메서드를 지정합니다. 예를 들어 app-store
, package
, ad-hoc
, enterprise
또는 development
입니다.
exportTeamId
- 팀 ID
string
. 선택 사항입니다. 을 사용할 때 exportOptions == specify
사용합니다.
내보내기에서 사용할 Apple 개발자 포털 10자리 팀 ID를 지정합니다.
exportOptionsPlist
- 내보내기 옵션 목록
string
. 필요한 경우 exportOptions == plist
입니다.
보관 내보내기를 구성하는 plist 파일의 경로를 지정합니다.
xcode8AutomaticSigning
- 자동 서명
boolean
. 기본값은 false
입니다.
자동 서명에 대해 Xcode 8 또는 Xcode 9 프로젝트가 구성된 경우 이 입력을 사용합니다.
teamId
- 팀 ID
string
. 선택 사항입니다. 을 사용할 때 xcode8AutomaticSigning = true
사용합니다.
10자리 개발자 팀 ID를 지정합니다. 이는 여러 개발 팀의 구성원인 경우 필요합니다.
signMethod
- 다음을 사용하여 재정의
string
. 허용되는 값: file
(파일 콘텐츠), id
(식별자). 기본값은 file
입니다.
빌드에서 기본값과 다른 서명 또는 프로비저닝 메서드를 사용하는 경우 이 입력을 사용합니다. P12 인증서 및 프로비저닝 프로필을 사용하도록 선택합니다 File Contents
. 기본 키체인 및 사전 설치된 프로필에서 서명 설정을 검색하도록 선택합니다Identifiers
. 기본 빌드 설정을 재정의하지 않으려면 해당 필드를 비워 둡니다.
iosSigningIdentity
- 서명 ID
string
. 선택 사항입니다. 을 사용할 때 signMethod = id
사용합니다.
빌드에 서명하는 데 사용되는 서명 ID 재정의를 지정합니다. 기본값은 Xcode 프로젝트 설정입니다. 잠금 해제 기본 키 집합 을 선택해야 할 수 있습니다.
unlockDefaultKeychain
- 기본 키 집합 잠금 해제
boolean
. 선택 사항입니다. 을 사용할 때 signMethod = id
사용합니다. 기본값은 false
입니다.
기본 키체인 잠금 해제하여 사용자 상호 작용이 허용되지 않는 오류를 해결합니다.
defaultKeychainPassword
- 기본 키 집합 암호
string
. 선택 사항입니다. 을 사용할 때 signMethod = id
사용합니다.
기본 키체인 잠금을 해제할 암호를 지정합니다.
provProfileUuid
- 프로비저닝 프로필 UUID
string
. 선택 사항입니다. 을 사용할 때 signMethod = id
사용합니다.
빌드에 사용할 설치된 프로비저닝 프로필의 UUID를 지정합니다. 서로 다른 체계 또는 대상이 있는 별도의 빌드 작업을 사용하여 단일 작업 영역(iOS, WatchKit, tvOS)에서 대상으로 프로비저닝 프로필을 지정합니다.
p12
- P12 인증서 파일
string
. 선택 사항입니다. 을 사용할 때 signMethod = file
사용합니다.
빌드에 사용할 서명 인증서가 포함된 PKCS12 형식의 P12 인증서 파일에 대한 상대 경로를 지정합니다.
p12pwd
- P12 암호
string
. 선택 사항입니다. 을 사용할 때 signMethod = file
사용합니다.
지정된 경우 P12 인증서 파일의 암호를 지정합니다. 빌드 변수를 사용하여 암호화합니다.
provProfile
- 프로비저닝 프로필 파일
string
. 선택 사항입니다. 을 사용할 때 signMethod = file
사용합니다.
빌드에 사용할 프로비저닝 프로필 재정의를 포함하는 파일의 상대 경로를 지정합니다. 서로 다른 체계 또는 대상이 있는 별도의 빌드 작업을 사용하여 단일 작업 영역(iOS, WatchKit, tvOS)에서 대상으로 프로비저닝 프로필을 지정합니다.
removeProfile
- 빌드 후 프로필 제거
boolean
. 선택 사항입니다. 을 사용할 때 signMethod = file
사용합니다. 기본값은 false
입니다.
빌드가 완료된 후 빌드 에이전트에서 프로비저닝 프로필 파일의 내용을 제거합니다. 사용자당 하나의 에이전트를 실행하는 경우에만 검사.
args
- 인수
string
.
빌드하는 데 사용되는 추가 명령줄 인수를 지정합니다. 이 입력은 작업 영역 및 체계를 지정하는 대신 또는 -project
를 사용 -target
하려는 경우에 유용합니다.
cwd
- 작업 디렉터리
string
.
빌드 실행에 대한 작업 디렉터리를 지정합니다. 기본값은 리포지토리의 루트입니다.
outputPattern
- 출력 디렉터리
string
. 필수 요소. 기본값은 output/$(SDK)/$(Configuration)
입니다.
빌드 출력(이진 파일)이 배치되는 상대 경로를 지정합니다.
xcodeDeveloperDir
- Xcode 개발자 경로
string
.
선택 사항입니다. 시스템 기본값이 아닌 경우 Xcode Developer 폴더의 경로를 지정합니다. 여러 버전의 Xcode가 시스템에 설치된 경우에 사용합니다. 예: /Applications/Xcode 7.app/Contents/Developer
useXcpretty
- xcpretty 사용
boolean
. 기본값은 false
입니다.
출력 형식을 지정 xcodebuild
하고 JUnit 테스트 결과 보고서를 생성합니다. 에이전트 호스트에 설치해야 합니다. xcpretty에 대해 자세히 알아보세요.
publishJUnitResults
- VSTS/TFS에 게시
boolean
. 기본값은 false
입니다.
를 사용하여 xctool
생성된 JUnit 테스트 결과는 VSTS/TFS에 게시됩니다.
useXctool
- xctool 사용
boolean
.
대신 를 xcodebuild
사용합니다xctool
. 에이전트 호스트에 설치해야 합니다. xctool에 대해 자세히 알아보세요.
참고:xctool
는 더 이상 사용되지 않으며 Xcode 8에서는 작동하지 않습니다.
xctoolReporter
- xctool Test Reporter 형식
string
.
테스트 작업을 지정하고 xctool 사용을 확인할 때 사용할 보고자 형식을 테스트합니다. 테스트 결과 게시 태스크와 호환되는 파일 형식을 생성하려면 를 지정 junit:output-file-path-here.xml
합니다. 지정하면 plain 이 자동으로 추가됩니다. xctool
에이전트 호스트에 설치해야 합니다. xctool에 대해 자세히 알아보세요.
참고:xctool
는 더 이상 사용되지 않으며 Xcode 8에서는 작동하지 않습니다.
작업 제어 옵션
모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.
출력 변수
없음