封裝版本編號

您所提供的每個套件都必須有版本編號 (在應用程式資訊清單中 套件/身分識別元素的版本屬性中提供值)。 Microsoft Store 強制執行與版本編號相關的某些規則，這些規則在不同作業系統版本中的運作方式略有不同。

注意

本主題指的是「套件」，但除非另有說明，否則相同的規則適用於 .msix/.appx 和 .msixbundle/.appxbundle 檔案的版本編號。

Windows 10 和 11 套件的版本編號

重要

對於 Windows 10 或 Windows 11 (UWP) 套件，版本編號的最後 (第四) 部分保留供 Store 使用，在建立套件時必須保留為 0 (儘管 Store 可能會變更此部分中的值)。 其他部分必須設定為介於 0 到 65535 之間的整數 (但第一個部分不能為 0 除外)。

從已發佈的提交中選擇 UWP 套件時，Microsoft Store 一律會使用適用於客戶 Windows 10 或 Windows 11 裝置的最高版本套件。 這為您提供了更大的靈活性，並使您可以控制向特定裝置類型的客戶提供哪些套件。 重要的是，您可以依任何順序提交這些套件；您不限於在每個後續提交中提供更高版本的套件。

您可以提供多個具有相同版本編號的 UWP 套件。 不過，共用版本編號的套件不能也有相同的架構，因為 Store 針對每個套件使用的完整身分識別必須是唯一的。 如需詳細資訊，請參閱身分識別。

當您提供多個使用相同版本編號的 UWP 套件時，架構 (依 x64、x86、Arm、中性的順序) 將用來決定哪一個排名較高 (當 Store 決定要提供給客戶的裝置之套件時)。 使用相同版本編號的排名應用程式套件組合時，會考慮套件組合內最高的架構排名：包含 x64 套件的應用程式套件組合的排名會高於只包含 x86 套件的應用程式套件組合。

這為您提供了很大的靈活性，可以隨著時間的推移改善您的應用程式。 您可以上傳並提交使用較低版本編號的新套件，以新增您先前不支援的 Windows 10 或 Windows 11 裝置支援，您可以新增具有更嚴格相依性的較高版本套件，以利用硬體或 OS 功能，也可以新增具有更嚴格相依性的較高版本套件，以做為部分或所有現有客戶群的更新。

下列範例說明如何管理版本編號，以透過多個提交將預期的套件傳遞給您的客戶。

範例：透過多個提交移至單一套件

Windows 10 可讓您撰寫可在任何地方執行的單一程式碼基底。 這可讓啟動新的跨平台專案變得更容易。 不過，出於許多原因，您可能不想合併現有的程式碼基底以立即建立單一專案。

您可以使用套件版本設定規則，逐漸將您的客戶移至通用裝置系列的單一套件，同時為特定裝置系列運送一些過渡性更新 (包括利用 Windows 10 API 的更新)。 下列範例說明相同應用程式一系列提交的相同規則如何一致地套用。

提交	目錄	客戶體驗
1	- 套件版本：1.1.10.0 - 裝置系列：Windows.Desktop、minVersion 10.0.10240.0	- Windows 10 和 11 Desktop 組建 10.0.10240.0 和更新版本的裝置將得到 1.1.10.0 - 其他裝置系列將無法購買並安裝應用程式
2	- 套件版本：1.1.10.0 - 裝置系列：Windows.Desktop、minVersion 10.0.10240.0 - 套件版本：1.0.0.0 - 裝置系列：Windows.Universal、minVersion 10.0.10240.0	- Windows 10 和 11 Desktop 組建 10.0.10240.0 和更新版本的裝置將得到 1.1.10.0 - 引進其他 （非桌面） 裝置系列時將得到 1.0.0.0 - 已安裝應用程式的桌面裝置不會看到任何更新（因為它們已經有可用的 1.1.10.0 版，且高於 1.0.0.0 版）
3	- 套件版本：1.1.10.0 - 裝置系列：Windows.Desktop、minVersion 10.0.10240.0 - 套件版本：1.1.5.0 - 裝置系列：Windows.Universal、minVersion 10.0.10250.0 - 套件版本：1.0.0.0 - 裝置系列：Windows.Universal、minVersion 10.0.10240.0	- Windows 10 和 11 Desktop 組建 10.0.10240.0 和更新版本的裝置將得到 1.1.10.0 - 使用組建 10.0.10250.0 和更新版本引進的其他 （非桌面） 裝置系列將得到 1.1.5.0 - 當組建 >=10.0.10240.0 和 < 10.010250.0 引進時，其他 （非桌面） 裝置會得到 1.1.0.0 - 已安裝應用程式的桌面裝置不會看到任何更新（因為它們已有最可用的 1.1.10.0 版，高於 1.1.5.0 和 1.0.0.0 版）
4	- 套件版本：2.0.0.0 - 裝置系列：Windows.Universal、minVersion 10.0.10240.0	- Windows 10 和 11 組建 v10.0.10240.0 及更新版本上所有裝置系列的所有客戶都會取得套件 2.0.0.0

注意

 在所有情況下，客戶裝置都會收到套件，該套件具有符合資格的最高可能版本編號。 例如，在上述第三個提交中，所有桌面裝置都會取得 v1.1.10.0，即使它們具有 OS 10.0.10250.0 版或更新版本，因此也可以接受 v1.1.5.0。 由於 1.1.10.0 是可用版本編號最高的版本編號，也就是它們將取得的套件。

使用版本編號來復原至先前隨附的套件以進行新的取得

如果您保留套件的複本，如果應該發現發行的問題，可以選擇將 Store 中的應用程式套件復原至舊版 Windows 10 套件。 這是一種暫時的方式，可讓您在需要時間修正問題時限制客戶的中斷。

若要這樣做，請建立新的提交。 移除有問題的套件，並上傳您想要在 Store 中提供的舊套件。 已收到您回復之套件的客戶仍然會有有問題的套件 (因為您的舊版套件會有較早的版本編號)。 但這將會阻止其他人取得有問題的套件，同時允許應用程式仍可在 Store 中使用。

若要修正已收到問題套件的客戶問題，您可以提交新的 Windows 10 套件，該套件的版本編號比不正確的套件儘快高。 在提交通過認證程序之後，所有客戶都會更新為新的套件，因為它會有較高的版本編號。

您可以透過安裝程式管理套件版本編號。 Win32 的套件版本編號不支援透過市集。

重要

應用程式附加元件不支援套件版本編號。