GenerateDeploymentManifest (tarea)

  • Artículo

Genera un manifiesto de una 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 tabla siguiente 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 solo se puede iniciar desde el menú Inicio. El valor predeterminado de este parámetro es false. Este valor solo 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.

Si no se especifica el parámetro de tarea EntryPoint, la etiqueta <customHostSpecified> se inserta como un elemento secundario de la etiqueta <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 propio ensamblado a ResolveManifestFiles.
3. Pase las dependencias a través del parámetro Dependencies a GenerateApplicationManifest.
ErrorReportUrl Parámetro System.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 el generador de manifiestos. De este modo, los datos estructurados, como las definiciones personalizadas del manifiesto, pueden reflejarse en el manifiesto de salida. El elemento raíz del 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 instala en el menú Inicio del usuario y se puede eliminar mediante el cuadro de diálogo Agregar o quitar programas. Si este parámetro es false, la aplicación está destinada a 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 usa 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 de archivo 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 de ClickOnce. Si se especifica este parámetro, se comprobará si la longitud de cada ruta de archivo de la aplicación rebasa 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 solo 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 usa para el nombre del 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 publicador 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 usa para el nombre de 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 del 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 aplicación es invariable en cuanto a la referencia cultural.
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 solo 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 solo 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 solo 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 solo 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 GenerateManifestBase, que a su vez hereda de la clase Task. Para obtener una lista de los parámetros de la clase Task, vea Task Base (Clase).

Vea también