Instalación
Paso 1: Instalar .NET Windows Runtime
Si aún no lo ha hecho, instale la versión más reciente de .NET 9 Desktop Runtime. Este es un requisito para ejecutar la CLI para desarrolladores de Microsoft Store.
La manera más fácil de instalarla es mediante winget:
winget install Microsoft.DotNet.DesktopRuntime.9
Paso 2: Instalación de la CLI para desarrolladores de Microsoft Store en Windows
Puede descargar la CLI de Microsoft Store Developer desde el Microsoft Store. Como alternativa, puede usar winget:
winget install "Microsoft Store Developer CLI"
Paso 1: Instalar .NET macOS Runtime
Si aún no lo ha hecho, instale la versión más reciente de la .NET 9 Runtime. Este es un requisito para ejecutar la CLI para desarrolladores de Microsoft Store.
Paso 2: Instalación de la CLI para desarrolladores de Microsoft Store en macOS
Puede descargar el archivo .tar.gz de macOS para su arquitectura específica (x64 o Arm64) desde la página de versiones de Microsoft Store Developer CLI. Una vez descargado, extraiga el archivo y colóquelo en la PATH, como quieras, por ejemplo:
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
Como alternativa, puede usar brew:
brew install microsoft/msstore-cli/msstore-cli
Paso 1: Instale el Runtime de .NET para Linux
Si aún no lo ha hecho, instale la versión más reciente de la .NET 9 Runtime. Este es un requisito para ejecutar la CLI para desarrolladores de Microsoft Store.
Paso 2: Instalación de la CLI para desarrolladores de Microsoft Store en Linux
Puede descargar el archivo .tar.gz de Linux para su arquitectura específica (x64 o Arm64) desde la página de versiones de Microsoft Store Developer CLI. Una vez descargado, extraiga el archivo y colóquelo en la PATH, como quieras, por ejemplo:
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
Como alternativa, puede usar brew:
brew install microsoft/msstore-cli/msstore-cli
Comando de información
Imprima la configuración existente.
Usage
msstore info
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelva a configurar la CLI para desarrolladores de Microsoft Store. Puede proporcionar un secreto de cliente o un certificado. Los certificados se pueden proporcionar a través de su huella digital o proporcionando una ruta de acceso de archivo (con o sin contraseña).
Usage
msstore reconfigure
Options
| Opción |
Descripción |
| -t, --tenantId |
Especifique el identificador de inquilino que se debe usar. |
| -s, --sellerId (ID del vendedor) |
Especifique el identificador de vendedor que se debe usar. |
| -c, --clientId (ID del cliente) |
Especifique el identificador de cliente que se debe usar. |
| -cs, --clientSecret (secreto del cliente) |
Especifique el secreto de cliente que se debe usar. |
| -ct, --certificateThumbprint |
Especifique la huella digital del certificado que se debe usar. |
| -cfp, --certificateFilePath |
Especifique la ruta de acceso del archivo de certificado que se debe usar. |
| -cp, --certificatePassword (contraseña del certificado) |
Especifique la contraseña del certificado que se debe usar. |
| --reiniciar |
Restablezca solo las credenciales, sin empezar de nuevo. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Comando de configuraciones
Cambie la configuración de la CLI para desarrolladores de Microsoft Store.
Usage
msstore settings
Options
| Opción |
Descripción |
| -t, --enableTelemetry |
Habilite (vacío/verdadero) o deshabilite (falso) la telemetría. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Subcomando de SetPDN
Establece la propiedad Nombre de visualización del editor que utiliza el comando init.
Usage
msstore settings setpdn <publisherDisplayName>
Argumentos
| Argumento |
Descripción |
publisherDisplayName |
La propiedad Nombre de visualización del editor que se establecerá de forma global. |
Options
| Opción |
Descripción |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Comando de aplicaciones
| Subcomando |
Descripción |
|
lista |
Enumera todas las aplicaciones de la cuenta. |
|
Obtener |
Obtiene los detalles de una aplicación específica. |
Aplicaciones: lista: uso
msstore apps list
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Aplicaciones - Obtener - Uso
msstore apps get <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Comando de envío
| Subcomando |
Descripción |
|
estado |
Obtiene el estado de un envío. |
|
Obtener |
Obtiene los metadatos y la información del paquete de un envío específico. |
|
getListingAssets |
Obtiene los activos de listado de un envío específico. |
|
updateMetadata |
Actualiza los metadatos de un envío específico. |
|
actualizar |
Actualiza el paquete de un envío específico. |
|
encuesta |
Consulta el estado de un envío. |
|
publish |
Publica una presentación específica. |
|
eliminación |
Elimina un envío específico. |
|
lanzamiento |
Ejecute operaciones relacionadas con la implementación gradual de paquetes. |
Envío: estado: uso
msstore submission status <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío - Obtener - Uso
msstore submission get <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío: GetListingAssets: uso
msstore submission getListingAssets <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
msstore submission updateMetadata <productId> <metadata>
Nota:
En el caso de las aplicaciones MSIX/empaquetadas, submission updateMetadata y submission update son equivalentes: ambos envían el JSON de envío completo devuelto por submission get, por lo que cualquiera de los comandos puede actualizar listas y paquetes juntos.
Las dos difieren solo para las aplicaciones sin empaquetar (MSI/EXE), donde el identificador de producto es un GUID: updateMetadata actualiza los metadatos de la descripción de la Tienda, mientras actualiza update los paquetes.
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
metadata |
Representación actualizada de metadatos JSON. |
Options
| Opción |
Descripción |
| -s, --skipInitialPolling |
Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False] |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío: actualización: uso
msstore submission update <productId> <package>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
package |
Representación JSON actualizada del paquete de aplicación. |
Options
| Opción |
Descripción |
| -s, --skipInitialPolling |
Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False] |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Sugerencia
Use submission get para recuperar el json del paquete actual antes de llamar a submission update. Esto garantiza que está trabajando con la estructura correcta y los valores actuales. Por ejemplo, en PowerShell:
# Step 1: Retrieve the current submission package JSON
msstore submission get <productId> | Out-File -Encoding utf8 package.json
# Step 2: Edit package.json to reflect your changes
# Step 3: Pass the updated JSON to submission update
$updatedPackage = Get-Content -Raw package.json
msstore submission update <productId> $updatedPackage
Para obtener más contexto, consulta publicar actualizaciones de la aplicación en Microsoft Store con Acciones de GitHub.
Envío - Encuesta - Uso
msstore submission poll <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío: publicación: uso
msstore submission publish <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío: eliminación: uso
msstore submission delete <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| --no-confirmar |
No solicitar confirmación. [valor predeterminado: False] |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío: comando de Implementación
Utilice estos subcomandos para administrar una implementación gradual de paquetes para un envío no incluido en un vuelo. Para administrar una implementación dirigida a un vuelo de paquetes, utilice msstore flights submission rollout en su lugar.
Estos comandos solo se admiten para aplicaciones MSIX/empaquetadas. Si se omite el ID de la presentación, la CLI utiliza la presentación pendiente de la aplicación y, en su defecto, recurre a la última publicada.
| Subcomando | Descripción | | ------------------------------------------------------- - | -------------------------------------------------- | | get | Recupera el estado de la de Implementación de un Envío. | | update | Actualiza el porcentaje de implementación de un envío. | | halt | Detiene el despliegue de un envío. | | finalize | Finaliza el despliegue de un envío. |
Nota:
Para que estos comandos puedan aplicarse a una presentación, es necesario habilitar una implementación en la misma. Habilítala en el momento de la publicación con msstore publish --packageRolloutPercentage, o bien estableciendo packageDeliveryOptions.packageRollout en el JSON enviado a submission update.
Envío - Uso del comando Obtener de Implementación
msstore submission rollout get <productId>
Envío - Argumentos del comando Obtener de Implementación
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Envío - Opciones del comando Obtener de Implementación
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío - Ayuda del comando Obtener de Implementación
msstore submission rollout get --help
Envío - Uso del comando Actualizar de Implementación
msstore submission rollout update <productId> <percentage>
Envío - Argumentos del comando Actualizar de Implementación
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
percentage |
El porcentaje de usuarios que recibirán la implementación del envío (0-100). |
Envío - Opciones del comando Actualizar de Implementación
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío - Ayuda del comando Actualizar de Implementación
msstore submission rollout update --help
Envío - Uso del comando Detener de Implementación
msstore submission rollout halt <productId>
Envío - Argumentos del comando Detener de Implementación
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Envío - Opciones del comando Detener de Implementación
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío - Ayuda del comando Detener de Implementación
msstore submission rollout halt --help
Envío - Uso del comando Finalizar de Implementación
msstore submission rollout finalize <productId>
Envío - Argumentos del comando Finalizar de Implementación
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Envío - Opciones del comando Finalizar de Implementación
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Envío - Ayuda del comando Finalizar de Implementación
msstore submission rollout finalize --help
Ejemplo: publicar una actualización e implementarla gradualmente
En el siguiente ejemplo de PowerShell se sube un paquete, se actualizan las notas de la versión, se inicia la implementación al 5 % y, a continuación, se aumenta y se completa.
$productId = '<productId>'
# 1. Upload the package but leave the submission in draft.
# 'publish' recreates the draft, so it has to run before any metadata edits.
msstore publish 'C:\path\to\app' --noCommit
# 2. Update the metadata and enable the rollout in a single call.
$submission = msstore submission get $productId | ConvertFrom-Json
$submission.Listings.'en-us'.BaseListing.ReleaseNotes = 'Bug fixes and improvements'
$submission.PackageDeliveryOptions.PackageRollout.IsPackageRollout = $true
$submission.PackageDeliveryOptions.PackageRollout.PackageRolloutPercentage = 5
msstore submission update $productId ($submission | ConvertTo-Json -Depth 100 -Compress)
# 3. Commit the submission and wait for it to publish.
msstore submission publish $productId
msstore submission poll $productId
# 4. Increase the rollout over time, without uploading the package again.
msstore submission rollout update $productId 20
# 5. Roll out to all customers (or use 'halt' to stop the rollout).
msstore submission rollout finalize $productId
Importante
Si la aplicación ya tiene un envío publicado, msstore publish elimina el borrador pendiente y crea uno nuevo a partir del último envío publicado, descartando los cambios de metadatos ya almacenados provisionalmente en ese borrador. Ejecute publishantes de actualizar los metadatos, no después.
Comandos de vuelos
| Subcomando |
Descripción |
|
lista |
Recupera todos los vuelos de la aplicación especificada. |
|
Obtener |
Recupera un vuelo para la aplicación y el vuelo especificados. |
|
eliminación |
Elimina un vuelo para la aplicación y el vuelo especificados. |
|
create |
Crea un vuelo para la aplicación y el vuelo especificados. |
|
Sumisión |
Ejecuta tareas relacionadas con los envíos de vuelos. |
Vuelos: uso de comandos de lista
msstore flights list <productId>
Vuelos - Argumentos del comando Enumerar
| Argumento |
Descripción |
productId |
Identificador del producto. |
Vuelos - Ayuda del comando Enumerar
msstore flights list --help
Vuelos: uso del comando Obtener
msstore flights get <productId> <flightId>
Vuelos: obtener argumentos de comando
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Obtener ayuda sobre comandos
msstore flights get --help
Vuelos: eliminación del uso de comandos
msstore flights delete <productId> <flightId>
Vuelos: eliminar argumentos de comando
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos: ayuda del comando Eliminar
msstore flights delete --help
Vuelos: uso del comando Crear
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Vuelos: crear argumentos de comando
| Argumento |
Descripción |
productId |
Identificador del producto. |
friendlyName |
Nombre amigable del vuelo. |
Vuelos: crear opciones de comando
| Opción |
Descripción |
| -g, --id de grupos |
Los ID de grupo que se deben asociar al vuelo. |
| -r, --rank-higher-than |
El ID de vuelo al que debe superar en clasificación. |
Vuelos: Ayuda para crear comandos
msstore flights create --help
Vuelos: comando Submission
| Subcomando |
Descripción |
|
Obtener |
Recupera la presentación del paquete de vuelo existente, ya sea el borrador actual o el último publicado. |
|
eliminación |
Elimina del almacén el envío de paquetes pendiente del vuelo. |
|
actualizar |
Actualiza el borrador de vuelo existente con el JSON proporcionado. |
|
publish |
Inicia el proceso de envío del vuelo para el borrador existente. |
|
encuesta |
Realiza consultas hasta que el envío de vuelo existente se PUBLIQUE o GENERE UN ERROR. |
|
estado |
Recupera el estado actual del envío de vuelo de la tienda. |
|
lanzamiento |
Ejecuta operaciones relacionadas con el lanzamiento de vuelos. |
Vuelos - Uso del comando Obtener Envío
msstore flights submission get <productId> <flightId>
Vuelos - Argumentos del comando Obtener Envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Ayuda del comando Obtener Envío
msstore flights submission get --help
Vuelos - Uso del comando Eliminar Envío
msstore flights submission delete <productId> <flightId>
Vuelos - Argumentos del comando Eliminar Envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos: Ayuda del comando Eliminar Envío
msstore flights submission delete --help
Vuelos: Uso del comando Actualizar Envío
msstore flights submission update <productId> <flightId> <product>
Vuelos: Argumentos del comando Actualizar Envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
product |
Representación actualizada del producto JSON. |
Vuelos: Opciones del comando Actualizar Envío
| Opción |
Descripción |
| -s, --skipInitialPolling |
Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False] |
Vuelos: Ayuda del comando Actualizar Envío
msstore flights submission update --help
Vuelos: Uso del comando Publicar Envío
msstore flights submission publish <productId> <flightId>
Vuelos: Argumentos del comando Publicar Envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos: Ayuda del comando Publicar Envío
msstore flights submission publish --help
Vuelos: Uso del comando Sondear Envío
msstore flights submission poll <productId> <flightId>
Vuelos - Argumentos del comando Sondear de un Envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Ayuda del comando Sondear de un Envío
msstore flights submission poll --help
Vuelos - Uso del comando Estado de un Envío
msstore flights submission status <productId> <flightId>
Vuelos - Argumentos del comando Estado de un Envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Ayuda del comando Estado de un Envío
msstore flights submission status --help
Vuelos - Envío - Comando de Despliegue
| Subcomando |
Descripción |
|
Obtener |
Recupera el estado de la implementación de un vuelo de un envío. |
|
actualizar |
Actualiza el porcentaje de implementación de un vuelo de un envío. |
|
detener |
Detiene la implementación de un vuelo de un envío. |
|
finalizar |
Finaliza el lanzamiento piloto de un envío. |
Vuelos - Envío - Uso del comando Obtener de Implementación
msstore flights submission rollout get <productId> <flightId>
Vuelos - Envío - Argumentos del comando Obtener de Implementación
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Envío - Opciones del comando Obtener de Implementación
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
Vuelos - Envío - Ayuda del comando Obtener de Implementación
msstore flights submission rollout get --help
Vuelos - Envío - Uso del comando Actualizar de Implementación
msstore flights submission rollout update <productId> <flightId> <percentage>
Vuelos - Envío - Argumentos del comando Actualizar de Implementación
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
percentage |
El porcentaje de usuarios que recibirán la implementación de la presentación. |
Vuelos - Envío - Opciones del comando Actualizar de Implementación
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
Vuelos - Envío - Ayuda del comando Actualizar de Implementación
msstore flights submission rollout update --help
Vuelos - Envío - Uso del comando Detener de Implementación
msstore flights submission rollout halt <productId> <flightId>
Vuelos - Envío - Argumentos del comando Detener de Implementación
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Envío - Opciones del comando Detener de Implementación
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
Vuelos - Envío - Ayuda del comando Detener de Implementación
msstore flights submission rollout halt --help
Vuelos - Envío - Uso del comando Finalizar de Implementación
msstore flights submission rollout finalize <productId> <flightId>
Vuelos - Envío - Argumentos del comando Finalizar de Implementación
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Envío - Opciones del comando Finalizar de Implementación
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
Vuelos - Envío - Ayuda del comando Finalizar de Implementación
msstore flights submission rollout finalize --help
Comando de inicialización
El comando init le ayuda a configurar la aplicación para publicar en el Microsoft Store. Actualmente admite los siguientes tipos de aplicación:
- WinUI
- .NET MAUI
- Flutter
- Electrón
- React Native para escritorio
- PWA
- Plataforma Universal de Windows (UWP)
Ejemplos de uso
SDK de Aplicaciones para Windows/WinUI
msstore init "C:\path\to\winui3_app"
Plataforma Universal de Windows (UWP)
msstore init "C:\path\to\uwp_app"
.NET MAUI
msstore init "C:\path\to\maui_app"
Flutter
msstore init "C:\path\to\flutter_app"
Electrón
msstore init "C:\path\to\electron_app"
React Native para escritorio
msstore init "C:\path\to\react_native_app"
Nota:
Para Electron, así como para proyectos de escritorio con React Native, se admiten tanto Npm como Yarn. La presencia del archivo de bloqueo (Yarn) se usará para determinar qué administrador de paquetes utilizar, así que asegúrese de ingresar el archivo de bloqueo yarn.lock en el sistema de control de código fuente.
PWA
msstore init https://contoso.com --output .
Argumentos
| Argumento |
Descripción |
pathOrUrl |
Ruta de acceso del directorio raíz donde está el archivo del proyecto o una URL pública que apunta a una PWA. |
Options
| Opción |
Descripción |
| -n, --publisherDisplayName |
El nombre de visualización del editor utilizado para configurar la aplicación. Si se proporciona, evita una llamada adicional a las API. |
| --paquete |
Si es compatible con el tipo de aplicación, empaqueta automáticamente el proyecto. |
| --publish |
Si es compatible con el tipo de aplicación, publica automáticamente el proyecto. Implica "--package true" |
| -f, --ID de vuelo |
Especifica el id. de vuelo donde se publicará el paquete. |
| -prp, --packageRolloutPercentage |
Especifica el porcentaje de lanzamiento del paquete. El valor debe estar entre 0 y 100. |
| -a, --arch |
Las arquitecturas para las que se va a compilar. Si no se proporciona, se usará la arquitectura predeterminada para el sistema operativo actual y el tipo de proyecto. Valores permitidos: "x86", "x64", "arm64". Solo se utiliza junto con --package true. |
| -o, --output |
Directorio de salida donde se almacenará la aplicación empaquetada. Si no se proporciona, se usará el directorio predeterminado para cada tipo de aplicación diferente. |
| -ver, --version |
Versión que se usa al compilar la aplicación. Si no se proporciona, se usará la versión del archivo del proyecto. |
Comando de paquetes
Le ayuda a empaquetar la aplicación de Microsoft Store como MSIX.
Ejemplos de uso
SDK de Aplicaciones para Windows/WinUI
msstore package "C:\path\to\winui3_app"
WinUI
msstore package "C:\path\to\uwp_app"
.NET MAUI
msstore package "C:\path\to\maui_app"
Flutter
msstore package "C:\path\to\flutter_app"
Electrón
msstore package "C:\path\to\electron_app"
React Native para escritorio
msstore package "C:\path\to\react_native_app"
PWA
msstore package "C:\path\to\pwa_app"
Argumentos
| Opción |
Descripción |
pathOrUrl |
Ruta de acceso del directorio raíz donde está el archivo del proyecto o una URL pública que apunta a una PWA. |
Options
| Opción |
Descripción |
| -o, --output |
Directorio de salida donde se almacenará la aplicación empaquetada. Si no se proporciona, se usará el directorio predeterminado para cada tipo de aplicación diferente. |
| -a, --arch |
Las arquitecturas para las que se va a compilar. Si no se proporciona, se usará la arquitectura predeterminada para el sistema operativo actual y el tipo de proyecto. Valores permitidos: "x86", "x64", "arm64". |
| -ver, --version |
Versión que se usa al compilar la aplicación. Si no se proporciona, se usará la versión del archivo del proyecto. |
Comando de publicación
Publica la aplicación en el Microsoft Store.
Ejemplos de uso
SDK de Aplicaciones para Windows/WinUI
msstore publish "C:\path\to\winui3_app"
WinUI
msstore publish "C:\path\to\uwp_app"
.NET MAUI
msstore publish "C:\path\to\maui_app"
Flutter
msstore publish "C:\path\to\flutter_app"
Electrón
msstore publish "C:\path\to\electron_app"
React Native para escritorio
msstore publish "C:\path\to\react_native_app"
PWA
msstore publish "C:\path\to\pwa_app"
Argumentos
| Opción |
Descripción |
pathOrUrl |
Ruta de acceso del directorio raíz donde está el archivo del proyecto o una URL pública que apunta a una PWA. |
Options
| Opción |
Descripción |
| -i, --inputFile |
Ruta de acceso al archivo '.msix' o '.msixupload' que se usará para el comando de publicación. Si no se proporciona, la CLI intentará encontrar el mejor candidato en función del argumento "pathOrUrl". |
| -id, --appId |
Especifica el identificador de la aplicación. Solo es necesario si el proyecto no se ha inicializado antes con el comando "init". |
| -nc, --noCommit |
Desactiva la confirmación del envío, manteniéndolo en estado de borrador. |
| -f, --ID de vuelo |
Especifica el id. de vuelo donde se publicará el paquete. |
| -prp, --packageRolloutPercentage |
Especifica el porcentaje de lanzamiento del paquete. El valor debe estar entre 0 y 100. |
Comando de vuelo
| Subcomando |
Descripción |
|
lista |
Recupera todos los vuelos de la aplicación especificada. |
|
Obtener |
Recupera un vuelo para la aplicación y el vuelo especificados. |
|
eliminación |
Elimina un vuelo para la aplicación y el vuelo especificados. |
|
create |
Crea un vuelo para la aplicación y el vuelo especificados. |
|
Sumisión |
Ejecuta tareas relacionadas con los envíos de vuelos. |
Vuelos - Lista - Uso
msstore flights list <productId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Obtener - Uso
msstore flights get <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Eliminar - Uso
msstore flights delete <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Flights - Crear - Uso
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
friendlyName |
Nombre amigable del vuelo. |
Options
| Opción |
Descripción |
| -g, --id de grupos |
Los ID de grupo que se deben asociar al vuelo. |
| -r, --rank-higher-than |
El ID de vuelo al que debe superar en clasificación. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Presentación
| Subcomando |
Descripción |
|
Obtener |
Recupera la presentación del paquete de vuelo existente, ya sea el borrador actual o el último publicado. |
|
eliminación |
Elimina del almacén el envío de paquetes pendiente del vuelo. |
|
actualizar |
Actualiza el borrador de vuelo existente con el JSON proporcionado. |
|
publish |
Inicia el proceso de envío del vuelo para el borrador existente. |
|
encuesta |
Realiza consultas hasta que el envío de vuelo existente se PUBLIQUE o GENERE UN ERROR. |
|
estado |
Recupera el estado actual del envío de vuelo de la tienda. |
|
lanzamiento |
Ejecuta operaciones relacionadas con el lanzamiento de vuelos. |
Vuelos - Envío de datos - Consulta - Uso
msstore flights submission get <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Eliminar - Uso
msstore flights submission delete <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| --no-confirmar |
No solicitar confirmación. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Actualización - Uso
msstore flights submission update <productId> <flightId> <product>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
product |
Representación actualizada del producto JSON. |
Options
| Opción |
Descripción |
| -s, --skipInitialPolling |
Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False] |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Publicación - Uso
msstore flights publish <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Sondeo - Uso
msstore flights poll <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Estado - Uso
msstore flights status <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Presentación - Lanzamiento
| Subcomando |
Descripción |
|
Obtener |
Recupera el estado de la implementación de un vuelo de un envío. |
|
actualizar |
Actualiza el porcentaje de implementación de un vuelo de un envío. |
|
detener |
Detiene la implementación de un vuelo de un envío. |
|
finalizar |
Finaliza el lanzamiento piloto de un envío. |
Flights - Envío - Implementación - Obtener - Uso
msstore flights submission rollout get <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Flights - Envío - Implementación - Actualizar - Uso
msstore flights submission rollout update <productId> <flightId> <percentage>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
percentage |
El porcentaje de usuarios que recibirán la implementación de la presentación. |
Options
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Presentación - Despliegue - Paralización - Uso
msstore flights submission rollout halt <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Lanzamiento - Finalizar - Utilización
msstore flights submission rollout finalize <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --verbose |
Imprima la salida detallada. |
| -?, -h, --help |
Mostrar información de ayuda y uso. |
Entornos de CI/CD
La CLI de Microsoft Store Developer (versión preliminar) admite la ejecución en entornos de CI/CD. Esto significa que puede usar la CLI para desarrolladores de Microsoft Store (versión preliminar) en las canalizaciones de CI/CD para, por ejemplo, publicar automáticamente las aplicaciones en el Microsoft Store.
El primer paso para lograrlo es instalar la CLI para desarrolladores de Microsoft Store (versión preliminar) en el entorno de CI/CD. Puede encontrar instrucciones sobre cómo hacer esto aquí.
Después de instalar la CLI de Microsoft Store Developer (versión preliminar), debe configurar el entorno para poder ejecutar comandos. Para ello, ejecute el msstore reconfigure comando con los parámetros específicos que identifican la cuenta del Centro de partners (TenantId, SellerId, ClientId). También debe proporcionar un ClientSecret o un certificado.
Es muy importante ocultar estas credenciales, ya que serán visibles en los registros de tu canalización de CI/CD. Puede hacerlo mediante secretos. Cada sistema de canalización de CI/CD tiene nombres diferentes para estos secretos. Por ejemplo, Azure DevOps llamarlas Secret Variables, pero GitHub Action las llama Encrypted Secrets. Cree un secreto para cada uno de los parámetros (TenantId, SellerId, ClientId y ClientSecret o Certificate) y, a continuación, use el comando para configurar el reconfigure entorno.
Por ejemplo:
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
Acciones de GitHub
- 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 }}
Una vez ejecutado este comando, la CLI de Microsoft Store developer (versión preliminar) se configurará para usar las credenciales proporcionadas. Ahora puedes utilizar la CLI para desarrolladores de Microsoft Store (versión preliminar) en tu canalización de CI/CD.
