GenerateDeploymentManifest 작업GenerateDeploymentManifest Task

ClickOnceClickOnce 배포 매니페스트를 생성합니다.Generates a ClickOnceClickOnce deployment manifest. ClickOnceClickOnce 배포 매니페스트는 배포에 대한 고유한 ID를 정의하고, 설치 또는 온라인 모드와 같은 배포 특성을 식별하고, 응용 프로그램 업데이트 설정 및 업데이트 위치를 지정하고, 해당 ClickOnceClickOnce 응용 프로그램 매니페스트를 지정하여 응용 프로그램의 배포를 설명합니다.A ClickOnceClickOnce deployment manifest describes the deployment of an application by defining a unique identity for the deployment, identifying deployment traits such as install or online mode, specifying application update settings and update locations, and indicating the corresponding ClickOnceClickOnce application manifest.

매개 변수Parameters

다음 표에서는 GenerateDeploymentManifest 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters for the GenerateDeploymentManifest task.

매개 변수Parameter 설명Description
AssemblyName 선택적 String 매개 변수입니다.Optional String parameter.

생성된 매니페스트에 대한 어셈블리 ID의 Name 필드를 지정합니다.Specifies the Name field of the assembly identity for the generated manifest. 이 매개 변수를 지정하지 않으면 이름은 EntryPoint 또는 InputManifest 매개 변수에서 유추됩니다.If this parameter is not specified, the name is inferred from the EntryPoint or InputManifest parameters. 이름을 유추할 수 없으면 작업에서 오류가 throw됩니다.If the name cannot be inferred, the task throws an error.
AssemblyVersion 선택적 String 매개 변수입니다.Optional String parameter.

생성된 매니페스트에 대한 어셈블리 ID의 Version 필드를 지정합니다.Specifies the Version field of the assembly identity for the generated manifest. 이 매개 변수를 지정하지 않으면 작업은 "1.0.0.0" 값을 사용합니다.If this parameter is not specified, the task uses the value "1.0.0.0".
CreateDesktopShortcut 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true이면 ClickOnce 응용 프로그램 설치 동안 아이콘이 바탕 화면에 만들어집니다.If true, an icon is created on the desktop during ClickOnce application installation.
DeploymentUrl 선택적 String 매개 변수입니다.Optional String parameter.

응용 프로그램에 대한 업데이트 위치를 지정합니다.Specifies the update location for the application. 이 매개 변수를 지정하지 않으면 응용 프로그램에 대한 업데이트 위치가 정의되지 않습니다.If this parameter is not specified, no update location is defined for the application. 그러나 UpdateEnabled 매개 변수가 true이면 업데이트 위치를 지정해야 합니다.However, if the UpdateEnabled parameter is true, the update location must be specified. 지정된 값은 정규화된 URL 또는 UNC 경로여야 합니다.The specified value should be a fully qualified URL or UNC path.
Description 선택적 String 매개 변수입니다.Optional String parameter.

응용 프로그램에 대한 선택적 설명을 지정합니다.Specifies an optional description for the application.
DisallowUrlActivation 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

응용 프로그램이 URL을 통해 열릴 때 자동으로 실행되어야 하는지 여부를 지정합니다.Specifies whether the application should be run automatically when it is opened through a URL. 이 매개 변수가 true이면 응용 프로그램을 시작 메뉴에서만 시작할 수 있습니다.If this parameter is true, the application can only be started from the Start menu. 이 매개 변수의 기본값은 false입니다.The default value of this parameter is false. 이 입력은 Install 매개 변수 값이 true일 때만 적용됩니다.This input applies only when the Install parameter value is true.
EntryPoint 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

생성된 매니페스트 어셈블리에 대한 진입점을 나타냅니다.Indicates the entry point for the generated manifest assembly. ClickOnceClickOnce 배포 매니페스트의 경우 이 입력은 ClickOnceClickOnce 응용 프로그램 매니페스트를 지정합니다.For a ClickOnceClickOnce deployment manifest, this input specifies the ClickOnceClickOnce application manifest.

Visual Studio 2005Visual Studio 2005에서 GenerateApplicationManifest 작업에는 응용 프로그램 매니페스트를 생성하기 위해 EntryPoint가 필요합니다.In Visual Studio 2005Visual Studio 2005, the GenerateApplicationManifest Task required an EntryPoint to generate an application manifest. (어셈블리 또는 네이티브 매니페스트에는 EntryPoint가 필요 하지 않습니다.) 이 요구 사항은 빌드 오류 "MSB3185: 매니페스트에 EntryPoint를 지정하지 않았습니다."를 나타내며 적용되었습니다.(Assembly or native manifests do not require an EntryPoint.) This requirement was enforced with the build error: "MSB3185: EntryPoint not specified for manifest."

MSBuildMSBuildEntryPoint 작업 매개 변수가 지정되지 않을 경우 이 오류를 발생하지 않습니다. does not issue this error when the EntryPoint task parameter is not specified. 대신 <customHostSpecified> 태그는 <entryPoint> 태그의 자식으로 삽입되며, 예를 들면 다음과 같습니다.Instead, the <customHostSpecified> tag is inserted as a child of the <entryPoint> tag, for example:

<entryPoint xmlns="urn:schemas-

microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

다음 단계를 사용하여 응용 프로그램 매니페스트에 DLL 종속성을 추가할 수 있습니다.You can add DLL dependencies to the application manifest by using the following steps:

1. ResolveAssemblyReference를 호출하여 어셈블리 참조를 확인합니다.1. Resolve the assembly references with a call to ResolveAssemblyReference.
2. 이전 작업의 출력 및 어셈블리 자체를 ResolveManifestFiles에 전달합니다.2. Pass the output of the previous task and the assembly itself to ResolveManifestFiles.
3. Dependencies 매개 변수를 사용하여 GenerateApplicationManifest에 종속성을 전달합니다.3. Pass the dependencies by using the Dependencies parameter to GenerateApplicationManifest.
ErrorReportUrl 선택적 System.String 매개 변수입니다.Optional System.String parameter.

ClickOnce 설치 중에 대화 상자에 표시되는 웹 페이지의 URL을 지정합니다.Specifies the URL of the Web page that is displayed in dialog boxes during ClickOnce installations.
InputManifest 선택적 ITaskItem 매개 변수입니다.Optional ITaskItem parameter.

매니페스트 생성기에 대한 기본으로 사용되는 입력 XML 문서를 나타냅니다.Indicates an input XML document to serve as a base for the manifest generator. 이를 통해 사용자 지정 매니페스트 정의와 같은 구조화된 데이터가 출력 매니페스트에 반영될 수 있습니다.This enables structured data, such as custom manifest definitions, to be reflected in the output manifest. XML 문서의 루트 요소는 asmv1 네임스페이스의 어셈블리 노드여야 합니다.The root element in the XML document must be an assembly node in the asmv1 namespace.
Install 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

응용 프로그램이 설치된 응용 프로그램인지 아니면 온라인 전용 응용 프로그램인지 여부를 지정합니다.Specifies whether the application is an installed application or an online-only application. 이 매개 변수가 true이면 응용 프로그램은 사용자의 [시작] 메뉴에 설치되며 [프로그램 추가/제거] 대화 상자를 사용하여 제거할 수 있습니다.If this parameter is true, the application will be installed on the user's Start menu, and can be removed by using the Add or Remove Programs dialog box. 이 매개 변수가 false이면 응용 프로그램을 웹 페이지에서 온라인으로 사용해야 합니다.If this parameter is false, the application is intended for online use from a Web page. 이 매개 변수의 기본값은 true입니다.The default value of this parameter is true.
MapFileExtensions 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

.deploy 파일 이름 확장명 매핑이 사용되는지 여부를 지정합니다.Specifies whether the .deploy file name extension mapping is used. 이 매개 변수가 true이면 모든 프로그램 파일이 .deploy 파일 이름 확장명을 사용하여 게시됩니다.If this parameter is true, every program file is published with a .deploy file name extension. 이 옵션은 웹 서버 보안에서 ClickOnceClickOnce 응용 프로그램 배포를 사용하도록 설정하기 위해 차단을 해제해야 하는 파일 이름 확장명의 수를 제한하는 데 유용합니다.This option is useful for Web server security to limit the number of file name extensions that must be unblocked to enable ClickOnceClickOnce application deployment. 이 매개 변수의 기본값은 false입니다.The default value of this parameter is false.
MaxTargetPath 선택적 String 매개 변수입니다.Optional String parameter.

ClickOnceClickOnce 응용 프로그램 배포에서 파일 경로의 최대 허용 길이를 지정합니다.Specifies the maximum allowed length of a file path in a ClickOnceClickOnce application deployment. 이 매개 변수를 지정하는 경우 응용 프로그램에서 각 파일 경로의 길이가 이 제한에 대해 확인됩니다.If this parameter is specified, the length of each file path in the application is checked against this limit. 한도를 초과하는 항목에서는 빌드 경고가 발생합니다.Any items that exceed the limit will cause a build warning. 이 입력이 지정되지 않거나 0으로 지정된 경우 검사가 수행되지 않습니다.If this input is not specified or is zero, no checking is performed.
MinimumRequiredVersion 선택적 String 매개 변수입니다.Optional String parameter.

사용자가 업데이트를 건너뛸 수 있는지 여부를 지정합니다.Specifies whether the user can skip the update. 사용자가 필요한 최소 버전보다 낮은 버전을 보유하고 있으면 업데이트를 건너뛸 수 있는 옵션이 제공되지 않습니다.If the user has a version that is less than the minimum required, he will not have the option to skip the update. 이 입력은 Install 매개 변수의 값이 true일 때만 적용됩니다.This input only applies when the value of the Install parameter is true.
OutputManifest 선택적 ITaskItem 매개 변수입니다.Optional ITaskItem parameter.

생성된 출력 매니페스트 파일의 이름을 지정합니다.Specifies the name of the generated output manifest file. 이 매개 변수를 지정하지 않으면 출력 파일의 이름이 생성된 매니페스트의 ID에서 유추됩니다.If this parameter is not specified, the name of the output file is inferred from the identity of the generated manifest.
Platform 선택적 String 매개 변수입니다.Optional String parameter.

응용 프로그램의 대상 플랫폼을 지정합니다.Specifies the target platform of the application. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.This parameter can have the following values:

- AnyCPU
- x86
- x64
- Itanium

기본값은 AnyCPU입니다.The default value is AnyCPU.
Product 선택적 String 매개 변수입니다.Optional String parameter.

응용 프로그램의 이름을 지정합니다.Specifies the name of the application. 이 매개 변수를 지정하지 않으면 이름이 생성된 매니페스트의 ID에서 유추됩니다.If this parameter is not specified, the name is inferred from the identity of the generated manifest. 이 이름은 시작 메뉴의 바로 가기 이름에 사용되고 프로그램 추가/제거 대화 상자에 표시되는 이름의 일부입니다.This name is used for the shortcut name on the Start menu and is part of the name that appears in the Add or Remove Programs dialog box.
Publisher 선택적 String 매개 변수입니다.Optional String parameter.

응용 프로그램의 게시자를 지정합니다.Specifies the publisher of the application. 이 매개 변수를 지정하지 않으면 이름이 등록된 사용자 또는 생성된 매니페스트의 ID에서 유추됩니다.If this parameter is not specified, the name is inferred from the registered user, or the identity of the generated manifest. 이 이름은 시작 메뉴의 폴더 이름에 사용되고 프로그램 추가/제거 대화 상자에 표시되는 이름의 일부입니다.This name is used for the folder name on the Start menu and is part of the name that appears in the Add or Remove Programs dialog box.
SuiteNamel 선택적 String 매개 변수입니다.Optional String parameter.

ClickOnce 배포 후에 응용 프로그램이 위치할 시작 메뉴의 폴더 이름을 지정합니다.Specifies the name of the folder on the Start menu where the application is located after ClickOnce deployment.
SupportUrl 선택적 String 매개 변수입니다.Optional String parameter.

응용 프로그램에 대한 프로그램 추가/제거 대화 상자에 표시되는 링크를 지정합니다.Specifies the link that appears in the Add or Remove Programs dialog box for the application. 지정된 값은 정규화된 URL 또는 UNC 경로여야 합니다.The specified value should be a fully qualified URL or UNC path.
TargetCulture 선택적 String 매개 변수입니다.Optional String parameter.

응용 프로그램의 문화권을 식별하고 생성된 매니페스트에 대한 어셈블리 ID의 Language 필드를 지정합니다.Identifies the culture of the application, and specifies the Language field of the assembly identity for the generated manifest. 이 매개 변수를 지정하지 않으면 응용 프로그램은 문화권이 고정되어 있다고 가정합니다.If this parameter is not specified, it is assumed that the application is culture invariant.
TrustUrlParameters 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

URL 쿼리 문자열 매개 변수를 응용 프로그램에 사용할 수 있게 해야 할지 여부를 지정합니다.Specifies whether URL query-string parameters should be made available to the application. 이 매개 변수의 기본값은 해당 매개 변수를 응용 프로그램에 사용할 수 없음을 나타내는 false입니다.The default value of this parameter is false, which indicates that parameters will not be available to the application.
UpdateEnabled 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

응용 프로그램을 업데이트할 수 있는지 여부를 나타냅니다.Indicates whether the application is enabled for updates. 이 매개 변수의 기본값은 false입니다.The default value of this parameter is false. 이 매개 변수는 Install 매개 변수의 값이 true일 때만 적용됩니다.This parameter only applies when the value of the Install parameter is true.
UpdateInterval 선택적 Int32 매개 변수입니다.Optional Int32 parameter.

응용 프로그램에 대한 업데이트 간격을 지정합니다.Specifies the update interval for the application. 이 매개 변수의 기본값은 0입니다.The default value of this parameter is zero. 이 매개 변수는 InstallUpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다.This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.
UpdateMode 선택적 String 매개 변수입니다.Optional String parameter.

업데이트를 응용 프로그램이 시작되기 전에 포그라운드에서 확인해야 하는지 아니면 응용 프로그램이 실행되는 동안 백그라운드에서 확인해야 하는지 여부를 지정합니다.Specifies whether updates should be checked in the foreground before the application is started, or in the background as the application is running. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.This parameter can have the following values:

- Foreground
- Background

이 매개 변수의 기본값은 Background입니다.The default value of this parameter is Background. 이 매개 변수는 InstallUpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다.This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.
UpdateUnit 선택적 String 매개 변수입니다.Optional String parameter.

UpdateInterval 매개 변수의 단위를 지정합니다.Specifies the units for the UpdateInterval parameter. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.This parameter can have the following values:

- Hours
- Days
- Weeks

이 매개 변수는 InstallUpdateEnabled 매개 변수의 값이 모두 true일 때만 적용됩니다.This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.

설명Remarks

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 GenerateManifestBase 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the GenerateManifestBase class, which itself inherits from the Task class. Task 클래스의 매개 변수 목록에 대해서는 Task 기본 클래스를 참조하세요.For a list of the parameters of the Task class, see Task Base Class.

참고 항목See Also

작업 Tasks
GenerateApplicationManifest 작업 GenerateApplicationManifest Task
SignFile 작업 SignFile Task
작업 참조Task Reference