Delen via


Installatieproblemen met het app-installatiebestand oplossen

Als u problemen ondervindt bij het installeren van een toepassing vanuit het app-installatiebestand, vindt u in dit onderwerp enkele richtlijnen voor probleemoplossing die kunnen helpen.

Vereiste voorwaarden

Als u apps in Windows 10 wilt sideloaden, moet het apparaat van de gebruiker voldoen aan de volgende vereisten:

Windows 10:

  • Het certificaat dat wordt gebruikt om het pakket te ondertekenen, moet worden vertrouwd door het apparaat. Zie de sectie Vertrouwde certificaten hieronder voor meer informatie.
  • De Windows 10-versie moet het .appinstaller bestandsschema en het distributieprotocol ondersteunen.

Windows 10 1909 en eerder:

Veelvoorkomende problemen

Er zijn enkele veelvoorkomende problemen bij het sideloaden van een toepassing voor de eerste keer op de computer van de gebruiker. In de volgende secties worden de meest voorkomende problemen en hun oplossingen beschreven.

Windows-versie

Elke Windows 10-release verbetert de sideloading-ervaring. In de tabel hieronder vindt u welke functies beschikbaar zijn in elke hoofdrelease. Als u probeert een app te sideloaden met een methode die niet wordt ondersteund in uw versie van Windows 10, krijgt u een implementatiefout.

Versie Notities sideload
Build 17134 (update van april 2018, versie 1803) Het .appinstaller bestand kan worden geopend via UNC/Share-mappen. Configureerbare updatecontroles zijn ook beschikbaar.
Build 16299 (Fall Creators Update, versie 1709) Er is een .appinstaller bestand geïntroduceerd om automatische updates voor uw app te verzorgen. Deze versie ondersteunt alleen HTTP-eindpunten. Updatecontroles kunnen niet worden geconfigureerd en worden elke 24 uur uitgevoerd.
Build 15063 (Creators-update, versie 1703) De app App Installer kan app-afhankelijkheden (alleen in de releasemodus) downloaden uit de Store.
Build 14393 (Jubileumupdate, versie 1607) De app App Installer is geïntroduceerd voor het installeren van .appx- en .appxbundle-bestanden, het .appinstaller-bestand wordt niet ondersteund.
Build 10586 (update van november, versie 1511) Sideload is alleen beschikbaar via PowerShell met behulp van de opdracht Add-AppxPackage .
Build 10240 (Windows 10, versie 1507) Sideload is alleen beschikbaar via PowerShell met behulp van de opdracht Add-AppxPackage .

Vertrouwde certificaten

App-pakketten moeten zijn ondertekend met een certificaat dat wordt vertrouwd door het apparaat. Certificaten die worden geleverd door algemene certificeringsinstanties, worden standaard vertrouwd in het Windows-besturingssysteem.

Als het certificaat dat wordt gebruikt voor het ondertekenen van een app-pakket echter niet wordt vertrouwd of een lokaal gegenereerd/zelfondertekend certificaat is dat tijdens de ontwikkeling wordt gebruikt, kan het app-installatieprogramma melden dat het pakket niet wordt vertrouwd en wordt voorkomen dat het wordt geïnstalleerd:

MSIX ondertekend met ontbrekend of niet-vertrouwd certificaat

Om dit probleem op te lossen, moet een gebruiker met lokale beheerdersrechten voor het apparaat het hulpprogramma Computercertificaten gebruiken om het certificaat te importeren in een van de volgende containers:

  1. Lokale computer: Vertrouwde personen
  2. Lokale computer: Vertrouwde basisinstanties (niet aanbevolen)

Belangrijk

Importeer geen pakketondertekeningscertificaten in het certificaatarchief van de gebruiker. Het app-installatieprogramma zoekt geen gebruikerscertificaten bij het verifiëren van de pakketidentiteit.

U kunt het beheerprogramma Computercertificaten eenvoudig vinden door in het menu Start te zoeken:

Zoek het hulpprogramma voor lokale computercertificaten via het menu Start

Zodra het handtekeningcertificaat met succes is geïmporteerd, zal het opnieuw uitvoeren van het installatieprogramma van de app aantonen dat het pakket wordt vertrouwd en kan worden geïnstalleerd:

MSIX ondertekend met een vertrouwd certificaat

Afhankelijkheden niet geïnstalleerd

Windows 10-toepassingen kunnen frameworkafhankelijkheden hebben op basis van het toepassingsplatform dat wordt gebruikt om de app te genereren. Als u C# of VB gebruikt, zijn voor de app de .NET Runtime- en .NET Framework-pakketten vereist. C++-toepassingen zijn afhankelijk van de VCLibs.

Belangrijk

Als het app-pakket is ingebouwd in de configuratie van de releasemodus, worden de frameworkafhankelijkheden verkregen uit de Microsoft Store. Als de app echter is ingebouwd in de configuratie van de foutopsporingsmodus, worden de afhankelijkheden verkregen van de locatie die is opgegeven in het .appinstaller bestand.

Bestanden die niet toegankelijk zijn

Wanneer u installeert vanaf een HTTP-eindpunt, is het belangrijk om te controleren of alle vereiste bestanden toegankelijk zijn. De eenvoudigste methode om dit te controleren, is door de koppelingen te volgen die zijn opgegeven op de HTML-pagina die is gegenereerd door Visual Studio. U moet deze bestanden controleren:

  • een .appinstaller bestand, te vinden Additional Links > App Installer File op de door Visual Studio gegenereerde pagina
  • een .appx, .appxbundle, .misx of msixbundle bestand, gevonden Additional Links > Package Bundle op de door Visual Studio gegenereerde pagina

Opmerking

Afhankelijk van uw configuratie is er mogelijk meer dan één .appxof .appxbundle.misxmsixbundle meer bestanden betrokken bij uw implementatie. Zorg ervoor dat ze allemaal toegankelijk zijn.

Bestanden die worden geleverd met een onjuist MIME-type

Wanneer u installeert vanaf een HTTP-eindpunt, moeten alle bestanden worden geleverd met het juiste MIME-type in de Content-Type header van de webserver.

Bestanden zonder Content-Length header geleverd

Bij de installatie vanaf een HTTP-eindpunt moeten alle antwoorden een juiste Content-Length header bevatten. Dit omvat GET evenals HEAD aanvragen. Zorg ervoor dat ze allemaal hun Content-Length correct specificeren. Als u dit niet doet, kan dit leiden tot fouten zoals App installation failed with error message: Appinstaller operation failed with error code 0x80072F76. Detail: Unknown error (0x80072f76) of anderen.

De installatie van de app is mislukt met een foutbericht: de parameter is onjuist

Aangezien vanity-URL's op dit moment niet worden ondersteund, moet de bronparameter eindigen met ms-appinstaller bij gebruik van het .appinstaller protocol. Het maakt niet uit of u omleidt naar een bestand dat eindigt op .appinstaller. Dat zal ook op dezelfde manier mislukken. De enige manier om dit op te lossen is ervoor te zorgen dat de oorspronkelijke URL eindigt op .appinstaller.

Problemen met app-installatieprogramma isoleren

Als het app-installatieprogramma de app niet kan installeren, helpen deze stappen bij het identificeren van het installatieprobleem.

Installatie van app-pakketbestand controleren

  • Download het app-pakketbestand naar een lokale map en probeer het te installeren met behulp van de PowerShell-opdracht Add-AppxPackage .

  • Download het .appinstaller bestand naar een lokale map en probeer het te installeren met behulp van de Add-AppxPackage -Appinstaller PowerShell-opdracht.

Gebeurtenislogboeken van app-installatieprogramma

De infrastructuur voor app-implementatie verzendt logboeken die vaak handig zijn voor het opsporen van problemen met de installatie via de Windows Event Viewer: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server. Er worden extra logboekbestanden gemaakt in deze map: %LocalAppData%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir