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

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

必要條件

若要能夠在 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 signed with missing or untrusted Cert

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

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

重要

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

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

Find the local Computer Certificates tool via the Start Menu

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

MSIX signed with a trusted Cert

未安裝相依性

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