XamarinAndroid@1 - Xamarin.Android v1 작업

  • 아티클

이 작업을 사용하여 Xamarin을 사용하여 Android 앱을 빌드합니다.

Syntax

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

입력

projectFile - 프로젝트
입력 별칭: project. string. 필수 요소. 기본값은 **/*.csproj입니다.

프로젝트의 리포지토리 루트 Xamarin.Android 에서 빌드할 상대 경로를 지정합니다. 와일드카드를 사용할 수 있습니다. 자세한 내용은 파일 일치 패턴 참조를 참조하세요. 예를 들어 모든 **/*.csproj 하위 폴더의 모든 csproj 파일에 대해 입니다. 이 선택된 경우 Create App Package 프로젝트에 대상이 있어야 합니다PackageForAndroid.


target - 대상
string.

이 프로젝트에서 빌드할 대상을 지정합니다. 세미콜론을 사용하여 여러 대상을 구분합니다.


outputDirectory - 출력 디렉터리
입력 별칭: outputDir. string.

선택 사항입니다. 빌드에 대한 출력 디렉터리를 제공합니다. 예: $(build.binariesDirectory)/bin/Release.


configuration - 구성
string.

빌드할 구성을 지정합니다. 예를 들어 debug 또는 release입니다.

팁

변수 탭(큐 시간에 선택)에서 와 같은 BuildConfiguration 빌드 변수를 Allow 선언하고 여기에서 로 $(BuildConfiguration)참조합니다. 그런 다음 빌드를 큐에 대기하고 여러 구성 빌드를 사용하도록 설정할 때 플랫폼을 수정할 수 있습니다.


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

빌드 중에 대상 를 (/t:PackageForAndroid)전달하여 APK를 생성합니다.


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

빌드하는 동안 클린 대상 (/t:clean)을 전달합니다.


msbuildLocationOption - Msbuild
입력 별칭: msbuildLocationMethod. string. 허용되는 값: version, location (위치 지정). 기본값은 version입니다.

MSBuild(Windows) 또는 xbuild(macOS)의 경로를 지정합니다. 기본 동작은 최신 버전을 검색하는 것입니다.


msbuildVersionOption - MSBuild 버전
입력 별칭: msbuildVersion. string. 선택 사항입니다. 을 사용할 때 msbuildLocationMethod = version사용합니다. 허용되는 값: latest, 17.0 (MSBuild 17.0), 16.0 (MSBuild 16.0), 15.0 (MSBuild 15.0), 14.0 (MSBuild 14.0), 12.0 (MSBuild 12.0), 4.0 (MSBuild 4.0). 기본값은 15.0입니다.

기본 버전을 찾을 수 없는 경우 최신 버전의 사용을 지정합니다. macOS에서는 xbuild(Mono) 또는 MSBuild(Mac용 Visual Studio)가 사용됩니다.


msbuildVersionOption - MSBuild 버전
입력 별칭: msbuildVersion. string. 선택 사항입니다. 을 사용할 때 msbuildLocationMethod = version사용합니다. 허용되는 값: latest, 15.0 (MSBuild 15.0), 14.0 (MSBuild 14.0), 12.0 (MSBuild 12.0), 4.0 (MSBuild 4.0). 기본값은 15.0입니다.

기본 버전을 찾을 수 없는 경우 최신 버전의 사용을 지정합니다. macOS에서는 xbuild(Mono) 또는 MSBuild(Mac용 Visual Studio)가 사용됩니다.


msbuildFile - MSBuild 위치
입력 별칭: msbuildLocation. string. 필요한 경우 msbuildLocationMethod = location입니다.

선택 사항입니다. MSBuild(Windows) 또는 xbuild(macOS)에 대한 경로를 제공합니다.


msbuildArchitectureOption - MSBuild 아키텍처
입력 별칭: msbuildArchitecture. string. 선택 사항입니다. 을 사용할 때 msbuildLocationMethod = version사용합니다. 허용되는 값: x86 (MSBuild x86), x64 (MSBuild x64). 기본값은 x86입니다.

실행하려는 MSBuild의 아키텍처(x86, x64)를 제공합니다.


msbuildArguments - 추가 인수
string.

MSBuild(Windows) 또는 xbuild(macOS)에 전달되는 추가 인수를 지정합니다.


jdkOption - 빌드에 사용할 JDK 선택
입력 별칭: jdkSelection. string. 필수 요소. 허용되는 값: JDKVersion (JDK 버전), Path. 기본값은 JDKVersion입니다.

빌드 프로세스 중에 태스크가 사용하는 JDK 버전을 지정합니다. 값은 JDKVersion 빌드 중에 태스크가 검색하는 JDK 버전을 지정합니다. 값은 Path JDK 버전의 파일 경로를 지정합니다.


jdkVersionOption - JDK 버전
입력 별칭: jdkVersion. string. 선택 사항입니다. 을 사용할 때 jdkSelection = JDKVersion사용합니다. 허용되는 값: default, 1.11 (JDK 11), 1.10 (JDK 10(지원되지 않음)), 1.9 (JDK 9(지원되지 않음)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6(지원되지 않음)) 기본값은 default입니다.

빌드 중에 사용할 JDK 버전을 지정합니다.


jdkDirectory - JDK 경로
입력 별칭: jdkUserInputPath. string. 필요한 경우 jdkSelection = Path입니다.

경로에서 빌드 jdkSelection 하는 동안 사용할 JDK 버전을 지정합니다.


jdkArchitectureOption - JDK 아키텍처
입력 별칭: jdkArchitecture. string. 선택 사항입니다. 을 사용할 때 jdkVersion != default사용합니다. 허용되는 값: x86, x64. 기본값은 x64입니다.

JDK의 아키텍처(x86, x64)를 제공합니다.


작업 제어 옵션

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

출력 변수

없음

설명

이 작업을 사용하여 Xamarin을 사용하여 Android 앱을 빌드합니다.

예제

요구 사항

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