Perintah

Artikel
11/08/2024

Penginstalan

Langkah 1: Instal .NET Windows Runtime

Jika Anda belum melakukannya, instal versi terbaru .NET 8 Desktop Runtime. Ini adalah persyaratan untuk menjalankan Microsoft Store Developer CLI.

Cara term mudah untuk menginstalnya adalah dengan menggunakan winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Langkah 2: Instal Microsoft Store Developer CLI di Windows

Anda dapat mengunduh Microsoft Store Developer CLI dari Microsoft Store. Atau, Anda dapat menggunakan winget:

winget install "Microsoft Store Developer CLI"

Langkah 1: Instal .NET macOS Runtime

Jika Anda belum melakukannya, instal versi terbaru .NET 8 Runtime. Ini adalah persyaratan untuk menjalankan Microsoft Store Developer CLI.

Langkah 2: Instal CLI Pengembang Microsoft Store di macOS

Anda dapat mengunduh .tar.gz macOS untuk arsitektur spesifik Anda (x64 atau Arm64) dari halaman rilis CLI Pengembang Microsoft Store. Setelah diunduh, ekstrak arsip dan letakkan di PATH Anda, namun Anda ingin melakukannya, misalnya:

mkdir MSStoreCLI
curl https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-osx-x64.tar.gz -o MSStoreCLI-osx-x64.tar.gz
tar -xvf MSStoreCLI-osx-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

Atau, Anda dapat menggunakan bir:

brew install microsoft/msstore-cli/msstore-cli

Langkah 1: Instal .NET Linux Runtime

Jika Anda belum melakukannya, instal versi terbaru .NET 8 Runtime. Ini adalah persyaratan untuk menjalankan Microsoft Store Developer CLI.

Langkah 2: Instal Microsoft Store Developer CLI di Linux

Anda dapat mengunduh .tar.gz Linux untuk arsitektur spesifik Anda (x64 atau Arm64) dari halaman rilis CLI Pengembang Microsoft Store. Setelah diunduh, ekstrak arsip dan letakkan di PATH Anda, namun Anda ingin melakukannya, misalnya:

mkdir MSStoreCLI
wget https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-linux-x64.tar.gz
tar -xvf MSStoreCLI-linux-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

Atau, Anda dapat menggunakan bir:

brew install microsoft/msstore-cli/msstore-cli

Perintah Info

Cetak konfigurasi yang ada.

Perintah Info - Penggunaan

msstore info

Perintah Info - Opsi

Opsi	Deskripsi
-v, --verbose	Cetak output verbose.

Mengonfigurasi ulang Perintah

Konfigurasikan ulang CLI Pengembang Microsoft Store. Anda dapat memberikan Rahasia Klien atau Sertifikat. Sertifikat dapat disediakan baik melalui Thumbprint-nya atau dengan menyediakan jalur file (dengan atau tanpa kata sandi).

Konfigurasi ulang - Penggunaan

msstore reconfigure

Konfigurasi ulang - Opsi

Opsi	Deskripsi
-t, --tenantId	Tentukan Id penyewa yang harus digunakan.
-s, --sellerId	Tentukan Id penjual yang harus digunakan.
-c, --clientId	Tentukan ID klien yang harus digunakan.
-cs, --clientSecret	Tentukan Rahasia klien yang harus digunakan.
-ct, --certificateThumbprint	Tentukan Thumbprint sertifikat yang harus digunakan.
-cfp, --certificateFilePath	Tentukan jalur file sertifikat yang harus digunakan.
-cp, --certificatePassword	Tentukan kata sandi sertifikat yang harus digunakan.
--Reset	Hanya atur ulang kredensial, tanpa memulai kembali.

Perintah Pengaturan

Ubah pengaturan CLI Pengembang Microsoft Store.

Pengaturan - Penggunaan

msstore settings

Sub-Perintah	Deskripsi
setpdn	Atur properti Nama Tampilan Publisher yang digunakan oleh perintah init.

Pengaturan - Opsi

Opsi	Deskripsi
-t, --enableTelemetry	Aktifkan telemetri (kosong/benar) atau Nonaktifkan (false).
-v, --verbose	Cetak output verbose.

Pengaturan - Penggunaan Perintah SetPDN

msstore settings setpdn <publisherDisplayName>

Argumen

Argumen	Deskripsi
`publisherDisplayName`	Properti Nama Tampilan Publisher yang akan diatur secara global.

Bantuan

msstore settings setpdn --help

Perintah Aplikasi

Sub-Perintah	Deskripsi
daftar	Mencantumkan semua aplikasi di akun Anda.
get	Mendapatkan detail aplikasi tertentu.

Aplikasi - Daftar Penggunaan Perintah

msstore apps list

Perintah Daftar - Bantuan

msstore apps list --help

Aplikasi - Dapatkan Penggunaan Perintah

msstore apps get <productId>

Aplikasi - Dapatkan Argumen Perintah

Argumen	Deskripsi
`productId`	ID produk.

Aplikasi - Dapatkan Bantuan Perintah

msstore apps get --help

Perintah Pengiriman

Sub-Perintah	Deskripsi
status	Mendapatkan status pengiriman.
get	Mendapatkan detail pengiriman tertentu.
getListingAssets	Mendapatkan aset daftar dari pengiriman tertentu.
updateMetadata	Memperbarui metadata pengiriman tertentu.
memperbarui	Memperbarui detail pengiriman tertentu.
Jajak pendapat	Polling status pengiriman.
terbitkan	Menerbitkan pengiriman tertentu.
hapus	Menghapus pengiriman tertentu.

Pengiriman - Penggunaan Perintah Status

msstore submission status <productId>

Pengiriman - Argumen Perintah Status

Argumen	Deskripsi
`productId`	ID produk.

Pengiriman - Bantuan Perintah Status

msstore submission status --help

Pengiriman - Dapatkan Penggunaan Perintah

msstore submission get <productId>

Pengiriman - Dapatkan Argumen Perintah

Argumen	Deskripsi
`productId`	ID produk.

Pengiriman - Opsi Dapatkan Perintah

Opsi	Deskripsi
-m, --module	Pilih modul mana yang ingin Anda ambil ('ketersediaan', 'daftar' atau 'properti').
-l, --language	Pilih bahasa mana yang ingin Anda ambil. [default: en]

Pengiriman - Dapatkan Bantuan Perintah

msstore submission get --help

Pengiriman - Penggunaan Perintah GetListingAssets

Mengambil aset daftar draf yang ada dari pengiriman toko.

msstore submission getListingAssets <productId>

Pengiriman - Argumen Perintah GetListingAssets

Argumen	Deskripsi
`productId`	ID produk.

Pengiriman - Opsi Perintah GetListingAssets

Opsi	Deskripsi
-l, --language	Pilih bahasa mana yang ingin Anda ambil. [default: en]

Pengiriman - Bantuan Perintah GetListingAssets

msstore submission getListingAssets --help

Pengiriman - Penggunaan Perintah UpdateMetadata

msstore submission updateMetadata <productId> <metadata>

Pengiriman - Argumen Perintah UpdateMetadata

Argumen	Deskripsi
`productId`	ID produk.
`metadata`	Representasi metadata JSON yang diperbarui.

Pengiriman - Opsi Perintah UpdateMetadata

Opsi	Deskripsi
-s, --skipInitialPolling	Lewati polling awal sebelum menjalankan tindakan. [default: False]

Pengiriman - Bantuan Perintah UpdateMetadata

msstore submission updateMetadata --help

Pengiriman - Memperbarui Penggunaan Perintah

msstore submission update <productId> <product>

Pengiriman - Perbarui Argumen Perintah

Argumen	Deskripsi
`productId`	ID produk.
`product`	Representasi produk JSON yang diperbarui.

Pengiriman - Perbarui Opsi Perintah

Opsi	Deskripsi
-s, --skipInitialPolling	Lewati polling awal sebelum menjalankan tindakan. [default: False]

Pengiriman - Perbarui Bantuan Perintah

msstore submission update --help

Pengiriman - Penggunaan Perintah Polling

msstore submission poll <productId>

Pengiriman - Argumen Perintah Polling

Argumen	Deskripsi
`productId`	ID produk.

Pengiriman - Bantuan Perintah Polling

msstore submission poll --help

Pengiriman - Terbitkan Penggunaan Perintah

msstore submission publish <productId>

Pengiriman - Terbitkan Argumen Perintah

Argumen	Deskripsi
`productId`	ID produk.

Pengiriman - Bantuan Terbitkan Perintah

msstore submission publish --help

Pengiriman - Hapus Penggunaan Perintah

Menghapus pengiriman yang tertunda dari penyimpanan.

Pengiriman - Hapus Argumen Perintah

Argumen	Deskripsi
`productId`	ID produk.

Pengiriman - Hapus Opsi Perintah

Opsi	Deskripsi
--no-confirm	Jangan meminta konfirmasi. [default: False]

Pengiriman - Hapus Bantuan Perintah

msstore submission delete --help

Perintah Init

Perintah ini init membantu Anda menyiapkan aplikasi untuk diterbitkan ke Microsoft Store. Saat ini mendukung jenis aplikasi berikut:

SDK Aplikasi Windows/WinUI 3
UWP
.NET MAUI
Flutter
Electron
React Native untuk Desktop
PWA

Perintah Init - Contoh Penggunaan

Perintah Init - SDK Aplikasi Windows/WinUI 3

msstore init "C:\path\to\winui3_app"

Perintah Init - UWP

msstore init "C:\path\to\uwp_app"

Perintah Init - .NET MAUI

msstore init "C:\path\to\maui_app"

Perintah Init - Berkibar

msstore init "C:\path\to\flutter_app"

Perintah Init - Elektron

msstore init "C:\path\to\electron_app"

Perintah Init - React Native untuk Desktop

msstore init "C:\path\to\react_native_app"

Catatan

Untuk Electron, serta React Native untuk proyek Desktop, baik Npm dan Yarn didukung. Kehadiran Yarn file kunci (yarn.lock) akan digunakan untuk menentukan manajer paket mana yang akan digunakan, jadi pastikan Anda memeriksa file kunci Anda ke sistem kontrol sumber Anda.

Perintah Init - PWA

msstore init https://contoso.com --output .

Perintah Init - Argumen

Argumen	Deskripsi
`pathOrUrl`	Jalur direktori akar tempat file proyek berada, atau URL publik yang menunjuk ke PWA.

Perintah Init - Opsi

Opsi	Deskripsi
-n, --publisherDisplayName	Nama Tampilan Publisher yang digunakan untuk mengonfigurasi aplikasi. Jika disediakan, hindari panggilan API tambahan.
--paket	Jika didukung oleh jenis aplikasi, secara otomatis mengemas proyek.
--menerbitkan	Jika didukung oleh jenis aplikasi, secara otomatis menerbitkan proyek. Menyiratkan '--package true'
-f, --flightId	Menentukan Id Penerbangan tempat paket akan diterbitkan.
-prp, --packageRolloutPercentage	Menentukan persentase peluncuran paket. Nilai harus antara 0 dan 100.
-a, --arch	Arsitektur yang akan dibangun. Jika tidak disediakan, arsitektur default untuk OS saat ini, dan jenis proyek, akan digunakan. Nilai yang diizinkan: "x86", "x64", "arm64". Hanya digunakan yang digunakan bersama dengan '--package true'.
-o, --output	Direktori output tempat aplikasi paket akan disimpan. Jika tidak disediakan, direktori default untuk setiap jenis aplikasi yang berbeda akan digunakan.
-ver, --version	Versi yang digunakan saat membuat aplikasi. Jika tidak disediakan, versi dari file proyek akan digunakan.

Perintah Paket

Membantu Anda mengemas Aplikasi Microsoft Store sebagai MSIX.

Perintah Paket - Contoh Penggunaan

Perintah Paket - SDK Aplikasi Windows/WinUI 3

msstore package "C:\path\to\winui3_app"

Perintah Paket - UWP

msstore package "C:\path\to\uwp_app"

Perintah Paket - .NET MAUI

msstore package "C:\path\to\maui_app"

Perintah Paket - Berkibar

msstore package "C:\path\to\flutter_app"

Perintah Paket - Elektron

msstore package "C:\path\to\electron_app"

Perintah Paket - React Native untuk Desktop

msstore package "C:\path\to\react_native_app"

Perintah Paket - PWA

msstore package "C:\path\to\pwa_app"

Perintah Paket - Argumen

Opsi	Deskripsi
`pathOrUrl`	Jalur direktori akar tempat file proyek berada, atau URL publik yang menunjuk ke PWA.

Perintah Paket - Opsi

Opsi	Deskripsi
-o, --output	Direktori output tempat aplikasi paket akan disimpan. Jika tidak disediakan, direktori default untuk setiap jenis aplikasi yang berbeda akan digunakan.
-a, --arch	Arsitektur yang akan dibangun. Jika tidak disediakan, arsitektur default untuk OS saat ini, dan jenis proyek, akan digunakan. Nilai yang diizinkan: "x86", "x64", "arm64".
-ver, --version	Versi yang digunakan saat membuat aplikasi. Jika tidak disediakan, versi dari file proyek akan digunakan.

Perintah Terbitkan

Menerbitkan Aplikasi Anda ke Microsoft Store.

Perintah Terbitkan - Contoh Penggunaan

Perintah Terbitkan - SDK Aplikasi Windows/WinUI 3

msstore publish "C:\path\to\winui3_app"

Perintah Terbitkan - UWP

msstore publish "C:\path\to\uwp_app"

Perintah Terbitkan - .NET MAUI

msstore publish "C:\path\to\maui_app"

Perintah Terbitkan - Berkibar

msstore publish "C:\path\to\flutter_app"

Perintah Terbitkan - Elektron

msstore publish "C:\path\to\electron_app"

Perintah Terbitkan - React Native untuk Desktop

msstore publish "C:\path\to\react_native_app"

Perintah Terbitkan - PWA

msstore publish "C:\path\to\pwa_app"

Perintah Terbitkan - Argumen

Opsi	Deskripsi
`pathOrUrl`	Jalur direktori akar tempat file proyek berada, atau URL publik yang menunjuk ke PWA.

Perintah Terbitkan - Opsi

Opsi	Deskripsi
-i, --inputDirectory	Direktori tempat file '.msix' atau '.msixupload' digunakan untuk perintah penerbitan. Jika tidak disediakan, cli akan mencoba menemukan kandidat terbaik berdasarkan argumen 'pathOrUrl'.
-id, --appId	Menentukan Id Aplikasi. Hanya diperlukan jika proyek belum diinisialisasi sebelumnya dengan perintah 'init'.
-nc, --noCommit	Menonaktifkan penerapan pengiriman, menyimpannya dalam status draf.
-f, --flightId	Menentukan Id Penerbangan tempat paket akan diterbitkan.
-prp, --packageRolloutPercentage	Menentukan persentase peluncuran paket. Nilai harus antara 0 dan 100.

Lingkungan CI/CD

Microsoft Store Developer CLI (pratinjau) mendukung berjalan di lingkungan CI/CD. Ini berarti Anda dapat menggunakan Microsoft Store Developer CLI (pratinjau) di alur CI/CD Anda, misalnya, secara otomatis menerbitkan aplikasi Anda ke Microsoft Store.

Langkah pertama untuk mencapainya untuk menginstal Microsoft Store Developer CLI (pratinjau) di lingkungan CI/CD Anda. Anda dapat menemukan instruksi tentang cara melakukan ini di sini.

Setelah menginstal Microsoft Store Developer CLI (pratinjau), Anda harus mengonfigurasi lingkungan Anda untuk dapat menjalankan perintah. Anda dapat melakukan ini dengan menjalankan msstore reconfigure perintah dengan parameter tertentu yang mengidentifikasi akun pusat mitra Anda (TenantId, SellerId, ClientId). Anda juga perlu memberikan ClientSecret atau Sertifikat.

Sangat penting untuk menyembunyikan kredensial ini, karena akan terlihat di log alur CI/CD Anda. Anda dapat melakukan ini dengan menggunakan rahasia. Setiap sistem alur CI/CD memiliki nama yang berbeda untuk rahasia ini. Misalnya, Azure DevOps memanggilnya Variabel Rahasia, tetapi Tindakan GitHub memanggilnya Rahasia Terenkripsi. Buat satu rahasia untuk setiap parameter (TenantId, SellerId, ClientId, dan ClientSecret atau Sertifikat), lalu gunakan reconfigure perintah untuk menyiapkan lingkungan Anda.

Contohnya:

Azure DevOps

- task: UseMSStoreCLI@0
  displayName: Setup Microsoft Store Developer CLI
- script: msstore reconfigure --tenantId $(PARTNER_CENTER_TENANT_ID) --sellerId $(PARTNER_CENTER_SELLER_ID) --clientId $(PARTNER_CENTER_CLIENT_ID) --clientSecret $(PARTNER_CENTER_CLIENT_SECRET)
  displayName: Configure Microsoft Store Developer CLI

GitHub Actions

- name: Setup Microsoft Store Developer CLI
  uses: microsoft/setup-msstore-cli@v1
- name: Configure Microsoft Store Developer CLI
  run: msstore reconfigure --tenantId ${{ secrets.PARTNER_CENTER_TENANT_ID }} --sellerId ${{ secrets.PARTNER_CENTER_SELLER_ID }} --clientId ${{ secrets.PARTNER_CENTER_CLIENT_ID }} --clientSecret ${{ secrets.PARTNER_CENTER_CLIENT_SECRET }}

Setelah perintah ini dijalankan, Microsoft Store Developer CLI (pratinjau) akan dikonfigurasi untuk menggunakan kredensial yang disediakan. Sekarang Anda dapat menggunakan Microsoft Store Developer CLI (pratinjau) di alur CI/CD Anda.

Bagikan melalui