Penomoran versi paket

Setiap paket yang Anda berikan harus memiliki nomor versi (disediakan sebagai nilai dalam atribut Versi elemen Paket/Identitas dalam manifes aplikasi). Microsoft Store memberlakukan aturan tertentu yang terkait dengan nomor versi, yang bekerja agak berbeda dalam versi OS yang berbeda.

Catatan

Topik ini mengacu pada "paket", tetapi kecuali disebutkan, aturan yang sama berlaku untuk nomor versi untuk file .msix/.appx dan .msixbundle/.appxbundle.

Penomoran versi untuk paket Windows 10 dan 11

Penting

Untuk paket Windows 10 atau Windows 11 (UWP), bagian terakhir (keempat) dari nomor versi dicadangkan untuk penggunaan Store dan harus dibiarkan sebagai 0 saat Anda membangun paket Anda (meskipun Store dapat mengubah nilai di bagian ini). Bagian lain harus diatur ke bilangan bulat antara 0 dan 65535 (kecuali untuk bagian pertama, yang tidak boleh 0).

Saat memilih paket UWP dari pengiriman yang Anda terbitkan, Microsoft Store akan selalu menggunakan paket versi tertinggi yang berlaku untuk perangkat Windows 10 atau Windows 11 pelanggan. Ini memberi Anda fleksibilitas yang lebih besar dan menempatkan Anda dalam kontrol atas paket mana yang akan diberikan kepada pelanggan pada jenis perangkat tertentu. Yang penting, Anda dapat mengirimkan paket ini dalam urutan apa pun; Anda tidak terbatas pada penyediaan paket versi yang lebih tinggi dengan setiap pengiriman berikutnya.

Anda dapat menyediakan beberapa paket UWP dengan nomor versi yang sama. Namun, paket yang berbagi nomor versi juga tidak dapat memiliki arsitektur yang sama, karena identitas lengkap yang digunakan Store untuk setiap paket Anda harus unik. Untuk informasi selengkapnya, lihat Identitas.

Ketika Anda menyediakan beberapa paket UWP yang menggunakan nomor versi yang sama, arsitektur (dalam urutan x64, x86, Arm, netral) akan digunakan untuk memutuskan mana yang memiliki peringkat yang lebih tinggi (ketika Store menentukan paket mana yang akan disediakan untuk perangkat pelanggan). Saat memberi peringkat bundel aplikasi yang menggunakan nomor versi yang sama, peringkat arsitektur tertinggi dalam bundel dipertimbangkan: bundel aplikasi yang berisi paket x64 akan memiliki peringkat yang lebih tinggi dari yang hanya berisi paket x86.

Ini memberi Anda banyak fleksibilitas untuk mengembangkan aplikasi Anda dari waktu ke waktu. Anda dapat mengunggah dan mengirimkan paket baru yang menggunakan nomor versi yang lebih rendah untuk menambahkan dukungan untuk perangkat Windows 10 atau Windows 11 yang sebelumnya tidak Anda dukung, Anda dapat menambahkan paket versi lebih tinggi yang memiliki dependensi lebih ketat untuk memanfaatkan fitur perangkat keras atau OS, atau Anda dapat menambahkan paket versi lebih tinggi yang berfungsi sebagai pembaruan untuk beberapa atau semua basis pelanggan yang ada.

Contoh berikut menggambarkan bagaimana penomoran versi dapat dikelola untuk mengirimkan paket yang dimaksudkan kepada pelanggan Anda melalui beberapa pengiriman.

Contoh: Pindah ke satu paket melalui beberapa pengiriman

Windows 10 memungkinkan Anda menulis basis kode tunggal yang berjalan di mana-mana. Ini membuat memulai proyek lintas platform baru jauh lebih mudah. Namun, karena sejumlah alasan, Anda mungkin tidak ingin menggabungkan basis kode yang ada untuk segera membuat satu proyek.

Anda dapat menggunakan aturan penerapan versi paket untuk memindahkan pelanggan Anda secara bertahap ke satu paket untuk keluarga perangkat Universal, sambil mengirimkan sejumlah pembaruan sementara untuk keluarga perangkat tertentu (termasuk yang memanfaatkan API Windows 10). Contoh di bawah ini menggambarkan bagaimana aturan yang sama diterapkan secara konsisten melalui serangkaian pengiriman untuk aplikasi yang sama.

Penyerahan	Konten	Pengalaman pelanggan
1	- Versi paket: 1.1.10.0 - Keluarga perangkat: Windows.Desktop, minVersion 10.0.10240.0	- Perangkat pada Windows 10 dan 11 Desktop build 10.0.10240.0 ke atas akan mendapatkan 1.1.10.0 - Keluarga perangkat lain tidak akan dapat membeli dan menginstal aplikasi
2	- Versi paket: 1.1.10.0 - Keluarga perangkat: Windows.Desktop, minVersion 10.0.10240.0 - Versi paket: 1.0.0.0 - Keluarga perangkat: Windows.Universal, minVersion 10.0.10240.0	- Perangkat pada Windows 10 dan 11 Desktop build 10.0.10240.0 ke atas akan mendapatkan 1.1.10.0 - Keluarga perangkat (non-desktop) lainnya ketika diperkenalkan akan mendapatkan 1.0.0.0 - Perangkat desktop yang sudah menginstal aplikasi tidak akan melihat pembaruan apa pun (karena mereka sudah memiliki versi terbaik yang tersedia 1.1.10.0 dan lebih tinggi dari 1.0.0.0)
3	- Versi paket: 1.1.10.0 - Keluarga perangkat: Windows.Desktop, minVersion 10.0.10240.0 - Versi paket: 1.1.5.0 - Keluarga perangkat: Windows.Universal, minVersion 10.0.10250.0 - Versi paket: 1.0.0.0 - Keluarga perangkat: Windows.Universal, minVersion 10.0.10240.0	- Perangkat pada Windows 10 dan 11 Desktop build 10.0.10240.0 ke atas akan mendapatkan 1.1.10.0 - Keluarga perangkat (non-desktop) lainnya ketika diperkenalkan dengan build 10.0.10250.0 ke atas akan mendapatkan 1.1.5.0 - Famile perangkat (non-desktop) lainnya saat diperkenalkan dengan build >=10.0.10240.0 dan < 10.010250.0 akan mendapatkan 1.1.0.0 - Perangkat desktop yang sudah menginstal aplikasi tidak akan melihat pembaruan apa pun (karena mereka sudah memiliki versi terbaik yang tersedia 1.1.10.0 yang lebih tinggi dari 1.1.5.0 dan 1.0.0.0)
4	- Versi paket: 2.0.0.0 - Keluarga perangkat: Windows.Universal, minVersion 10.0.10240.0	- Semua pelanggan di semua keluarga perangkat pada Windows 10 dan 11 build v10.0.10240.0 ke atas akan mendapatkan paket 2.0.0.0

Catatan

 Dalam semua kasus, perangkat pelanggan akan menerima paket yang memiliki nomor versi tertinggi yang memenuhi syarat. Misalnya, pada pengiriman ketiga di atas, semua perangkat desktop akan mendapatkan v1.1.10.0, bahkan jika mereka memiliki OS versi 10.0.10250.0 atau yang lebih baru dan dengan demikian juga dapat menerima v1.1.5.0. Karena 1.1.10.0 adalah nomor versi tertinggi yang tersedia untuk mereka, yaitu paket yang akan mereka dapatkan.

Menggunakan penomoran versi untuk mengembalikan ke paket yang dikirim sebelumnya untuk akuisisi baru

Jika menyimpan salinan paket, Anda akan memiliki opsi untuk mengembalikan paket aplikasi di Store ke paket Windows 10 sebelumnya jika Anda harus menemukan masalah dengan rilis. Ini adalah cara sementara untuk membatasi gangguan pada pelanggan Anda saat Anda meluangkan waktu untuk memperbaiki masalah.

Untuk melakukan ini, buat pengiriman baru. Hapus paket bermasalah dan unggah paket lama yang ingin Anda sediakan di Store. Pelanggan yang telah menerima paket yang Anda gulung balik masih akan memiliki paket yang bermasalah (karena paket lama Anda akan memiliki nomor versi yang lebih lama). Tetapi ini akan menghentikan orang lain untuk memperoleh paket yang bermasalah, sambil memungkinkan aplikasi masih tersedia di Toko.

Untuk memperbaiki masalah bagi pelanggan yang telah menerima paket bermasalah, Anda dapat mengirimkan paket Windows 10 baru yang memiliki nomor versi yang lebih tinggi daripada paket buruk sesegera mungkin. Setelah pengiriman itu melalui proses sertifikasi, semua pelanggan akan diperbarui ke paket baru, karena akan memiliki nomor versi yang lebih tinggi.

Anda dapat mengelola penomoran versi paket melalui alat penginstal Anda. Penomoran versi paket untuk Win32 tidak di-suppot melalui Store.

Penting

Penomoran versi paket tidak didukung untuk add-on aplikasi.