Solución de problemas de instalación con el archivo de Instalador de aplicaciónTroubleshoot installation issues with the App Installer file

Si encuentra algún problema al instalar una aplicación desde el archivo del instalador de la aplicación, en este tema se proporcionará una guía para la solución de problemas que puede ayudarle.If you find any issues when installing an application from the App Installer file, this topic will provide some troubleshooting guidance that may help.

Requisitos previosPrerequisites

Para poder transferir localmente aplicaciones en Windows 10, el dispositivo de usuario debe cumplir los siguientes requisitos:To be able to sideload apps in Windows 10, the user device must satisfy the next requirements:

  • El dispositivo debe estar habilitado para el modo de desarrollador o para la instalación de prueba de aplicaciones.The device must be enabled for Developer Mode or Sideloading apps. Vea Habilitar el dispositivo para el desarrollo para obtener más información.See Enable your device for development to learn more.
  • El certificado usado para firmar el paquete debe ser de confianza para el dispositivo.The certificate used to sign the package must be trusted by the device. Consulte la sección de certificados de confianza a continuación para obtener más detalles.See the Trusted certificates section below for more details.
  • La versión de Windows 10 debe admitir el .appinstaller esquema de archivo y el protocolo de distribución.The Windows 10 version must support the .appinstaller file schema and the distribution protocol.

Problemas comunesCommon issues

Hay algunos problemas comunes que surgen cuando se ejecuta la instalación de prueba de una aplicación por primera vez en el equipo del usuario.There are some common issues when sideloading an application for first time in the user machine. En las próximas secciones se describen los problemas más frecuentes y sus soluciones.The next few sections describe the most frequent issues and their solutions.

Versión de WindowsWindows version

Cada versión de Windows 10 mejora la experiencia de instalación de prueba, en la tabla siguiente encontrará qué características están disponibles en cada versión principal.Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. Si intenta realizar una instalación de prueba de una aplicación con un método no admitido en su versión de Windows 10, obtendrá un error de implementación.If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.

VersiónVersion Notas de la transferencia de pruebaSideload Notes
Compilación 17134 (actualización de abril de 2018, versión 1803)Build 17134 (April 2018 Update, version 1803) .appinstallerSe puede tener acceso al archivo a través de carpetas UNC o compartidas.The .appinstaller file can be accessed over UNC/Share folders. También están disponibles las comprobaciones de actualización configurables.Configurable update checks are also available.
Compilación 16299, (Fall Creators Update, versión 1709)Build 16299 (Fall Creators Update, version 1709) Presentó el .appinstaller archivo para proporcionar actualizaciones automáticas a la aplicación.Introduced the .appinstaller file to provide automatic updates to your app. Esta versión solo admite puntos de conexión HTTP.This version only supports HTTP endpoints. Las comprobaciones de actualización no se pueden configurar y tienen lugar cada 24 horas.Update checks are not configurable and happens each 24 hours.
Compilación 15063, (Creators Update, versión 1703)Build 15063 (Creators Update, version 1703) La aplicación del instalador de la aplicación puede descargar las dependencias de la aplicación (solo en el modo de lanzamiento) del almacén.The App Installer app is able to download app dependencies (only in release mode) from the Store.
Compilación 14393 (Actualización de aniversario, versión 1607)Build 14393 (Anniversary Update, version 1607) Se presentó la aplicación del instalador de la aplicación para instalar los archivos. appx y. appxbundle, no se admite el archivo. AppInstaller.Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.
Compilación 10586 (actualización de noviembre, versión 1511)Build 10586 (November Update, version 1511) La transferencia de prueba solo está disponible a través de PowerShell mediante el comando Add-AppxPackage .Sideload is only available through PowerShell using the Add-AppxPackage command.
Compilación 10240 (Windows 10, versión 1507)Build 10240 (Windows 10, version 1507) La transferencia de prueba solo está disponible a través de PowerShell mediante el comando Add-AppxPackage .Sideload is only available through PowerShell using the Add-AppxPackage command.

Certificados de confianzaTrusted certificates

Los paquetes de aplicaciones deben firmarse con un certificado que sea de confianza para el dispositivo.App packages must be signed with a certificate that is trusted by the device. Los certificados proporcionados por las entidades de certificación comunes son de confianza de forma predeterminada en el sistema operativo Windows.Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system.

Sin embargo, si el certificado usado para firmar un paquete de aplicación no es de confianza, o si es un certificado autofirmado o generado localmente que se usa durante el desarrollo, es posible que el instalador de la aplicación informe de que el paquete no es de confianza y evita que se instale:However, if the certificate used to sign an app package is not trusted, or is a locally-generated/self-signed certificate used during development, the app installer may report that the package is untrusted and will prevent it from being installed:

MSIX firmado con certificado que falta o que no es de confianza

Para solucionar este problema, un usuario con derechos de administrador local en el dispositivo debe usar la herramienta de certificados de equipo para importar el certificado en uno de los siguientes contenedores:To solve this issue, a user with local administrator rights to the device must use the Computer Certificates tool to import the certificate into one of the following containers:

  1. Equipo local: personas de confianzaLocal Computer: Trusted People
  2. Equipo local: entidades de certificación raíz de confianza (no recomendado)Local Computer: Trusted Root Authorities (not recommended)

Importante

No importe certificados de firma de paquetes en el almacén de certificados de usuario.Do not import package signing certificates into the User Certificate store. El instalador de la aplicación no busca certificados de usuario al comprobar la identidad del paquete.The App Installer does not search User Certificates when verifying package identity.

La herramienta de administración de certificados de equipo se puede encontrar fácilmente mediante la búsqueda en el menú Inicio:The Computer Certificates management tool can be easily found by searching from the Start Menu:

Buscar la herramienta certificados de equipo local a través del menú Inicio

Una vez que se haya importado correctamente el certificado de firma, al volver a ejecutar el instalador de la aplicación se mostrará que el paquete es de confianza y se puede instalar:Once the signing certificate is successfully imported, re-running the app installer will show that the package is trusted and can be installed:

MSIX firmado con un certificado de confianza

Dependencias no instaladasDependencies not installed

Las aplicaciones de Windows 10 pueden tener dependencias de marco de trabajo basadas en la plataforma de aplicaciones que se usa para generar la aplicación.Windows 10 applications can have framework dependencies based on the application platform used to generate the app. Si usa C# o VB, la aplicación necesitará el entorno de tiempo de ejecución de .NET y los paquetes de .NET Framework.If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. Las aplicaciones de C++ requieren el VCLibs.C++ applications require the VCLibs.

Importante

Si el paquete de la aplicación está integrado en la configuración del modo de versión, las dependencias del marco se obtendrán de la Microsoft Store.If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. Sin embargo, si la aplicación está integrada en la configuración del modo de depuración, las dependencias se obtendrán de la ubicación especificada en el .appinstaller archivo.However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the .appinstaller file.

Archivos no accesiblesFiles not accessible

Al instalar desde un punto de conexión HTTP, es importante comprobar que se puede tener acceso a todos los archivos con el tipo MIME correcto.When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. El método más sencillo para comprobar estos archivos es siguiendo los vínculos proporcionados en la página HTML generada por Visual Studio.The easiest method to verify these files is by following the links provided in the HTML page generated by Visual Studio. Debe comprobar estos archivos:You must check these files:

  • .appinstaller archivo, disponible como application/xml.appinstaller file, available as an application/xml
  • .appx y .appxbundle archivos, disponibles como application/vns.ms-appx.appx and .appxbundle files, available as application/vns.ms-appx

Aislar problemas de aplicaciones de instalador de aplicacionesIsolate App Installer app issues

Si el instalador de la aplicación no puede instalar la aplicación, estos pasos le ayudarán a identificar el problema de instalación.If the App Installer cannot install the app, these steps will help identify the installation issue.

Comprobar la instalación del archivo de paquete de aplicaciónVerify app package file installation

  • Descargue el archivo de paquete de la aplicación en una carpeta local e intente instalarlo con el comando de PowerShell Add-AppxPackage .Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.

  • Descargue el .appinstaller archivo en una carpeta local e intente instalarlo con el Add-AppxPackage -Appinstaller comando de PowerShell.Download the .appinstaller file to a local folder and try to install it using the Add-AppxPackage -Appinstaller PowerShell command.

Registros de eventos del instalador de aplicacionesApp Installer event logs

La infraestructura de implementación de aplicaciones emite registros que a menudo resultan útiles para depurar problemas de instalación a través del Visor de eventos de Windows: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-ServerThe app deployment infrastructure emits logs that are often useful for debugging installation issues via the Windows Event Viewer: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server