Megosztás a következőn keresztül:


Parancsok (MSI/EXE)

Installation

1. lépés: A .NET windowsos futtatókörnyezetének telepítése

Ha még nem tette meg, telepítse a .NET 8 asztali futtatókörnyezet legújabb verzióját. Ez a Microsoft Store fejlesztői parancssori felület futtatásának követelménye.

A telepítés legegyszerűbb módja a winget használata:

winget install Microsoft.DotNet.DesktopRuntime.8

2. lépés: A Microsoft Store fejlesztői parancssori felület telepítése Windows rendszeren

A Microsoft Store fejlesztői parancssori felületét a Microsoft Store áruházból töltheti le. Másik lehetőségként használhatja a winget:

winget install "Microsoft Store Developer CLI"

1. lépés: A .NET macOS Runtime telepítése

Ha még nem tette meg, telepítse a .NET 8 futtatókörnyezet legújabb verzióját. Ez a Microsoft Store fejlesztői parancssori felület futtatásának követelménye.

2. lépés: A Microsoft Store fejlesztői parancssori felületének telepítése macOS rendszeren

A macOS -.tar.gz az adott architektúrához (x64 vagy Arm64) a Microsoft Store fejlesztői parancssori felületének kiadási oldaláról töltheti le. Miután letöltötte az archívumot, bontsa ki, és helyezze el a PATH-ban, ahogyan Ön szeretné, például:

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

Másik lehetőségként használhatja a brew-t:

brew install microsoft/msstore-cli/msstore-cli

1. lépés: A .NET Linux-futtatókörnyezet telepítése

Ha még nem tette meg, telepítse a .NET 8 futtatókörnyezet legújabb verzióját. Ez a Microsoft Store fejlesztői parancssori felület futtatásának követelménye.

2. lépés: A Microsoft Store fejlesztői parancssori felület telepítése Linux rendszeren

Az adott architektúrához (x64 vagy Arm64) tartozó Linux -.tar.gz a Microsoft Store fejlesztői CLI kiadási oldaláról töltheti le. Miután letöltötte az archívumot, helyezze el a PATH-ban, ahogyan szeretné, például:

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

Másik lehetőségként használhatja a brew-t:

brew install microsoft/msstore-cli/msstore-cli

Információ parancs

Meglévő konfiguráció nyomtatása.

Usage

msstore info

Beállítások

Lehetőség Description
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Parancs újrakonfigurálása

Konfigurálja újra a Microsoft Store fejlesztői parancssori felületét. Megadhat egy ügyfélkulcsot vagy egy tanúsítványt. A tanúsítványok az ujjlenyomatán keresztül vagy egy fájl elérési útján (jelszóval vagy jelszó nélkül) is megadhatóak.

Usage

msstore reconfigure

Beállítások

Lehetőség Description
-t, --tenantId Adja meg a használni kívánt bérlőazonosítót.
-s, --sellerId Adja meg a használni kívánt eladóazonosítót.
-c, --ügyfélAzonító Adja meg a használni kívánt ügyfél-azonosítót.
-cs, --ügyféltitok Adja meg a használni kívánt ügyfélkulcsot.
-ct, --certificateThumbprint Adja meg a használni kívánt tanúsítvány ujjlenyomatát.
-cfp, --certificateFilePath (tanúsítványfájl elérési út) Adja meg a használni kívánt tanúsítványfájl elérési útját.
-cp, --certificatePassword Adja meg a használni kívánt tanúsítványjelszót.
--visszaállítás Csak a hitelesítő adatok alaphelyzetbe állítása újrakezdés nélkül.
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beállítások parancs

A Microsoft Store fejlesztői parancssori felület beállításainak módosítása.

Usage

msstore settings

Beállítások

Lehetőség Description
-t, --enableTelemetry Engedélyezze (üres/igaz) vagy tiltsa le a (hamis) telemetriát.
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

SetPDN Sub-Command

Állítsa be a Közzétevő megjelenítendő neve tulajdonságot.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName A Közzétevő megjelenítendő neve tulajdonság, amely globálisan lesz beállítva.

Beállítások

Lehetőség Description
-?, -h, --help Súgó- és használati adatok megjelenítése.

Küldési parancs

Alparancs Description
állapot Lekéri a beküldés állapotát.
szerezze meg Lekéri egy adott beküldés metaadatait és csomagadatait.
getListingAssets Lekéri egy adott beküldés elemeit.
updateMetadata Frissíti egy adott beküldés metaadatait.
frissít Frissíti egy adott beküldés csomaginformációját.
szavazás Lekérdezi a beküldés állapotát.
közzétesz Megjelentet egy adott beküldést.

Beküldés – Állapot – Használat

msstore submission status <productId>

Arguments

Argument Description
productId A Partnerközpont azonosítója.

Beállítások

Lehetőség Description
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – Lekérés – Használat

msstore submission get <productId>

Arguments

Argument Description
productId A Partnerközpont azonosítója.

Beállítások

Lehetőség Description
-l, --language Válassza ki a lekérni kívánt nyelvet. [alapértelmezett: hu]
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – GetListingAssets – Használat

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId A Partnerközpont azonosítója.

Beállítások

Lehetőség Description
-l, --language Válassza ki a lekérni kívánt nyelvet. [alapértelmezett: hu]
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – UpdateMetadata – Használat

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId A Partnerközpont azonosítója.
metadata A frissített JSON-metaadatok megjelenítése.

Beállítások

Lehetőség Description
-s, --skipInitialPolling A művelet végrehajtása előtt hagyja ki a kezdeti lekérdezést. [alapértelmezett: Hamis]
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – Frissítés – Használat

msstore submission update <productId> <package>

Arguments

Argument Description
productId A Partnerközpont azonosítója.
package Az alkalmazáscsomag frissített JSON-ábrázolása.

Beállítások

Lehetőség Description
-s, --skipInitialPolling (kezdeti lekérdezés kihagyása) A művelet végrehajtása előtt hagyja ki a kezdeti lekérdezést. [alapértelmezett: Hamis]
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – Szavazás – Használat

msstore submission poll <productId>

Arguments

Argument Description
productId A Partnerközpont azonosítója.

Beállítások

Lehetőség Description
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – Közzététel – Használat

msstore submission publish <productId>

Arguments

Argument Description
productId A Partnerközpont azonosítója.

Beállítások

Lehetőség Description
-v, --részletes Részletes kimenet nyomtatása.
-?, -h, --help Súgó- és használati adatok megjelenítése.

CI/CD-környezetek

A Microsoft Store fejlesztői parancssori felület (előzetes verzió) támogatja a CI/CD-környezetekben való futtatásokat. Ez azt jelenti, hogy a CI/CD-folyamatokban a Microsoft Store fejlesztői parancssori felület (előzetes verzió) használatával például automatikusan közzéteheti alkalmazásait a Microsoft Store-ban.

Ennek első lépéseként telepítse a Microsoft Store fejlesztői parancssori felületét (előzetes verzió) a CI/CD-környezetben. Erről itt talál útmutatást.

A Microsoft Store fejlesztői parancssori felületének (előzetes verzió) telepítése után konfigurálnia kell a környezetet a parancsok futtatására. Ehhez futtassa a parancsot a msstore reconfigure partnerközpont fiókját azonosító paraméterekkel (TenantId, SellerId, ClientId). Meg kell adnia egy ClientSecret vagy egy tanúsítványt is.

Nagyon fontos, hogy elrejtse ezeket a hitelesítő adatokat, mivel azok láthatók lesznek a CI/CD-folyamat naplóiban. Ezt titkos kódok használatával teheti meg. Mindegyik CI/CD-folyamatrendszernek különböző nevei vannak ezekhez a titkos kódokhoz. Az Azure DevOps például titkos változóknak hívja őket, de a GitHub Action titkosított titkos kódnak hívja őket. Hozzon létre egy titkos kulcsot az egyes paraméterekhez (TenantId, SellerId, ClientId és ClientSecretvagy tanúsítvány), majd a reconfigure paranccsal állítsa be a környezetet.

Például:

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/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 }}

A parancs végrehajtása után a Microsoft Store fejlesztői parancssori felülete (előzetes verzió) a megadott hitelesítő adatok használatára lesz konfigurálva. Most már használhatja a Microsoft Store fejlesztői parancssori felületét (előzetes verzió) a CI/CD-folyamatban.