GenerateDeploymentManifest 작업

ClickOnce 배포 매니페스트를 생성합니다. ClickOnce 배포 매니페스트는 배포에 대한 고유한 ID를 정의하고, 설치 또는 온라인 모드와 같은 배포 특성을 식별하고, 응용 프로그램 업데이트 설정 및 업데이트 위치를 지정하고, 해당 ClickOnce 응용 프로그램 매니페스트를 지정하여 응용 프로그램의 배포를 설명합니다.

매개 변수

다음 표에서는 GenerateDeploymentManifest 작업의 매개 변수에 대해 설명합니다.

매개 변수 설명
AssemblyName 선택적 String 매개 변수입니다.

생성된 매니페스트에 대한 어셈블리 ID의 Name 필드를 지정합니다. 이 매개 변수를 지정하지 않으면 이름은 EntryPoint 또는 InputManifest 매개 변수에서 유추됩니다. 이름을 유추할 수 없으면 작업에서 오류가 throw됩니다.
AssemblyVersion 선택적 String 매개 변수입니다.

생성된 매니페스트에 대한 어셈블리 ID의 Version 필드를 지정합니다. 이 매개 변수를 지정하지 않으면 작업은 "1.0.0.0" 값을 사용합니다.
CreateDesktopShortcut 선택적 Boolean 매개 변수입니다.

true이면 ClickOnce 응용 프로그램 설치 동안 아이콘이 바탕 화면에 만들어집니다.
DeploymentUrl 선택적 String 매개 변수입니다.

응용 프로그램에 대한 업데이트 위치를 지정합니다. 이 매개 변수를 지정하지 않으면 응용 프로그램에 대한 업데이트 위치가 정의되지 않습니다. 그러나 UpdateEnabled 매개 변수가 true이면 업데이트 위치를 지정해야 합니다. 지정된 값은 정규화된 URL 또는 UNC 경로여야 합니다.
Description 선택적 String 매개 변수입니다.

응용 프로그램에 대한 선택적 설명을 지정합니다.
DisallowUrlActivation 선택적 Boolean 매개 변수입니다.

응용 프로그램이 URL을 통해 열릴 때 자동으로 실행되어야 하는지 여부를 지정합니다. 이 매개 변수가 true이면 응용 프로그램을 시작 메뉴에서만 시작할 수 있습니다. 이 매개 변수의 기본값은 false입니다. 이 입력은 Install 매개 변수 값이 true일 때만 적용됩니다.
EntryPoint 선택적 ITaskItem[] 매개 변수입니다.

생성된 매니페스트 어셈블리에 대한 진입점을 나타냅니다. ClickOnce 배포 매니페스트의 경우 이 입력은 ClickOnce 응용 프로그램 매니페스트를 지정합니다.

Visual Studio 2005에서 GenerateApplicationManifest 작업에는 응용 프로그램 매니페스트를 생성하기 위해 EntryPoint가 필요합니다. (어셈블리 또는 네이티브 매니페스트에는 EntryPoint가 필요 하지 않습니다.) 이 요구 사항은 빌드 오류 "MSB3185: 매니페스트에 EntryPoint를 지정하지 않았습니다."를 나타내며 적용되었습니다.

MSBuild는 EntryPoint 작업 매개 변수가 지정되지 않을 경우 이 오류를 발생하지 않습니다. 대신 <customHostSpecified> 태그는 <entryPoint> 태그의 자식으로 삽입되며, 예를 들면 다음과 같습니다.

<entryPoint xmlns="urn:schemas-

microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

다음 단계를 사용하여 응용 프로그램 매니페스트에 DLL 종속성을 추가할 수 있습니다.

1. ResolveAssemblyReference를 호출하여 어셈블리 참조를 확인합니다.
2. 이전 작업의 출력 및 어셈블리 자체를 ResolveManifestFiles에 전달합니다.
3. Dependencies 매개 변수를 사용하여 GenerateApplicationManifest에 종속성을 전달합니다.
ErrorReportUrl 선택적 System.String 매개 변수입니다.

ClickOnce 설치 중에 대화 상자에 표시되는 웹 페이지의 URL을 지정합니다.
InputManifest 선택적 ITaskItem 매개 변수입니다.

매니페스트 생성기에 대한 기본으로 사용되는 입력 XML 문서를 나타냅니다. 이를 통해 사용자 지정 매니페스트 정의와 같은 구조화된 데이터가 출력 매니페스트에 반영될 수 있습니다. XML 문서의 루트 요소는 asmv1 네임스페이스의 어셈블리 노드여야 합니다.
Install 선택적 Boolean 매개 변수입니다.

응용 프로그램이 설치된 응용 프로그램인지 아니면 온라인 전용 응용 프로그램인지 여부를 지정합니다. 이 매개 변수가 true이면 응용 프로그램은 사용자의 [시작] 메뉴에 설치되며 [프로그램 추가/제거] 대화 상자를 사용하여 제거할 수 있습니다. 이 매개 변수가 false이면 응용 프로그램을 웹 페이지에서 온라인으로 사용해야 합니다. 이 매개 변수의 기본값은 true입니다.
MapFileExtensions 선택적 Boolean 매개 변수입니다.

.deploy 파일 이름 확장명 매핑이 사용되는지 여부를 지정합니다. 이 매개 변수가 true이면 모든 프로그램 파일이 .deploy 파일 이름 확장명을 사용하여 게시됩니다. 이 옵션은 웹 서버 보안에서 ClickOnce 응용 프로그램 배포를 사용하도록 설정하기 위해 차단을 해제해야 하는 파일 이름 확장명의 수를 제한하는 데 유용합니다. 이 매개 변수의 기본값은 false입니다.
MaxTargetPath 선택적 String 매개 변수입니다.

ClickOnce 응용 프로그램 배포에서 파일 경로의 최대 허용 길이를 지정합니다. 이 매개 변수를 지정하는 경우 응용 프로그램에서 각 파일 경로의 길이가 이 제한에 대해 확인됩니다. 한도를 초과하는 항목에서는 빌드 경고가 발생합니다. 이 입력이 지정되지 않거나 0으로 지정된 경우 검사가 수행되지 않습니다.
MinimumRequiredVersion 선택적 String 매개 변수입니다.

사용자가 업데이트를 건너뛸 수 있는지 여부를 지정합니다. 사용자가 필요한 최소 버전보다 낮은 버전을 보유하고 있으면 업데이트를 건너뛸 수 있는 옵션이 제공되지 않습니다. 이 입력은 Install 매개 변수의 값이 true일 때만 적용됩니다.
OutputManifest 선택적 ITaskItem 매개 변수입니다.

생성된 출력 매니페스트 파일의 이름을 지정합니다. 이 매개 변수를 지정하지 않으면 출력 파일의 이름이 생성된 매니페스트의 ID에서 유추됩니다.
Platform 선택적 String 매개 변수입니다.

응용 프로그램의 대상 플랫폼을 지정합니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.

- AnyCPU
- x86
- x64
- Itanium

기본값은 AnyCPU입니다.
Product 선택적 String 매개 변수입니다.

응용 프로그램의 이름을 지정합니다. 이 매개 변수를 지정하지 않으면 이름이 생성된 매니페스트의 ID에서 유추됩니다. 이 이름은 시작 메뉴의 바로 가기 이름에 사용되고 프로그램 추가/제거 대화 상자에 표시되는 이름의 일부입니다.
Publisher 선택적 String 매개 변수입니다.

응용 프로그램의 게시자를 지정합니다. 이 매개 변수를 지정하지 않으면 이름이 등록된 사용자 또는 생성된 매니페스트의 ID에서 유추됩니다. 이 이름은 시작 메뉴의 폴더 이름에 사용되고 프로그램 추가/제거 대화 상자에 표시되는 이름의 일부입니다.
SuiteNamel 선택적 String 매개 변수입니다.

ClickOnce 배포 후에 응용 프로그램이 위치할 시작 메뉴의 폴더 이름을 지정합니다.
SupportUrl 선택적 String 매개 변수입니다.

응용 프로그램에 대한 프로그램 추가/제거 대화 상자에 표시되는 링크를 지정합니다. 지정된 값은 정규화된 URL 또는 UNC 경로여야 합니다.
TargetCulture 선택적 String 매개 변수입니다.

응용 프로그램의 문화권을 식별하고 생성된 매니페스트에 대한 어셈블리 ID의 Language 필드를 지정합니다. 이 매개 변수를 지정하지 않으면 응용 프로그램은 문화권이 고정되어 있다고 가정합니다.
TrustUrlParameters 선택적 Boolean 매개 변수입니다.

URL 쿼리 문자열 매개 변수를 응용 프로그램에 사용할 수 있게 해야 할지 여부를 지정합니다. 이 매개 변수의 기본값은 해당 매개 변수를 응용 프로그램에 사용할 수 없음을 나타내는 false입니다.
UpdateEnabled 선택적 Boolean 매개 변수입니다.

응용 프로그램을 업데이트할 수 있는지 여부를 나타냅니다. 이 매개 변수의 기본값은 false입니다. 이 매개 변수는 Install 매개 변수의 값이 true일 때만 적용됩니다.
UpdateInterval 선택적 Int32 매개 변수입니다.

응용 프로그램에 대한 업데이트 간격을 지정합니다. 이 매개 변수의 기본값은 0입니다. 이 매개 변수는 InstallUpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다.
UpdateMode 선택적 String 매개 변수입니다.

업데이트를 응용 프로그램이 시작되기 전에 포그라운드에서 확인해야 하는지 아니면 응용 프로그램이 실행되는 동안 백그라운드에서 확인해야 하는지 여부를 지정합니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.

- Foreground
- Background

이 매개 변수의 기본값은 Background입니다. 이 매개 변수는 InstallUpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다.
UpdateUnit 선택적 String 매개 변수입니다.

UpdateInterval 매개 변수의 단위를 지정합니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.

- Hours
- Days
- Weeks

이 매개 변수는 InstallUpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다.

설명

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 GenerateManifestBase 클래스의 매개 변수도 상속합니다. Task 클래스의 매개 변수 목록에 대해서는 Task 기본 클래스를 참조하세요.

참고 항목

작업
GenerateApplicationManifest 작업
SignFile 작업
작업 참조