アプリ インストーラー ファイルからアプリケーションをインストールするときに問題が発生した場合は、このトピックで役立つトラブルシューティング ガイダンスを提供します。
[前提条件]
Windows 10 でアプリをサイドロードできるようにするには、ユーザー デバイスが次の要件を満たす必要があります。
Windows 10:
- パッケージの署名に使用される証明書は、デバイスによって信頼されている必要があります。 詳細については、以下の 「信頼できる証明書 」セクションを参照してください。
- Windows 10 バージョンでは、
.appinstaller
ファイル スキーマと配布プロトコルがサポートされている必要があります。
Windows 10 1909 以前:
- デバイスは、開発者モードまたはサイドローディング アプリで有効にする必要があります。 詳細については、「 デバイスの開発を有効にする 」を参照してください。
一般的な問題
ユーザー コンピューターでアプリケーションを初めてサイドロードする場合、いくつかの一般的な問題があります。 次のいくつかのセクションでは、最も頻繁に発生する問題とその解決策について説明します。
Windows のバージョン
各 Windows 10 リリースではサイドローディング エクスペリエンスが向上します。次の表では、各メジャー リリースで使用できる機能を確認できます。 Windows 10 のバージョンでサポートされていない方法を使用してアプリをサイドロードしようとすると、展開エラーが発生します。
バージョン | ノートのサイドロード |
---|---|
ビルド 17134 (2018 年 4 月の更新プログラム、バージョン 1803) |
.appinstaller ファイルには UNC/共有フォルダー経由でアクセスできます。 構成可能な更新チェックも利用できます。 |
ビルド 16299 (Fall Creators Update、バージョン 1709) | アプリに自動更新を提供するために、 .appinstaller ファイルを導入しました。 このバージョンでは、HTTP エンドポイントのみがサポートされています。 更新チェックは構成可能ではなく、24 時間ごとに行われます。 |
ビルド 15063 (Creators Update、バージョン 1703) | アプリ インストーラー アプリは、アプリの依存関係 (リリース モードのみ) をストアからダウンロードできます。 |
ビルド 14393 (Anniversary Update、バージョン 1607) | .appxファイルと .appxbundle ファイルをインストールするためのアプリ インストーラー アプリが導入されました。.appinstaller ファイルはサポートされていません。 |
ビルド 10586 (11 月の更新プログラム、バージョン 1511) | サイドロードは、 Add-AppxPackage コマンドを使用して PowerShell 経由でのみ使用できます。 |
ビルド 10240 (Windows 10 バージョン 1507) | サイドロードは、 Add-AppxPackage コマンドを使用して PowerShell 経由でのみ使用できます。 |
信頼された証明書
アプリ パッケージは、デバイスによって信頼されている証明書で署名する必要があります。 一般的な証明機関によって提供される証明書は、Windows オペレーティング システムでは既定で信頼されます。
ただし、アプリ パッケージの署名に使用される証明書が信頼されていない場合、または開発中にローカルで生成された自己署名証明書である場合、アプリ インストーラーはパッケージが信頼されていないことを報告し、インストールを妨げる可能性があります。
この問題を解決するには、デバイスに対するローカル管理者権限を持つユーザーが コンピューター証明書 ツールを使用して、証明書を次のいずれかのコンテナーにインポートする必要があります。
- ローカル コンピューター: 信頼できるユーザー
- ローカル コンピューター: 信頼されたルート機関 (推奨されません)
重要
パッケージ署名証明書をユーザー証明書ストアにインポートしないでください。 アプリ インストーラーは、パッケージ ID を確認するときにユーザー証明書を検索しません。
[スタート] メニューから検索すると、コンピューター証明書管理ツールを簡単に見つけることができます。
署名証明書が正常にインポートされると、アプリ インストーラーを再実行すると、パッケージが信頼され、インストール可能であることが表示されます。
依存関係がインストールされていない
Windows 10 アプリケーションは、アプリの生成に使用されるアプリケーション プラットフォームに基づいてフレームワークの依存関係を持つことができます。 C# または VB を使用している場合、アプリには .NET ランタイムパッケージと .NET Framework パッケージが必要です。 C++ アプリケーションには VCLibs が必要です。
重要
アプリ パッケージがリリース モード構成でビルドされている場合、フレームワークの依存関係は Microsoft Store から取得されます。 ただし、アプリがデバッグ モード構成でビルドされている場合、依存関係は、 .appinstaller
ファイルで指定された場所から取得されます。
アクセスできないファイル
HTTP エンドポイントからインストールする場合は、必要なすべてのファイルにアクセス可能であることを確認することが重要です。 これを確認する最も簡単な方法は、Visual Studio によって生成された HTML ページに記載されているリンクに従う方法です。 次のファイルを確認する必要があります。
- Visual Studio で生成されたページの
.appinstaller
にあるAdditional Links > App Installer File
ファイル -
.appx
、.appxbundle
、.misx
、またはmsixbundle
ファイル(Visual Studio で生成されたページのAdditional Links > Package Bundle
にあります)
注
構成によっては、デプロイに複数の .appx
、 .appxbundle
、 .misx
、または msixbundle
ファイルが含まれる場合があります。 すべてのユーザーがアクセスできることを確認します。
間違った MIME の種類で提供されたファイル
HTTP エンドポイントからインストールする場合、すべてのファイルは、Web サーバーによって ヘッダーにContent-Type
で提供される必要があります。
Content-Length ヘッダーなしで提供されるファイル
HTTP エンドポイントからインストールする場合、すべての応答に正しい Content-Length
ヘッダーを含める必要があります。 これには、 GET
と HEAD
要求が含まれます。 すべてのユーザーが Content-Length
を正しく指定していることを確認します。 これを行わないと、 App installation failed with error message: Appinstaller operation failed with error code 0x80072F76. Detail: Unknown error (0x80072f76)
などのエラーが発生する可能性があります。
エラー メッセージでアプリのインストールに失敗しました: パラメーターが正しくありません
現時点ではバニティ URL はサポートされていないため、 ms-appinstaller
プロトコルを使用する場合、ソース パラメーターは .appinstaller
で終わる必要があります。
.appinstaller
で終わるファイルにリダイレクトするかどうかは関係ありません。 これは同じ方法でも失敗します。 これを修正する唯一の方法は、元の URL が .appinstaller
で終わることを確認する方法です。
アプリ インストーラー アプリの問題を分離する
アプリ インストーラーでアプリをインストールできない場合、これらの手順はインストールの問題を特定するのに役立ちます。
アプリ パッケージ ファイルのインストールを確認する
アプリ パッケージ ファイルをローカル フォルダーにダウンロードし、 Add-AppxPackage PowerShell コマンドを使用してインストールを試みます。
.appinstaller
ファイルをローカル フォルダーにダウンロードし、Add-AppxPackage -Appinstaller
PowerShell コマンドを使用してインストールを試みます。
アプリ インストーラーのイベント ログ
アプリの展開インフラストラクチャは、Windows イベント ビューアーを使用したインストールの問題のデバッグに役立つログを生成します: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server
。 次のフォルダーに追加のログ ファイルが作成されます。 %LocalAppData%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir