다음을 통해 공유

XamariniOS@1 - Xamarin.iOS v1 작업

  • 아티클

파이프라인에서 이 작업을 사용하여 macOS에서 Xamarin을 사용하여 iOS 앱을 빌드합니다. 자세한 내용은 Xamarin 지침 참조하고 CI 중에 앱에 서명하는.

구문론

# Xamarin.iOS v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

입력

solutionFile - 솔루션
입력 별칭: solution. string; 필수 사항입니다. 기본값은 **/*.sln입니다.

Xamarin.iOS 솔루션의 리포지토리 루트에서 빌드까지의 상대 경로를 지정합니다. 와일드카드를 포함할 수 있습니다.


configuration - 구성
string; 필수 사항입니다. 기본값은 Release입니다.

구성을 지정합니다. 표준 구성은 임시, AppStore, 디버그 및 릴리스입니다.


clean - 정리
boolean; 기본값은 false입니다.

선택 사항. 빌드 전에 클린 빌드(/t:clean)를 실행합니다.


packageApp - 앱 패키지 만들기
boolean; 기본값은 true입니다.

true설정하면 빌드의 일부로 IPA를 생성합니다.


iOS용 빌드buildForSimulator -
입력 별칭: forSimulator. boolean; 기본값은 false입니다.

선택 사항. 실제 iOS 디바이스 대신 iOS 시뮬레이터용으로 빌드합니다.


NuGet 복원실행 runNugetRestore -
boolean; 기본값은 true입니다.

Xamarin iOS 솔루션에서 nuget restore 실행하여 빌드 전에 참조된 모든 패키지를 설치합니다. 빌드 에이전트 컴퓨터의 PATH에 있는 nuget 도구가 사용됩니다. 다른 버전의 NuGet을 사용하거나 추가 인수를 설정하려면 NuGet 설치 관리자 작업사용합니다.


args - 인수
string;

선택 사항. 빌드에 사용되는 추가 명령줄 인수를 지정합니다.


workingDirectory - 작업 디렉터리
입력 별칭: cwd. string;

선택 사항. 빌드가 실행될 작업 디렉터리를 지정합니다. 값이 비어 있으면 리포지토리의 루트가 사용됩니다.


buildToolOption - 빌드 도구
입력 별칭: buildTool. string; 허용되는 값: xbuild(xbuild(Xamarin Studio)), msbuild(MSBuild(Mac용 Visual Studio)) 기본값은 xbuild입니다.

태스크에서 사용할 빌드 도구를 지정합니다.


mdtoolFile - 빌드 도구 경로
입력 별칭: mdtoolLocation. string;

선택 사항. xbuild(Xamarin Studio 모노 빌드 도구) 또는 MSBuild(Mac용 Visual Studio 빌드 도구)에 대한 경로를 제공합니다. 값이 비어 있으면 기본 xbuild 또는 MSBuild 경로가 사용됩니다.


사용하여 재정의 signingOption -
입력 별칭: signMethod. string; 허용되는 값: file(파일 내용), id(식별자). 기본값은 file입니다.

빌드에서 기본값과 다른 서명 또는 프로비저닝 방법을 사용하는 경우 이 입력을 사용합니다. P12 인증서 및 프로비저닝 프로필을 사용하려면 file 선택합니다. id 선택하여 기본 키 집합 및 미리 설치된 프로필에서 서명 설정을 검색합니다. 기본 빌드 설정을 재정의하지 않으려면 해당 필드를 비워 둡니다.


signingIdentity - 서명 ID
입력 별칭: iosSigningIdentity. string; 선택 사항. signMethod = id때 사용합니다.

빌드에 서명하는 데 사용할 서명 ID를 재정의합니다. 값이 비어 있으면 Xcode 프로젝트의 설정이 사용됩니다. 이 옵션을 사용하는 경우 signingUnlockDefaultKeychain 선택해야 할 수 있습니다.


signingUnlockDefaultKeychain - 기본 키 집합 잠금 해제
입력 별칭: unlockDefaultKeychain. boolean; 선택 사항. signMethod = id때 사용합니다. 기본값은 false입니다.

기본 키 집합의 잠금을 해제하여 "사용자 상호 작용이 허용되지 않음" 오류를 해결합니다.


기본 키 집합 암호signingDefaultKeychainPassword -
입력 별칭: defaultKeychainPassword. string; 선택 사항. signMethod = id때 사용합니다.

signingUnlockDefaultKeychain 설정되면 기본 키 집합의 잠금을 해제할 암호를 지정합니다.


signingProvisioningProfileID - 프로비저닝 프로필 UUID
입력 별칭: provProfileUuid. string; 선택 사항. signMethod = id때 사용합니다.

이 빌드에 사용할 설치된 프로비저닝 프로필의 UUID를 지정합니다.


P12 인증서 파일signingP12File -
입력 별칭: p12. string; 선택 사항. signMethod = file때 사용합니다.

이 빌드에 사용할 서명 인증서를 포함하는 PKCS12 형식의 P12 인증서 파일에 대한 상대 경로를 지정합니다.


P12 암호signingP12Password -
입력 별칭: p12pwd. string; 선택 사항. signMethod = file때 사용합니다.

P12 인증서 파일의 암호를 지정합니다. 빌드 변수를 사용하여 이 값을 암호화합니다.


프로비저닝 프로필 파일signingProvisioningProfileFile -
입력 별칭: provProfile. string; 선택 사항. signMethod = file때 사용합니다.

이 빌드에 사용할 설치된 프로비저닝 프로필 재정의의 UUID를 지정합니다.


signingRemoveProfile - 빌드 후 프로필 제거
입력 별칭: removeProfile. boolean; 선택 사항. signMethod = file때 사용합니다. 기본값은 false입니다.

빌드가 완료된 후 프로비전 프로필 파일의 내용을 빌드 에이전트에서 제거해야 되도록 지정합니다. 사용자당 하나의 에이전트를 실행하는 경우에만 사용하도록 설정합니다..


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성참조하세요.

출력 변수

없음.

요구 사항

요구 사항 설명
파이프라인 유형 YAML, 클래식 빌드
다음에서 실행 에이전트, DeploymentGroup
요구 자체 호스팅 에이전트에는 다음 요구 사항과 일치하는 기능이 있어야 하며, 이 작업을 사용하는 작업을 실행하기 위해: Xamarin.iOS
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어느 것이든
settable 변수 어느 것이든
에이전트 버전 지원되는 모든 에이전트 버전입니다.
작업 범주 빌드