アプリ インストーラー ファイルを使ったインストールに関する問題のトラブルシューティングTroubleshoot installation issues with the App Installer file

アプリ インストーラー ファイルからアプリケーションをインストールするときに問題が発生した場合、このトピックで示されているトラブルシューティングのガイダンスが役立つことがあります。If you find any issues when installing an application from the App Installer file, this topic will provide some troubleshooting guidance that may help.

前提条件Prerequisites

Windows 10 でアプリをサイドローディングできるようにするには、ユーザーのデバイスが以下の要件を満たしている必要があります。To be able to sideload apps in Windows 10, the user device must satisfy the next requirements:

  • デバイスで開発者モードまたはサイドローディング アプリが有効になっている必要があります。The device must be enabled for Developer Mode or Sideloading apps. 詳しくは、「デバイスを開発用に有効にする」ご覧ください。See Enable your device for development to learn more.
  • パッケージの署名に使う証明書がデバイスによって信頼されている必要があります。The certificate used to sign the package must be trusted by the device. 詳しくは、後述の「信頼できる証明書」をご覧ください。See the Trusted certificates section below for more details.
  • Windows 10 のバージョンで .appinstaller ファイル スキーマと配布プロトコルがサポートされている必要があります。The Windows 10 version must support the .appinstaller file schema and the distribution protocol.

一般的な問題Common issues

ユーザーのコンピューターで初めてアプリケーションをサイドローディングするときにいくつかの問題がよく発生します。There are some common issues when sideloading an application for first time in the user machine. 以降のセクションでは、最も一般的な問題とその解決策について説明します。The next few sections describe the most frequent issues and their solutions.

Windows のバージョンWindows version

Windows 10 の各リリースでは、サイドローディング エクスペリエンスが強化されています。次の表に、各メジャー リリースで利用可能な機能を示します。Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. お使いのバージョンの Windows 10 でサポートされていない方法を使ってアプリをサイドローディングしようとすると、展開エラーが発生します。If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.

バージョンVersion サイドローディングの注意事項Sideload Notes
ビルド 17134 (2018 年 4 月の更新、バージョン 1803)Build 17134 (April 2018 Update, version 1803) .appinstaller ファイルには、UNC/共有フォルダー経由でアクセスすることができます。The .appinstaller file can be accessed over UNC/Share folders. 構成可能な更新プログラムのチェックも使用できます。Configurable update checks are also available.
ビルド 16299 (Fall Creators Update バージョン 1709)Build 16299 (Fall Creators Update, version 1709) アプリを自動更新するため、.appinstaller ファイルが導入されました。Introduced the .appinstaller file to provide automatic updates to your app. このバージョンでは、HTTP エンドポイントのみサポートされます。This version only supports HTTP endpoints. 更新プログラムのチェックは構成できません。24 時間おきに行われます。Update checks are not configurable and happens each 24 hours.
ビルド 15063 (Creators Update バージョン 1703)Build 15063 (Creators Update, version 1703) アプリ インストーラー アプリは、Microsoft Store からアプリの依存関係をダウンロードできます (リリース モードでのみ)。The App Installer app is able to download app dependencies (only in release mode) from the Store.
ビルド 14393 (Anniversary Update バージョン 1607)Build 14393 (Anniversary Update, version 1607) .appx ファイルと .appxbundle ファイルをインストールするため、アプリ インストーラー アプリが導入されました.appinstaller ファイルはサポートされません。Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.
ビルド 10586 (November Update バージョン 1511)Build 10586 (November Update, version 1511) サイドローディングは、PowerShell で Add-AppxPackage コマンドを使う場合のみ使用できます。Sideload is only available through PowerShell using the Add-AppxPackage command.
ビルド 10240 (Windows 10 バージョン 1507)Build 10240 (Windows 10, version 1507) サイドローディングは、PowerShell で Add-AppxPackage コマンドを使う場合のみ使用できます。Sideload is only available through PowerShell using the Add-AppxPackage command.

信頼できる証明書Trusted certificates

アプリ パッケージは、デバイスで信頼されている証明書を使って署名されている必要があります。The app package must be signed with a certificate that is trusted by the device. 共通の証明機関によって提供される証明書は、Windows オペレーティング システムで既定で信頼されますが、証明書が信頼されていない場合、アプリをインストールする前にデバイスにインストールする必要があります。Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system, however if the certificate is not trusted, it must be installed in the device before installing the app. 証明書を信頼するには、証明書がデバイス上の次のいずれかのローカル コンピューター証明書ストアに存在している必要があります。To trust the certificate, the certificate must be present in one of the following local machine certificate stores on your device:

  • 信頼される発行者Trusted Publishers
  • 信頼されたユーザーTrusted People
  • 信頼されたルート機関 (非推奨)Trusted Root Authorities (not recommended)

重要

ローカル コンピューター ストアに証明書をインストールするには、管理アクセス権が必要です。Installing a certificate in the Local Machine store requires administrative access.

依存関係はインストールされないDependencies not installed

Windows 10 のアプリケーションでは、アプリの生成に使用されるアプリケーション プラットフォームに基づくフレームワーク依存関係を持つことができます。Windows 10 applications can have framework dependencies based on the application platform used to generate the app. C# や VB を使っている場合、アプリには .NET Runtime と .NET Framework パッケージが必要になります。If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. C++ アプリケーションには VCLibs が必要です。C++ applications require the VCLibs.

重要

アプリ パッケージがリリース モード構成でビルドされた場合、フレームワークの依存関係は Microsoft Store から取得されます。If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. ただし、アプリがデバッグ モード構成でビルドされた場合、依存関係は .appinstaller ファイルで指定された場所から取得されます。However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the .appinstaller file.

ファイルにアクセスできないFiles not accessible

HTTP エンドポイントからインストールする場合、すべてのファイルに正しい MIME タイプを使ってアクセスできることを確認することが重要です。When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. これらのファイルを確認する最も簡単な方法として、Visual Studio によって生成された HTML ページにあるリンクに移動できます。The easiest method to verify these files is by following the links provided in the HTML page generated by Visual Studio. 以下のファイルを確認する必要があります。You must check these files:

  • .appinstaller ファイルをとして使用します。 application/xml.appinstaller file, available as an application/xml
  • .appx .appxbundleファイルとして利用できます application/vns.ms-appx.appx and .appxbundle files, available as application/vns.ms-appx

アプリ インストーラー アプリの問題の切り分けIsolate App Installer app issues

アプリ インストーラー アプリがアプリをインストールできない場合、次の手順でインストールの問題を識別できます。If the App Installer app cannot install the app, these steps will help identify the installation issue.

アプリ パッケージ ファイルのインストールを確認します。Verify app package file installation

  • ローカル フォルダーに、アプリ パッケージ ファイルをダウンロードしてを使用してインストールしようとしています、 Add-appxpackage PowerShell コマンド。Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.

  • .appinstaller ファイルをローカル フォルダーにダウンロードし、Add-AppxPackage -Appinstaller PowerShell コマンドを使ってインストールしてみます。Download the .appinstaller file to a local folder and try to install it using the Add-AppxPackage -Appinstaller PowerShell command.

アプリ展開インフラストラクチャには、Windows イベント ビューアーでデバッグするためのログが用意されています。The app deployment infrastructure provides logs for debugging in the Windows Event Viewer. ここではこれらのログにあります。 Application and Services Logs->Microsoft->Windows->AppxDeployment-ServerThese logs are found here: Application and Services Logs->Microsoft->Windows->AppxDeployment-Server