Aceleradores

Un acelerador proporciona una manera eficaz de convertir aplicaciones heredadas (aplicaciones) en formato MSIX. Consta de información importante sobre: el paquete (la aplicación); el sistema operativo (SO) en el que se produce la conversión; y los pasos necesarios para corregir el paquete para que funcione correctamente el MSIX convertido.

Prerrequisitos

Para probar los aceleradores en una compilación de versión preliminar de acceso anticipado, únase al programa Insider de MSIX Packaging Tool.

Creación de un acelerador

Para ver la estructura del acelerador y usarla para crear su propio acelerador, consulte los aceleradores de ejemplo en el repositorio de GitHub de MSIX-Labs .

Definiciones

PackageName: Package es una aplicación o programa (Win32, WPF o aplicación de Windows Forms) que tiene un instalador heredado (exe, msi, etc.) que se convierte en formato MSIX.
PackageVersion: las versiones de paquete están asociadas a una versión específica. En algunos casos, verás un número de versión semántica perfectamente formado; y en otros casos podrías ver algo diferente. Pueden estar impulsadas por fechas o pueden tener otros caracteres que tienen un significado específico para el paquete.
PublisherName: nombre del publicador original del paquete.
EligibleForConversion: algunas aplicaciones están prohibidas para la conversión por motivos de seguridad, el uso de controladores, etc. Por lo tanto, esta marca se usa para determinar la idoneidad para la conversión. Los valores aceptados se pueden encontrar aquí.
ConversionStatus: determine el estado de la conversión de la aplicación. Los valores aceptados se pueden encontrar aquí.
RemediationApproach:
- SequenceNumber: determina el número de secuencia de un paso de corrección. Deben establecerse pasos para convertir exitosamente la aplicación en forma secuencial.
- Problema:
  - Descripción: descripción del texto del problema real detectado durante la conversión. Por ejemplo, errores del Registro o errores de FileCreate en Procmon.
  - Referencia: (Campo opcional) vínculo al documento que contiene información detallada sobre el problema.
- Corrección:
  - FixType: el tipo específico de paso. Ejemplo: si FixType es "Funcionalidad", es necesario agregar una funcionalidad específica en este momento. Los valores aceptados se pueden encontrar aquí.
  - Referencia: vínculo de referencia al documento que contiene información detallada sobre la corrección y cómo debe realizarse. Este campo es opcional.
  - FixDetails: para determinar un tipo específico de corrección necesario en un fixType determinado. Ejemplo: si Fixtype es "Dependency", FixDetails tendría un campo de tipo de matriz denominado "Dependencias" para enumerar todas las dependencias que se deben agregar para la aplicación. Los casos de uso se pueden encontrar aquí.
MinimumPSFVersion: (obligatorio solo cuando al menos uno de FixType usa PSF o PackageSupportFramework). Dado que las versiones de PSF son compatibles con versiones anteriores, cualquier versión mayor que la especificada será compatible.
AdditionalComments: para enumerar información adicional sobre la conversión de aplicaciones, diseñada únicamente para la lectura humana. Este campo es opcional.
Edición: edición del sistema operativo. Ejemplo: Windows 10 Enterprise.
MinimumOSVersion: versión del sistema operativo. Ejemplo: 21H1. Este campo es para indicar que cualquier versión mayor que esta versión del sistema operativo especificada funcionará.
MinimumOSBuild: versión de compilación del sistema operativo. Ejemplo: "19043.1165". Este campo es para indicar que cualquier compilación del sistema operativo mayor que esta compilación del sistema operativo especificada funcionará.
Arquitectura: arquitectura del paquete (aplicación). (32/64 bits)
MSIXConversionToolVersion: versión de MSIX Packaging Tool usada para la conversión. Ejemplo: 1.2021.709.0;
AcceleratorVersion: versión del acelerador que se está usando. Actualmente, la versión más reciente es la 1.0.0.

Opción de línea de comandos para aceleradores

Para la conversión automática, puede generar la plantilla de acelerador a través de la herramienta MSIX Packaging.

Asegúrese de que la opción "Generar un archivo de línea de comandos con cada paquete" está seleccionada en Configuración de la herramienta de empaquetado MSIX.
Convierta una aplicación mediante la herramienta MSIX Packaging, aplicando un acelerador en el proceso de conversión.
De forma predeterminada, el archivo de plantilla de conversión se guardará en la misma ubicación que el paquete MSIX, a menos que especifique otra ubicación de guardado.
Ejecute el MsixPackagingTool.exe en modo con privilegios elevados.
Ejecute el siguiente cmdlet para usar la plantilla de acelerador:

MsixPackagingTool.exe create-package --template c:\users\documents\AcceleratorTemplate.xml

Aquí encontrará más información sobre cómo generar un archivo de plantilla para las conversiones de línea de comandos . Obtenga información sobre los parámetros que se pueden pasar como argumentos de línea de comandos aquí.

Casos de uso para ConversionStatus

Satisfactorio: no se necesita corrección

ConversionStatus: Successful - No Fix Required

Éxito - Corrección necesaria

ConversionStatus: Successful - Fix Required

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: App unable to install visual c++ dependency
    Fix:
      FixType: Dependency
      FixDetails:
        Dependencies:
          - Visual C++

Convertido con incidencias

ConversionStatus: Converted With Issues

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: Shortcut not captured
    Fix:
      FixType: EntryPoint 
      FixDetails:
        EntryPointIssue: ShortcutNotCaptured
        Solution:
          - Launch from start menu

Fracasado

ConversionStatus: Failed

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: Registry errors in Procmon

No apto

EligibleForConversion: No - Driver Required

ConversionStatus: Not Eligible

Casos de uso para FixDetails

FixType: Capacidad

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: Admin Access needed to run an app 
    Fix:
      FixType: Capability
      Reference: /windows/uwp/packaging/app-capability-declarations#:~:text=or%20Visual%20Studio.-,Elevation,-The%20allowElevation%20restricted
      FixDetails:
        Capabilities:
          - allowElevation

FixType: Dependencia

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: The app needs a 2008 C++ to be installed in the system
      Reference: https://forums.guru3d.com/threads/problem-running-afterburner.408768/
    Fix:
      FixType: Dependency
      Reference: https://forums.guru3d.com/threads/problem-running-afterburner.408768/
      FixDetails:
        Dependencies:
          - C++ 2008 runtime

TipoDeCorrección: RutaDeInstalación

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: Required permissions were not granted to the VFS folder and launcher.exe was not available during msix launch
    Fix:
      FixType: InstallationPath
      Reference: /windows/msix/packaging-tool/create-app-package#package-information
      FixDetails:
        Path: C:/Users/User/AppData/Local

FixType: Personalizado

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description:  Chromium is downloaded as zip (not exe or msi).
    Fix:
      FixType: Custom
      FixDetails:
        Solution:
          - MSIX Packaging Tool Installation Step, Unzip the chromium.zip and then launch chrome.exe.

FixType: PSF

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: There were create file errors in process monitor
    Fix:
      FixType: PSF
      Reference: https://github.com/Microsoft/MSIX-PackageSupportFramework/tree/master/fixups/FileRedirectionFixup
      FixDetails:
        PSFConfig:
          applications:
            - id: LINELAUNCHER
              executable: LINE/bin/LineLauncher.exe
              workingDirectory: LINE/bin/
          processes:
            - executable: LineLauncher
              fixups:
                - dll: FileRedirectionFixup.dll
                  config:
                    redirectedPaths:
                      packageRelative:
                        - base: LINE/Data/
                          patterns:
                            - .*\.tst
                        - base: LINE/bin/
                          patterns:
                            - .*

FixType: Servicios

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: MSIX Packaging Tool failed to convert to MSIX stating a service is running outside the package.
    Fix:
      FixType: Services
      FixDetails:
        Exclude:
          - CleanupPSvc

FixType: EntryPoint

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: Shortcut not captured
      Reference: https://microsoft.visualstudio.com/DefaultCollection/OS/_workitems/edit/35877020
    Fix:
      FixType: EntryPoint 
      FixDetails:
        EntryPointIssue: ShortcutNotCaptured
        Solution:
          - Launch from start menu

FixType: VirtualizaciónDeUbicaciónInstalada

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: Test Issue
    Fix:
      FixType: InstalledLocationVirtualization
      Reference: /uwp/schemas/appxpackage/uapmanifestschema/element-uap10-installedlocationvirtualization
      FixDetails:
        UpdateActionsAttributes:
          ModifiedItems: keep
          DeletedItems: reset
          AddedItems: keep

FixType: LoaderSearchPathOverride

RemediationApproach:
  - SequenceNumber: 1
    Issue:
      Description: DLL not found 
    Fix:
      FixType: LoaderSearchPathOverride
      Reference: /uwp/schemas/appxpackage/uapmanifestschema/element-uap6-loadersearchpathoverride
      FixDetails:
        FolderPaths: 
          - VFS\ProgramFilesX64\LINE\lib
          - VFS\ProgramFilesX64\LINE\bin

Valores aceptados para EligibleForConversion

Sí
No
No se requiere controlador

Valores aceptados para ConversionStatus

Satisfactorio: no se necesita corrección
Éxito - Corrección necesaria
Convertido con incidencias
Fracasado
No apto

Relación entre EligibleForConversion y ConversionStatus

Elegible para conversión	ConversionStatus
Sí	Correcto: no se requiere corrección, Correcto: se requiere corrección, Convertido con problemas
No	Fallido, no elegible
No se requiere controlador	No apto

Valores aceptados para FixType

Valores aceptados	Definiciones
Capacidad*	Funcionalidades necesarias (por ejemplo, allowElevation, uiAccess, etc.) para que funcione la aplicación MSIX. Para agregarlo en AppManifest o a través de la página Capacidades de la herramienta de empaquetado MSIX durante la conversión. Obtenga más información aquí.
Dependencia	Dependencias necesarias (por ejemplo: C++ 2008 Redistributable x86) para que funcione la aplicación MSIX. Para descargarse externamente en el entorno del sistema operativo.
Ruta de Instalación	Se usa para establecer la ubicación del instalador exe/msi en caso de que instale datos fuera de la carpeta predeterminada (Archivos de programa). La ruta debe agregarse en la página "Información del paquete" en la herramienta de empaquetado MSIX al convertir. Obtenga más información aquí.
Personalizado	Correcciones que el usuario debe realizar manualmente para corregir la aplicación MSIX. Por ejemplo, cambiar la secuencia de ID de la aplicación en el manifiesto de la aplicación.
PSF*	Agregar correcciones del marco de compatibilidad de paquetes (por ejemplo, FileRedirectionFixup) para corregir la aplicación MSIX. El usuario debe crear un config.json y agregarlo y otros archivos DLL necesarios en el paquete durante la conversión. Obtenga más información aquí. El autor del acelerador debe proporcionar el equivalente en yaml de config.json en el campo PSFConfig.
Servicios	Servicios que debían incluirse o excluirse para que la aplicación MSIX funcione. Debe especificarse en la herramienta Service Report of MSIX Packaging durante la conversión. Obtenga más información aquí.
PuntoDeEntrada	Para corregir problemas relacionados con EntryPoint (Por ejemplo, ShortcutNotCaptured). Obtenga más información aquí.
VirtualizaciónDeUbicaciónInstalada*	Es una extensión que redirige cualquier escritura del directorio de instalación de la aplicación a una ubicación en los datos de la aplicación. Consulte aquí y aquí para obtener más detalles. Los valores predeterminados de ModifiedItems, DeletedItems y AddedItems son mantener, reiniciar y mantener respectivamente.
LoaderSearchPathOverride*	Es una extensión que permite que un desarrollador de aplicaciones declare una ruta de acceso en el paquete de la aplicación, relativa a la ruta de acceso raíz del paquete de la aplicación, que se incluirá en la ruta de búsqueda del cargador para los procesos de la aplicación. El autor del acelerador debe proporcionar una lista de rutas de acceso que se van a incluir. Obtenga más información aquí.

Nota:

FixTypes aceptados marcados con un asterisco (*) arriba están compatibles automáticamente con la herramienta de empaquetado MSIX.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-06-10