次の方法で共有


MSIX パッケージ作成ツールに関する既知の問題とトラブルシューティングのヒント

この記事では、既知の問題について説明するほか、MSIX Packaging Tool を使用してアプリを MSIX に変換するときに考慮すべきトラブルシューティングのヒントを提供します。 切断された環境で MSIX パッケージ作成ツールまたはドライバーを取得する必要がある場合は、他のドキュメントを確認してください。

既知の問題

MSIX パッケージ作成ツールの最新の Insider Preview ビルドを取得する

Insider Program にオプトインした場合、MSIX パッケージ作成ツールの正しいバージョンを持っていることを確認してください。

  • MSIX パッケージ作成ツールの [バージョン情報] セクションに移動して、使用しているバージョンを確認します。
  • ここに移動して最新の Insider Preview バージョンを判別し、そのバージョンの MSIX パッケージ作成ツールがインストールされていることを確認します。
  • フライティングのために新規登録した MSA が、Microsoft Store にサインインしているアカウントであることを確認します。
  • MSIX パッケージ作成ツールを、コンピューター上の Microsoft Store によって手動で更新します。 このオプションが使用可能な場合は、Store を開き、[ダウンロードと更新] に移動し、[更新情報の取得] をクリックします。 または、MSIX パッケージ作成ツールを検索し、その製品ページで更新のためのプロンプトを表示できます。
  • オフラインで使用するための MSIX パッケージ作成ツールをインストールするには、記載されている手順に従って、オフライン プロセスを通じて最新のアプリを取得してください。

Insider Program への参加に関心がある場合は、「MSIX Packaging Tool Insiders への参加」を 参照してください

MSIX パッケージ作成ツール ドライバー

MSIX パッケージ作成ツール ドライバーは、Windows Update からオンデマンド機能 (FOD) パッケージとして提供されます。 Windows Update サービスがコンピューターで無効になっている場合、または Windows Insider のフライト リング設定がコンピューターの OS ビルドと一致しない場合、インストールは失敗します。

ドライバーの取得で問題が発生している場合、またはオフライン環境で作業している場合は、ドライバーをダウンロードするためのリンクがここにあります。

ドライバーをダウンロードした後、パッケージの変換中に問題が発生している場合は、次のいずれかの問題である可能性があります。

ネットワーク接続の問題

次のエラー コードは、接続の問題が発生していることを示している可能性があります。

  • -2145107924 (0x8024402c)
  • -2145107945 (0x80244017)
  • -2145123272 (0x80240438)

Windows Server Update Service (WSUS)、Configuration Manager、または Windows Update の接続に影響を与えるグループ ポリシー

次のエラー コードは、コンピューター上のポリシーが 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 が発生し、ドライバーが失敗します。

解決策は、次の手順に従って、既存のイベント トレース セッションの一部を停止することです。

  1. [スタート] メニューを開き、パフォーマンス モニターを見つけます。
  2. それを右クリックして、[詳細] -> [管理者として実行] を選択します。
  3. ツリー メニューから、[データ コレクター セット] -> [イベント トレース セッション] を選択します。
  4. リストにある既存のセッションのいくつかを右クリックし、[停止] を選択します。

これで MSIX パッケージ作成ツールを使用して、変換の実行を再試行できます。

最小バージョン

いくつかの機能では、MSIX パッケージの最小バージョン サポートが自動的に変更されるので注意する必要があります。

Microsoft Store のバージョン管理要件の適用

1.2019.701.0 より前のバージョンの MSIX パッケージ作成ツールを使用して既存のインストーラーを変換する場合、ツールで [Microsoft Store のバージョン管理要件の適用] がオンになっている場合、または最小バージョンが 10.0.16299.0 (Windows 10 バージョン 1709) に設定されていない別のツールを使用してパッケージを作成した場合。 このとき、アプリを Windows 10 バージョン 1709 以降のバージョンにデプロイするとエラー メッセージが表示されます。

この問題を解決するには、MSIX パッケージ作成ツールを開き、パッケージ エディターを使用してアプリを編集します。 マニフェストを開き、TargetDeviceFamily 要素の MinVersion 属性を "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 をインストールすることはできませんが、Windows 10 1809 までは、MSIX パッケージ作成ツールを使用してそのような 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 パッケージ作成ツールは、これらのすべてのファイルの移動先となり、変換中にそれらがキャプチャされる場所を認識する必要があります。

この問題を解決するには、パッケージ サポート フレームワークのインストール ディレクトリへの書き込みの修正プログラムを使用します。 MSIX ツールには、この機能が既定で追加されました。これにより、この機能を 1809 まで使用することができます。 アプリケーションが 1709 では動作せず、1809 では動作する場合、この問題である可能性があります。

フィードバックの送信

フィードバックはフィードバック Hub から送信することが最善です。

  1. [フィードバック Hub] を開くか、Windows + F キーを押します。
  2. タイトルと、問題の再現に必要な手順を入力します。
  3. [区分] で、[アプリ][MSIX Packaging Tool] の順に選択します。
  4. 変換に関連付けられているログ ファイルを添付します。 ログは上記のフォルダー内にあります。
  5. 変換済み MSIX パッケージを添付します (可能な場合)。
  6. 送信 をクリックします。

[設定] の下の [ご意見ご感想] タブに移動して、MSIX Packaging Tool から直接フィードバックを送信することもできます。

Note

フィードバックが届くまでには 24 時間かかる場合があります。 したがって、VM を使用してパッケージを変換している場合は、変換後も VM をオンのままにし、現在の状態を 24 時間にわたって維持してください。 また、変換ログをフィードバックに手動で添付することもできます。