다음을 통해 공유


XamariniOS@2 - Xamarin.iOS v2 작업

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

Syntax

# Xamarin.iOS v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  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: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

입력

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

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


configuration - 구성
string. 필수 요소. 기본값은 Release입니다.

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


clean - 청소
boolean. 기본값은 false입니다.

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


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

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


buildForSimulator - iOS 시뮬레이터용 빌드
입력 별칭: forSimulator. boolean. 기본값은 false입니다.

(선택 사항) 실제 iOS 디바이스 대신 iOS 시뮬레이터용 빌드


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

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


args - 인수
string.

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


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

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


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

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


signingIdentity - 서명 ID
입력 별칭: iosSigningIdentity. string.

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


signingProvisioningProfileID - 프로비저닝 프로필 UUID
입력 별칭: provProfileUuid. string.

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


작업 제어 옵션

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

출력 변수

없음

설명

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

이 작업 버전의 새로운 기능

  • iOS 등록 설정이 작업에서 제거되었습니다. 를 지원 작업 Install Apple CertificateInstall Apple Provisioning Profile 함께 사용하고 Secure Files 서명을 설정할 수 있습니다. 에서 더 잘 Visual Studio for Mac작동하도록 옵션이 업데이트되었습니다.

예제

요구 사항

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