對應用程式安裝程式檔案的安裝問題進行疑難排解

如果您從應用程式安裝程式檔案安裝應用程式時發現任何問題,本主題會提供一些可能有助益的疑難排解指引。

必要條件

若要能夠在 Windows 10 中側載應用程式,使用者裝置必須符合以下需求:

Windows 10:

  • 用來簽署套件的憑證,必須受到裝置信任。 如需詳細資訊,請參閱以下的<驗證憑證>一節。
  • Windows 10 版本必須支援 .appinstaller 檔案結構描述和散發通訊協定。

Windows 10 1909 及更早版本:

常見問題

第一次在使用者電腦中側載應用程式時有一些常見問題。 接下來的幾個章節描述最常見的問題和其解決方案。

Windows 版本

每個 Windows 10 版本改善側載體驗,在下表您會找到每個主要版本中可用的功能。 如果您嘗試使用 Windows 10 版本中不支援的方法側載應用程式,會發生部署錯誤。

版本 側載附註
組建 17134 (2018 年4月更新版本 1803) 可以透過 UNC/共用資料夾存取 .appinstaller 檔案。 也會提供可設定的更新檢查。
組建 16299 (Fall Creators Update,版本 1709) 導入了.appinstaller檔案以提供應用程式的自動更新。 此版本僅支援 HTTP 端點。 更新檢查不可以設定,而且每隔 24 小時發生一次。
組建 15063 (Creators Update,版本 1703) 應用程式安裝程式應用程式可以從 Microsoft Store 下載 app 相依性(只能在發行模式)。
組建 14393 (年度更新版,版本 1607) 導入了應用程式安裝程式應用程式以安裝.appx 和.appxbundle 檔案,.appinstaller 檔案不受支援。
組建 10586 (11 月更新,版本 1511) 透過 PowerShell 使用Add-AppxPackage命令,才可以側載。
Build 10240 (Windows 10,版本 1507) 透過 PowerShell 使用Add-AppxPackage命令,才可以側載。

受信任的憑證

應用程式套件必須使用裝置信任的憑證進行簽署。 一般憑證授權單位單位所提供的憑證預設會在 Windows 作業系統中受到信任。

但是,如果用來簽署應用程式套件的憑證不受信任,或者是在開發期間使用的本機產生/自我簽署的憑證,則應用程式安裝程式可能會報告套件未受信任,而且會防止其安裝:

MSIX 已簽署,但缺少憑證或未受信任的憑證

若要解決此問題,具有裝置之本機系統管理員許可權的使用者必須使用 [ 電腦憑證 ] 工具,將憑證匯入下列其中一個容器:

  1. 本機電腦:信任的人
  2. 本機電腦:不建議使用受信任的根授權單位 ()

重要

請勿將套件簽署憑證匯入使用者憑證存放區。 當驗證套件身分識別時,應用程式安裝程式不會搜尋使用者憑證。

從 [開始] 功能表搜尋,即可輕鬆找到電腦憑證管理工具:

透過 [開始] 功能表尋找 [本機電腦憑證] 工具

成功匯入簽署憑證之後,重新執行應用程式安裝程式會顯示該套件已受信任且可以安裝:

使用受信任憑證簽署的 MSIX

未安裝相依性

Windows 10 的應用程式可以根據用來產生應用程式的應用程式平臺來建立架構相依性。 如果您使用 C# 或 VB,app 會需要 .NET 執行階段和 .NET Framework 套件。 C++ 應用程式需要 VCLibs。

重要

如果在發行模式設定中建置應用程式套件,將會從 Microsoft Store 取得架構相依性。 不過,如果在偵錯模式設定中建置應用程式,將會從.appinstaller檔案中指定的位置取得相依性。

不可存取檔案

從 HTTP 端點安裝時,請務必確認所有檔案都是正確的 MIME 類型、可供存取。 確認這些檔案最簡單的方法是追蹤 Visual Studio 所產生 HTML 網頁中的連結。 您必須檢查這些檔案︰

  • .appinstaller 檔案,提供為 application/xml
  • .appx 和檔案 .appxbundle ,提供為 application/vns.ms-appx

應用程式安裝失敗,錯誤訊息:參數不正確

因為目前不支援虛名 Url,所以在使用 ms-appinstaller 通訊協定時,來源參數必須以結尾 .appinstaller 。 如果您重新導向至結尾為的檔案,則不重要 .appinstaller 。 這樣也會以相同的方式失敗。 修正此問題的唯一方法是確定原始 url 的結尾是 .appinstaller

找出應用程式安裝程式應用程式問題

如果應用程式安裝程式無法安裝應用程式,這些步驟將有助於找出安裝問題。

確認應用程式套件檔案安裝

  • 將應用程式套件檔案下載至本機資料夾,並嘗試使用 Add-appxpackage PowerShell 命令進行安裝。

  • 下載.appinstaller檔案到本機資料夾,然後使用Add-AppxPackage -Appinstaller PowerShell 命令嘗試安裝它。

應用程式安裝程式事件記錄檔

應用程式部署基礎結構會發出記錄,這些記錄通常有助於透過 Windows 事件檢視器來偵測安裝問題:Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server