Compartir a través de


GenerateDeploymentManifest (Tarea)

Genera un manifiesto de implementación de ClickOnce.Un manifiesto de implementación de ClickOnce describe la implementación de una aplicación definiendo una identidad única para la implementación, identificando opciones de la implementación, como el modo de instalación o el modo en línea, especificando la configuración y la ubicación de actualización de la aplicación y señalando el manifiesto de la aplicación ClickOnce correspondiente.

Parámetros

En la siguiente tabla se describen los parámetros de la tarea GenerateDeploymentManifest.

Parámetro

Descripción

AssemblyName

Parámetro String opcional.

Especifica el campo Name de la identidad del ensamblado para el manifiesto generado.Si no se especifica este parámetro, el nombre se deduce de los parámetros EntryPoint o InputManifest.Si no se puede deducir el nombre, la tarea muestra un error.

AssemblyVersion

Parámetro String opcional.

Especifica el campo Version de la identidad del ensamblado para el manifiesto generado.Si no se especifica este parámetro, la tarea utiliza el valor "1.0.0.0".

CreateDesktopShortcut

Parámetro Boolean opcional.

Si es true, se crea un icono en el escritorio durante la instalación de la aplicación ClickOnce.

DeploymentUrl

Parámetro String opcional.

Especifica la ubicación de actualización para la aplicación.Si no se especifica este parámetro, no se definirá ninguna ubicación de actualización para la aplicación.Sin embargo, si el parámetro UpdateEnabled es true, se debe especificar la ubicación de actualización.El valor especificado debe ser una dirección URL o ruta de acceso UNC completa.

Description

Parámetro String opcional.

Especifica una descripción opcional para la aplicación.

DisallowUrlActivation

Parámetro Boolean opcional.

Especifica si la aplicación debe ejecutarse automáticamente cuando se abre mediante una dirección URL.Si este parámetro es true, la aplicación sólo se puede iniciar desde el menú Inicio.El valor predeterminado de este parámetro es false.Este valor sólo se aplica cuando el valor del parámetro Install es true.

EntryPoint

Parámetro ITaskItem[] opcional.

Indica el punto de entrada para el manifiesto del ensamblado generado.En un manifiesto de implementación de ClickOnce, este valor especifica el manifiesto de aplicación de ClickOnce.

En Visual Studio 2005, la tarea GenerateApplicationManifest (Tarea) necesita un parámetro EntryPoint para generar un manifiesto de aplicación.(Los manifiestos de ensamblado o nativos no necesitan el parámetro EntryPoint). Este requisito se exige con el siguiente error de compilación: "MSB3185: No se especificó EntryPoint para el manifiesto".

MSBuild  no emite este error cuando no se especifica el parámetro de tarea EntryPoint.En su lugar, la etiqueta <customHostSpecified> se inserta como etiqueta secundaria de <entryPoint>; por ejemplo:

<entryPoint xmlns="urn:schemas-

microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

Puede agregar dependencias de DLL al manifiesto de aplicación siguiendo estos pasos:

  1. Resuelva las referencias del ensamblado con una llamada a ResolveAssemblyReference.

  2. Pase el resultado de la tarea anterior y el ensamblado propiamente dicho a ResolveManifestFiles.

  3. Pase las dependencias a través del parámetro Dependencies a GenerateApplicationManifest.

ErrorReportUrl

Parámetro [String] opcional.

Especifica la dirección URL de la página web que se muestra en los cuadros de diálogo durante las instalaciones ClickOnce.

InputManifest

Parámetro ITaskItem opcional.

Indica un documento XML de entrada que sirve de base para la generación del manifiesto.De este modo, los datos estructurados, como las definiciones personalizadas del manifiesto, pueden reflejarse en el manifiesto de salida.El elemento raíz en el documento XML debe ser un nodo de ensamblado en el espacio de nombres asmv1.

Install

Parámetro Boolean opcional.

Especifica si la aplicación es una aplicación instalada o se trata de una aplicación que únicamente está disponible en línea.Si este parámetro es true, la aplicación se instalará en el menú Inicio del usuario y se podrá eliminar a través del cuadro de diálogo Agregar o quitar programas.Si este parámetro es false, la aplicación está destinada para su uso en línea desde una página Web.El valor predeterminado de este parámetro es true.

MapFileExtensions

Parámetro Boolean opcional.

Especifica si se utiliza la asignación de extensión de nombre de archivo .deploy.Si este parámetro es true, todos los archivos de programa se publican con una extensión de nombre de archivo .deploy.Esta opción es útil para la seguridad de los servidores web, ya que limita el número de extensiones de nombre que deben desbloquearse para habilitar la implementación de la aplicación ClickOnce.El valor predeterminado de este parámetro es false.

MaxTargetPath

Parámetro String opcional.

Especifica la longitud máxima permitida de la ruta de acceso de un archivo en una implementación de aplicación ClickOnce.Si se especifica este parámetro, se comprobará la longitud de cada ruta de archivo en la aplicación respecto a este límite.Cualquier elemento que supere el límite provocará una advertencia de compilación.Si no se especifica esta entrada o es cero, no se realiza ninguna comprobación.

MinimumRequiredVersion

Parámetro String opcional.

Especifica si el usuario puede omitir la actualización.Si el usuario tiene una versión anterior a la versión mínima requerida, no podrá omitir la actualización.Este valor sólo se aplica cuando el valor del parámetro Install es true.

OutputManifest

Parámetro ITaskItem opcional.

Especifica el nombre del archivo de manifiesto de salida generado.Si no se especifica este parámetro, el nombre del archivo de salida se deduce de la identidad del manifiesto generado.

Platform

Parámetro String opcional.

Especifica la plataforma de destino de la aplicación.Este parámetro puede tener los valores siguientes:

  • AnyCPU

  • x86

  • x64

  • Itanium

El valor predeterminado es AnyCPU.

Product

Parámetro String opcional.

Especifica el nombre de la aplicación.Si no se especifica este parámetro, el nombre se deduce de la identidad del manifiesto generado.Este nombre se utiliza para el acceso directo del menú Inicio y forma parte del nombre que aparece en el cuadro de diálogo Agregar o quitar programas.

Publisher

Parámetro String opcional.

Especifica el editor de la aplicación.Si no se especifica este parámetro, el nombre se deduce del usuario registrado o de la identidad del manifiesto generado.Este nombre se utiliza para la carpeta del menú Inicio y forma parte del nombre que aparece en el cuadro de diálogo Agregar o quitar programas.

SuiteNamel

Parámetro String opcional.

Especifica el nombre de la carpeta en el menú Inicio donde se ubica la aplicación después de la implementación ClickOnce.

SupportUrl

Parámetro String opcional.

Especifica el vínculo que aparece en el cuadro de diálogo Agregar o quitar programas para la aplicación.El valor especificado debe ser una dirección URL o ruta de acceso UNC completa.

TargetCulture

Parámetro String opcional.

Identifica la referencia cultural de la aplicación y especifica el campo Language de la identidad del ensamblado para el manifiesto generado.Si no se especifica este parámetro, se supone que la referencia cultural de la aplicación es la referencia cultural de todos los idiomas.

TrustUrlParameters

Parámetro Boolean opcional.

Especifica si los parámetros de cadena de consulta de dirección URL deben ponerse a disposición de la aplicación.El valor predeterminado de este parámetro es false, lo que indica que los parámetros no estarán disponibles para la aplicación.

UpdateEnabled

Parámetro Boolean opcional.

Indica si se permite actualizar la aplicación.El valor predeterminado de este parámetro es false.Este parámetro sólo se aplica cuando el valor del parámetro Install es true.

UpdateInterval

Parámetro Int32 opcional.

Especifica el intervalo de actualización de la aplicación.El valor predeterminado de este parámetro es cero.Este parámetro sólo se aplica cuando los valores de los parámetros Install y UpdateEnabled son ambos true.

UpdateMode

Parámetro String opcional.

Especifica si las actualizaciones deben comprobarse en primer plano antes de que se inicie la aplicación o en segundo plano mientras la aplicación se está ejecutando.Este parámetro puede tener los valores siguientes:

  • Foreground

  • Background

El valor predeterminado de este parámetro es Background.Este parámetro sólo se aplica cuando los valores de los parámetros Install y UpdateEnabled son ambos true.

UpdateUnit

Parámetro String opcional.

Especifica las unidades del parámetro UpdateInterval.Este parámetro puede tener los valores siguientes:

  • Hours

  • Days

  • Weeks

Este parámetro sólo se aplica cuando los valores de los parámetros Install y UpdateEnabled son ambos true.

Comentarios

Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase GenerateManifest, que hereda de la clase Task.Para obtener una lista de los parámetros de la clase la clase Task, vea Task Base (Clase).

Vea también

Referencia

GenerateApplicationManifest (Tarea)

SignFile (Tarea)

Conceptos

Tareas de MSBuild

Otros recursos

Referencia de tareas de MSBuild