Problembehandlung bei der Installation mit der App-Installer-Datei

Wenn Sie Probleme beim Installieren einer Anwendung aus der App-Installer finden, finden Sie in diesem Thema anleitungen zur Problembehandlung, die ihnen helfen können.

Voraussetzungen

Das Benutzergerät muss die nächsten Anforderungen erfüllen, um Apps in Windows 10 laden zu können:

Windows 10:

  • Das Zertifikat, das zum Signieren des Pakets verwendet wird, muss vom Gerät als vertrauenswürdig eingestuft werden. Weitere Informationen finden Sie weiter unten im Abschnitt Vertrauenswürdige Zertifikate.
  • Die Windows 10 version muss das .appinstaller Dateischema und das Verteilungsprotokoll unterstützen.

Windows 10 1909 und früher:

Häufige Probleme

Es gibt einige häufige Probleme beim erstmaligen Sideloaden einer Anwendung auf dem Benutzercomputer. In den nächsten Abschnitten werden die häufigsten Probleme und deren Lösungen beschrieben.

Windows-Version

Jedes Windows 10 verbessert das Sideloading. In der folgenden Tabelle sehen Sie, welche Features in den einzelnen Hauptversionen verfügbar sind. Wenn Sie versuchen, eine App mit einer Methode zu sideloaden, die in Ihrer Version von Windows 10 nicht unterstützt wird, erhalten Sie einen Bereitstellungsfehler.

Version Hinweise zum Sideload
Build 17134 (Update april 2018, Version 1803) Auf .appinstaller die Datei kann über UNC-/Freigabeordner zugegriffen werden. Konfigurierbare Updateüberprüfungen sind ebenfalls verfügbar.
Build 16299 (Fall Creators Update, Version 1709) Die Datei wurde .appinstaller eingeführt, um automatische Updates für Ihre App zu ermöglichen. Diese Version unterstützt nur HTTP-Endpunkte. Updateüberprüfungen sind nicht konfigurierbar und werden alle 24 Stunden durchgeführt.
Build 15063 (Creators Update, Version 1703) Die App-Installer App kann App-Abhängigkeiten (nur im Releasemodus) aus dem Store.
Build 14393 (Anniversary Update, Version 1607) Die App App-Installer App zum Installieren von APPX- und APPXBUNDLE-Dateien wurde eingeführt. Die APPINSTALLER-Datei wird nicht unterstützt.
Build 10586 (November Update, Version 1511) Sideload ist nur über PowerShell mithilfe des Befehls Add-AppxPackage verfügbar.
Build 10240 (Windows 10, Version 1507) Sideload ist nur über PowerShell mithilfe des Befehls Add-AppxPackage verfügbar.

Vertrauenswürdige Zertifikate

App-Pakete müssen mit einem Zertifikat signiert werden, das vom Gerät als vertrauenswürdig eingestuft wird. Zertifikate, die von allgemeinen Zertifizierungsstellen bereitgestellt werden, sind im Betriebssystem Windows vertrauenswürdig.

Wenn das Zertifikat, das zum Signieren eines App-Pakets verwendet wird, jedoch nicht vertrauenswürdig ist oder ein lokal generiertes/selbstsigniertes Zertifikat ist, das während der Entwicklung verwendet wird, kann das App-Installationsprogramm melden, dass das Paket nicht vertrauenswürdig ist, und verhindert die Installation:

MSIX mit fehlendem oder nicht vertrauenswürdigem Zertifikat signiert

Um dieses Problem zu beheben, muss ein Benutzer mit lokalen Administratorrechten für das Gerät das Tool Computerzertifikate verwenden, um das Zertifikat in einen der folgenden Container zu importieren:

  1. Lokaler Computer: Vertrauenswürdige Personen
  2. Lokaler Computer: Vertrauenswürdige Stammzertifizierungsstellen (nicht empfohlen)

Wichtig

Importieren Sie keine Paketsignaturzertifikate in den Benutzerzertifikatspeicher. Der App-Installer sucht beim Überprüfen der Paketidentität nicht nach Benutzerzertifikaten.

Das Verwaltungstool Für Computerzertifikate ist leicht zu finden, indem Sie im Startmenü suchen:

Suchen des tools für lokale Computerzertifikate über das Startmenü

Nachdem das Signaturzertifikat erfolgreich importiert wurde, zeigt das erneute Ausführen des App-Installers an, dass das Paket vertrauenswürdig ist und installiert werden kann:

MSIX mit einem vertrauenswürdigen Zertifikat signiert

Abhängigkeiten nicht installiert

Windows 10 Anwendungen können Frameworkabhängigkeiten aufweisen, die auf der Anwendungsplattform basieren, die zum Generieren der App verwendet wird. Wenn Sie C# oder VB verwenden, benötigt die App die Pakete .NET Runtime und .NET Framework. C++-Anwendungen erfordern VCLibs.

Wichtig

Wenn das App-Paket in der Konfiguration des Releasemodus erstellt wurde, werden die Frameworkabhängigkeiten aus der Microsoft Store. Wenn die App jedoch in der Debugmoduskonfiguration erstellt wurde, werden die Abhängigkeiten von dem in der Datei angegebenen Speicherort .appinstaller ermittelt.

Auf Dateien kann nicht zugegriffen werden

Bei der Installation über einen HTTP-Endpunkt ist es wichtig zu überprüfen, ob auf alle Dateien mit dem richtigen MIME-Typ zugegriffen werden kann. Am einfachsten können Sie diese Dateien überprüfen, indem Sie die Links auf der html-Seite aufrufen, die von Visual Studio. Sie müssen diese Dateien überprüfen:

  • .appinstaller -Datei, verfügbar als application/xml
  • .appx - .appxbundle und -Dateien, verfügbar als application/vns.ms-appx

Fehler bei der App-Installation mit Fehlermeldung: Der Parameter ist falsch.

Da vanity-URLs derzeit nicht unterstützt werden, MUSS der Quellparameter bei Verwendung des Protokolls ms-appinstaller mit .appinstaller enden. Es spielt keine Rolle, ob Sie zu einer Datei umleiten, die mit .appinstaller endet. Dies wird auch auf die gleiche Weise fehlschlagen. Die einzige Möglichkeit, dies zu beheben, besteht im Sicherstellen, dass die ursprüngliche URL mit .appinstaller endet.

Isolieren App-Installer App-Problemen

Wenn der App-Installer die App nicht installieren kann, helfen diese Schritte beim Identifizieren des Installationsproblems.

Überprüfen der Installation der App-Paketdatei

  • Laden Sie die App-Paketdatei in einen lokalen Ordner herunter, und versuchen Sie, sie mit dem PowerShell-Befehl Add-AppxPackage zu installieren.

  • Laden Sie .appinstaller die Datei in einen lokalen Ordner herunter, und versuchen Sie, sie mithilfe des Add-AppxPackage -Appinstaller PowerShell-Befehls zu installieren.

App-Installer von Ereignisprotokollen

Die App-Bereitstellungsinfrastruktur gibt Protokolle aus, die häufig zum Debuggen von Installationsproblemen über die folgenden Windows Ereignisanzeige:Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server