套件版本編號

您所提供的每個套件都必須有版本號碼（在應用程式指令清單中 Package/Identity 元素的 Version 屬性中提供值）。 Microsoft Store 會強制執行與版本號碼相關的特定規則，這些規則在不同操作系統版本中的運作方式有些不同。

注意

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

Windows 10 和 11 套件的版本編號

重要

針對 Windows 10 或 Windows 11 （UWP） 套件，版本號碼的最後（第四個）區段會保留供市集使用，而且當您建置套件時，必須保留為 0（雖然市集可能會變更本節中的值）。 其他區段必須設定為介於 0 到 65535 之間的整數（但第一個區段不能為 0 除外）。

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

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

當您提供多個使用相同版本號碼的 UWP 套件時，架構（依 x64、x86、Arm、中性的順序）將用來決定哪一個等級較高（當市集決定要提供給客戶的裝置的套件時）。 使用相同版本號碼的排名應用程式套件組合時，會考慮套件組合內最高的架構排名：包含 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 是可用版本號碼最高的版本號碼，也就是它們將取得的套件。

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

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

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

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

您可以透過安裝程式管理套件版本編號。 Win32 的套件版本編號不會透過市集來提供。

重要

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