Uso de un archivo del Instalador de aplicación incrustado para actualizar la aplicación

  • Artículo

Importante

El uso de un archivo de Instalador de aplicación incrustado está disponible en la versión 10.0.21300.0 de Windows. Para usar esta característica, asegúrese de que MaxVersionTested hace referencia a esta o una versión más reciente del sistema operativo Windows.

El archivo del Instalador de aplicación proporciona una ruta de actualización que una aplicación de Windows puede atravesar la búsqueda de actualizaciones y reparaciones.

Al usar Visual Studio para compilar y publicar la aplicación de Windows con un archivo de instalador de aplicación incrustado, debe asegurarse de que se ha instalado windows 10 SDK 2104 (o posterior) y las propiedades del proyecto tienen Windows 10 21H1 (o posterior) como versiones de destino (MaxVersionTested y MinVersion). Si no se ha configurado, la aplicación de Windows no establecerá las configuraciones insertadas de AppInstaller en el dispositivo cuando se instale la aplicación de Windows.

Instrucciones: MSIX Packaging Tool

Los pasos siguientes le guiarán a través de cómo usar la herramienta de empaquetado MSIX para editar una aplicación de Windows existente para incluir una aplicación de Instalador de aplicación insertada.

Nota:

En las instrucciones siguientes se da por supuesto que ha creado previamente el archivo del Instalador de aplicación mediante Visual Studio para automatizar la creación de un archivo del Instalador de aplicación, con el uso del kit de herramientas MSIX o manualmente. Para obtener instrucciones sobre cómo crear un archivo del Instalador de aplicación, visite uno de los siguientes artículos de Docs:

Abrir la aplicación de Windows para editar

Los siguientes pasos le guiarán sobre cómo utilizar la aplicación Microsoft MSIX Packaging Tool para empezar a editar una aplicación Windows.

  1. Inicie microsoft MSIX Packaging Tool (Disponible en Microsoft Store: MSIX Packaging Tool).
  2. Seleccione el botón Editor de paquetes para editar un paquete existente.
  3. Seleccione el botón Examinar y, en la ventana que se le pide, busque la aplicación de Windows y seleccione el botón Abrir.
  4. Seleccione el botón Abrir paquete.

Importar el archivo del Instalador de aplicación en la aplicación de Windows

Los pasos siguientes le guiarán a través de cómo insertar un archivo del Instalador de aplicación en una aplicación de Windows existente previamente mediante la aplicación Microsoft MSIX Packaging Tool. En estos pasos se supone que ya ha abierto la aplicación de Windows para su edición mediante la aplicación Microsoft MSIX Packaging Tool.

  1. En la parte izquierda de MSIX Packaging Tool, seleccione Archivos de paquete.
  2. Expanda la entrada Paquete dentro de la vista de árbol.
  3. Haga clic con el botón derecho en Paquete y seleccione Agregar archivo en el menú desplegable.
  4. Seleccione el botón Examinar dentro de la ventana que se le solicita, vaya a y seleccione el archivo instalador de aplicación y seleccione el botón Abrir.
  5. Seleccione el botón Guardar.

Actualización de AppxManifest

Los pasos siguientes le guiarán a través de la actualización de AppxManifest para que apunte al archivo instalador de aplicación que se agregó anteriormente a la aplicación de Windows.

  1. En la parte izquierda de MSIX Packaging Tool, seleccione Información del paquete.
  2. Desplácese hasta la parte inferior de la sección Información del paquete.
  3. Seleccione el botón Abrir archivo para abrir AppxManifest en una ventana de Bloc de notas.
  4. Asegúrese de que las propiedades <Package> incluyen los siguientes espacios de nombres y Espacios de nombres ignorables:
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  5. Dentro de la inclusión <Properties> de los parámetros siguientes <uap13:AutoUpdate> y secundarios: 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  6. Guarde los cambios realizados en el AppxManifest.
  7. Cierre la ventana AppxManifest del Bloc de notas y vuelva a la MSIX Packaging Tool.

Nota:

En las instrucciones anteriores se supone que el nombre de archivo del Instalador de aplicación es "Update.appinstaller".

Cerrar y empaquetar la aplicación de Windows

Los pasos siguientes le guiarán a través del empaquetado de la aplicación de Windows como una versión más reciente. En estos pasos se supone que ha configurado las preferencias de firma para cumplir los requisitos de su organización o cliente.

  1. En la MSIX Packaging Tool, seleccione el botón Guardar.
  2. En la ventana que se le solicita, seleccione el botón Sí, Incremento.
  3. Vaya a la ubicación en la que desea guardar la aplicación de Windows recién actualizada y seleccione el botón Guardar.
  4. Seleccione el botón Cerrar.
  5. Cierre la ventana MSIX Packaging Tool.

Instrucciones: Visual Studio

Antes de empezar, asegúrese de que está trabajando en un dispositivo Windows 10 con Windows 10 SDK 2104 o posterior instalado. Este SDK es necesario para asegurarse de que las propiedades Versión de destino y Versión mínima se establecen con los valores adecuados a medida que compila la aplicación.

Insertar el archivo del instalador de aplicación

Los pasos siguientes le guiarán a través de la inserción del archivo del Instalador de aplicación en el proyecto de Visual Studio de la aplicación de Windows (UWP).

  1. En su proyecto de Visual Studio, Explorador de soluciones, haga clic con el botón derecho en el nombre de su aplicación Windows.
  2. Seleccione Añadir>>Artículo Existente en el menú desplegable.
  3. Vaya al archivo del Instalador de aplicación, selecciónelo y seleccione el botón Agregar.
  4. En el Explorador de soluciones, haga doble clic en Update.appinstaller para abrir el archivo y revisarlo.
  5. Confirme que el archivo instalador de aplicación es correcto y cierre el archivo.

Actualización de AppxManifest

Los pasos siguientes proporcionarán instrucciones sobre cómo actualizar AppxManifest en el proyecto de Visual Studio para tener como destino el archivo del instalador de aplicación recién insertado.

En esta guía se da por supuesto:

  • El SDK de Windows 10 2104 o posterior está instalado
  • Las propiedades del proyecto se establecen en Windows 10, versión 2104 o posterior.
  • El nombre del archivo del instalador de aplicación es Update.appinstaller.
  1. En su proyecto de Visual Studio, seleccione Compilar en el menú superior.
  2. Seleccione Compilar solución en el menú desplegable. Asegúrese de que la compilación de la aplicación Windows se ha realizado correctamente.
  3. Seleccione Equipo local en la cinta de opciones para probar la funcionalidad de la aplicación de Windows.
  4. Cierre la aplicación de Windows poco después de iniciarla y detenga la depuración.
  5. En el Explorador de soluciones, haga clic con el botón derecho en Package.appxmanifest
  6. Seleccione Ver código en el menú desplegable.
  7. Asegúrese de que las propiedades <Package> incluyen los siguientes espacios de nombres y Espacios de nombres ignorables:
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  8. Dentro de la inclusión <Properties> de los parámetros siguientes <uap13:AutoUpdate> y secundarios: 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  9. Guarde los cambios en el archivo y ciérrelo.

Compilación de la aplicación de Windows

Los pasos siguientes le guiarán a través de la creación del paquete de aplicación de Windows para la instalación en sistemas operativos compatibles.

  1. En el proyecto de Visual Studio, haga clic con el botón derecho en el nombre de la aplicación de Windows.
  2. Seleccione Publicar>>Crear paquetes de aplicaciones... en el menú desplegable.
  3. Seleccione el botón de radio Transferir localmente, en la nueva ventana de diálogo Crear paquetes de aplicaciones.
  4. Haga clic en el botón Siguiente.
  5. Seleccione el botón de radio Sí, utilizar el certificado actual:
  6. Importe un certificado existente o genere automáticamente un certificado para firmar la aplicación de Windows.
  7. Haga clic en el botón Siguiente.
  8. Especifique la configuración de la solución, la versión y la compilación opcional de una agrupación de aplicaciones de Windows para la aplicación de Windows.
  9. Seleccione el botón Crear.