Microsoft Store Geliştirici CLI'sı (MSI/EXE)

Uyarı

Bu sayfa, Microsoft Store Geliştirici CLI kullanılarak MSI/EXE uygulaması yayımlamayı kapsar. Microsoft Store Geliştirici CLI kullanarak MSIX uygulaması yayımlama hakkında bilgi için buraya tıklayın .

Microsoft Store Komut Satırı Arabirimi, Microsoft Store'daki uygulamalarınıza güncelleştirmeler yayımlamanıza yardımcı olan platformlar arası (Windows, macOS, Linux) bir CLI'dır. MSI/EXE uygulamaları için CLI, geliştirici tarafından barındırılan yükleyicinizin URL'sini içeren paket meta verilerini göndermek için Partner Center APIs'i çağırır. Mağaza, yükleyiciyi bu URL'den alır; CLI, yükleyici ikili dosyasını paketlemez veya karşıya yüklemez. Barındırma gereksinimleri için bkz. Paket bilgilerini ekleme ve düzenleme.

Önemli

Uygulamanızın Microsoft Store'daki ilk yayınını Partner Center aracılığıyla tamamlamanız gerekir. Uygulamanız yayımlandıktan sonra, sonraki güncelleştirmeleri yayımlamak için Microsoft Store Geliştirici CLI'sini kullanabilirsiniz.

Mağaza Geliştirici CLI'sini kullanma işlemi hem MSI/EXE hem de MSIX uygulamaları için aynıdır. Bu nedenle, nasıl kullanacağınızı anlamak için aşağıdaki videoya göz atın:

Önkoşullar

Microsoft Store Geliştirici CLI'sini kullanmak için şunları yapmanız gerekir:

• İş Ortağı Merkezi'nde Windows uygulama geliştiricisi olarak kaydolma
• İş Ortağı Merkezi hesabınızla ilişkilendirilmiş bir kiracınız olmalıdır. Bunu, İş Ortağı Merkezi'nde mevcut bir Microsoft Entra Kimliği ile ilişkilendirerek veya İş Ortağı Merkezi'ndeyeni bir Microsoft Entra Kimliği oluşturarak elde edebilirsiniz.
• Uygulamanızın İş Ortağı Merkezi'nde zaten oluşturulmasını sağlayın. Uygulamanız henüz yoksa, İş Ortağı Merkezi'nde adını rezerve ederek uygulamanızı oluşturun . CLI sizin için bir uygulama oluşturamaz.
• uygulamanın ilk yayınını Partner Center aracılığıyla tamamlayın. Uygulama için ilk gönderimi oluşturun, yaş derecelendirme anketi dahil olmak üzere, ve İş Ortağı Merkezi'nde sertifikasyon için gönderin. Sonraki güncelleştirmeleri yayımlamak için CLI'yi kullanmadan önce uygulama Microsoft Store'da yayımlanana kadar bekleyin.

Kurulum

Microsoft Store Geliştirici CLI'sı Windows 10+, Linux ve macOS'u destekler:

Microsoft Store Geliştirici CLI'sini (önizleme) şimdi yükleyin!

Başlangıç Yapmak

Microsoft Store Geliştirici CLI'sını yükledikten sonra, ortamınızı komutları çalıştırabilecek şekilde yapılandırmanız gerekir. Cli'yi ilk kez çalıştırarak bunu yapabilirsiniz. CLI, yapılandırma işleminde size yol gösterir:

msstore

Önemli

Oturum açarken MSA'nızı kullanmayın! Microsoft Store Geliştirici CLI'si, Microsoft Entra Id kimlik bilgilerinizi kullanmanızı gerektirir. Bu konuda daha fazla bilgiyi önkoşullar bölümünde bulabilirsiniz.

CI ortamlarında çalıştırma da desteklenir ve Microsoft Store Geliştirici CLI'si (önizleme), örneğin Microsoft Store’daki uygulamalarınıza yönelik güncelleştirmeleri otomatik olarak yayımlamak için CI/CD işlem hatlarınızda kullanılabilir. Bunun nasıl yapıldığını gösteren diğer yönergeler burada bulunabilir.

Uyarı

Microsoft Store Geliştirici CLI aracılığıyla uygulama güncelleştirme işlemleri şu anda yalnızca ücretsiz ürünler için desteklenmektedir. Ücretli ürünler gelecekteki bir sürümde desteklenecektir.

Commands

Microsoft Store Developer CLI için kullanılabilen komutlar şunlardır:

Command	Description
bilgi	Mevcut yapılandırmayı yazdırın.
yeniden yapılandırma	Microsoft Store Geliştirici CLI'sını yeniden yapılandırın.
Ayarlar	Microsoft Store Geliştirici CLI'sının ayarlarını değiştirin.
Teslim	'status', 'get', 'getListingAssets', 'updateMetadata', 'update', 'poll', 'publish' gibi ilgili komutları gönderme.

Daha fazla bilgi için bkz. Komutlar.

Sık sorulan sorular

1. Microsoft Store Geliştirici CLI'sı nedir ve bana nasıl yardımcı olabilir?

   Microsoft Store Geliştirici CLI'sı, geliştiricilerin aşağıdakiler gibi birçok İş Ortağı Merkezi görevini otomatikleştirmesine olanak tanıyan platformlar arası bir komut satırı aracıdır:

   • Uygulama bilgilerini listeleme ve eriştirme
   • Geliştirici tarafından barındırılan yükleyicinizin URL'si de dahil olmak üzere paket meta verilerini güncelleştirme
   • Mağaza meta verilerini güncelleştirme
   • Uygulama güncelleştirmelerini gönderme ve yayımlama

   Bu araç, güncelleştirilmiş yükleyici URL'lerini otomatik olarak gönderebileceğiniz ve uygulamanın Partner Center aracılığıyla ilk yayımlanmasının ardından uygulama güncelleştirmelerini yayımlayabileceğiniz CI/CD pipelines için özellikle kullanışlıdır. Kimlik doğrulaması, İş Ortağı Merkezi hesabınıza bağlı Entra Kimliği kimlik bilgileri kullanılarak yapılır.

   Web kullanıcı arabirimine esnek bir alternatif sunar ve Windows, macOS ve Linux genelinde betik iş akışlarını destekler. Bunu kullanmak için, geliştiricilerin önce API erişimini uygun izinlerle yapılandırması gerekir. Bu araçla ekipler yayın işlemlerini önemli ölçüde kolaylaştırabilir ve ölçeklendirebilir.

2. CLI ile Mağaza gönderimlerini otomatikleştirebilir miyim?

   Evet, uygulamanızın ilk yayınını İş Ortağı Merkezi aracılığıyla tamamladıktan sonra, güncelleştirilmiş paket meta verilerini göndermek ve sonraki uygulama güncelleştirmelerini yayımlamak için derleme işlem hatlarında CLI'yi kullanabilirsiniz. MSI/EXE yükleyicinizi ayrı olarak derleyin ve barındırın, ardından CLI kullanarak URL'sini içeren paket meta verilerini gönderin. Mağaza, yükleyiciyi bu URL'den alır; CLI bunu paketlemez veya karşıya yüklemez. İlk yayını tamamlamak için CLI’yi kullanamazsınız.