Problemas conocidos y sugerencias para la solución de problemas de MSIX Packaging ToolKnown issues and troubleshooting tips for the MSIX Packaging Tool

En este artículo se describen problemas conocidos y se proporcionan sugerencias para la solución de problemas, que se deben tener en cuenta al convertir las aplicaciones a MSIX con MSIX Packaging Tool.This article describes known issues and provides troubleshooting tips to consider when converting your apps to MSIX using the MSIX Packaging Tool. Consulte nuestros otros documentos si necesita adquirir la herramienta de empaquetado de MSIX o el controlador en un entorno desconectado.Check out our other docs if you need to acquire the MSIX Packaging Tool or driver in a disconnected environments.

Problemas conocidosKnown issues

Obtención de la última versión de la versión preliminar de Insider de la herramienta de empaquetado de MSIXGetting the latest Insider Preview build of the MSIX Packaging Tool

Si ha participado en nuestro programa Insider, asegúrese de que tiene la versión correcta de la herramienta de empaquetado de MSIX:If you have opted in to our Insider Program, make sure you have the correct version of the MSIX Packaging Tool:

  • Vaya a la sección acerca de en la herramienta de empaquetado de MSIX para ver la versión en la que se encuentre.Go to the About section in the MSIX Packaging Tool to view which version you are on.
  • Vaya aquí para determinar la versión más reciente de Insider Preview y confirme que tiene instalada esa versión de la herramienta de empaquetado de MSIX.Go here to determine the latest Insider Preview version, and confirm you have that version of the MSIX Packaging Tool installed.
  • Asegúrese de que la MSA que se ha registrado para el vuelo es la cuenta que ha iniciado sesión en el Microsoft Store.Make sure the MSA that's signed up for flighting is the account that is signed into the Microsoft Store.
  • Actualice manualmente la herramienta de empaquetado de MSIX a través del Microsoft Store del equipo.Manually update the MSIX Packaging Tool through the Microsoft Store on your computer. Si esta opción está disponible, abra el almacén, vaya a descargas y actualizacionesy haga clic en obtener actualizaciones.If this option if available to you, open the Store, go to Downloads and updates, and click Get updates. Como alternativa, busque la herramienta de empaquetado de MSIX y, en la página del producto, puede solicitar una actualización.Alternatively, search for the MSIX Packaging Tool, and on the product page you can then prompt it for an update.
  • Para instalar la herramienta de empaquetado de MSIX para su uso sin conexión, siga estas instrucciones para asegurarse de que obtiene la última aplicación a través de nuestro proceso sin conexión.To install the MSIX Packaging Tool for offline use, follow these instructions to ensure you get the latest app through our offline process.

Si está interesado en unirse a nuestro programa Insider, haga clic aquí.If you are interested in joining our Insider Program, click here.

Controlador de la herramienta de empaquetado de MSIXMSIX Packaging Tool driver

El controlador de la herramienta de empaquetado de MSIX se entrega como un paquete de características a petición (du) de Windows Update.The MSIX Packaging Tool driver is delivered as a Feature on Demand (FOD) package from Windows Update. No podrá instalarse si el servicio de Windows Update está deshabilitado en el equipo o si la configuración de Windows Insider Flight Ring no coincide con la compilación del sistema operativo del equipo.It will fail to install if the Windows Update service is disabled on the computer or if Windows Insider flight ring settings do not match the OS build of the computer.

Si tiene problemas para adquirir el controlador o está trabajando en un entorno sin conexión, puede encontrar vínculos para descargar el controlador aquí.If you are running into problems acquiring the driver, or you are working in an offline environment, you can find links to download the driver here.

Si ha descargado el controlador y se están ejecutando problemas durante la conversión del paquete, puede ser uno de los siguientes problemas.If you have downloaded the driver and are running into issues during your package conversion, it may be one of the following issues.

Problemas de conectividad de redNetwork connectivity issues

Los códigos de error siguientes pueden indicar que se están produciendo problemas de conexión:The following error codes might indicate that you are encountering connection issues:

  • -2145107924 (0x8024402c)-2145107924 (0x8024402c)
  • -2145107945 (0x80244017)-2145107945 (0x80244017)
  • -2145123272 (0x80240438)-2145123272 (0x80240438)

Windows Server Update Service (WSUS), Configuration Manager o directivas de grupo que afectan a la conectividad de Windows UpdateWindows Server Update Service (WSUS), Configuration Manager, or group policies affecting Windows Update connectivity

El siguiente código de error puede indicar que las directivas del equipo están afectando a la conectividad de Windows Update:-2145124306 (0x8024002e).The following error code may indicate that policies on your computer are be affecting Windows Update connectivity: -2145124306 (0x8024002e).

Si recibe este código de error, puede que tenga que comprobar la configuración del entorno y las directivas.If you receive this error code, you may need to check your environment settings and policies.

El controlador necesita una reinstalaciónDriver required a reinstall

En este escenario, la herramienta de empaquetado de MSIX le notificará en el mensaje de error y registrará que el controlador necesita un reinicio.In this scenario, the MSIX Packaging Tool will notify you in the error message and logs that your driver needs a restart. Reinicie el equipo e inicie de nuevo la conversión para corregir este problema.Restart your computer and start your conversion again to fix this issue.

Versión mínimaMinimum version

Hay algunas características que se deben tener en cuenta que cambian automáticamente la compatibilidad con la versión de mínimas en el paquete MSIX.There are a few features to be aware of that automatically change the minimun version support in your MSIX Package.

Exigir los requisitos de versiones de Microsoft StoreEnforce Microsoft store versioning requirements

Si convierte el instalador existente mediante una versión de la herramienta de empaquetado de MSIX anterior a 1.2019.701.0, la herramienta ha aplicado Microsoft Store requisitos de control de versiones en o ha usado otra herramienta para crear el paquete que no estableció la versión mínima en 10.0.16299.0 (Windows 10, versión 1709).If you convert your existing installer using a version of the MSIX Packaging Tool earlier than 1.2019.701.0, the tool had Enforce Microsoft Store versioning requirements on, or used another tool to create your package that did not set the minimum version to 10.0.16299.0 (Windows 10, version 1709). Esto producirá un mensaje de error al implementar la aplicación en Windows 10, versión 1709 o una versión posterior.This will cause an error message when deploying your app to Windows 10, version 1709 or a later version.

Para corregir este problema, abra la herramienta de empaquetado de MSIX y edite la aplicación a través del Editor de paquetes.To fix this issue, open the MSIX Packaging Tool and edit your app through Package Editor. Abra el manifiesto y establezca el MinVersion atributo del TargetDeviceFamily elemento en "10.0.16299.0".Open your manifest and set the MinVersion attribute of the TargetDeviceFamily element to "10.0.16299.0".

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

MSIX con serviciosMSIX with services

En la versión 1.2019.1220.0 de la herramienta de empaquetado de MSIX, hemos agregado compatibilidad con la creación de un paquete de MSIX con servicios.In version 1.2019.1220.0 of the MSIX Packaging Tool, we added support for creating an MSIX package with Services. Debido a las restricciones de sistema operativo compatibles con los servicios, la herramienta de empaquetado de MSIX cambia automáticamente la versión mínima admitida en un paquete MSIX con servicios a 10.0.19025.0.Due to the OS restrictions with services support, the MSIX Packaging Tool automatically changes the min version supported in an MSIX package with services to 10.0.19025.0. Esto significa que no se puede instalar una MSIX con los servicios en un sistema operativo anterior a la versión 2004 de Windows 10, pero puede crear esa MSIX mediante la herramienta de empaquetado de MSIX hasta Windows 10 1809.This means that you cannot install an MSIX with services on an OS lower than the Windows 10 version 2004, but you can create that MSIX using the MSIX Packaging Tool down to Windows 10 1809. Si necesita instalar esta aplicación en un sistema operativo inferior, actualice la versión mínima correctamente, pero tenga en cuenta que la compatibilidad con los servicios no funcionará.If you need to install this app on a lower OS, update the min version appropriately but note that support for services will not work.

Marcos de trabajo y controladoresFrameworks and drivers

Si la aplicación requiere un marco, asegúrese de que el marco se instala durante la fase de supervisión de la conversión.If the app requires a framework, make sure the framework is installed during the monitoring phase of the conversion. Recorra los registros para asegurarse de que esto ocurre.Go through the logs to ensure this is happening. Si la aplicación requiere que se instale un controlador, debe evaluar si es necesario para que la aplicación se ejecute correctamente.If your app requires a driver to install, you need to evaluate whether this is required for your app to run properly. Actualmente, MSIX no admite la instalación de controladores.MSIX currently does not support driver installation.

Equipo remotoRemote Machine

Si tiene problemas con el uso de una máquina virtual remota para sus conversiones, consulte las instrucciones de configuración para las conversiones de equipos remotos.If you are running into issues with using a remote VM for your conversions, see Setup instructions for remote machine conversions.

Problemas durante la conversiónIssues during conversion

  • Algunos instaladores podrían provocar errores de conversión con el código de salida 259.Some installers might fail to convert with exit code 259. Esto indica que el instalador ha generado un subproceso y no ha esperado a que finalizara.This indicates that the installer spawned a thread and did not wait for it to complete. En otras palabras, el subproceso principal ha terminado de instalarse, pero se ha salido con el error 259 porque ha generado un subproceso que aún está en ejecución.In other words, the main thread finished installing but it exited with error 259 because it spawned a thread that is still running. Se recomienda utilizar la opción de instalación adecuada de setup.exe.We recommend that you use the appropriate install option for setup.exe.

Problemas durante la firmaIssues during signing

Certificado PE incorrecto (0x800700C1)Bad PE certificate (0x800700C1)

Este problema se produce cuando el paquete contiene un archivo binario con un certificado dañado.This problem occurs when the package contains a binary file that has a corrupt certificate. Para resolver este problema, use el dumpbin.exe /headers comando para volcar los encabezados de archivo e inspeccionar elementos incorrectos.To resolve this issue, use the dumpbin.exe /headers command to dump the file headers and inspect for bad elements. Vuelva a escribir manualmente los encabezados para corregir el problema.Manually rewrite the headers to fix the issue. En general, la herramienta de empaquetado de MSIX detecta automáticamente encabezados incorrectos.In general, the MSIX Packaging tool automatically detects bad headers. Si el problema persiste, envíe los comentarios de los archivos.If this issue persists, file feedback. Puede encontrar más información aquí.More information can be found here.

Firmas de Device GuardDevice Guard signing

Asegúrese de seguir estos pasos y de que está asignando los roles adecuados en el Microsoft Store para la empresa.Make sure to follow these steps and that you are assigning the appropriate roles in the Microsoft Store for Business.

Certificado expiradoExpired certificate

  • Use una marca de tiempo al firmar el paquete.Use a timestamp when you sign your package.
  • Puede refirmar con un certificado de marca de tiempo o de firma válido.You can resign with a valid sign or timestamp certificate.

Puede reasignar la aplicación mediante el script de conversión por lotes.You can resign your app using the batch conversion script.

Solución de problemasTroubleshooting

Archivos de registroLog files

Ya se haya realizado la conversión de forma correcta o no, se generan archivos de registro para cada conversión.Whether or not your conversion was successful, log files are generated for every conversion. Se pueden encontrar aquí:They can be found here:

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

Se escriben códigos de error que indican los puntos de error durante el proceso de conversión.Failure codes are written and indicate any point of failure during the conversion process. Los códigos de error están diseñados para ser fáciles de usar.The error codes are meant to be user friendly.

Archivos de registro de dispositivos remotos o máquinas virtualesLog files from remote devices or VMs

Si la conversión se realiza en un dispositivo remoto o una máquina virtual, se recomienda que copies los archivos de registro desde ese dispositivo y los adjuntes como parte del elemento de opiniones.If the conversion is performed on a remote device or a VM, we recommend that you copy the log files from that device and attach them as part of the feedback item. Esto nos ayudará a diagnosticar y resolver problemas de una forma más eficaz.This will help us diagnose and resolve issues more efficiently.

Aquí encontrarás los registros de las conversiones remotas: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txtYou will find the logs from the remote conversions here: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Incluso resultaría más beneficioso si puede compartir la carpeta de registros completos que incluirá las operaciones que se producen en el cliente local, así como en el servidor remoto.It would even more beneficial if you can share the whole Logs folder that will include the operations occurring on the local client as well the remote server.

Problemas comunesCommon problems

Errores de traducción de MakePri/manifestMakePri/Manifest translation errors

Este error se produce cuando hay un problema con el manifiesto del paquete.This error occurs when there is an issue with the package’s manifest. Para identificar el problema, vaya al editor de paquetes y abra el manifiesto.To identify the issue, go to Package Editor and open the manifest. Al abrir el manifiesto, puede identificar el problema y proporcionar la corrección adecuada.When you open the manifest, you can identify the issue and provide the proper fix.

Archivo no encontradoFile not found

El archivo puede estar abierto o ser inexistente.The file may either be open or non-existent. Para resolver este problema, agregue el archivo adecuado o cierre el archivo que está actualmente en uso.To resolve this issue, add the appropriate file or close the file that is currently in use. Tenga en cuenta que no recibirá un File not Found error si está abierto.Note that you will not get a File not Found error if it is open. En su lugar, obtendrá un Access Denied error o File in Use .Instead, you’ll get an Access Denied or File in Use error.

Asociaciones de tipo de archivoFile Type Associations

Los problemas relacionados con las asociaciones de tipo de archivo (FTA) varían de un paquete a un paquete.The issues regarding File Type Associations (FTA) vary from package to package. La herramienta de empaquetado de MSIX admite asociaciones de archivos para instalaciones de doble clic.MSIX Packaging Tool support file associations for double click installs. Por ejemplo, si la aplicación tiene un menú contextual, no se agrega automáticamente, por lo que tendrá que agregarla manualmente al manifiesto.For example, if your app has context menu, it is not automatically added, so you will need to add it manually to the manifest. Vea el elemento de manifiesto desktop4: FileExplorerContextMenus para obtener un ejemplo.See the desktop4:FileExplorerContextMenus manifest element for an example.

Métodos abreviados con argumentosShortcuts with arguments

Los métodos abreviados con argumentos no se admiten actualmente con MSIX.Shortcuts with arguments are not currently supported with MSIX. Si se detecta que el instalador los incluye, MSIX creará un icono sin argumentos.If we detect that the installer includes these, MSIX will create a tile with no arguments.

Directorio de instalaciónInstall directory

Esto es más común para los usuarios que usan una unidad secundaria para realizar conversiones de aplicaciones.This is more common for those who use a secondary drive to perform app conversions. Si decide cambiar la ubicación de instalación, cambia la raíz de donde se colocan todos los archivos.If you choose to change the installation location, it changes the root of where all of the files go. Esto significa que la herramienta de empaquetado de MSIX deberá saber dónde van todos estos archivos y se capturarán durante la conversión.This means that the MSIX Packaging tool will need to know where all these files go and will be captured during conversion.

Puede corregir este paso mediante el marco de trabajo de compatibilidad de paquetes escribir para instalar la revisión del directorio.You can fix this by using the Package Support Framework write to install directory fix. Lo hemos agregado como una funcionalidad de forma predeterminada en la herramienta MSIX, que lo permite hasta 1809.We have added this as a capability by default in the MSIX Tool, which allows this down to 1809. Si la aplicación no funciona en 1709 y está en 1809, es probable que se produzca el problema.If your application isn't working in 1709 and is in 1809, this is likely the issue.

Envío de opinionesSending feedback

La mejor manera de enviar sus comentarios es a través del centro de comentarios.The best way to send your feedback is through the Feedback Hub.

  1. Abre el Centro de opiniones o escribe Windows + F.Open Feedback Hub or type Windows + F.
  2. Especifica un título y los pasos necesarios para reproducir el problema.Provide a title and necessary steps to reproduce the issue.
  3. En Categoría, selecciona Aplicaciones y luego MSIX Packaging Tool.Under Category, select Apps and select MSIX Packaging Tool.
  4. Adjunta cualquier archivo de registro asociado a la conversión.Attach any log files associated to the conversion. Puedes encontrar los registros en la carpeta proporcionada anteriormente.You can find the logs in the folder provided above.
  5. Adjunta el paquete de MSIX convertido (si es posible).Attach the converted MSIX package (if possible).
  6. Haga clic en Enviar.Click Submit.

También nos puedes enviar opiniones directamente desde MSIX Packaging Tool en la pestaña Feedback (Opiniones) en Settings (Configuración).You can also send us feedback directly from the MSIX Packaging Tool by going to the Feedback tab under Settings.

Nota

Tus comentarios pueden tardar 24 horas en llegarnos.It may take 24 hours for your feedback to get to us. Por lo tanto, si usas una máquina virtual para convertir el paquete, quizá quieras mantener la máquina virtual encendida y en su estado actual durante 24 horas después de la conversión.Therefore if you are using a VM to convert your package, you may want to keep your VM on and in its current state for 24 hours after conversion. Además, puede adjuntar manualmente los registros de conversión a los comentarios.Also, you can manually attach conversion logs to the feedback.