Tutorial: Implementar manualmente una aplicación ClickOnce

Artículo
10/07/2008

Actualización: noviembre 2007

En este tutorial se describen los pasos necesarios para crear una implementación completa de ClickOnce utilizando la versión de línea de comandos o la versión gráfica de la herramienta de generación y edición de manifiestos (Mage).

Si no utiliza Visual Studio de forma habitual, si necesita automatizar el proceso de implementación o si necesita utilizar características avanzadas de implementación como la implementación de aplicaciones de confianza, debería utilizar la herramienta de línea de comandos Mage.exe para crear los manifiestos de ClickOnce. El siguiente tutorial le guiará a lo largo de todos los pasos necesarios para generar una implementación completa de ClickOnce utilizando la versión de línea de comandos (Mage.exe) o la versión de formularios Windows Forms (MageUI.exe) de la herramienta de generación y edición de manifiestos.

Requisitos previos

Este tutorial se ha redactado teniendo en cuenta que el usuario tiene una aplicación de Windows Forms que se dispone a implementar. Se hará referencia a dicha aplicación con el nombre WindowsFormsApp1. También debe instalar Kit de desarrollo de software de Windows (SDK).

Hay varias cuestiones que necesita decidir antes de generar una implementación. Lo primero y más importante es cómo distribuirá la implementación: en el Web, desde un recurso compartido de archivos o instalada desde un CD. Para obtener más información, vea Información general sobre la implementación de ClickOnce.

A continuación necesita determinar si la aplicación se ejecutará con un nivel elevado de confianza. Como se describe en Información general sobre la implementación de aplicaciones de confianza, las aplicaciones ClickOnce se ejecutarán de manera predeterminada en modo de confianza parcial, y los permisos correspondientes se determinarán en función de si las aplicaciones están hospedadas en una Intranet o se ejecutan desde Internet. Si una aplicación necesita tener acceso a datos en el equipo cliente, comunicarse con dispositivos locales, llamar a funciones Windows API, o realizar operaciones potencialmente peligrosas, tendrá que confirmar un mayor nivel de confianza. Si la aplicación requiere Plena confianza, por ejemplo, acceso total al sistema del usuario, puede utilizar Mage.exe para establecer fácilmente dicha configuración. Si desea definir un conjunto de permisos personalizados para la aplicación, puede copiar la sección de permisos de Internet o Intranet de otro manifiesto, modificarlo para ajustarlo a sus necesidades y agregarlo al manifiesto de la aplicación utilizando un editor de texto o MageUI.exe.

Los dos métodos para confirmar un nivel de confianza superior en un manifiesto de ClickOnce son la elevación de permisos y la implementación de aplicaciones de confianza. En ambos casos, deberá firmar la implementación con un certificado Authenticode generado mediante la herramienta MakeCert.exe, o bien obtenido por una entidad de certificación (CA). Si decide utilizar la implementación de aplicaciones de confianza, también tendrá que realizar una instalación única del certificado en todos los equipos cliente. Para obtener más información, vea Información general sobre la implementación de aplicaciones de confianza.

Para implementar una aplicación con la herramienta de línea de comandos Mage.exe

Abra un símbolo del sistema de Windows SDK y cambie al directorio en el que va a guardar los archivos de ClickOnce.
Cree un directorio con el nombre de la versión actual de la implementación. Si es la primera vez que está implementando la aplicación, probablemente elegirá 1.0.0.0.

Nota:

La versión de la implementación puede ser distinta de la versión de los archivos de aplicación.
Cree un subdirectorio de esa carpeta denominado bin y sitúe allí todos sus archivos de aplicación, incluidos los archivos ejecutables, ensamblados, recursos y archivos de datos.

Nota:
La versión de la implementación puede ser distinta de la versión de los archivos de aplicación.

Genere el manifiesto de aplicación con una llamada a Mage.exe:

mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin

Firme el manifiesto de aplicación con el certificado digital:

mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx

Genere el manifiesto de implementación con una llamada a Mage.exe. De forma predeterminada, Mage.exe marcará la implementación ClickOnce como una aplicación instalada, para que se pueda ejecutar tanto en línea como fuera de línea. Para establecer que la aplicación esté disponible sólo cuando el usuario está en línea, utilice el indicador -i con un valor de f. Si utiliza el valor predeterminado, y los usuarios instalan la aplicación desde un sitio Web o un recurso compartido de archivos, asegúrese de que el valor del indicador -providerUrl apunta a la ubicación del manifiesto de aplicación en el servidor Web o recurso compartido de archivos.
```
mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest -providerUrl http://www.adatum.com/WindowsFormsApp1/WindowsFormsApp1.application
```

Firme el manifiesto de implementación con el certificado:

mage -Sign WindowsFormsApp1.application -CertFile mycert.pfx

Copie todos los archivos del directorio actual, incluidas la carpeta de versión y la carpeta \bin, al destino de implementación. Puede ser una carpeta en un sitio Web o sitio FTP, un recurso compartido de archivos o un CD.
Proporcione a sus usuarios la dirección URL, UNC o los medios de comunicación físicos necesarios para instalar la aplicación. Si está proporcionando una dirección URL o UNC, debe darles la ruta de acceso completa al manifiesto de implementación. Por ejemplo, si WindowsFormsApp1 se implementa en http://webserver01/ en el directorio WindowsFormsApp1, la ruta de acceso completa de la dirección URL sería http://webserver01/WindowsFormsApp1/WindowsFormsApp1.deploy.

Implementar la aplicación con la herramienta gráfica MageUI.exe

Abra un símbolo del sistema de Windows SDK y navegue al directorio en el que va a guardar los archivos de ClickOnce.
Cree un subdirectorio denominado bin y coloque en el mismo todos sus archivos de aplicación, incluidos los archivos ejecutables, ensamblados, recursos y archivos de datos.
Cree un subdirectorio con el nombre de la versión actual de la implementación. Si es la primera vez que está implementando la aplicación, probablemente elegirá 1.0.0.0.

Nota:

La versión de la implementación puede ser distinta de la versión de los archivos de aplicación.
Mueva el directorio \bin al directorio creado en el paso 2 y, a continuación, inicie la herramienta gráfica:
```
MageUI.exe
```
Cree un nuevo manifiesto de aplicación seleccionando Archivo, Nuevo, Manifiesto de la aplicación en el menú.
En la ficha Nombre predeterminada, escriba el nombre y el número de versión de esta implementación.
Seleccione la ficha Archivos y haga clic en el botón Examinar... junto al cuadro de texto Directorio de la aplicación.
Seleccione el directorio que contiene los archivos de aplicación que creó en el paso 2 y haga clic en Aceptar en el cuadro de diálogo de selección de la carpeta.
Haga clic en el botón Rellenar para agregar todos sus archivos de aplicación a la lista de archivos. Si la aplicación contiene más de un archivo ejecutable, marque el archivo ejecutable principal de esta implementación como la aplicación de inicio seleccionando Punto de entrada en la lista desplegable Tipo de archivo. (Si sólo contiene un archivo ejecutable, MageUI.exe lo marcará para usted.)
Seleccione la ficha Permisos necesarios y seleccione el nivel de confianza que la aplicación necesita afirmar. El valor predeterminado es Plena confianza, adecuado para la mayoría de las aplicaciones.
Seleccione Archivo, Guardar en el menú, y guarde el manifiesto de aplicación. Se le solicitará que firme el manifiesto de aplicación al guardarlo.
Si tiene un certificado almacenado como un archivo en el sistema de archivos, utilice la opción Firmar como archivo de certificados y seleccione el certificado en el sistema de archivos utilizando el botón ....

O bien,

Si el certificado se guarda en un almacén de certificados accesible desde el equipo, seleccione la opción Firmar con certificado almacenado y luego seleccione el certificado en la lista suministrada.
Seleccione Archivo, Nuevo, Manifiesto de implementación en el menú para crear el manifiesto de implementación, y en la ficha Nombre, especifique un nombre y un número de versión (en este ejemplo 1.0.0.0).
Seleccione la ficha Editor y proporcione los valores de Editor y Producto. (Producto es el nombre dado a la aplicación en el menú Inicio de Windows cuando instala la aplicación localmente.)
Cambie a la ficha Actualizar y especifique la frecuencia de actualización de esta aplicación. Si la aplicación utiliza la API de implementación de ClickOnce para comprobar las actualizaciones, desactive la casilla Esta aplicación debe buscar actualizaciones.
Vaya a la ficha Referencia de la aplicación. Se pueden rellenar previamente todos los valores de esta ficha haciendo clic en el botón Seleccionar manifiesto y seleccionando el manifiesto de aplicación que ha creado en los pasos anteriores.
Elija Guardar y guarde el manifiesto de implementación en el disco. Se le solicitará que firme el manifiesto de aplicación al guardarlo.
Si tiene un certificado almacenado como un archivo en el sistema de archivos, utilice la opción Firmar como archivo de certificados y seleccione el certificado en el sistema de archivos utilizando el botón ....

O bien,

Si el certificado se guarda en un almacén de certificados accesible desde el equipo, seleccione la opción Firmar con certificado almacenado y luego seleccione el certificado en la lista suministrada.
Copie todos los archivos del directorio actual, incluidas la carpeta de versión y la carpeta \bin, en el destino de implementación. Puede ser una carpeta en un sitio Web o sitio FTP, un recurso compartido de archivos o un CD.
Proporcione a sus usuarios la dirección URL, UNC o los medios de comunicación físicos necesarios para instalar la aplicación. Si está proporcionando una dirección URL o UNC, debe darles la ruta de acceso completa al manifiesto de implementación. Por ejemplo, si WindowsFormsApp1 se implementa en http://webserver01/ en el directorio WindowsFormsApp1, la ruta de acceso completa de la dirección URL sería http://webserver01/WindowsFormsApp1/WindowsFormsApp1.deploy.

Nota:
La versión de la implementación puede ser distinta de la versión de los archivos de aplicación.

Pasos siguientes

Cuando necesite implementar una nueva versión de la aplicación, tendrá que crear un nuevo directorio con el nombre de la nueva versión, por ejemplo, 1.1.0.0, y mover los nuevos archivos de aplicación a una carpeta \bin situada en dicho directorio. Deberá generar un nuevo manifiesto de aplicación, almacenarlo en el nuevo directorio y solicitar al editor que lo firme. Cuando reciba el manifiesto firmado, podrá utilizar Mage.exe para actualizar el manifiesto de implementación y señalar el nuevo manifiesto de aplicación:

mage -Update WindowsFormsApp1.application -Version 1.1.0.0 -AppManifest 1.1.0.0\WindowsFormsApp1.exe.manifest

Los usuarios de MageUI.exe pueden realizar la misma operación abriendo el manifiesto de implementación, seleccionando la ficha Referencia de la aplicación y seleccionando de nuevo el botón Seleccionar manifiesto.

Una vez actualizada la referencia del manifiesto de aplicación, tendrá que volver a firmar el manifiesto de implementación, ya que al realizar cualquier cambio en un manifiesto se invalida la firma digital.