Problembehandlung bei der Installation mit der App-Installer-DateiTroubleshoot installation issues with the App Installer file

Wenn beim Installieren einer Anwendung aus der APP-Installationsdatei Probleme auftreten, finden Sie in diesem Thema einige Anleitungen zur Problembehandlung, die Ihnen helfen können.If you find any issues when installing an application from the App Installer file, this topic will provide some troubleshooting guidance that may help.

VoraussetzungenPrerequisites

Zum querladen von apps in Windows 10 muss das Benutzergerät die folgenden Anforderungen erfüllen:To be able to sideload apps in Windows 10, the user device must satisfy the next requirements:

  • Das Gerät muss für den Entwicklermodus oder Sideload-apps aktiviert werden.The device must be enabled for Developer Mode or Sideloading apps. Weitere Informationen finden Sie unter Aktivieren Ihres Geräts für die Entwicklung .See Enable your device for development to learn more.
  • Das Zertifikat, mit dem das Paket signiert wird, muss vom Gerät als vertrauenswürdig eingestuft werden.The certificate used to sign the package must be trusted by the device. Weitere Informationen finden Sie unten im Abschnitt " vertrauenswürdige Zertifikate ".See the Trusted certificates section below for more details.
  • Die Windows 10-Version muss das .appinstaller Datei Schema und das Verteilungs Protokoll unterstützen.The Windows 10 version must support the .appinstaller file schema and the distribution protocol.

Allgemeine ProblemeCommon issues

Beim ersten Sideload einer Anwendung auf dem Benutzer Computer sind einige häufige Probleme aufgetreten.There are some common issues when sideloading an application for first time in the user machine. In den nächsten Abschnitten werden die häufigsten Probleme und ihre Lösungen beschrieben.The next few sections describe the most frequent issues and their solutions.

Windows-VersionWindows version

Alle Windows 10-Releases verbessern die Sideload-Umgebung. in der folgenden Tabelle werden Sie feststellen, welche Features in den einzelnen Hauptversionen verfügbar sind.Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. Wenn Sie versuchen, eine App mithilfe einer Methode quer zuladen, die in Ihrer Windows 10-Version nicht unterstützt wird, erhalten Sie einen Bereitstellungs Fehler.If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.

VersionVersion Querladen NotizenSideload Notes
Build 17134 (April 2018 Update, Version 1803)Build 17134 (April 2018 Update, version 1803) .appinstallerAuf die Datei kann über UNC/Share-Ordner zugegriffen werden.The .appinstaller file can be accessed over UNC/Share folders. Konfigurierbare Update Überprüfungen sind ebenfalls verfügbar.Configurable update checks are also available.
Build 16299 (Fall Creators Update, Version 1709)Build 16299 (Fall Creators Update, version 1709) In wurde die .appinstaller Datei eingeführt, um automatische Updates für Ihre APP bereitzustellen.Introduced the .appinstaller file to provide automatic updates to your app. Diese Version unterstützt nur HTTP-Endpunkte.This version only supports HTTP endpoints. Update Überprüfungen sind nicht konfigurierbar und werden alle 24 Stunden ausgeführt.Update checks are not configurable and happens each 24 hours.
Build 15063 (Creators Update, Version 1703)Build 15063 (Creators Update, version 1703) Die APP-Installer-app kann App-Abhängigkeiten (nur im Releasemodus) aus dem Store herunterladen.The App Installer app is able to download app dependencies (only in release mode) from the Store.
Build 14393 (Anniversary Update, Version 1607)Build 14393 (Anniversary Update, version 1607) In wurde die APP-Installer-app zum Installieren von AppX-und appxbundle-Dateien eingeführt. die appinstaller-Datei wird nicht unterstützt.Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.
Build 10586 (November Update, Version 1511)Build 10586 (November Update, version 1511) Sideload ist nur über PowerShell mit dem Befehl Add-appxpackage verfügbar.Sideload is only available through PowerShell using the Add-AppxPackage command.
Build 10240 (Windows 10, Version 1507)Build 10240 (Windows 10, version 1507) Sideload ist nur über PowerShell mit dem Befehl Add-appxpackage verfügbar.Sideload is only available through PowerShell using the Add-AppxPackage command.

Vertrauenswürdige ZertifikateTrusted certificates

App-Pakete müssen mit einem Zertifikat signiert werden, das vom Gerät als vertrauenswürdig eingestuft wird.App packages must be signed with a certificate that is trusted by the device. Zertifikate, die von allgemeinen Zertifizierungsstellen bereitgestellt werden, sind im Windows-Betriebssystem standardmäßig vertrauenswürdig.Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system.

Wenn das Zertifikat, das zum Signieren eines App-Pakets verwendet wird, nicht vertrauenswürdig ist oder bei der Entwicklung ein lokal generiertes bzw. selbst signiertes Zertifikat verwendet wird, meldet der APP-Installer möglicherweise, dass das Paket nicht vertrauenswürdig ist, und verhindert die Installation:However, if the certificate used to sign an app package is not trusted, or is a locally-generated/self-signed certificate used during development, the app installer may report that the package is untrusted and will prevent it from being installed:

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 Computer Zertifikate verwenden, um das Zertifikat in einen der folgenden Container zu importieren:To solve this issue, a user with local administrator rights to the device must use the Computer Certificates tool to import the certificate into one of the following containers:

  1. Lokaler Computer: vertrauenswürdige PersonenLocal Computer: Trusted People
  2. Lokaler Computer: vertrauenswürdige Stamm Zertifizierungsstellen (nicht empfohlen)Local Computer: Trusted Root Authorities (not recommended)

Wichtig

Importieren Sie keine Paket Signatur Zertifikate in den Zertifikat Speicher des Benutzers.Do not import package signing certificates into the User Certificate store. Beim Überprüfen der Paket Identität werden Benutzerzertifikate vom APP-Installer nicht durchsucht.The App Installer does not search User Certificates when verifying package identity.

Das Tool für die Verwaltung von Computer Zertifikaten ist leicht zu finden, indem Sie im Startmenü nach:The Computer Certificates management tool can be easily found by searching from the Start Menu:

Suchen des Tools für lokale Computer Zertifikate über das Startmenü

Nachdem das Signaturzertifikat erfolgreich importiert wurde, wird durch das erneute Ausführen des App-Installers angezeigt, dass das Paket vertrauenswürdig ist und installiert werden kann:Once the signing certificate is successfully imported, re-running the app installer will show that the package is trusted and can be installed:

Msix mit vertrauenswürdigem Zertifikat signiert

Nicht installierte AbhängigkeitenDependencies not installed

Für Windows 10-Anwendungen können frameworkabhängigkeiten basierend auf der Anwendungsplattform vorhanden sein, die zum Generieren der APP verwendet wird.Windows 10 applications can have framework dependencies based on the application platform used to generate the app. Wenn Sie c# oder VB verwenden, benötigt die APP die .NET-Runtime-und .NET Framework-Pakete.If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. C++-Anwendungen erfordern die vclisb.C++ applications require the VCLibs.

Wichtig

Wenn das App-Paket in der releasemoduskonfiguration erstellt wird, werden die Framework-Abhängigkeiten vom Microsoft Store abgerufen.If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. Wenn die APP jedoch in der Konfiguration des Debugmodus erstellt wird, werden die Abhängigkeiten von dem in der Datei angegebenen Speicherort abgerufen .appinstaller .However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the .appinstaller file.

Dateien nicht zugänglichFiles not accessible

Bei der Installation von einem HTTP-Endpunkt ist es wichtig zu überprüfen, ob auf alle Dateien mit dem richtigen MIME-Typ zugegriffen werden kann.When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. Die einfachste Methode, diese Dateien zu überprüfen, ist das Befolgen der Links, die in der von Visual Studio generierten HTML-Seite bereitgestellt werden.The easiest method to verify these files is by following the links provided in the HTML page generated by Visual Studio. Diese Dateien müssen überprüft werden:You must check these files:

  • .appinstaller Datei, verfügbar als application/xml.appinstaller file, available as an application/xml
  • .appx -und- .appxbundle Dateien, verfügbar als application/vns.ms-appx.appx and .appxbundle files, available as application/vns.ms-appx

App-Probleme mit APP-Installer isolierenIsolate App Installer app issues

Wenn die APP vom APP-Installer nicht installiert werden kann, können Sie mithilfe dieser Schritte das Installationsproblem identifizieren.If the App Installer cannot install the app, these steps will help identify the installation issue.

Überprüfen der APP-Paketdatei InstallationVerify app package file installation

  • Laden Sie die APP-Paketdatei in einen lokalen Ordner herunter, und versuchen Sie, Sie mit dem PowerShell -Befehl Add-appxpackage zu installieren.Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.

  • Laden .appinstaller Sie die Datei in einen lokalen Ordner herunter, und versuchen Sie, Sie mit dem Add-AppxPackage -Appinstaller PowerShell-Befehl zu installieren.Download the .appinstaller file to a local folder and try to install it using the Add-AppxPackage -Appinstaller PowerShell command.

Ereignisprotokolle für APP-InstallerApp Installer event logs

Die APP-Bereitstellungs Infrastruktur gibt Protokolle aus, die häufig für das Debuggen von Installationsproblemen über das Windows-Ereignisanzeige nützlich sind Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-ServerThe app deployment infrastructure emits logs that are often useful for debugging installation issues via the Windows Event Viewer: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server