GenerateDeploymentManifest 작업
ClickOnce 배포 매니페스트를 생성합니다. ClickOnce 배포 매니페스트에서는 배포의 고유한 ID 정의, 설치 또는 온라인 모드 같은 배포 특성 식별, 응용 프로그램 업데이트 설정 및 업데이트 위치 지정, 상응하는 ClickOnce 응용 프로그램 매니페스트 지정 등을 통해 응용 프로그램의 배포를 설명합니다.
매개 변수
다음 표에서는 GenerateDeploymentManifest 작업의 매개 변수에 대해 설명합니다.
Parameter |
설명 |
|---|---|
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를 지정하지 않았습니다."와 함께 적용되었습니다. EntryPoint 작업 매개 변수를 지정하지 않아도 MSBuild에서 이 오류가 발생하지 않습니다. 대신 <entryPoint> 태그의 자식으로 <customHostSpecified> 태그가 삽입되며, 예를 들면 다음과 같습니다. <entryPoint xmlns="urn:schemas- microsoft-com:asm.v2"> <co.v1:customHostSpecified /> </entryPoint> 다음 단계에 따라 응용 프로그램 매니페스트에 DLL 종속성을 추가할 수 있습니다.
|
ErrorReportUrl |
선택적 [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입니다. |
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입니다. 이 매개 변수는 Install 및 UpdateEnabled 매개 변수의 값이 모두 true인 경우에만 적용됩니다. |
UpdateMode |
선택적 String 매개 변수입니다. 응용 프로그램을 시작하기 전에 포그라운드에서 업데이트를 검사할지 응용 프로그램 실행 중에 백그라운드에서 업데이트를 검사할지 여부를 지정합니다. 이 매개 변수는 다음 값을 가질 수 있습니다.
이 매개 변수의 기본값은 Background입니다. 이 매개 변수는 Install 및 UpdateEnabled 매개 변수의 값이 모두 true인 경우에만 적용됩니다. |
UpdateUnit |
선택적 String 매개 변수입니다. UpdateInterval 매개 변수의 단위를 지정합니다. 이 매개 변수는 다음 값을 가질 수 있습니다.
이 매개 변수는 Install 및 UpdateEnabled 매개 변수의 값이 모두 true인 경우에만 적용됩니다. |
설명
위에 나열된 매개 변수 외에도 이 작업은 Task 클래스에서 상속하는 GenerateManifest 클래스의 매개 변수를 상속합니다. 작업 클래스의 매개 변수 목록을 보려면 작업 기본 클래스를 참조하십시오.
참고 항목
참조
GenerateApplicationManifest 작업