Persyaratan paket aplikasi

Ikuti panduan ini untuk menyiapkan paket aplikasi Anda untuk pengiriman ke Microsoft Store.

Sebelum Anda membuat paket aplikasi untuk Microsoft Store

Pastikan untuk menguji aplikasi Anda dengan Kit Sertifikasi Aplikasi Windows. Kami juga menyarankan agar Anda menguji aplikasi pada berbagai jenis perangkat keras. Perhatikan bahwa sampai kami mensertifikasi aplikasi Anda dan membuatnya tersedia dari Microsoft Store, aplikasi hanya dapat diinstal dan dijalankan di komputer yang memiliki lisensi pengembang.

Membangun paket aplikasi menggunakan Microsoft Visual Studio

Jika Anda menggunakan Microsoft Visual Studio sebagai lingkungan pengembangan, Anda sudah memiliki alat bawaan yang membuat paket aplikasi menjadi proses yang cepat dan mudah. Untuk informasi selengkapnya, lihat Mengemas aplikasi.

Catatan

Pastikan bahwa semua nama file Anda menggunakan ANSI.

Saat membuat paket di Visual Studio, pastikan Anda masuk dengan akun yang sama yang terkait dengan akun pengembang Anda. Beberapa bagian manifes paket memiliki detail spesifik yang terkait dengan akun Anda. Info ini terdeteksi dan ditambahkan secara otomatis. Tanpa informasi tambahan yang ditambahkan ke manifes, Anda mungkin mengalami kegagalan unggahan paket.

Saat Anda membuat paket UWP aplikasi, Visual Studio dapat membuat file .msix atau appx, atau file .msixupload atau .appxupload. Untuk aplikasi UWP, kami sarankan Anda selalu mengunggah file .msixupload atau .appxupload di halaman Paket . Untuk informasi selengkapnya tentang mengemas aplikasi UWP untuk Toko, lihat Mengemas aplikasi UWP dengan Visual Studio.

Paket aplikasi Anda tidak perlu ditandatangani dengan sertifikat yang berakar pada otoritas sertifikat tepercaya.

Bundel aplikasi

Untuk aplikasi UWP, Visual Studio dapat menghasilkan app bundle (.msixbundle atau .appxbundle) untuk mengurangi ukuran aplikasi yang diunduh pengguna. Ini dapat membantu jika Anda telah menentukan aset khusus bahasa, berbagai aset skala gambar, atau sumber daya yang berlaku untuk versi Microsoft DirectX tertentu.

Catatan

 Satu app bundle dapat berisi paket Anda untuk semua arsitektur.

Dengan bundel aplikasi, pengguna hanya akan mengunduh file yang relevan, daripada semua sumber daya yang mungkin. Untuk informasi selengkapnya tentang bundel aplikasi, lihat Mengemas aplikasi dan Mengemas aplikasi UWP dengan Visual Studio.

Membangun paket aplikasi secara manual

Jika Anda tidak menggunakan Visual Studio untuk membuat paket, Anda harus membuat manifes paket secara manual.

Pastikan untuk meninjau dokumentasi manifes paket Aplikasi untuk detail dan persyaratan manifes lengkap. Manifes Anda harus mengikuti skema manifes paket untuk lulus sertifikasi.

Manifes Anda harus menyertakan beberapa info spesifik tentang akun dan aplikasi Anda. Anda dapat menemukan info ini dengan melihat Lihat detail identitas aplikasi di bagian Manajemen produk di halaman gambaran umum aplikasi Anda di dasbor.

Catatan

 Nilai dalam manifes peka huruf besar/kecil. Spasi dan tanda baca lainnya juga harus cocok. Masukkan nilai dengan hati-hati dan tinjau untuk memastikan bahwa nilai tersebut benar.

App bundles (.msixbundle atau .appxbundle) menggunakan manifes yang berbeda. Tinjau dokumentasi manifes Bundel untuk detail dan persyaratan untuk manifes bundel aplikasi. Perhatikan bahwa dalam .msixbundle atau .appxbundle, manifes dari setiap paket yang disertakan harus menggunakan elemen dan atribut yang sama, kecuali untuk atribut ProcessorArchitecture dari elemen Identity .

Tip

 Pastikan untuk menjalankan Kit Sertifikasi Aplikasi Windows sebelum Anda mengirimkan paket Anda. Ini dapat membantu Anda menentukan apakah manifes Anda memiliki masalah yang dapat menyebabkan kegagalan sertifikasi atau pengiriman.

Persyaratan format paket

Paket aplikasi Anda harus mematuhi persyaratan ini.

Properti paket aplikasi	Persyaratan
Ukuran paket	.msixbundle atau .appxbundle: Maksimum 25 GB per bundel Paket .msix atau .appx yang menargetkan Windows 10 atau Windows 11: maksimum 25 GB per paket
Blokir hash peta	Algoritma SHA2-256

Penting

Anda tidak dapat lagi mengunggah paket XAP baru yang dibuat menggunakan Windows Telepon 8.x SDK. Aplikasi yang sudah ada di Store dengan paket XAP akan terus berfungsi di perangkat Windows 10 Mobile. Untuk informasi selengkapnya, lihat posting blog ini.

Versi yang didukung

Untuk aplikasi UWP, semua paket harus menargetkan versi Windows 10 atau Windows 11 yang didukung oleh Store. Versi yang didukung paket Anda harus ditunjukkan dalam atribut MinVersion dan MaxVersionTested dari elemen TargetDeviceFamily dari manifes aplikasi.

Versi yang saat ini didukung berkisar dari:

• Minimum: 10.0.10240.0
• Maksimum: 10.0.22621.0

File XML StoreManifest

StoreManifest.xml adalah file konfigurasi opsional yang mungkin disertakan dalam paket aplikasi. Tujuannya adalah untuk mengaktifkan fitur, seperti mendeklarasikan aplikasi Anda sebagai aplikasi perangkat Microsoft Store atau mendeklarasikan persyaratan bahwa paket bergantung pada berlaku untuk perangkat, yang tidak dicakup oleh manifes paket. Jika digunakan, StoreManifest.xml dikirimkan dengan paket aplikasi dan harus berada di folder akar proyek utama aplikasi Anda. Untuk informasi selengkapnya, lihat Skema StoreManifest.

Kirim URL unduhan yang diaktifkan HTTPS (tautan langsung) ke biner penginstal produk. Produk yang dikirimkan dengan cara ini tunduk pada persyaratan berikut:

• Biner penginstal mungkin hanya .msi atau .exe.

• Biner dan semua file Portable Executable (PE) harus ditandatangani secara digital dengan sertifikat penandatanganan kode yang menautkan hingga sertifikat yang dikeluarkan oleh Otoritas Sertifikat (CA) yang merupakan bagian dari Program Akar Tepercaya Microsoft.

• Anda harus mengirimkan URL unduhan versi di Pusat Mitra. Biner yang terkait dengan URL tersebut tidak boleh berubah setelah pengiriman.

• Setiap kali Anda memiliki biner yang diperbarui untuk didistribusikan, Anda harus menyediakan URL unduhan versi terbaru di Pusat Mitra yang terkait dengan biner yang diperbarui. Anda bertanggung jawab untuk memelihara dan memperbarui URL unduhan.

• Memulai penginstalan tidak boleh menampilkan antarmuka pengguna penginstalan (yaitu, penginstalan senyap diperlukan), namun dialog Kontrol Akun Pengguna (UAC) diizinkan.

• Alat penginstal adalah alat penginstal mandiri dan bukan penginstal stub/web pengunduh yang mengunduh bit saat dijalankan.

Penting

Persyaratan paket aplikasi tidak didukung untuk add-on aplikasi.