パッケージ バージョンの番号付けPackage version numbering

提供する各パッケージには、バージョン番号がある必要があります (アプリ マニフェストの Package/Identity 要素の Version 属性の値として提供されます)。Each package you provide must have a version number (provided as a value in the Version attribute of the Package/Identity element in the app manifest). Microsoft Store ではバージョン番号に関する特定の規則が適用され、別の OS バージョンでは機能が多少異なります。The Microsoft Store enforces certain rules related to version numbers, which work somewhat differently in different OS versions.

注意

このトピックでは「パッケージ」していますが、.msix/.appx および.msixbundle/.appxbundle ファイルの両方のバージョン番号に同じ規則が適用、記載されていない場合。This topic refers to "packages", but unless noted, the same rules apply to version numbers for both .msix/.appx and .msixbundle/.appxbundle files.

Windows 10 パッケージのバージョン番号付けVersion numbering for Windows10 packages

重要

Windows 10 (UWP) パッケージのバージョン番号の最後 (4 番目) のセクションはストア用に予約されておりままにしてする必要があります 0 (ただし、ストアでは、このセクションの値を変更可能性があります)、パッケージをビルドするとします。For Windows 10 (UWP) packages, the last (fourth) section of the version number is reserved for Store use and must be left as 0 when you build your package (although the Store may change the value in this section). その他のセクションでは、0 ~ 65535 (を除き、最初のセクションが 0 にすることはできません) の整数に設定する必要があります。The other sections must be set to an integer between 0 and 65535 (except for the first section, which cannot be 0).

公開された申請から UWP パッケージを選択するとき、Microsoft Store は常にユーザーの Windows 10 デバイスに適用可能な最も高いバージョンのパッケージを使用します。When choosing a UWP package from your published submission, the Microsoft Store will always use the highest-versioned package that is applicable to the customer’s Windows 10 device. これにより高い柔軟性が与えられ、特定のデバイスの種類のユーザーにどのパッケージを提供するかを管理することができます。This gives you greater flexibility and puts you in control over which packages will be provided to customers on specific device types. 重要なことに、これらのパッケージは任意の順序で申請することができます。後続の各申請でより高いバージョンのパッケージを提供する必要はありません。Importantly, you can submit these packages in any order; you are not limited to providing higher-versioned packages with each subsequent submission.

同じバージョン番号を持つ複数の UWP パッケージを提供できます。You can provide multiple UWP packages with the same version number. ただし、バージョン番号を共有するパッケージが同じアーキテクチャを持つことはできません。ストアで各パッケージに使用する完全な ID は一意である必要があるためです。However, packages that share a version number cannot also have the same architecture, because the full identity that the Store uses for each of your packages must be unique. 詳しくは、「Identity」をご覧ください。For more info, see Identity.

同じバージョン番号を使用する複数の UWP パッケージを提供する場合は、どのランクがより高い場合、ストアは、ユーザーのデバイスに提供するには、どのパッケージを決定します) を決定するアーキテクチャ (x64、x86、ARM、ニュートラルの順番) が使用されます。When you provide multiple UWP packages that use the same version number, the architecture (in the order x64, x86, ARM, neutral) will be used to decide which one is of higher rank (when the Store determines which package to provide to a customer's device). バージョン番号が同じアプリ バンドルにランクを付けるときは、x64 パッケージが含まれているアプリ バンドルが x86 パッケージしか含まれていないアプリ バンドルより高いランクとなるようにバンドル内で最高のアーキテクチャのランクを考慮します。When ranking app bundles that use the same version number, the highest architecture rank within the bundle is considered: an app bundle that contains an x64 package will have a higher rank than one that only contains an x86 package.

これにより、アプリを時間をかけて進化させる大きな柔軟性が与えられます。This gives you a lot of flexibility to evolve your app over time. ハードウェアまたは OS の機能を活用するためにより厳密な依存関係を持つより高いバージョンのパッケージを追加することができます。 が、アップロードし、小さいバージョン番号を使用して、以前サポートしていない Windows 10 デバイスのサポートを追加する新しいパッケージを提出できます。基本、既存の顧客の一部または全部に更新となるより高いバージョンのパッケージを追加できます。You can upload and submit new packages that use lower version numbers to add support for Windows 10 devices that you did not previously support, you can add higher-versioned packages that have stricter dependencies to take advantage of hardware or OS features, or you can add higher-versioned packages that serve as updates to some or all of your existing customer base.

次の例は、バージョン番号を管理して複数の申請でユーザーに目的のパッケージを提供する方法について説明します。The following example illustrates how version numbering can be managed to deliver the intended packages to your customers over multiple submissions.

例: 複数の申請で 1 つのパッケージに移行するExample: Moving to a single package over multiple submissions

Windows 10 をすべての場所で実行されること、単一のコードベースを記述することができます。Windows10 enables you to write a single codebase that runs everywhere. これにより、新しいクロスプラットフォーム プロジェクトの開始がはるかに簡単になります。This makes starting a new cross-platform project much easier. ただし、さまざまな理由から、既存のコードベースを結合してすぐに 1 つのプロジェクトを作成したくない場合があります。However, for a number of reasons, you might not want to merge existing codebases to create a single project right away.

パッケージのバージョンの規則を使用すると、暫定的な更新プログラム (windows 10 Api を利用するものを含む) 特定のデバイス ファミリの数値を配送先住所中には、ユニバーサル デバイス ファミリの 1 つのパッケージにお客様を徐々 に移行します。You can use the package versioning rules to gradually move your customers to a single package for the Universal device family, while shipping a number of interim updates for specific device families (including ones that take advantage of Windows10 APIs). 次の例では、同じアプリの申請用の一連の間、同じ規則が一貫して適用されるしくみを示しています。The example below illustrates how the same rules are consistently applied over a series of submissions for the same app.

申請Submission 内容Contents カスタマー エクスペリエンスCustomer experience
11 - パッケージ バージョン: 1.1.10.0- Package version: 1.1.10.0
- デバイス ファミリ: Windows.Desktop、minVersion 10.0.10240.0- Device family: Windows.Desktop, minVersion 10.0.10240.0

- パッケージ バージョン: 1.1.0.0- Package version: 1.1.0.0
- デバイス ファミリ: Windows.Mobile、minVersion 10.0.10240.0- Device family: Windows.Mobile, minVersion 10.0.10240.0
- Windows 10 デスクトップ ビルド 10.0.10240.0 以上のデバイスでは 1.1.10.0 を取得。- Devices on Windows 10 Desktop build 10.0.10240.0 and above will get 1.1.10.0
- Windows 10 Mobile ビルド 10.0.10240.0 以上のデバイスでは 1.1.0.0 を取得。- Devices on Windows 10 Mobile build 10.0.10240.0 and above will get 1.1.0.0
- その他のデバイス ファミリでアプリの購入とインストールを行うことはできない。- Other device families will not be able to purchase and install the app
22 - パッケージ バージョン: 1.1.10.0- Package version: 1.1.10.0
- デバイス ファミリ: Windows.Desktop、minVersion 10.0.10240.0- Device family: Windows.Desktop, minVersion 10.0.10240.0

- パッケージ バージョン: 1.1.0.0- Package version: 1.1.0.0
- デバイス ファミリ: Windows.Mobile、minVersion 10.0.10240.0- Device family: Windows.Mobile, minVersion 10.0.10240.0

- パッケージ バージョン: 1.0.0.0- Package version: 1.0.0.0
- デバイス ファミリ: Windows.Universal、minVersion 10.0.10240.0- Device family: Windows.Universal, minVersion 10.0.10240.0
- Windows 10 デスクトップ ビルド 10.0.10240.0 以上のデバイスでは 1.1.10.0 を取得。- Devices on Windows 10 Desktop build 10.0.10240.0 and above will get 1.1.10.0
- Windows 10 Mobile ビルド 10.0.10240.0 以上のデバイスでは 1.1.0.0 を取得。- Devices on Windows 10 Mobile build 10.0.10240.0 and above will get 1.1.0.0
- 導入されているその他の (非デスクトップ、非モバイル) デバイス ファミリでは 1.0.0.0 を取得。- Other (non-desktop, non-mobile) device families when they are introduced will get 1.0.0.0
- アプリが既にインストールされているデスクトップ デバイスとモバイル デバイスでは更新が表示されない (利用可能な最高のバージョンが既にあり、1.1.10.0 と 1.1.0.0 は共に 1.0.0.0 より上位であるため)。- Desktop and mobile devices that already have the app installed will not see any update (because they already have the best available version—1.1.10.0 and 1.1.0.0 are both higher than 1.0.0.0)
33 - パッケージ バージョン: 1.1.10.0- Package version: 1.1.10.0
- デバイス ファミリ: Windows.Desktop、minVersion 10.0.10240.0- Device family: Windows.Desktop, minVersion 10.0.10240.0

- パッケージ バージョン: 1.1.5.0- Package version: 1.1.5.0
- デバイス ファミリ: Windows.Universal、minVersion 10.0.10250.0- Device family: Windows.Universal, minVersion 10.0.10250.0

- パッケージ バージョン: 1.0.0.0- Package version: 1.0.0.0
- デバイス ファミリ: Windows.Universal、minVersion 10.0.10240.0- Device family: Windows.Universal, minVersion 10.0.10240.0
- Windows 10 デスクトップ ビルド 10.0.10240.0 以上のデバイスでは 1.1.10.0 を取得。- Devices on Windows 10 Desktop build 10.0.10240.0 and above will get 1.1.10.0
- Windows 10 Mobile ビルド 10.0.10250.0 以上のデバイスでは 1.1.5.0 を取得。- Devices on Windows 10 Mobile build 10.0.10250.0 and above will get 1.1.5.0
- Windows 10 Mobile ビルド 10.0.10240.0 以上 10.010250.0 未満のデバイスでは 1.1.0.0 を取得。- Devices on Windows 10 Mobile build >=10.0.10240.0 and < 10.010250.0 will get 1.1.0.0
44 - パッケージ バージョン: 2.0.0.0- Package version: 2.0.0.0
- デバイス ファミリ: Windows.Universal、minVersion 10.0.10240.0- Device family: Windows.Universal, minVersion 10.0.10240.0
- Windows 10 ビルド v10.0.10240.0 以上のすべてのデバイス ファミリのすべてのユーザーはパッケージ 2.0.0.0 を取得。- All customers on all device families on Windows 10 build v10.0.10240.0 and above will get package 2.0.0.0

注意

どの場合でも、ユーザーのデバイスでは条件を満たす最も大きいバージョン番号のパッケージを受け取ります。In all cases, customer devices will receive the package that has the highest possible version number that they qualify for. たとえば、上記の 3 番目の申請では、OS バージョン 10.0.10250.0 以上で v1.1.5.0 を取得できる場合でも、すべてのデスクトップ デバイスが v1.1.10.0 を取得します。For example, in the third submission above, all desktop devices will get v1.1.10.0, even if they have OS version 10.0.10250.0 or higher and thus could also accept v1.1.5.0. 1.1.10.0 は利用可能な最も大きいバージョン番号であるため、これが取得するパッケージになります。Since 1.1.10.0 is the highest version number available to them, that is the package they will get.

新規の取得のためにバージョン番号を使用して以前配布したパッケージにロールバックするUsing version numbering to roll back to a previously-shipped package for new acquisitions

パッケージのコピーを保持する場合にロールバックするアプリのパッケージ、ストアで以前の windows 10 パッケージ場合は、リリースに関する問題を検出する必要がありますオプションがあります。If you keep copies of your packages, you'll have the option to roll back your app’s package in the Store to an earlier Windows10 package if you should discover problems with a release. これは、間、問題を修正する時間がかかることをユーザーに限定する一時的な方法です。This is a temporary way to limit the disruption to your customers while you take time to fix the issue.

これを行うには、新しい申請を作成します。To do this, create a new submission. 問題があるパッケージを削除して、ストアで提供する以前のパッケージをアップロードします。Remove the problematic package and upload the old package that you want to provide in the Store. ロールバックするパッケージを既に受け取っているユーザーは問題のあるパッケージを持ったままになります (以前のパッケージのバージョン番号がより小さいため)。Customers who have already received the package you are rolling back will still have the problematic package (since your older package will have an earlier version number). しかし、これにより、ストアでアプリを利用できるようにした間にその他のユーザーが問題のあるパッケージを取得することができなくなります。But this will stop anyone else from acquiring the problematic package, while allowing the app to still be available in the Store.

問題のあるパッケージを既に受信した顧客の問題を解決をすることがすぐに、問題のあるパッケージよりも大きいバージョン番号を持つ新しい windows 10 パッケージを提出することができます。To fix the issue for the customers who have already received the problematic package, you can submit a new Windows10 package that has a higher version number than the bad package as soon as you can. その申請の認定プロセスが完了すると、それがより大きいバージョン番号になるため、すべてのユーザーが新しいパッケージに更新されます。After that submission goes through the certification process, all customers will be updated to the new package, since it will have a higher version number.

バージョン番号付け Windows8.1 (以前) と Windows Phone 8.1 パッケージVersion numbering for Windows8.1 (and earlier) and Windows Phone 8.1 packages

重要

2018 年 10 月 31 日の時点で、新しく作成した製品が Windows 8.x/Windows を対象とするパッケージを含めることはできません Phone 8.x 以前のバージョン。As of October 31, 2018, newly-created products cannot include packages targeting Windows 8.x/Windows Phone 8.x or earlier. 詳しくは、このブログ記事を参照してください。For more info, see this blog post.

Windows Phone 8.1 を対象とする .appx パッケージでは、新しい申請のパッケージのバージョン番号は最後の申請 (または、以前の申請) に含まれるパッケージの番号より常に大きい必要があります。For .appx packages that target Windows Phone 8.1, the version number of the package in a new submission must always be greater than that of the package included in the last submission (or any previous submission).

アーキテクチャごとを Windows8 と Windows8.1 をターゲットとする .appx パッケージでは、同じ規則が適用されます。 新しい申請のパッケージのバージョン番号は最後に、同じアーキテクチャのストアに公開されたパッケージのより大きい常にある必要があります。For .appx packages that target Windows8 and Windows8.1, the same rule applies per architecture: the version number of the package in a new submission must always be greater than that of the package last published to the Store for the same architecture.

さらに、Windows8.1 パッケージのバージョン番号常に同じアプリ用の Windows8 パッケージのいずれかのバージョン番号より大きいである必要があります。Additionally, the version number of Windows8.1 packages must always be greater than the version numbers of any of your Windows8 packages for the same app. つまり、ユーザーが提出した Windows8 パッケージのバージョン番号は、同じアプリについて申請した Windows8.1 パッケージのバージョン番号よりも低いである必要があります。In other words, the version number of any Windows8 package that you submit must be lower than the version number of any Windows8.1 package that you've submitted for the same app.

注意

アプリでは、windows 10 パッケージもに、windows 10 パッケージのバージョン番号 Windows8 や Windows8.1、Windows Phone 8.1 パッケージのいずれかより大きい場合があります。If your app also has Windows10 packages, the version number of the Windows10 packages must be higher than those for any of your Windows8, Windows8.1, and/or Windows Phone 8.1 packages. 詳しくは、以前に公開されたアプリを windows 10 用の追加のパッケージを参照してください。For more info, see Adding packages for Windows10 to a previously-published app.

Windows8 と Windows8.1 を対象とするパッケージのさまざまなバージョン番号の更新シナリオで何が起きるの例をいくつかを示します。Here are some examples of what happens in different version number update scenarios for packages targeting Windows8 and Windows8.1.

ストア内のアプリのバージョンWith this version of your app in the Store アップロードするバージョンAnd you upload this version 新しいバージョンが Microsoft Store にアップロードされた後の動作、新規インストールのバージョンAfter the new version is in the Store, this will be installed in a new acquisition 新しいバージョンが Microsoft Store にアップロードされた後の動作、既存のバージョンの更新After the new version is in the Store, this will be updated if a customer already has the app
なしNothing x86, v1.0.0.0x86, v1.0.0.0 x86, v1.0.0.0 (x86 と x64 の両方のコンピューター)x86, v1.0.0.0 on both x86 and x64 computers なし。Nothing.
x86, v1.0.0.0x86, v1.0.0.0 x64, v1.0.0.0x64, v1.0.0.0 対応するアーキテクチャ用の v1.0.0.0v1.0.0.0 for the customer's architecture なし: Nothing. バージョン番号は同じであるため。The version numbers are the same.
x86, v1.0.0.0x86, v1.0.0.0
x64, v1.0.0.0x64, v1.0.0.0
x64, v1.0.0.1x64, v1.0.0.1 x86 の場合は v1.0.0.0v1.0.0.0 for customers with an x86
x64 の場合は v1.0.0.1v1.0.0.1 for customers with an x64
アプリを x86 コンピューターで実行している場合はなし。Nothing for customers running the app on an x86 computer.
アプリを x64 コンピューターで実行している場合は v1.0.0.0 から v1.0.0.1 に更新。v1.0.0.0 will be updated to v1.0.0.1 for customers running the app on an x64 computer.
注: 場合 x64 バージョンのアプリが実行されている x86 コンピューターで、アプリ、x64 に更新されませんバージョン アンインストールして再インストールしない限り、します。NoteIf the x86 version of the app is running on an x64 computer, the app won’t get updated to the x64 version unless the customer uninstalls and reinstalls.
なしNothing neutral, v1.0.0.1neutral, v1.0.0.1 neutral, v1.0.0.1 (すべてのコンピューター)neutral, v1.0.0.1 on all computers なし。Nothing.
neutral, v1.0.0.1neutral, v1.0.0.1 x86, v1.0.0.0x86, v1.0.0.0
x64, v1.0.0.0x64, v1.0.0.0
ARM, v1.0.0.0ARM, v1.0.0.0
対応するアーキテクチャ用の v1.0.0.0v1.0.0.0 for the architecture of the customer's computer. なし: Nothing. neutral, v1.0.0.1 のアプリは引き続き使用される。Those who have the neutral, v1.0.0.1 version of the app will continue to use it.
neutral, v1.0.0.1neutral, v1.0.0.1
x86, v1.0.0.0x86, v1.0.0.0
x64, v1.0.0.0x64, v1.0.0.0
ARM, v1.0.0.0ARM, v1.0.0.0
x86, v1.0.0.1x86, v1.0.0.1
x64, v1.0.0.1x64, v1.0.0.1
ARM, v1.0.0.1ARM, v1.0.0.1
対応するアーキテクチャ用の v1.0.0.1v1.0.0.1 for the architecture of the customer's computer. neutral, v1.0.0.1 のアプリを実行している場合はなし。Nothing for customers running the neutral, v1.0.0.1 version app.
特定のアーキテクチャ用の v1.0.0.0 のアプリを実行している場合は v1.0.0.0 から v1.0.0.1 に更新。v1.0.0.0 will be updated to v1.0.0.1 for customers running v1.0.0.0 of the app built for their computer's specific architecture.
x86, v1.0.0.1x86, v1.0.0.1
x64, v1.0.0.1x64, v1.0.0.1
ARM, v1.0.0.1ARM, v1.0.0.1
x86, v1.0.0.2x86, v1.0.0.2
x64, v1.0.0.2x64, v1.0.0.2
ARM, v1.0.0.2ARM, v1.0.0.2
対応するアーキテクチャ用の v1.0.0.2v1.0.0.2 for the architecture of the customer's computer. 特定のアーキテクチャ用の v1.0.0.1 のアプリを実行している場合は v1.0.0.1 から v1.0.0.2 に更新。v1.0.0.1 will be updated to v1.0.0.2 for customers running either v1.0.0.1 of the app built for their computer's specific architecture.

注意

.appx パッケージとは異なり、.xap パッケージのバージョン番号は、特定の顧客にどのパッケージを提供するかを決める場合に考慮されません。Unlike .appx packages, the version numbers in any .xap packages are not considered when determining which package to provide a given customer. 特定の .xap パッケージから新しいパッケージへと顧客を更新するには、新しい提出で以前の .xap を削除してください。To update a customer from one .xap package to a newer one, make sure to remove the older .xap in the new submission.