Komutlar (MSI/EXE)

Kurulum

1. Adım: .NET Windows Çalışma Zamanı'nı yükleme

Henüz yapmadıysanız .NET 8 Desktop Runtime'ın en son sürümünü yükleyin. Bu, Microsoft Store Geliştirici CLI'sını çalıştırmak için bir gereksinimdir.

Bunu yüklemenin en kolay yolu winget kullanmaktır:

winget install Microsoft.DotNet.DesktopRuntime.8

2. Adım: Windows'a Microsoft Store Geliştirici CLI'sini yükleme

Microsoft Store Geliştirici CLI'sını Microsoft Store'dan indirebilirsiniz. Alternatif olarak , winget'i kullanabilirsiniz:

winget install "Microsoft Store Developer CLI"

1. Adım: .NET macOS Runtime'ı yükleme

Henüz yapmadıysanız.NET 8 Çalışma Zamanı'nın en son sürümünü yükleyin. Bu, Microsoft Store Geliştirici CLI'sını çalıştırmak için bir gereksinimdir.

2. Adım: macOS'a Microsoft Store Geliştirici CLI'sini yükleme

Microsoft Store Geliştirici CLI sürümleri sayfasından belirli mimariniz (x64 veya Arm64) için macOS .tar.gz indirebilirsiniz. İndirildikten sonra, arşivi ayıklayın ve PATH'inize yerleştirin, ancak bunu yapmak isteyebilirsiniz, örneğin:

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

Alternatif olarak, brew kullanabilirsiniz:

brew install microsoft/msstore-cli/msstore-cli

1. Adım: .NET Linux Çalışma Zamanı'nı yükleme

Henüz yapmadıysanız.NET 8 Çalışma Zamanı'nın en son sürümünü yükleyin. Bu, Microsoft Store Geliştirici CLI'sını çalıştırmak için bir gereksinimdir.

2. Adım: Linux'ta Microsoft Store Geliştirici CLI'sini yükleme

Linux .tar.gz dosyasını, belirli mimariniz (ya x64 veya Arm64) için, Microsoft Store Geliştirici CLI sürümleri sayfasından indirebilirsiniz. İndirildikten sonra, arşivi ayıklayın ve dilediğiniz şekilde PATH'inize yerleştirin, örneğin:

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

Alternatif olarak, brew kullanabilirsiniz:

brew install microsoft/msstore-cli/msstore-cli

Bilgi Komutu

Mevcut yapılandırmayı yazdırın.

Usage

msstore info

Options

Seçenek	Description
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Komutu Yeniden Yapılandır

Microsoft Store Geliştirici CLI'sını yeniden yapılandırın. İstemci Gizli Anahtarı veya Sertifika sağlayabilirsiniz. Sertifikalar, ya Parmak İzi aracılığıyla ya da (parola ile veya parolasız) bir dosya yolu aracılığıyla sağlanabilir.

Usage

msstore reconfigure

Options

Seçenek	Description
-t, --kiraciId	Kullanılacak kiracı kimliğini belirtin.
-s, --satıcıKimliği	Kullanılacak satıcı kimliğini belirtin.
-c, --clientId	Kullanılacak istemci kimliğini belirtin.
-cs, --clientSecret	Kullanılacak istemci Sırrını belirtin.
-ct, --certificateThumbprint	Kullanılması gereken sertifika parmak izini belirtin.
-cfp, --certificateFilePath	Kullanılacak sertifika dosyası yolunu belirtin.
-cp, --certificatePassword (sertifika parolası)	Kullanılacak sertifika parolasını belirtin.
--sıfırlama	Yeniden başlatmadan yalnızca kimlik bilgilerini sıfırlayın.
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Ayarlar Komutu

Microsoft Store Geliştirici CLI'sının ayarlarını değiştirin.

Usage

msstore settings

Options

Seçenek	Description
-t, --enableTelemetry	Telemetriyi etkinleştir (boş/doğru) veya Devre Dışı Bırak (yanlış).
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

SetPDN Alt-Komut

Yayımcı Görünen Adı özelliğini ayarlayın.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument	Description
publisherDisplayName	Global olarak ayarlanacak Yayımcı Görünen Adı özelliği.

Options

Seçenek	Description
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Gönderme Komutu

Sub-Command	Description
durum	Gönderimin durumunu alır.
al	Belirli bir gönderimin meta verilerini ve paket bilgilerini alır.
getListingAssets	Belirli bir gönderimin listeleme varlıklarını alır.
updateMetadata	Belirli bir gönderimin meta verilerini güncelleştirir.
güncelleştirmek	Belirli bir gönderimin paket bilgilerini güncelleştirir.
Anket	Gönderimin durumunu sorgular.
yayınlamak	Belirli bir gönderimi yayımlar.

Gönderim - Durum - Kullanım

msstore submission status <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Gönder - Al - Kullanım

msstore submission get <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-l, --language	Almak istediğiniz dili seçin. [varsayılan: en]
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Gönderim - GetListingAssets - Kullanım

msstore submission getListingAssets <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-l, --language	Almak istediğiniz dili seçin. [varsayılan: en]
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Gönderim - MetaVeriGüncelleme - Kullanım

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument	Description
productId	Partner Merkezi ID'si.
metadata	Güncelleştirilmiş JSON meta veri gösterimi.

Options

Seçenek	Description
-s, --skipInitialPolling (ilk yoklamayı atla)	Eylemi yürütmeden önce ilk yoklamayı atlayın. [varsayılan: Yanlış]
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Gönderim - Güncelleştirme - Kullanım

msstore submission update <productId> <package>

Arguments

Argument	Description
productId	Ortak merkez kimliği.
package	Uygulama paketinin güncelleştirilmiş JSON gösterimi.

Options

Seçenek	Description
-s, --skipInitialPolling	Eylemi yürütmeden önce ilk yoklamayı atlayın. [varsayılan: Yanlış]
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Gönderim - Yoklama - Kullanım

msstore submission poll <productId>

Arguments

Argument	Description
productId	Partner Merkezi ID'si.

Options

Seçenek	Description
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

Gönderim - Yayımlama - Kullanım

msstore submission publish <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-v, --ayrıntılı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --help	Yardım ve kullanım bilgilerini gösterin.

CI/CD Ortamları

Microsoft Store Geliştirici CLI'si (önizleme), CI/CD ortamlarında çalıştırmayı destekler. Başka bir deyişle, ci/CD işlem hatlarınızda Microsoft Store Geliştirici CLI'sini (önizleme) kullanarak uygulamalarınızı otomatik olarak Microsoft Store'da yayımlayabilirsiniz.

Bunu başarmak için ilk adım, CI/CD ortamınıza Microsoft Store Geliştirici CLI'sini (önizleme) yüklemektir. Bunu nasıl yapacağınıza ilişkin yönergeleri burada bulabilirsiniz.

Microsoft Store Geliştirici CLI'sını (önizleme) yükledikten sonra, ortamınızı komutları çalıştırabilecek şekilde yapılandırmanız gerekir. Bunu yapmak için komutunu iş ortağı merkezi hesabınızı (msstore reconfigure, ClientId) tanımlayan belirli parametrelerle çalıştırabilirsiniz. Ayrıca ClientSecret veya Sertifika sağlamanız gerekir.

CI/CD işlem hattınızın günlüklerinde görünür olacağı için bu kimlik bilgilerini gizlemek çok önemlidir. Bunu gizliler kullanarak yapabilirsiniz. Her CI/CD işlem hattı sisteminin bu gizli diziler için farklı adları vardır. Örneğin, Azure DevOps bunlara Gizli Değişkenler derken, GitHub Actions bunlara Şifrelenmiş Gizli olarak adlandırır. Parametrelerin her biri (TenantId, SellerId, ClientId ve ClientSecret veya Bir Sertifika) için bir gizli dizi oluşturun ve ardından komutunu kullanarak reconfigure ortamınızı ayarlayın.

Örneğin:

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 İşlemleri

- name: Setup Microsoft Store Developer CLI
  uses: microsoft/microsoft-store-apppublisher@v1.1
- 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 }}

Bu komut yürütüldükten sonra, Microsoft Store Geliştirici CLI'sı (önizleme) sağlanan kimlik bilgilerini kullanacak şekilde yapılandırılır. Artık CI/CD işlem hattınızda Microsoft Store Geliştirici CLI'sini (önizleme) kullanabilirsiniz.