GenerateDeploymentManifest 작업
ClickOnce 배포 매니페스트를 생성합니다. ClickOnce 배포 매니페스트는 배포의 고유한 ID를 정의하고, 설치 또는 온라인 모드와 같은 배포 특성을 식별하고, 애플리케이션 업데이트 설정 및 업데이트 위치를 지정하고, 해당 ClickOnce 애플리케이션 매니페스트를 지정하여 애플리케이션의 배포를 설명합니다.
매개 변수
다음 표에서는 GenerateDeploymentManifest 작업의 매개 변수에 대해 설명합니다.
| 매개 변수 | Description |
|---|---|
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 애플리케이션 매니페스트를 지정합니다. 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입니다. 이 매개 변수는 Install 및 UpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다. |
UpdateMode |
선택적 String 매개 변수입니다.업데이트를 애플리케이션이 시작되기 전에 포그라운드에서 확인해야 하는지 아니면 애플리케이션이 실행되는 동안 백그라운드에서 확인해야 하는지 여부를 지정합니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다. - Foreground- Background이 매개 변수의 기본값은 Background입니다. 이 매개 변수는 Install 및 UpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다. |
UpdateUnit |
선택적 String 매개 변수입니다.UpdateInterval 매개 변수의 단위를 지정합니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.- Hours- Days- Weeks이 매개 변수는 Install 및 UpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다. |
설명
이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 GenerateManifestBase 클래스의 매개 변수도 상속합니다. Task 클래스의 매개 변수 목록에 대해서는 Task 기본 클래스를 참조하세요.