Compartir a través de

Uso de un archivo de instalador de aplicación insertado para actualizar la aplicación

Importante

El uso de un archivo de instalador de aplicaciones 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 aplicaciones 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 aplicaciones incrustado, debes asegurarte 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.

Cómo: Herramienta de empaquetado MSIX

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 aplicaciones insertada.

Nota:

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

Abrir la aplicación de Windows para editar

Los pasos siguientes le guiarán a través de cómo usar la aplicación microsoft MSIX Packaging Tool para empezar a editar una aplicación de 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 aplicaciones en la aplicación de Windows

Los pasos siguientes le guiarán a través de cómo insertar un archivo del Instalador de aplicaciones 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 el lado izquierdo de la herramienta de empaquetado MSIX, 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. Selecciona 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 el lado izquierdo de la herramienta de empaquetado MSIX, 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 del Bloc de notas.
  4. Asegúrese de que las <Package> propiedades incluyen los siguientes espacios de nombres e 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 <Properties>, incluye los siguientes <uap13:AutoUpdate> y parámetros secundarios: 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  6. Guarde los cambios realizados en AppxManifest.
  7. Cierre la ventana del Bloc de notas de AppxManifest y vuelva a la herramienta de empaquetado MSIX.

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 herramienta de empaquetado MSIX , 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 ( Herramienta de empaquetado msix ).

Cómo: 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 incorporación del archivo del Instalador de aplicaciones en su proyecto de Visual Studio de aplicación UWP para Windows.

  1. En el proyecto de Visual Studio, haga clic con el botón derecho sobre el nombre de su aplicación de Windows en el Explorador de soluciones.
  2. Seleccione Agregar>>elemento 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 para su revisión.
  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 aplicaciones 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 están configuradas para dirigirse a Windows 10, versión 2104 o posterior.
  • El nombre del archivo del instalador de aplicación es Update.appinstaller.
  1. En el 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 de Windows sea correcta.
  3. Seleccione Máquina 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 <Package> propiedades incluyen los siguientes espacios de nombres e 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 <Properties>, incluye los siguientes <uap13:AutoUpdate> y parámetros secundarios: 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  9. Guarde los cambios en el archivo y cierre.

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>>paquetes de aplicaciones... en el menú desplegable.
  3. Seleccione el botón de opción Sideloading en la nueva ventana de diálogo Crear paquetes de aplicaciones.
  4. Haz clic en el botón Siguiente.
  5. Seleccione la opción Sí, use el certificado actual.
  6. Importe un certificado existente o genere automáticamente un certificado para firmar la aplicación de Windows.
  7. Haz 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.