共用方式為


應用程式套件要求

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

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

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

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

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

注意

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

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

當您建置應用程式的 UWP 套件時,Visual Studio 可以建立 .msix 或 appx 檔案,或 .msixupload 或 .appxupload 檔案。 針對 UWP 應用程式,建議您一律在套件頁面中上傳 .msixupload 或 .appxupload 檔案。 如需封裝適用於 Store 的 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 Phone 8.x SDK 所建置的新 XAP 套件。 已在 Store 上架、使用 XAP 套件的應用程式將繼續在 Windows 10 行動裝置版裝置上運作。 如需詳細資訊,請參閱這篇部落格文章

支援的版本

針對 UWP 應用程式,所有套件都必須以 Store 支援的 Windows 10 或 Windows 11 版本為目標。 您的套件支援的版本必須在應用程式資訊清單的 TargetDeviceFamily 元素的 MinVersionMaxVersionTested 屬性中指明。

目前支援的版本範圍從:

  • 最小: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 安裝程式。

重要

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