Mengunggah paket aplikasi

Halaman Paket dari proses pengiriman aplikasi adalah tempat Anda mengunggah semua file paket (.msix, .msixupload, .msixbundle, .appx, .appxupload, dan/atau .appxbundle) untuk aplikasi yang Anda kirimkan. Anda dapat mengunggah semua paket untuk aplikasi yang sama di halaman ini, dan ketika pelanggan mengunduh aplikasi Anda, Store akan secara otomatis memberi setiap pelanggan paket yang paling sesuai untuk perangkat mereka. Setelah mengunggah paket, Anda akan melihat tabel yang menunjukkan paket mana yang akan ditawarkan kepada keluarga perangkat Windows 10 atau Windows 11 tertentu (dan versi OS sebelumnya, jika berlaku) dalam urutan berpangkat.

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.

Untuk detail tentang apa yang disertakan paket dan bagaimana paket harus disusun, lihat Persyaratan paket aplikasi. Anda juga ingin mempelajari tentang bagaimana nomor versi memengaruhi paket mana yang dikirimkan kepada pelanggan tertentu dan cara mengelola paket untuk berbagai skenario.

Mengunggah paket ke pengiriman Anda

Untuk mengunggah paket, seret paket ke bidang unggahan atau klik untuk menelusuri file Anda. Halaman Paket akan memungkinkan Anda mengunggah file .msix, .msixupload, .msixbundle, .appx, .appxupload, dan/atau .appxbundle.

Penting

Untuk Windows 10, sebaiknya unggah file .msixupload atau .appxupload di sini daripada .msix, .appx, .msixbundle, atau .appxbundle. Untuk informasi selengkapnya tentang mengemas aplikasi UWP untuk Store, lihat Mengemas aplikasi UWP dengan Visual Studio.

Jika Anda telah membuat penerbangan paket untuk aplikasi, Anda akan melihat menu drop-down dengan opsi untuk menyalin paket dari salah satu penerbangan paket Anda. Pilih penerbangan paket yang memiliki paket yang ingin Anda tarik. Anda kemudian dapat memilih salah satu atau semua paketnya untuk disertakan dalam pengiriman ini.

Jika kami mendeteksi kesalahan dengan paket saat memvalidasinya, kami akan menampilkan pesan untuk memberi tahu Anda apa yang salah. Anda harus menghapus paket, memperbaiki masalah, lalu mencoba mengunggahnya lagi. Anda mungkin juga melihat peringatan untuk memberi tahu Anda tentang masalah yang dapat menyebabkan masalah tetapi tidak akan memblokir Anda untuk melanjutkan pengiriman Anda.

Ketersediaan keluarga perangkat

Setelah paket Anda berhasil diunggah, bagian Ketersediaan keluarga perangkat akan menampilkan tabel yang menunjukkan paket mana yang akan ditawarkan ke keluarga perangkat Windows 10 atau Windows 11 tertentu (dan versi OS sebelumnya, jika berlaku), dalam urutan berpangkat. Bagian ini juga memungkinkan Anda memilih apakah akan menawarkan pengiriman kepada pelanggan pada keluarga perangkat Windows 10 atau Windows 11 tertentu atau tidak.

Untuk informasi selengkapnya, lihat Ketersediaan keluarga perangkat.

Detail paket

Paket yang Anda unggah tercantum di sini, dikelompokkan menurut sistem operasi target. Nama, versi, dan arsitektur paket akan ditampilkan. Untuk informasi selengkapnya seperti bahasa, kemampuan aplikasi, dan ukuran file yang didukung untuk setiap paket, klik Tampilkan detail.

Jika Anda perlu menghapus paket dari pengiriman Anda, klik tautan Hapus di bagian bawah setiap bagian Detail paket.

Menghapus paket redundan

Jika kami mendeteksi bahwa satu atau beberapa paket Anda berlebihan, kami akan menampilkan peringatan yang menunjukkan bahwa Anda menghapus paket redundan dari pengiriman ini. Seringkali ini terjadi ketika Anda sebelumnya telah mengunggah paket, dan sekarang Anda menyediakan paket versi lebih tinggi yang mendukung set pelanggan yang sama. Dalam hal ini, tidak ada pelanggan yang akan mendapatkan paket redundan, karena Anda sekarang memiliki paket yang lebih baik (versi lebih tinggi) untuk mendukung pelanggan ini.

Ketika kami mendeteksi bahwa Anda memiliki paket redundan, kami akan menyediakan opsi untuk menghapus semua paket redundan dari pengiriman ini secara otomatis. Anda juga dapat menghapus paket dari pengiriman satu per satu jika mau.

Peluncuran paket bertahap

Jika pengiriman Anda adalah pembaruan untuk aplikasi yang diterbitkan sebelumnya, Anda akan melihat kotak centang yang bertuliskan Luncurkan pembaruan secara bertahap setelah pengiriman ini diterbitkan (hanya untuk pelanggan Windows 10 atau Windows 11). Ini memungkinkan Anda memilih persentase pelanggan yang akan mendapatkan paket dari pengiriman sehingga Anda dapat memantau umpan balik dan data analitik untuk memastikan Anda yakin tentang pembaruan sebelum meluncurkannya lebih luas. Anda dapat meningkatkan persentase (atau menghentikan pembaruan) kapan saja tanpa harus membuat pengiriman baru.

Untuk informasi selengkapnya, lihat Peluncuran paket bertahap.

Pembaruan wajib

Jika pengiriman Anda adalah pembaruan ke aplikasi yang diterbitkan sebelumnya, Anda akan melihat kotak centang yang bertuliskan Buat pembaruan ini wajib. Ini memungkinkan Anda untuk mengatur tanggal dan waktu untuk pembaruan wajib, dengan asumsi Anda telah menggunakan API Windows.Services.Store untuk memungkinkan aplikasi Anda memeriksa pembaruan paket secara terprogram dan mengunduh dan menginstal paket yang diperbarui. Aplikasi Anda harus menargetkan Windows 10, versi 1607 atau yang lebih baru untuk menggunakan opsi ini.

Untuk informasi selengkapnya, lihat Mengunduh dan menginstal pembaruan paket untuk aplikasi Anda.

Halaman Paket dari proses pengiriman aplikasi adalah tempat Anda menyediakan paket (MSI/EXE) dan informasi terkait untuk aplikasi yang Anda kirimkan. Saat pelanggan mengunduh aplikasi Anda, Store akan secara otomatis memberi setiap pelanggan paket yang paling sesuai untuk perangkat mereka.

Anda harus menyelesaikan halaman Paket untuk setidaknya satu paket. Untuk menambahkan paket, klik tambahkan paket dari halaman Paket.

Menambahkan dan mengedit Info paket

Untuk mengedit Info paket, pilih Paket dari halaman Paket. Anda harus mengedit setiap paket secara terpisah.

URL Paket
Diperlukan

Anda harus memasukkan setidaknya satu URL aman versi yang menunjuk ke paket aplikasi (MSI/EXE) yang dihosting di CDN Anda. Contoh URL aman versinya adalah https://www.contoso.com/downloads/1.1/setup.exe. Saat pelanggan menginstal aplikasi Anda dari Store, Store mengunduh paket dari URL ini. Anda perlu mengikuti praktik CDN yang baik dan memastikan bahwa URL ini berkinerja, andal, dan tersedia berdasarkan pilihan pasar Anda.

Jika Anda perlu memperbarui URL paket, Anda dapat menggunakan opsi Pengiriman pembaruan di Pusat Mitra untuk menentukan URL paket baru.

Biner pada URL paket tidak boleh berubah setelah dikirimkan untuk memastikan hanya biner bersertifikat yang diinstal oleh pengguna. Store akan menyimpan salinan paket aplikasi terbaru Anda untuk didistribusikan jika penginstal aplikasi yang dihosting oleh Anda di layanan hosting terpisah, seperti jaringan pengiriman konten (CDN), ditukar dengan paket penginstal aplikasi baru tanpa pengiriman melalui Pusat Mitra atau API. Store juga akan mengunduh paket aplikasi baru dan memulai proses sertifikasi. Jika pembaruan lulus pengujian sertifikasi, Store membuatnya tersedia untuk pengguna akhir. Jika pembaruan gagal menguji sertifikasi, Stores memberi tahu Anda untuk mengirimkan pembaruan melalui Pusat Mitra atau API.

Anda harus mengirimkan alat penginstal mandiri/offline dan bukan pengunduh yang mengunduh biner saat dipanggil. Ini diperlukan untuk mensertifikasi biner yang diinstal adalah biner yang sama yang lulus proses sertifikasi.

Sistem
Diperlukan

Anda harus memilih arsitektur kode yang terkandung dalam paket dari salah satu nilai berikut:

• x86
• x64
• netral
• arm
• arm64

Jika Anda memiliki paket yang dikompilasi dalam lebih dari 1 arsitektur, Anda harus menambahkannya ke pengiriman.

Bahasa
Diperlukan

Anda dapat mengirimkan aplikasi ke Microsoft Store dalam lebih dari 100 bahasa. Aplikasi Anda harus mendukung setidaknya salah satu bahasa berikut.

Catatan

Kode bahasa yang tidak tercantum di sini tidak didukung oleh penyimpanan.

Nama bahasa	Kode bahasa yang didukung
Afrika	af, af-za
Albania	sq, sq-al
Amharik	am, am-et
Armenia	hy, hy-am
Assam	sebagai, as-in
Azerbaijani	az-arab, az-arab-az, az-cyrl, az-cyrl-az, az-latn, az-latn-az
Basque (Basque)	eu, eu-es
Belarusia	be, be-by
Bengali	bn, bn-bd, bn-in
Bosnia	bs, bs-cyrl, bs-cyrl-ba, bs-latn, bs-latn-ba
Bulgaria	bg, bg-bg
Katalan	ca, ca-es, ca-es-valencia
Cherokee	chr-cher, chr-cher-us, chr-latn
Tionghoa (Aksara Sederhana)	zh-Hans, zh-cn, zh-hans-cn, zh-sg, zh-hans-sg
Tionghoa (Aksara Tradisional)	zh-Hant, zh-hk, zh-mo, zh-tw, zh-hant-hk, zh-hant-mo, zh-hant-tw, zh-mo, zh-tw, zh-hant-hk, zh-hant-mo, zh-hant-tw
Kroasia	jam, jam-jam, hr-ba
Cheska	cs, cs-cz
Dansk	da, da-dk
Dari	prs, prs-af, prs-arab
Belanda	nl, nl-nl, nl-be
Inggris	en, en-au, en-ca, en-gb, en-ie, en-in, en-nz, en-sg, en-us, en-za, en-bz, en-hk, en-id, en-jm, en-kz, en-mt, en-my, en-ph, en-pk, en-tt, en-vn, en-zw
Esti	et, et-ee
Filipino	fil, fil-latn, fil-ph
Suomi	fi, fi-fi
Prancis	fr, fr-be , fr-ca , fr-ch , fr-fr, fr-lu, fr-cd, fr-ci, fr-cm, fr-ht, fr-ma, fr-mc, fr-ml, fr-re, frc-latn, frp-latn
Galisia	gl, gl-es
Georgia	ka, ka-ge
Jerman	de, de-at, de-ch, de-de, de-lu, de-li
Yunani	el, el-gr
Gujarat	gu, gu-in
Hausa	ha, ha-latn, ha-latn-ng
Ibrani	dia, he-il
Hindi	hai, hi-in
Hungaria	hu, hu-hu
Islandia	adalah, is-is
Igbo	ig-latn, ig-ng
Indonesia	id, id-id
Inuktitut (Latin)	iu-cans, iu-latn, iu-latn-ca
Irlandia	ga, ga-ie
isiXhosa	xh, xh-za
isiZulu	zu, zu-za
Italia	itu, it-it, it-ch
Jepang	ja , ja-jp
Kannada	kn, kn-in
Kazakh	kk, kk-kz
Khmer	km, km-kh
K'iche'	quc-latn, qut-gt, qut-latn
Kinyarwanda	rw, rw-rw
Kiswahili	sw, sw-ke
Konkani	kok, kok-in
Korea	ko, ko-kr
Kurdi	ku-arab, ku-arab-iq
Kyrgyz	ky-kg, ky-cyrl
Laos	lo, lo-la
Latvi	lv, lv-lv
Lituavi	lt, lt-lt
Luksemburg	lb, lb-lu
Makedonia	mk, mk-mk
Melayu	ms, ms-bn, ms-my
Malayalam	ml, ml-in
Malta	mt, mt-mt
Maori	mi, mi-latn, mi-nz
Marathi	mr, mr-in
Bahasa Mongolia (Sirilik)	mn-cyrl, mn-mong, mn-mn, mn-phag
Nepal	ne, ne-np
Norwegia	nb, nb-no, nn, nn-no, no, no-no
Odia	atau, atau
Farsi	fa, fa-ir
Polski	pl, pl-pl
Portugis (Brasil)	pt-br
Portugis (Portugal)	pt, pt-pt
Punjabi	pa, pa-arab, pa-arab-pk, pa-deva, pa-in
Quechua	quz, quz-bo, quz-ec, quz-pe
Rumania	ro, ro-ro
Rusia	ru , ru-ru
Gaelik Skotlandia	gd-gb, gd-latn
Serbia (Latin)	sr-Latn, sr-latn-cs, sr, sr-latn-ba, sr-latn-me, sr-latn-rs
Serbia (Sirilik)	sr-cyrl, sr-cyrl-ba, sr-cyrl-cs, sr-cyrl-me, sr-cyrl-rs
Sesotho sa Leboa	nso, nso-za
Setswana	tn, tn-bw, tn-za
Sindhi	sd-arab, sd-arab-pk, sd-deva
Sinhala	si, si-lk
Slovak	sk, sk-sk
Sloven	sl, sl-si
Spanyol	es, es-cl, es-co, es-es, es-mx, es-ar, es-bo, es-cr, es-do, es-ec, es-gt, es-hn, es-ni, es-pa, es-pe, es-pr, es-py, es-sv, es-us, es-uy, es-ve
Swedia	sv, sv-se, sv-fi
Tajik (Sirilik)	tg-arab, tg-cyrl, tg-cyrl-tj, tg-latn
Tamil	ta, ta-in
Tatar	tt-arab, tt-cyrl, tt-latn, tt-ru
Telugu	te, te-in
Thailand	th, th-th
Tigrinya	ti, ti-et
Turki	tr, tr-tr
Turkmen	tk-cyrl, tk-latn, tk-tm, tk-latn-tr, tk-cyrl-tr
Ukraina	uk, uk-ua
Urdu	Anda, your-pk
Uyghur	ug-arab, ug-cn, ug-cyrl, ug-latn
Uzbek (Latin)	uz, uz-cyrl, uz-latn, uz-latn-uz
Vietnam	vi, vi-vn
Wales	cy, cy-gb
Wolof	wo, wo-sn
Yoruba	yo-latn, yo-ng

Jenis aplikasi
Diperlukan

Pilih jenis aplikasi Anda – (EXE/MSI). Jika Anda memilih EXE, Anda diharuskan untuk memberikan parameter dan detail Alat Penginstal untuk penanganan Alat Penginstal.

Parameter penginstal
Diperlukan

Store harus menjalankan alat penginstal Anda dalam mode senyap. Untuk mendukung ini, Anda perlu menyediakan sakelar yang diperlukan, seperti /s, khusus untuk alat penginstal untuk aplikasi EXE Anda. Ini tidak diperlukan jika alat penginstal Anda berjalan dalam mode senyap secara default, tanpa sakelar apa pun.

Untuk aplikasi MSI, Store menggunakan sakelar senyap default '/qn' untuk menjalankan alat penginstal Anda dalam mode senyap.

Penanganan alat penginstal untuk aplikasi EXE Anda
Diperlukan

Aplikasi EXE biasanya memiliki alat penginstal yang mengembalikan kode kustom selama penginstalan. Store mendukung pesan dan tindakan yang berhadapan dengan pelanggan yang sesuai untuk kode pengembalian kustom yang Anda berikan.

Berikut ini adalah skenario penginstalan standar yang didukung oleh Store:

Skenario	Deskripsi
Penginstalan dibatalkan oleh pengguna	Operasi penginstalan dibatalkan oleh pengguna.
Aplikasi sudah ada	Aplikasi sudah ada pada perangkat.
Penginstalan sudah berlangsung	Penginstalan lain sudah berlangsung. Pengguna perlu menyelesaikan penginstalan sebelum melanjutkan penginstalan ini.
Ruang disk penuh	Ruang disk penuh.
Memulai ulang diperlukan	Mulai ulang diperlukan untuk menyelesaikan penginstalan.
kegagalan jaringan	Berikan nilai kode pengembalian kustom untuk berbagai kegagalan terkait jaringan.
Paket ditolak selama penginstalan	Paket ditolak selama penginstalan karena kebijakan keamanan diaktifkan pada perangkat.
Penginstalan berhasil	Penginstalan telah berhasil.

Anda dapat menambahkan lebih dari 1 kode pengembalian untuk setiap skenario di atas tergantung pada perilaku alat penginstal Anda.

Untuk skenario di luar daftar skenario standar di atas, pelanggan diarahkan ke dokumentasi kode pengembalian alat penginstal Anda. Untuk skenario kegagalan penginstalan lain-lain, Anda dapat menambahkan kode pengembalian kustom bersama dengan URL dokumentasi khusus kode pengembalian yang dapat mengarahkan pelanggan.

Kami sangat merekomendasikan informasi ini untuk disediakan untuk aplikasi EXE sehingga Store dapat memberikan pengalaman yang disesuaikan kepada pelanggan. Ini juga akan membantu Store untuk memperlakukan dan melaporkan penginstalan aplikasi Anda untuk aplikasi EXE.

Setelah menambahkan paket, klik Simpan draf. Anda akan kembali ke halaman Kelola Paket. Dalam Daftar paket, Anda akan melihat paket Anda telah ditambahkan. Setelah memverifikasi bahwa paket Anda telah ditambahkan dalam Daftar paket, klik Simpan Semua. Anda akan melihat pesan yang diunggah paket Anda dan setelah pengunggahan berhasil, Anda akan mendapatkan pesan sebagai Berhasil Disimpan.

Penting

Paket aplikasi saat ini tidak didukung untuk add-on.