Acceleratorer

En accelerator är ett effektivt sätt att konvertera äldre program (appar) till MSIX-format. Den består av viktig information om: paketet (appen); det operativsystem (OS) som konverteringen sker på. och de steg som krävs för att åtgärda paketet för att det konverterade MSIX ska fungera korrekt.

Förutsättningar

Om du vill prova acceleratorer i en förhandsversion av tidig åtkomst går du med i MSIX Packaging Tool Insider Program.

Skapa en accelerator

Information om hur du ser acceleratorstrukturen och hur du använder den för att skapa en egen accelerator finns i exempelacceleratorerna på GITHub-lagringsplatsen MSIX-Labs .

Definitioner

PackageName: Paketet är ett program eller program (Win32, WPF eller Windows Forms-app) som har ett äldre installationsprogram (exe, msi osv.) som konverteras till MSIX-format.
PackageVersion: Paketversioner är associerade med en specifik version. I vissa fall ser du ett perfekt formaterat Semantisk Version-nummer; och i andra fall kan du se något annat. Dessa kan vara datumdrivna, eller så kan de ha andra tecken med viss paketspecifik betydelse.
PublisherName: Namnet på den ursprungliga utgivaren av paketet.
EligibleForConversion: Vissa appar är förbjudna att konvertera av säkerhetsskäl, användning av drivrutiner osv. Därför används den här flaggan för att fastställa berättigandet till konvertering. Godkända värden finns här.
ConversionStatus: Fastställa status för programkonvertering. Godkända värden finns här.
RemediationApproach:
- SequenceNumber: Avgör sekvensnumret för ett korrigeringssteg. Korrigeringssteg för att konvertera appen måste anges sekventiellt.
- Problem:
  - Beskrivning: Textbeskrivning av det faktiska problemet som påträffades under konverteringen. Till exempel registerfel eller FilSkapa fel i Procmon.
  - Referens: (Valfritt fält) länk till dokumentet som innehåller detaljerad information om problemet.
- Korrigering:
  - FixType: Den specifika typen av steg. Exempel – Om FixType är "Kapacitet" måste en specifik funktion läggas till i det här läget. Godkända värden finns här.
  - Referens: Referenslänk till dokumentet som innehåller detaljerad information om korrigeringen och hur den behöver göras. Det här fältet är valfritt.
  - FixDetails: För att fastställa vilken typ av korrigering som krävs under en viss FixType. Exempel – Om Fixtype är "Dependency" skulle FixDetails ha ett fält av matristyp med namnet "Beroenden" för att visa en lista över alla beroenden som behöver läggas till för programmet. Användningsfall finns här.
MinimumPSFVersion: (Krävs endast när minst en av FixType använder PSF eller PackageSupportFramework). Eftersom PSF-versioner är bakåtkompatibla fungerar alla versioner som är större än den angivna versionen.
AdditionalComments: Att lista ytterligare information om appkonvertering, endast avsett för mänsklig läsning. Det här fältet är valfritt.
Utgåva: Utgåva av operativsystemet. Exempel – Windows 10 Enterprise.
MinimumOSVersion: Version av operativsystemet. Exempel – 21H1. Det här fältet är att ange att alla versioner som är större än den angivna operativsystemversionen ska fungera.
MinimumOSBuild: Skapa version av operativsystemet. Exempel – "19043.1165". Det här fältet är till för att ange att alla operativsystemversioner som är större än den angivna OS-versionen fungerar.
Arkitektur: Paketets arkitektur (programmet). (32/64 bitar)
MSIXConversionToolVersion: Version av MSIX-paketeringsverktyget som används för konvertering. Exempel – 1.2021.709.0;
AcceleratorVersion: Version av acceleratorn som används. För närvarande är den senaste versionen 1.0.0.

Kommandoradsalternativ för acceleratorer

För automatisk konvertering kan du generera acceleratormallen via MSIX-paketeringsverktyget.

Kontrollera att alternativet "Generera en kommandoradsfil med varje paket" är markerat i inställningarna för MSIX-packningsverktyget.
Konvertera en app med hjälp av verktyget för MSIX-paketering och tillämpa en accelerator i konverteringsprocessen.
Som standard sparas konverteringsmallfilen på samma plats som MSIX-paketet, såvida du inte anger en annan plats för sparande.
Kör MsixPackagingTool.exe i förhöjt läge.
Kör följande cmdlet för att använda acceleratormallen:

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

Mer information om hur du genererar en mallfil för kommandoradskonverteringar här. Lär dig mer om de parametrar som kan skickas som kommandoradsargument här.

Användningsfall för ConversionStatus

Lyckades – ingen korrigering krävs

ConversionStatus: Successful - No Fix Required

Lyckades – Korrigering krävs

ConversionStatus: Successful - Fix Required

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

Konverterad med problem

ConversionStatus: Converted With Issues

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

Misslyckades

ConversionStatus: Failed

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

Inte berättigad

EligibleForConversion: No - Driver Required

ConversionStatus: Not Eligible

Användningsfall för FixDetails

FixType: Kapacitet

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: Beroende

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

FixType: Installationsväg

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: Anpassad

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: Tjänster

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

FixTyp: Ingångspunkt

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

Typkorrigering: Installerad platsvirtualisering

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

FixTyp: 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

Godkända värden för EligibleForConversion

Ja
Nej
Nej – Drivrutin krävs

Godkända värden för ConversionStatus

Lyckades – ingen korrigering krävs
Lyckades – Korrigering krävs
Konverterad med problem
Misslyckades
Inte berättigad

Relation mellan EligibleForConversion och ConversionStatus

Kvalificerad för konvertering	Konvertering Status
Ja	Lyckades – Ingen korrigering krävs, Lyckades – Korrigering krävs, Konverterades med problem
Nej	Misslyckades, är inte berättigad
Nej – Drivrutin krävs	Inte berättigad

Godkända värden för FixType

Godkända värden	Definitioner
Förmåga*	Funktioner som behövs (t.ex. allowElevation, uiAccess osv.) för att MSIX-programmet ska fungera. Ska läggas till i AppManifest eller via sidan Funktioner i MSIX-paketeringsverktyget under konverteringen. Mer information finns här.
Beroende	Beroenden som behövs (t.ex. C++ 2008 Redistributable x86) för att MSIX-programmet ska fungera. Laddas ned externt i OS-miljön.
InstallationPath	Används för att anpassa installationsplatsen exe/msi om den installerar data utanför standardmappen (Programfiler). Sökvägen måste läggas till på sidan Paketinformation i MSIX-paketeringsverktyget under konverteringen. Mer information finns här.
Skräddarsydd	Korrigeringar som måste utföras manuellt av användaren för att åtgärda MSIX-programmet. T.ex. Ändra program-ID-sekvens i appmanifestet.
POLYESTERSTAPELFIBRER*	Lägga till korrigeringar för paketstödramverk (t.ex. FileRedirectionFixup) för att fixa MSIX-applikationen. Användaren måste skapa en config.json och lägga till den och andra nödvändiga dll:er i paketet under konverteringen. Mer information finns här. Acceleratorns författare måste ange yaml-motsvarigheten till config.json i FÄLTET PSFConfig.
Tjänster	Tjänster som behövde inkluderas/exkluderas för att MSIX-programmet ska fungera. Du måste ange i MSIX-paketeringsverktygets tjänstrapport under konverteringen. Mer information finns här.
Ingångspunkt	Åtgärda problem som rör EntryPoint (t.ex. ShortcutNotCaptured). Mer information finns här.
Installerad Platsvirtualisering	Det är ett tillägg som omdirigerar alla skrivningar till appens installationskatalog till en plats i programdata. Mer information finns här och här . Standardvärdena för ModifiedItems, DeletedItems och AddedItems är 'behåll', 'återställ' respektive 'behåll'.
LoaderSearchPathOverride*	Det är ett tillägg som gör att en apputvecklare kan deklarera en sökväg i apppaketet, i förhållande till rotsökvägen för apppaketet, som ska ingå i sökvägen för inläsaren för appens processer. Acceleratorns författare måste ange en lista över sökvägar som ska inkluderas. Mer information finns här.

Anmärkning

Accepterade FixTypes som markerats med en asterisk (*) ovan stöds automatiskt av MSIX-paketeringsverktyget.

Feedback

Var den här sidan hjälpsam?

Last updated on 2025-06-10