Tutorial: Empaquetar una solución Smart Device para su implementación

  • Artículo

Actualización: noviembre 2007

Este tutorial muestra cómo utilizar Visual Studio para empaquetar una aplicación determinada y sus recursos en un archivo CAB, de modo que se pueda implementar en un dispositivo inteligente de usuario final.

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.

En este tutorial, se comienza por cualquier solución de dispositivo inteligente escrita en Visual Basic, Visual C# o Visual C++. Para obtener más información, vea Tutorial: Crear aplicaciones de Windows Forms para un dispositivo.

Este tutorial muestra cómo hacer lo siguiente:

  • Agregar un proyecto Cab a la solución.

  • Cambiar el nombre de producto.

  • Cambiar la ruta de acceso de resultados.

  • Rellenar el archivo CAB con el resultado primario de la aplicación.

  • Agregar las dependencias que se requieran.

  • Crear un acceso directo a la aplicación.

  • Mover el acceso directo al menú Inicio o a la carpeta Programas.

  • Modificar una entrada del Registro.

Requisitos previos

Una solución de dispositivo inteligente existente. En relación con este tutorial, hay que tener en cuenta la creación y la compilación de un proyecto sencillo, como el proyecto descrito en Tutorial: Crear aplicaciones de Windows Forms para un dispositivo.

Establecer el proyecto Cab

Para agregar un proyecto Cab de Smart Device a la solución

  1. Abra el proyecto para dispositivos inteligentes existente y asegúrese de que el Explorador de soluciones se encuentre visible.

  2. En el menú Archivo, elija Agregar y, después, haga clic en Nuevo proyecto.

    Aparecerá el cuadro de diálogo Agregar nuevo proyecto.

  3. En el panel Tipos de proyecto, expanda el nodo Otros tipos de proyectos y seleccione Instalación e implementación.

  4. En el panel Plantillas, haga clic en Proyecto CAB de Smart Device.

    Éste es el único tipo de proyecto Cab válido para dispositivos inteligentes. Los otros tipos de proyecto son sólo para soluciones de escritorio.

  5. En el cuadro Nombre, escriba CABProject y, a continuación, haga clic en Aceptar.

    El proyecto CAB se agrega a la solución pertinente y se encuentra visible en el Explorador de soluciones. Ahora aparecen los dos paneles del Editor del sistema de archivos.

Personalizar el proyecto Cab

Para cambiar el nombre del producto y otras propiedades del proyecto

  1. En el Explorador de soluciones, haga clic en CABProject si todavía no se encuentra seleccionado.

  2. En el menú Ver, haga clic en Ventana Propiedades para abrir la ventana Propiedades.

  3. En el campo ProductName de la cuadrícula de propiedad, cambie el valor a MyProduct.

    El valor de la propiedad ProductName determina 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.

    • También es posible utilizar esta ventana para cambiar el nombre del fabricante y especificar las versiones mínima y máxima del sistema operativo.

    • Es posible establecer la propiedad OSVersionMin en 4.21 para indicar que la aplicación para Pocket PC tiene conocimiento sobre la orientación de pantalla. Sin embargo, estableciendo esta propiedad en 4.21 se evitará que la aplicación se instale en Pocket PC basada en Windows Mobile 2003 y anterior. Para permitir que se realice la instalación en tales dispositivos y, a la vez, indicar el conocimiento sobre la orientación de la pantalla para los dispositivos más actuales, es necesario modificar de forma manual el archivo .inf con el fin de establecer la propiedad BuildMax en uno de los siguientes valores:

      0xA0000000 para indicar que la aplicación admite pantallas cuadradas (240x240 píxeles)

      0xC0000000 para indicar que la aplicación admite la rotación de pantallas

      O bien

      0xE0000000 para indicar que la aplicación admite pantallas cuadradas y la rotación de pantallas.

      Para obtener más información, vea el artículo de MSDN Developing Screen Orientation-Aware Applications.

    • Para soluciones Pocket PC basadas en Windows Mobile 2003 SE y anteriores, las propiedades Compress y NoUninstall Device Deployment deben ser falsas. Hay que tener en cuenta que esta opción se puede establecer en true para dispositivos equipados con Compact Framework 2.0. Para obtener más información, vea Propiedades (Ventana), Proyecto Cab de Smart Device.

    • Si se está utilizando una DLL de instalación de Windows CE, utilice esta cuadrícula de propiedad para especificar el nombre de archivo y la ubicación. Para obtener más información acerca de las DLL de instalación de Windows CE, consulte la documentación relacionada con Pocket PC o Smartphone SDK.

Para cambiar el nombre del archivo CAB y agregar autenticación

  1. En el Explorador de soluciones, haga clic con el botón secundario del mouse en CABProject y, a continuación, en Propiedades.

    Aparecerá el cuadro de diálogo Páginas de propiedades del proyecto Cab pertinente. En el cuadro Nombre del archivo de resultados, cambie el nombre del archivo CAB y la ruta de acceso a Debug\MyApp.cab y, a continuación, haga clic en Aceptar.

  2. También es posible utilizar esta página de propiedades para agregar autenticación al proyecto en cuestión. Es necesaria la autenticación para soluciones Smartphone y no se admite en soluciones Pocket PC basadas en Windows Mobile 2003 SE y anteriores. Para obtener más información, vea Seguridad en los proyectos de dispositivos.

Para agregar la aplicación del proyecto de dispositivos al proyecto Cab

  1. En el panel que se encuentra a la izquierda del Editor del sistema de archivos, haga clic en Carpeta de la aplicación con el fin de especificar que los archivos que se seleccionen en los siguientes pasos se instalarán en la carpeta del dispositivo de destino.

    Si el Editor del sistema de archivos no se encuentra visible, haga clic con el botón secundario del mouse en el nombre del proyecto CAB del Explorador de soluciones, seleccione Ver y haga clic en Sistema de archivos.

  2. En el menú Acción de Visual Studio, elija Agregar y, a continuación, haga clic en Resultados del proyecto.

  3. En el cuadro de diálogo Agregar grupo de resultados del proyecto, seleccione el proyecto de Smart Device correspondiente de la lista desplegable Proyecto.

  4. En la lista de resultados, seleccione Resultado principal y, a continuación, haga clic en Aceptar.

Nota:

A la hora de crear un proyecto CAB de Smart Device para una aplicación diseñada en C++, es necesario agregar de forma manual cualquier dependencia, como atl90.dll, mfc90U.dll o msvcr.dll, al proyecto CAB en cuestión si se están estableciendo vínculos de forma dinámica a las DLL especificadas. No obstante, se recomienda el establecimiento de vínculos estáticos para reducir las dependencias en los archivos DLL de MFC/ATL. Si se están estableciendo vínculos de forma estática, los archivos DLL no se deberían redistribuir con la aplicación en cuestión. Si se están estableciendo vínculos de forma dinámica y resulta necesario redistribuir los archivos DLL del proyecto Cab, no instale los archivos DLL en el directorio del sistema (como \windows) en el dispositivo. En su lugar, instale los archivos DLL en el directorio local de la aplicación. Si se está redistribuyendo un conjunto de aplicaciones y todas están vinculadas de forma dinámica a los tiempos de ejecución de ATL/MFC, instale todas las aplicaciones, junto con los archivos DLL en tiempo de ejecución, en un solo directorio de aplicaciones y proporcione accesos directos a las aplicaciones en cuestión que se puedan colocar en sus propias carpetas. Esto ayudará a ahorrar algo de espacio y evitará que exista algún tipo de peligro con respecto a que los archivos DLL del directorio del sistema sean reemplazados posteriormente y pueda dañarse cualquier aplicación que esté vinculada de forma dinámica a ellos.

Para agregar dependencias al proyecto Cab (sólo proyectos de C++)

  1. En el Explorador de soluciones, haga clic en el nombre del proyecto CAB con el botón secundario del mouse, seleccione Agregar y haga clic en Archivo.

  2. Navegue a la carpeta de instalación de Visual Studio\VC\ce\dll\plataforma.

  3. Seleccione los archivos que desee agregar.

    • En el caso de un proyecto MFC, presione CTRL y haga clic en MFC90U.DLL, atl90.dll y msvcr90.dll. Puede que también sea necesario hacer clic en uno o más de los archivos DLL específicos del lenguaje si la aplicación pertinente requiere recursos concretos para el lenguaje de MFC.

    • Para un proyecto ATL, presione CTRL y haga clic en atl90.dll y msvcr90.dll. Si la solución ATL admite MFC, también haga clic en MFC90U.DLL.

    • Para un proyecto Win32, haga clic en msvcr90.dll.

  4. Haga clic en Abrir en el cuadro de diálogo Agregar archivos para agregar los archivos al proyecto Cab.

  5. En el panel izquierdo del Editor del sistema de archivos, haga clic con el botón secundario del mouse en Sistema de archivosenEquipo de destino.

  6. Haga clic en Agregar carpeta especial y, a continuación, haga clic en Carpeta Windows.

  7. En el panel izquierdo de Editor del sistema de archivos, haga clic en la carpeta que contiene el resultado principal. Los archivos DLL se han agregado de manera predeterminada a la misma carpeta como su resultado principal. Para moverlos a la carpeta de Windows, seleccione los archivos en el panel central del Editor del sistema de archivos y arrástrelos hasta el icono Carpeta Windows.

  8. Utilice el mismo procedimiento para agregar otras dependencias que sean necesarias para la solución en cuestión. Es posible agregar dependencias a cualquier carpeta; no es necesario agregarlas a la carpeta Windows.

Para crear un acceso directo para la aplicación del proyecto de dispositivos

  1. En el panel derecho del Editor del sistema de archivos, seleccione Resultado principal desde <nombre del proyecto de la aplicación>.

  2. En el menú Acción, haga clic en Crear acceso directo al resultado primario a partir del <nombre del proyecto de la aplicación>.

    Este comando agrega un elemento Acceso directo en el elemento Resultados.

  3. Haga clic con el botón secundario del mouse en el elemento Acceso directo, haga clic en Cambiar nombre y cambie el nombre del acceso directo a algún nombre más apropiado para un acceso directo.

Para mover el acceso directo al menú Inicio o a la carpeta Programas

  1. En el panel izquierdo del Editor del sistema de archivos, haga clic con el botón secundario en Sistema de archivos en el equipo de destino, señale Agregar carpeta especial y seleccione Carpeta del menú Inicio o Carpeta Programas.

  2. Arrastre el acceso directo desde la Carpeta Aplicación hasta la Carpeta del menú Inicio o la Carpeta Programas.

Para agregar una entrada de Registro

  1. En el Explorador de soluciones, haga clic en el proyecto CAB.

  2. En el menú Ver, elija Editor y, a continuación, haga clic en Registro.

  3. En el Editor del Registro, haga clic con el botón secundario del mouse en HKEY_CURRENT_USER y, a continuación, haga clic en Nueva clave.

  4. Cuando aparezca la entrada Nueva clave en el Editor del Registro, cámbiele el nombre a SOFTWARE.

  5. Haga clic con el botón secundario del mouse en esta nueva clave, señale Nueva y, a continuación, haga clic en Clave.

  6. Cuando aparezca la entrada Nueva clave en el Editor del Registro, cámbiele el nombre a MyCompany.

  7. Haga clic con el botón secundario en la entrada MiCompañía y, a continuación, haga clic en Ventana Propiedades.

    El valor Name ha cambiado a MyCompany.

Generar e implementar el archivo CAB

Para generar el archivo CAB

  1. En el menú Generar, haga clic en Generar CABProject.

    O bien

    Haga clic con el botón secundario del mouse en CABProject en el Explorador de soluciones y, a continuación, haga clic en Generar.

  2. En el menú Archivo, haga clic en Guardar todo.

    Los archivos CAB para soluciones Smartphone deben estar firmados digitalmente antes de implementarse en un dispositivo de usuario final. La firma digital no se admite en soluciones Pocket PC basadas en Windows Mobile 2003 SE y anteriores. Para obtener más información, vea Cómo: Firmar un archivo CAB (Dispositivos).

Para implementar el archivo CAB en el dispositivo

  1. En el Explorador de Windows, navegue a la carpeta donde se encuentra almacenada esta solución. Encontrará el archivo CAB en la carpeta CABProject\Release de la solución.

  2. Copie el archivo CAB en un dispositivo que se encuentre conectado mediante ActiveSync 4.0 o versiones posteriores.

    Cuando un usuario determinado puntee sobre el nombre del archivo CAB en el Explorador de archivos del dispositivo, Windows CE hará explotar el CAB y procederá a la instalación de la aplicación en el dispositivo.

    Para obtener más información, consulte la documentación del SDK de Smartphone o Pocket PC.

Vea también

Referencia

Empaquetar (Cómo se empaqueta en Smart Devices)

Otros recursos

Empaquetar soluciones de dispositivos para su implementación