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 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. En Visual Studio 2005, la tarea GenerateApplicationManifest (Tarea) requería 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 exigía 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:
|
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 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 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 la 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á 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:
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 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 utiliza 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:
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:
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
Referencia
GenerateApplicationManifest (Tarea)