MSIX 封裝工具的已知問題和疑難解答秘訣

本文說明已知問題，並提供使用 MSIX 封裝工具將應用程式轉換成 MSIX 時應考慮的疑難解答秘訣。 如果您需要在 中斷連線的環境中取得 MSIX 封裝工具或驅動程式，請參閱我們的其他檔。

已知問題

取得 MSIX 封裝工具的最新「Insider Preview」版本

如果您已選擇加入我們的 測試人員計劃，請確定您有正確的 MSIX 封裝工具版本：

  • 移至 MSIX 封裝工具中的 [ 關於 ] 區段，以檢視您所在的版本。
  • 請 移至這裡 來判斷最新的 Insider Preview 版本，並確認您已安裝該版本的 MSIX 封裝工具。
  • 請確保用於參加測試計畫的 MSA 帳戶是登入 Microsoft Store 的帳戶。
  • 請透過電腦上的 Microsoft Store 手動更新 MSIX 封包工具。 如果此選項可供您使用，請開啟 [市集]，移至 [ 下載和更新]，然後按兩下 [ 取得更新]。 或者，搜尋 MSIX 封裝工具，然後在產品頁面上提示進行更新。
  • 若要安裝 MSIX 封裝工具以供離線使用，請遵循 這些指示 ，確保您透過離線程式取得最新的應用程式。

如果您有興趣加入我們的測試人員計劃，請移至 加入 MSIX 封裝工具測試人員！。

MSIX 封裝工具驅動程式

MSIX 封裝工具驅動程式以 功能隨選（FOD）套件形式由 Windows Update 提供。 如果電腦上停用 Windows Update 服務，或 Windows Insider 飛行環設定與電腦的作業系統版本不符，安裝失敗。

如果您遇到取得驅動程式的問題，或是在離線環境中工作，您可以 在這裡找到下載驅動程序的連結。

如果您已下載驅動程式並在套件轉換期間發生問題，可能是下列其中一個問題。

網路連線問題

下列錯誤碼可能表示您遇到連線問題：

  • -2145107924 （0x8024402c）
  • -2145107945 （0x80244017）
  • -2145123272 （0x80240438）

Windows Server Update Service（WSUS）、設定管理員 或影響 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 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 版本的作業系統上安裝包含服務的 MSIX，但你可以使用 MSIX 打包工具建立該 MSIX，直到 Windows 10 1809。 如果您需要在較低的OS上安裝此應用程式，請適當地更新最小版本，但請注意，服務的支援將無法運作。

架構和驅動程式

如果應用程式需要架構，請確定架構是在轉換的監視階段安裝。 請瀏覽記錄，以確保這種情況正在發生。 如果您的應用程式需要安裝驅動程式，您必須評估應用程式是否需要此專案才能正確執行。 MSIX 目前不支援驅動程式安裝。

遠端電腦

如果您因使用遠端 VM 進行轉換而發生問題，請參閱 遠端電腦轉換的設定指示。

轉換期間的問題

  • 某些安裝程式可能無法使用結束代碼 259 進行轉換。 這表示安裝程式繁衍線程，但未等候線程完成。 換句話說，主執行緒已完成安裝，但結束時出現錯誤 259，因為它生成了一個仍在運行的執行緒。 建議您針對 setup.exe使用適當的安裝選項。

簽署期間的問題

無效的 PE 憑證 （0x800700C1）

當封裝包含具有損毀憑證的二進位檔時，就會發生此問題。 若要解決此問題，請使用 dumpbin.exe /headers 命令以傾印方式檢視檔案標頭，並檢查錯誤的元素。 手動重寫標頭以修正問題。 一般而言，MSIX 封裝工具會自動偵測不正確的標頭。 如果此問題持續發生，請提出意見反應。 您可以在這裡找到詳細資訊。

Device Guard 簽署

務必遵循這些步驟，並確保您在 Microsoft Store 商店中為企業分配適當的角色。

過期的憑證

  • 當您簽收包裹時，請使用時間戳。
  • 您可以使用有效的簽署或時間戳憑證來辭職。

您可以使用 MSIX 工具組 - 文稿的批次轉換腳本來辭職應用程式。

故障排除

記錄檔

無論您的轉換是否成功，都會針對每個轉換產生記錄檔。 您可以在這裡找到它們：

%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 封裝工具會擷取所有用戶層級快捷方式以及自變數。 如果無法正確偵測到這些快捷方式，您可以手動將其新增至指令清單。 如需詳細資訊，請參閱 desktop7：Shortcut 。

安裝目錄

對於使用次要磁碟驅動器來執行應用程序轉換的人來說，這比較常見。 如果您選擇變更安裝位置，它會變更所有檔案的根目錄。 這表示 MSIX 封裝工具必須知道所有這些檔案的去向，而且會在轉換期間擷取。

您可以使用套件支援框架的寫入功能來修正安裝目錄的問題。 在 MSIX 工具中，我們預設會將此功能新增為功能，這可讓此功能降到 1809。 如果您的應用程式在 1709 版本中無法運作，但能在 1809 版本中運作，這可能是問題所在。

傳送意見反應

傳送意見反應的最佳方式是透過意見反應中心。

  1. 開啟 Feedback Hub或輸入 Windows + F。
  2. 提供重現問題的標題和必要步驟。
  3. 在 [類別] 下，選取 [ 應用程式 ]，然後選取 [MSIX 封裝工具]。
  4. 附加與轉換相關聯的任何 記錄檔 。 您可以在上面提供的資料夾中找到記錄。
  5. 附加已轉換的 MSIX 套件（可能的話）。
  6. 按一下 [提交] 。

您也可以直接從 MSIX 封裝工具的 [設定] 底下的 [意見反應] 索引標籤來傳送意見反應。

備註

您的意見反應可能需要 24 小時才能到達我們。 因此，如果您使用 VM 來轉換套件，您可能想要在轉換後的 24 小時內將 VM 保持開啟且處於目前狀態。 此外，您也可以手動將轉換記錄附加至意見反應。

  • Last updated on