この記事では、既知の問題について説明し、MSIX パッケージ ツールを使用してアプリを MSIX に変換する際に考慮すべきトラブルシューティングのヒントを示します。 切断された環境で MSIX パッケージ ツールまたはドライバーを取得する必要がある場合は、他のドキュメントを参照してください。
既知の問題
MSIX パッケージ 化ツールの最新の Insider Preview ビルドを取得する
Insider Program にオプトインしている場合は、MSIX Packaging Tool の正しいバージョンがあることを確認してください。
- MSIX パッケージ ツールの [バージョン情報 ] セクションに移動して、使用しているバージョンを確認します。
- 最新の Insider Preview バージョンを確認し、そのバージョンの MSIX Packaging Tool がインストールされていることを確認するには、 ここに 移動します。
- フライティングのために新規登録した MSA が、Microsoft Store にサインインしているアカウントであることを確認します。
- コンピューター上の Microsoft Store から MSIX パッケージ ツールを手動で更新します。 このオプションが使用可能な場合は、ストアを開き、[ ダウンロードと更新プログラム] に移動し、[ 更新プログラムの取得] をクリックします。 または、MSIX パッケージ 化ツールを検索し、製品ページで更新プログラムの入力を求めることができます。
- オフラインで使用するために MSIX Packaging Tool をインストールするには、 次の手順 に従って、オフライン プロセスを通じて最新のアプリを入手してください。
Insider Program への参加に関心がある場合は、「 MSIX Packaging Tool Insiders への参加」を参照してください。
MSIX パッケージ作成ツール ドライバー
MSIX パッケージ ツール ドライバーは、Windows Update から オンデマンド機能 (FOD) パッケージとして提供されます。 コンピューターで Windows Update サービスが無効になっている場合、または Windows Insider フライト リングの設定がコンピューターの OS ビルドと一致しない場合、インストールに失敗します。
ドライバーの取得で問題が発生している場合、またはオフライン環境で作業している場合は、ドライバーをダウンロードするためのリンク を参照してください。
ドライバーをダウンロードし、パッケージの変換中に問題が発生している場合は、次のいずれかの問題が発生する可能性があります。
ネットワーク接続の問題
次のエラー コードは、接続の問題が発生していることを示している可能性があります。
- -2145107924 (0x8024402c)
- -2145107945 (0x80244017)
- -2145123272 (0x80240438)
Windows Update の接続に影響する Windows Server Update Service (WSUS)、Configuration Manager、またはグループ ポリシー
次のエラー コードは、コンピューター上のポリシーが Windows Update の接続に影響していることを示している可能性があります: -2145124306 (0x8024002e)。
このエラー コードが表示される場合は、 環境設定とポリシーを確認する必要があります。
ドライバーの再インストールが必要
このシナリオでは、MSIX パッケージ 化ツールによって、ドライバーの再起動が必要であることを示すエラー メッセージとログが表示されます。 コンピューターを再起動し、もう一度変換を開始してこの問題を解決します。
MSIX パッケージ ツール ドライバー 0x80131500の起動中にエラーが発生しました
変換中にこのエラーが発生した場合、ログ ファイルを確認すると、次のようなエントリが見つかります。
[Error] Error monitoring: Insufficient system resources exist to complete the requested service
このエラーは、ツールが新しいシステム イベント トレース セッションを開始したが、Windows がシステム全体で作成できるセッションの最大数を超えている場合に発生します。 既定の制限 (64) を超えると、ERROR_NO_SYSTEM_RESOURCES エラーが発生し、ドライバーが失敗します。
解決策は、次の手順に従って、既存のイベント トレース セッションの一部を停止することです。
- [スタート] メニューを開き、パフォーマンス モニターを探します。
- それを右クリックし、[その他] -> [管理者として実行] を選択します。
- ツリー メニューから、データ コレクター セット -> イベント トレース セッションを選択します。
- リスト内の既存のセッションの一部を右クリックし、[停止] を選択します。
MSIX パッケージ ツールを使用して変換を再度実行できます。
最小バージョン
MSIX パッケージで minimun バージョンのサポートを自動的に変更することに注意する必要がある機能がいくつかあります。
Microsoft Store のバージョン管理要件を適用する
1.2019.701.0 より前のバージョンの MSIX Packaging Tool を使用して既存のインストーラーを変換した場合、ツールは Microsoft Store のバージョン管理要件を適用していたか、または別のツールを使用して、最小バージョンが 10.0.16299.0 (Windows 10 バージョン 1709) に設定されていないパッケージを作成しました。 これにより、アプリを Windows 10 バージョン 1709 以降のバージョンに展開するときにエラー メッセージが表示されます。
この問題を解決するには、 MSIX パッケージ ツール を開き、 パッケージ エディターでアプリを編集します。 マニフェストを開き、MinVersion
要素のTargetDeviceFamily
属性を "10.0.16299.0" に設定します。
<Dependencies>
<TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>
サービスを含む MSIX
MSIX パッケージ ツールのバージョン 1.2019.1220.0 では、サービスを使用して MSIX パッケージを作成するためのサポートが追加されました。 サービスのサポートに関する OS の制限により、MSIX パッケージ ツールは、サービスを含む MSIX パッケージでサポートされている最小バージョンを 10.0.19025.0 に自動的に変更します。 つまり、Windows 10 バージョン 2004 より低い OS にサービスを含む MSIX をインストールすることはできませんが、MSIX パッケージ 化ツールを使用して Windows 10 1809 まで MSIX を作成できます。 このアプリを下位の OS にインストールする必要がある場合は、最小バージョンを適切に更新しますが、サービスのサポートは機能しないことに注意してください。
フレームワークとドライバー
アプリにフレームワークが必要な場合は、変換の監視フェーズ中にフレームワークがインストールされていることを確認します。 ログを確認して、これが発生していることを確認します。 アプリでドライバーをインストールする必要がある場合は、アプリを正常に実行するためにこれが必要かどうかを評価する必要があります。 MSIX は現在、ドライバーのインストールをサポートしていません。
リモート コンピューター
変換にリモート VM を使用するときに問題が発生している場合は、 リモート コンピューターの変換のセットアップ手順を参照してください。
変換中の問題
- 一部のインストーラーは、終了コード 259 で変換できない場合があります。 これは、インストーラーがスレッドを生成し、完了するまで待機しなかったことを示します。 言い換えると、メイン スレッドはインストールを完了しましたが、まだ実行中のスレッドが生成されたため、エラー 259 で終了しました。 setup.exeに適切なインストール オプションを使用することをお勧めします。
署名中の問題
無効な PE 証明書 (0x800700C1)
この問題は、パッケージに証明書が破損しているバイナリ ファイルが含まれている場合に発生します。 この問題を解決するには、 dumpbin.exe /headers
コマンドを使用してファイル ヘッダーをダンプし、不適切な要素を調べます。 問題を解決するためにヘッダーを手動で書き換えます。 一般に、MSIX パッケージ 化ツールは無効なヘッダーを自動的に検出します。 この問題が解決しない場合は、フィードバックを送信してください。 詳細については、 こちらをご覧ください。
Device Guard の署名
次の手順に従い、ビジネス向け Microsoft Store で適切なロールを割り当てるようにしてください。
期限切れの証明書
- パッケージに署名するときにタイムスタンプを使用します。
- 有効な署名またはタイムスタンプ証明書を使用して、辞任することができます。
MSIX Toolkit - Scripts のバッチ変換スクリプトを使用して、アプリを再署名できます。
トラブルシューティング
ログ ファイル
変換が成功したかどうかにかかわらず、すべての変換に対してログ ファイルが生成されます。 これらは次の場所にあります。
%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\
エラー コードが書き込まれ、変換プロセス中にエラーが発生した時点を示します。 エラー コードは、わかりやすいものです。
リモート デバイスまたは VM からのログ ファイル
変換がリモート デバイスまたは VM で実行される場合は、そのデバイスからログ ファイルをコピーし、フィードバック項目の一部として添付することをお勧めします。 これにより、問題をより効率的に診断して解決できます。
リモート変換のログは、次の場所にあります。 %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt
ローカル クライアントとリモート サーバーで発生する操作を含む Logs フォルダー全体を共有できれば、さらに便利です。
一般的な問題
MakePri/Manifest 変換エラー
このエラーは、パッケージのマニフェストに問題がある場合に発生します。 問題を特定するには、パッケージ エディターに移動し、マニフェストを開きます。 マニフェストを開くと、問題を特定し、適切な修正プログラムを提供できます。
ファイルが見つかりません
ファイルが開いているか、存在しない可能性があります。 この問題を解決するには、適切なファイルを追加するか、現在使用中のファイルを閉じます。 開いている場合、 File not Found
エラーは発生しないことに注意してください。 代わりに、 Access Denied
または File in Use
エラーが発生します。
ファイルの種類の関連付け
ファイルの種類の関連付け (FTA) に関する問題は、パッケージによって異なります。 MSIXパッケージツールは、ダブルクリックインストールのためのファイルの関連付けをサポートしています。 たとえば、アプリにコンテキスト メニューがある場合は自動的に追加されないため、マニフェストに手動で追加する必要があります。 例については、 desktop4:FileExplorerContextMenus マニフェスト要素を参照してください。
引数を含むショートカット
MSIX Packaging ツールは、すべてのユーザー レベルのショートカットと引数をキャプチャします。 これらのショートカットが正しく検出されない場合は、マニフェストに手動で追加できます。 詳細については、 desktop7:Shortcut を参照してください。
ディレクトリのインストール
これは、セカンダリ ドライブを使用してアプリの変換を実行するユーザーにとってより一般的です。 インストール場所を変更すると、すべてのファイルのルートが変更されます。 つまり、MSIX Packaging ツールは、これらすべてのファイルが移動する場所を把握する必要があり、変換中にキャプチャされます。
これを修正するには、パッケージ サポート フレームワークの書き込みを使用してディレクトリ修正をインストールします。 MSIX ツールでは、これを既定で機能として追加しました。これにより、1809 まで可能になります。 アプリケーションが 1709 で動作せず、1809 年である場合は、これが問題である可能性があります。
フィードバックの送信
フィードバックを送信する最善の方法は、フィードバック ハブを通じて行 う方法です。
- フィードバック ハブを開くか、「Windows + F」と入力します。
- タイトルと、問題を再現するために必要な手順を指定します。
- [ カテゴリ] で [ アプリ ] を選択し、[ MSIX パッケージ ツール] を選択します。
- 変換に関連付けられている ログ ファイル を添付します。 ログは、上記のフォルダーにあります。
- 変換された MSIX パッケージをアタッチします (可能な場合)。
- 送信 をクリックします。
また、[設定] の [フィードバック] タブに移動して、MSIX パッケージ ツールから直接フィードバックを送信することもできます。
注
フィードバックが Microsoft に届くには 24 時間かかる場合があります。 そのため、VM を使用してパッケージを変換する場合は、変換後 24 時間、VM をオンにしたまま、現在の状態に保つことができます。 また、フィードバックに変換ログを手動で添付することもできます。