Tutorial: Implementar una aplicación basada en Windows

Artículo
08/10/2011

Este tutorial muestra el proceso de creación de un instalador para una aplicación basada en Windows que inicia el Bloc de notas. En este tutorial, creará la aplicación basada en Windows. A continuación, creará un instalador que establezca los accesos directos y las asociaciones de archivos, agregue una entrada al Registro, muestre cuadros de diálogo personalizados y compruebe la versión de Internet Explorer durante la instalación.

Si crea sus propios instaladores, no será necesario que realice algunos de estos pasos. El propósito de este tutorial es presentar algunas de las capacidades opcionales de implementación que pueden resultar útiles. Para crear un instalador básico, complete los primeros cuatro grupos de procedimientos.

Nota

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio.

Nota

Las instrucciones siguientes muestran cómo crear un proyecto de implementación utilizando un proyecto Visual Basic. Los principios generales se aplican a todos los proyectos de lenguajes de Visual Studio que admiten la implementación de aplicaciones basadas en Windows.

Creación e implementación de aplicaciones básicas

Para crear una aplicación basada en Windows

En el menú Archivo, haga clic en Nuevo proyecto.
En el cuadro de diálogo Nuevo proyecto, en el panel Tipos de proyecto, seleccione Visual Basic y, a continuación, haga clic en Aplicación para Windows en el panel Plantillas. En el cuadro Nombre, escriba My Notepad.
Haga clic en Aceptar para cerrar el cuadro de diálogo.

El proyecto se agregará al Explorador de soluciones y se abrirá el Diseñador de Windows Forms.
Seleccione la ficha Todos los formularios Windows Forms en el Cuadro de herramientas y arrastre un control Button al formulario.
Haga doble clic en el control Button para agregar un controlador de eventos para el botón. En el controlador de evento, agregue el código siguiente:
```
Shell("Notepad.exe", AppWinStyle.NormalFocus)
```
Esto hará que el programa Notepad.exe se inicie y obtenga el foco.
En el menú Generar, haga clic en Generar My Notepad para generar la aplicación.

Para crear un proyecto de implementación

En el menú Archivo, elija Agregar y, después, haga clic en Nuevo proyecto.
En el cuadro de diálogo Agregar nuevo proyecto, en el recuadro Tipos de proyecto, abra el nodo Otros tipos de proyectos, haga clic en Proyectos de instalación e implementación, haga clic en Instalador de Visual Studio y, a continuación, en Proyecto de instalación. En el cuadro Nombre, escriba Instalador de My Notepad.
Haga clic en Aceptar para cerrar el cuadro de diálogo.

El proyecto se agregará al Explorador de soluciones y se abrirá el Editor del sistema de archivos.
Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En la ventana Propiedades, seleccione la propiedad ProductName y escriba My Notepad.

Nota

El valor de la propiedad ProductName especifica el nombre que se mostrará para la aplicación en los nombres de carpeta y en el cuadro de diálogo Agregar o quitar programas.

Para agregar la aplicación basada en Windows al instalador

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el Editor del sistema de archivos, haga clic con el botón secundario en el nodo Carpeta de la aplicación.
En el menú Proyecto, elija Agregar y después haga clic en Resultados del proyecto.
En el cuadro de diálogo Agregar grupo de resultados del proyecto, seleccione My Notepad en la lista Proyecto.
Seleccione el grupo Resultado principal de la lista. En el cuadro Configuración, seleccione (Activo). Haga clic en Aceptar para cerrar el cuadro de diálogo.
En el menú Generar, haga clic en Generar Instalador de My Notepad.

Para implementar la aplicación (instalador básico)

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Proyecto, haga clic en Instalar.

Esto hará que se ejecute el instalador (Asistente para proyectos de instalación) e instalará My Notepad en el equipo de desarrollo.

Nota

Debe tener permisos de instalación en el equipo para poder ejecutar el instalador.

Capacidades de implementación opcionales

En este paso se muestran capacidades de implementación adicionales y se crea un acceso directo a la aplicación en el escritorio de del equipo de destino durante la instalación.

Para crear los accesos directos de la aplicación basada en Windows

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones.
En el Editor del sistema de archivos, seleccione el nodo Resultado principal desde My Notepad.
En el menú Acción, haga clic en Crear acceso directo al resultado principal de My Notepad.

De esta forma, se agregará un nodo denominado Acceso directo a Resultado principal de My Notepad.
Cambie el nombre del acceso directo a Acceso directo a My Notepad.
Seleccione Acceso directo a My Notepad y arrástrelo a la carpeta Escritorio del usuario, en el panel de la izquierda.

Crear una asociación de archivo

En este paso, se agrega una asociación de archivo para My Notepad de modo que, al hacer doble clic en los archivos .vbn, se abra la aplicación My Notepad.

Para crear la asociación de archivos de la aplicación basada en Windows

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Ver, seleccione Editor y, a continuación, haga clic en Tipos de archivo. Aparece el Editor de tipos de archivos.
En el Editor de tipos de archivos, seleccione el nodo Tipos de archivo en el equipo de destino. En el menú Acción, haga clic en Agregar tipo de archivo.

Se agrega un nodo denominado Nuevo tipo de documento #1 que queda abierto para cambiar el nombre.
Cambie el nombre de Nuevo tipo de documento #1 por Vbn.doc.
En la ventana Propiedades, establezca la propiedad Extensions del tipo de archivo en vbn.
Seleccione la propiedad Command y haga clic en el botón de puntos suspensivos (...). En el cuadro de diálogo Seleccionar elemento en el proyecto, navegue a la Carpeta de la aplicación y seleccione Resultado principal desde My Notepad.
Haga clic en Aceptar para cerrar el cuadro de diálogo.

Agregar una entrada del Registro

Este paso permite agregar una clave y un valor al Registro. Se puede hacer referencia a esta clave del Registro desde el código de la aplicación para recuperar información específica de usuario en tiempo de ejecución.

Para agregar una entrada del Registro de la aplicación basada en Windows

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Ver, seleccione Editor y, a continuación, haga clic en Registro. Aparece el Editor del Registro.
En el Editor del Registro, seleccione el nodo HKEY_CURRENT_USER y expándalo, a continuación, expanda el nodo Software y seleccione el nodo [Manufacturer].

Nota

El nodo [Manufacturer]aparece entre corchetes para indicar que se trata de una propiedad. Será reemplazado por el valor especificado para la propiedad Manufacturer del proyecto de implementación.
En el menú Acción, elija Nueva y después haga clic en Clave.
Cambie el nombre de la clave UserChoice y selecciónela.
En el menú Acción, elija Nueva y, a continuación, haga clic en Valor de cadena.
Cambie el nombre del valor de la cadena TextColor.
En la ventana Propiedades, seleccione la propiedad Value y escriba Black.

Agregar un cuadro de diálogo de instalación personalizado

En este paso se agrega y se configura un cuadro de diálogo de interfaz de usuario personalizado que se mostrará durante la instalación.

Para agregar un cuadro de diálogo de instalación personalizado

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Ver, seleccione Editor y, a continuación, haga clic en Interfaz de usuario. Aparece el Editor de la interfaz de usuario.
En el Editor de la interfaz de usuario, seleccione el nodo Iniciar (bajo el nodo Instalar).
En el menú Acción, haga clic en Agregar cuadro de diálogo.
En el cuadro de diálogo Agregar cuadro de diálogo, seleccione Casillas (A).
Haga clic en Aceptar para cerrar el cuadro de diálogo.
Haga clic con el botón secundario en el cuadro de diálogo Casillas (A) y seleccione dos veces Subir para colocarlo sobre el cuadro de diálogo Carpeta de instalación.
En la ventana Propiedades, establezca la propiedad BannerText en Samples.
Establezca la propiedad BodyText del modo siguiente.

La casilla Instalar ejemplos controla si se instalan los archivos de ejemplo. Si se deja desactivada, los ejemplos no se instalarán.
Establezca la propiedad CheckBox1Label en ¿Instalar ejemplos?
Establezca las propiedades Checkbox2Visible, Checkbox3Visible y Checkbox4Visible en False. Esta operación ocultará las casillas adicionales.

Trabajar con ejemplos

En este paso, se crea una subcarpeta Ejemplos que se instalará bajo la carpeta Aplicación.

Para agregar una carpeta Ejemplos

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Ver, seleccione Editor y, a continuación, haga clic en Sistema de archivos. Seleccione Carpeta de la aplicación si aún no está seleccionada.
Haga clic con el botón secundario en Carpeta de la aplicación, seleccione Agregar y, a continuación, haga clic en Carpeta.
Cambie el nombre de la carpeta Nueva carpeta #1 por Ejemplos.

Este paso permite crear dos archivos de texto de ejemplo que se instalarán si el usuario elige la opción Instalar ejemplos en el cuadro de diálogo personalizado.

Para crear archivos de ejemplo para la aplicación

Con el Bloc de notas u otro editor de texto, cree un archivo de texto que contenga el texto This is rules.vbn. Guárdelo como Rules.vbn.

Nota

Para evitar que el Bloc de notas agregue automáticamente una extensión .txt, seleccione Todos los archivos en la lista Tipo de archivo.
Cree otro archivo de texto que incluya el texto This is memo.vbn. Guárdelo como Memo.vbn.

En este paso, se agregan los archivos de ejemplo a la carpeta Ejemplos, y se establece una condición que determina si los archivos se deben instalar.

Para agregar los ejemplos al instalador

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Ver, seleccione Editor, Sistema de archivos y, a continuación, seleccione la carpeta Ejemplos.
En el menú Acción, seleccione Agregar y, a continuación, haga clic en Archivo. Agregue los archivos Rules.vbn y Memo.vbn Ejemplos.
Seleccione el archivo Rules.vbn en el Editor del sistema de archivos.
En la ventana Propiedades, establezca la propiedad Condition en CHECKBOXA1=1. Al ejecutar el instalador, sólo se instalará el archivo Rules.vbn si está seleccionada la casilla personalizada.
Seleccione el archivo Memo.vbn en el Editor del sistema de archivos.
En la ventana Propiedades, establezca la propiedad Condition en CHECKBOXA1=1. Al ejecutar el instalador, sólo se instalará el archivo Memo.vbn si está seleccionada la casilla personalizada.

Agregar condiciones de inicio

En este paso, se comprueba si en el equipo de destino está instalada la versión 5.0 de Internet Explorer o una versión posterior y se detiene la instalación si no está instalado el archivo.

Para agregar una condición de inicio para comprobar la versión de Internet Explorer

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Ver, elija Editor y, a continuación, haga clic en Condiciones de inicio.

Nota

Este paso está pensado sólo para demostrar el concepto de condiciones de inicio; la aplicación My Notepad no tiene una dependencia real de Internet Explorer.
En el Editor de condiciones de inicio, seleccione el nodo Requisitos del equipo de destino.
En el menú Acción, haga clic en Agregar condición de inicio del archivo.

Se agrega un nodo Buscar archivo1 bajo el nodo Buscar equipo de destino, y se agrega un nodo Condición1 bajo el nodo Condiciones de inicio.
Cambie el nombre de Buscar archivo1 por Buscar Internet Explorer.
En la ventana Propiedades, establezca la propiedad FileName en Iexplore.exe, la propiedad Folder en [ProgramFilesFolder], la propiedad Depth en 2 y la propiedad MinVersion en 5.00.
Seleccione el nodo Condición1.
Establezca la propiedad Message del modo siguiente.

Este programa requiere Microsoft Internet Explorer 5.0 o posterior. Instale Internet Explorer y vuelva a ejecutar el instalador del Bloc de notas.

Establecer propiedades para componentes de requisitos previos

Este paso establece una propiedad para instalar automáticamente .NET Framework si la versión correcta no está presente en el equipo de destino. Observe que el paquete de .NET Framework 2.0 también instalará los archivos de Windows Installer 2.0.

Cuando las propiedades de los requisitos previos se establecen tal y como se indica a continuación, al hacer clic en setup.exe, .NET Framework se instala automáticamente antes de ejecutar el archivo .msi. (Se trata del comportamiento predeterminado.) Para obtener más información acerca de la especificación de requisitos previos, consulte Requisitos previos (Cuadro de diálogo).

Para establecer propiedades opcionales del proyecto de implementación

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Ver, haga clic en Páginas de propiedades.
En el cuadro de diálogo Páginas de propiedades del instalador de My Notepad, en Dirección URL de instalación, especifique la dirección URL de un servidor o sitio Web a partir del cual se van a instalar la aplicación o los requisitos previos. Haga clic en el botón Requisitos previos.
En el cuadro de diálogo Requisitos previos, en Elegir los requisitos previos que se van a instalar, asegúrese de que esté seleccionada la opción .NET Framework. (Debería estar seleccionada de forma predeterminada.) Bajo Especificar la ubicación de instalación de los requisitos previos, acepte la configuración predeterminada.
En el menú Generar, haga clic en Generar Instalador de My Notepad.

Instalar en el equipo de desarrollo

En este paso se ejecuta el instalador y se instala My Notepad en el equipo de desarrollo.

Para instalar My Notepad en el equipo de desarrollo

Seleccione el proyecto Instalador de My Notepad en el Explorador de soluciones. En el menú Proyecto, haga clic en Instalar.

Nota

Debe tener permisos de instalación en el equipo para poder ejecutar el instalador.

Implementar en otro equipo

En este paso se ejecuta el instalador y se instala My Notepad en otro equipo.

Para implementar My Notepad en otro equipo

En el Explorador de Windows, navegue hasta el directorio del proyecto y busque el instalador que se ha compilado. La ruta de acceso predeterminada será \Documents and Settings\suNombreDeInicioDeSesión\Mis documentos\Visual Studio 9.0\Proyectos\Nombre de la carpeta de soluciones\Instalador de My Notepad\configuración de proyecto\My Notepad Installer.msi. (La configuración de proyecto predeterminada es Debug o Release.)
Copie el archivo Instalador de My Notepad.msi, Setup.exe, y todos los demás archivos y subdirectorios en el directorio del otro equipo.

Nota

Para realizar una instalación en un equipo que no esté en red, copie los archivos en un soporte tradicional, como un CD-ROM.
En el equipo de destino, haga doble clic en el archivo Setup.exe para ejecutar el instalador.

Nota

Debe tener los permisos de instalación del equipo de destino para poder ejecutar el instalador.

Pruebas

Este paso probará el inicio de la aplicación desde un acceso directo de escritorio y también probará la desinstalación.

Para probar la instalación

Compruebe que el acceso directo se haya instalado en el escritorio y que inicie correctamente la aplicación My Notepad.
Desinstale la aplicación mediante Agregar o quitar programas, en el Panel de control. En Agregar o quitar programas, seleccione My Notepad y, a continuación, haga clic en el botón Quitar.

Nota

Para desinstalar la aplicación del equipo de desarrollo, en el menú Proyecto, haga clic en Desinstalar.
El icono debería desaparecer del escritorio, y los archivos y carpetas de aplicación instalados se deberían quitar de su equipo.