應用程式套件要求

  • 發行項

請遵循這些指導方針來準備應用程式的套件，以提交至 Microsoft Store。

建置 Microsoft Store 應用程式套件之前

請務必 使用 Windows 應用程式認證套件來測試您的應用程式。 我們也建議您在不同類型的硬體上測試您的應用程式。 請注意，在我們認證您的應用程式並使其可從 Microsoft Store 取得之前，它只能安裝在具有開發人員授權的電腦上並執行。

使用 Microsoft Visual Studio 建置應用程式套件

如果您使用 Microsoft Visual Studio 作為開發環境，則已經有內建工具，可讓建立應用程式套件成為快速且簡單的程式。 如需詳細資訊，請參閱 封裝應用程式。

注意

請確定您的所有檔名都使用 ANSI。

當您在 Visual Studio 中建立套件時，請確定您已使用與您開發人員帳戶相關聯的相同帳戶登入。 套件指令清單的某些部分有與您的帳戶相關的特定詳細數據。 系統會自動偵測並新增這項資訊。 若未將其他資訊新增至指令清單，您可能會遇到套件上傳失敗。

當您建置應用程式的 UWP 套件時，Visual Studio 可以建立 .msix 或 appx 檔案，或 .msixupload 或 .appxupload 檔案。 針對UWP app，建議您一律在 [套件] 頁面中上傳 .msixupload 或 .appxupload 檔案。 如需封裝市集 UWP 應用程式的詳細資訊，請參閱 使用 Visual Studio 封裝 UWP 應用程式。

您的應用程式套件不需要使用跟在受信任證書頒發機構單位中的憑證進行簽署。

應用程式套件組合

針對UWP應用程式，Visual Studio可以產生應用程式套件組合 （.msixbundle 或 .appxbundle），以減少使用者下載的應用程式大小。 如果您已定義特定語言資產、各種映射規模資產，或套用至特定版本的 Microsoft DirectX 資源，這會很有説明。

注意

 一個應用程式套件組合可以包含所有架構的套件。

使用應用程式套件組合時，使用者只會下載相關的檔案，而不是所有可能的資源。 如需應用程式套件組合的詳細資訊，請參閱使用Visual Studio封裝應用程式和封裝UWP應用程式。

手動建置應用程式套件

如果您未使用 Visual Studio 來建立套件，則必須 手動建立套件指令清單。

請務必檢閱 應用程式套件指令清單檔，以取得完整的指令清單 詳細數據和需求。 您的指令清單必須遵循套件指令清單架構，才能通過認證。

您的指令清單必須包含一些關於您的帳戶和應用程式的特定資訊。 您可以在儀錶板中應用程式概觀頁面的 [產品管理] 區段中查看檢視應用程式身分識別詳細數據，以找到此資訊。

注意

 指令清單中的值會區分大小寫。 空格和其他標點符號也必須相符。 仔細輸入這些值，並加以檢閱，以確保它們正確無誤。

應用程式套件組合 （.msixbundle 或 .appxbundle） 使用不同的指令清單。 如需應用程式套件組合指令清單的詳細數據和需求，請檢閱套件組合指令清單檔。 請注意，在 .msixbundle 或 .appxbundle 中，每個包含套件的指令清單都必須使用相同的元素和屬性，但 Identity 元素的 ProcessorArchitecture 屬性除外。

提示

 提交套件之前，請務必執行 Windows 應用程式認證套件 。 這可協助您判斷您的指令清單是否有任何可能導致認證或提交失敗的問題。

套件格式需求

您的應用程式套件必須符合這些需求。

應用程式套件屬性 需求
封裝大小 .msixbundle 或 .appxbundle：每個套件組合最多 25 GB
以 Windows 10 或 Windows 11 為目標的 .msix 或 .appx 套件：每個套件上限為 25 GB
封鎖對應哈希 SHA2-256 演算法

重要

您無法再上傳使用 Windows 電話 8.x SDK 所建置的新 XAP 套件。 已在市集中使用 XAP 套件的應用程式將繼續在 Windows 10 行動裝置版 裝置上運作。 如需詳細資訊，請參閱此 部落格文章。

支援的版本

針對UWP app，所有套件都必須以市集支援的Windows 10或 Windows 11 版本為目標。 套件支援的版本必須以應用程式指令清單之 TargetDeviceFamily 元素的 MinVersion 和 MaxVersionTested 屬性指出。

目前支援的版本範圍從：

  • 最小值：10.0.10240.0
  • 最大值：10.0.22621.0

StoreManifest XML 檔案

StoreManifest.xml是可能包含在應用程式套件中的選擇性組態檔。 其用途是啟用功能，例如將您的應用程式宣告為 Microsoft Store 裝置應用程式，或宣告套件相依於裝置的需求，套件指令清單未涵蓋。 如果使用，StoreManifest.xml會與應用程式套件一起提交，且必須位於您應用程式主要專案的根資料夾中。 如需詳細資訊，請參閱 StoreManifest 架構。

將啟用 HTTPS 的下載 URL（直接連結）提交至產品的安裝程式二進位檔。 以這種方式提交的產品應符合下列需求：

  • 安裝程式二進位檔只能是 .msi 或 .exe。

  • 二進位檔及其所有可攜式執行檔 (PE) 都必須使用程式碼簽署憑證進行數位簽署，該憑證會鏈結至憑證授權單位 (CA) 所發行的憑證，其係屬 Microsoft 信任根計畫。

  • 您必須在合作夥伴中心內提交已建立版本的下載 URL。 在提交之後，與該 URL 相關聯的二進位檔就不得變更。

  • 每當您有要散發的已更新二進位檔時，您必須在與已更新的二進位檔相關聯的合作夥伴中心內，提供已更新且已建立版本的下載 URL。 您必須負責維護和更新下載 URL。

  • 起始安裝時，不得顯示安裝使用者介面 (例如，需要無訊息安裝)，但允許使用 [使用者帳戶控制 (UAC)] 對話方塊。

  • 安裝程式是獨立的安裝程式，而且不是會在執行時下載 BITS 的下載程式虛設常式/Web 安裝程式。

重要

應用程式附加元件不支援應用程式套件需求。