Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Instalación
Paso 1: instalar el runtime para Windows de .NET
Si todavía no lo ha hecho, instale la última versión del runtime para escritorio de .NET 8. Este es un requisito para ejecutar Microsoft Store Developer CLI.
La manera más fácil de instalarla es mediante winget:
winget install Microsoft.DotNet.DesktopRuntime.8
Paso 2: Instalar la CLI para desarrolladores de Microsoft Store en Windows
Puede descargar Microsoft Store Developer CLI desde Microsoft Store. Como alternativa, puede usar winget:
winget install "Microsoft Store Developer CLI"
Paso 1: instalar el runtime para macOS de .NET
Si todavía no lo ha hecho, instale la última versión del runtime de .NET 8. Este es un requisito para ejecutar Microsoft Store Developer CLI.
Paso 2: Instalar 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 RUTA, independientemente de cómo quiera hacerlo, 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: instalar el runtime para Linux de .NET
Si todavía no lo ha hecho, instale la última versión del runtime de .NET 8. Este es un requisito para ejecutar Microsoft Store Developer CLI.
Paso 2: Instalar 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 RUTA, independientemente de cómo quiera hacerlo, 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.
Comando Info: uso
msstore info
Comando Info: opciones
| Opción | Descripción |
|---|---|
| -v, --detallado | Imprima la salida detallada. |
Volver a configurar el comando
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).
Reconfiguración: uso
msstore reconfigure
Reconfiguración: opciones
| Opción | Descripción |
|---|---|
| -t, --tenantId | Especifique el identificador de inquilino que se debe usar. |
| -s, --sellerId | Especifique el identificador de vendedor que se debe usar. |
| -c, --clientId | Especifique el identificador de cliente que se debe usar. |
| -cs, --clientSecret | Especifique el secreto de cliente que se debe usar. |
| -ct, --certificadoHuella digital | 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 | Especifique la contraseña del certificado que se debe usar. |
| --restablecimiento | Restablezca solo las credenciales, sin empezar de nuevo. |
Settings (Comando)
Cambie la configuración de la CLI para desarrolladores de Microsoft Store.
Configuración: uso
msstore settings
| Sub-Comando | Descripción |
|---|---|
| setpdn | Establezca la propiedad Nombre para mostrar del publicador que usa el comando init. |
Configuración: opciones
| Opción | Descripción |
|---|---|
| -t, --habilitarTelemetry | Habilite (vacío/true) o deshabilite (false) telemetría. |
| -v, --detallado | Imprima la salida detallada. |
Configuración: uso del comando SetPDN
msstore settings setpdn <publisherDisplayName>
Argumentos
| Argumento | Descripción |
|---|---|
publisherDisplayName |
Propiedad Nombre para mostrar del publicador que se establecerá globalmente. |
Ayuda
msstore settings setpdn --help
Comando de aplicaciones
| Sub-Comando | Descripción |
|---|---|
| lista | Enumera todas las aplicaciones de la cuenta. |
| Obtener | Obtiene los detalles de una aplicación específica. |
Aplicaciones: enumeración del uso de comandos
msstore apps list
Comando List: Ayuda
msstore apps list --help
Aplicaciones: obtención del uso de comandos
msstore apps get <productId>
Aplicaciones: obtener argumentos de comando
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
Aplicaciones: Ayuda para obtener comandos
msstore apps get --help
Comando de envío
| Sub-Comando | Descripción |
|---|---|
| estado | Obtiene el estado de un envío. |
| Obtener | Obtiene los detalles de un envío específico. |
| obtenerActivosDeListado | Obtiene los recursos de lista de un envío específico. |
| actualizarMetadatos | Actualiza los metadatos de un envío específico. |
| actualizar | Actualiza los detalles de un envío específico. |
| encuesta | Sondea el estado de un envío. |
| publicar | Publica un envío específico. |
| eliminación | Elimina un envío específico. |
Envío: uso de comandos de estado
msstore submission status <productId>
Envío: argumentos de comando de estado
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
Envío: ayuda del comando Estado
msstore submission status --help
Envío: obtener uso de comandos
msstore submission get <productId>
Envío: obtener argumentos de comando
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
Envío: obtener opciones de comando
| Opción | Descripción |
|---|---|
| -m, --módulo | Seleccione el módulo que desea recuperar ("availability", "listings" o "properties"). |
| -l, --idioma | Seleccione el idioma que desea recuperar. [valor predeterminado: en] |
Envío: Obtener ayuda del comando
msstore submission get --help
Envío: uso del comando GetListingAssets
Recupera los recursos de la lista de borradores existentes del envío de la tienda.
msstore submission getListingAssets <productId>
Envío: argumentos de comando GetListingAssets
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
Envío: Opciones de comando GetListingAssets
| Opción | Descripción |
|---|---|
| -l, --idioma | Seleccione el idioma que desea recuperar. [valor predeterminado: en] |
Envío: Ayuda del comando GetListingAssets
msstore submission getListingAssets --help
Envío: uso de comandos UpdateMetadata
msstore submission updateMetadata <productId> <metadata>
Envío: argumentos de comando UpdateMetadata
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
metadata |
Representación actualizada de metadatos JSON. |
Envío: opciones de comando UpdateMetadata
| Opción | Descripción |
|---|---|
| -s, --skipInitialPolling (saltar el sondeo inicial) | Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False] |
Envío: Ayuda del comando UpdateMetadata
msstore submission updateMetadata --help
Envío: actualización del uso del comando
msstore submission update <productId> <product>
Envío: actualizar argumentos de comando
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
product |
Representación actualizada del producto JSON. |
Envío: opciones de comando de actualización
| Opción | Descripción |
|---|---|
| -s, --skipInitialPolling (saltar el sondeo inicial) | Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False] |
Envío: Ayuda del comando Update
msstore submission update --help
Envío: uso de comandos de sondeo
msstore submission poll <productId>
Envío: argumentos de comando de sondeo
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
Envío: Ayuda del comando Poll
msstore submission poll --help
Envío: uso de comandos de publicación
msstore submission publish <productId>
Envío: publicar argumentos de comando
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
Envío: Ayuda para publicar comandos
msstore submission publish --help
Envío: eliminación del uso de comandos
Elimina el envío pendiente de la tienda.
Envío: eliminar argumentos de comando
| Argumento | Descripción |
|---|---|
productId |
El ID de producto. |
Envío: Eliminar opciones de comando
| Opción | Descripción |
|---|---|
| --no-confirmar | No solicita confirmación. [valor predeterminado: False] |
Envío: Ayuda para eliminar comandos
msstore submission delete --help
Comando de inicialización
El init comando le ayuda a configurar la aplicación para publicarla en Microsoft Store. Actualmente admite los siguientes tipos de aplicación:
- SDK de Aplicaciones para Windows o WinUI 3
- Plataforma Universal de Windows (UWP)
- .NET MAUI
- Flamear
- Electrón
- React Native para escritorio
- PWA
Comando Init: ejemplos de uso
Comando Init: SDK de Aplicaciones para Windows/WinUI 3
msstore init "C:\path\to\winui3_app"
Comando Init: UWP
msstore init "C:\path\to\uwp_app"
Comando Init: .NET MAUI
msstore init "C:\path\to\maui_app"
Comando Init- Flutter
msstore init "C:\path\to\flutter_app"
Comando Init - Electron
msstore init "C:\path\to\electron_app"
Comando Init: React Native for Desktop
msstore init "C:\path\to\react_native_app"
Nota:
Para Electron, así como React Native para proyectos de escritorio, y NpmYarn se admiten. La presencia del archivo de bloqueo (Yarn) se usará para determinar qué administrador de paquetes usar, así que asegúrese de proteger el yarn.lock archivo de bloqueo en el sistema de control de código fuente.
Comando Init: PWA
msstore init https://contoso.com --output .
Comando Init: 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. |
Comando Init: opciones
| Opción | Descripción |
|---|---|
| -n, --editorDisplayName | Nombre para mostrar del publicador usado 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. |
| --publicar | Si es compatible con el tipo de aplicación, publica automáticamente el proyecto. Implica "--package true" |
| -f, --flightId | 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, --arco | 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 usó junto con "--package true". |
| -o, --salida | 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 (muestra la versión) | 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
Ayuda a empaquetar la aplicación de Microsoft Store como MSIX.
Comando Package: ejemplos de uso
Comando package: SDK de Aplicaciones para Windows/WinUI 3
msstore package "C:\path\to\winui3_app"
Comando Package: UWP
msstore package "C:\path\to\uwp_app"
Comando Package: .NET MAUI
msstore package "C:\path\to\maui_app"
Comando package- Flutter
msstore package "C:\path\to\flutter_app"
Comando Package - Electron
msstore package "C:\path\to\electron_app"
Comando package: React Native for Desktop
msstore package "C:\path\to\react_native_app"
Comando Package: PWA
msstore package "C:\path\to\pwa_app"
Comando Package: 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. |
Comando Package: opciones
| Opción | Descripción |
|---|---|
| -o, --salida | 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, --arco | 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 (muestra la versión) | 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 su aplicación en Microsoft Store.
Comando Publish: ejemplos de uso
Comando Publish: SDK de Aplicaciones para Windows/WinUI 3
msstore publish "C:\path\to\winui3_app"
Comando Publish: UWP
msstore publish "C:\path\to\uwp_app"
Comando Publish: .NET MAUI
msstore publish "C:\path\to\maui_app"
Comando Publish: Flutter
msstore publish "C:\path\to\flutter_app"
Comando Publish: Electron
msstore publish "C:\path\to\electron_app"
Comando Publish: React Native for Desktop
msstore publish "C:\path\to\react_native_app"
Comando Publish: PWA
msstore publish "C:\path\to\pwa_app"
Comando Publish: 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. |
Comando Publish: opciones
| Opción | Descripción |
|---|---|
| -i, --directorioDeEntrada | Directorio donde se usará el archivo '.msix' o '.msixupload' 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 | Deshabilita la confirmación del envío y la mantiene en estado de borrador. |
| -f, --flightId | 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. |
Entornos de CI/CD
La CLI para desarrolladores de Microsoft Store (versión preliminar) admite la ejecución en entornos de CI/CD. Esto significa que puedes 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 Microsoft Store.
El primer paso para lograrlo para 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 para desarrolladores de Microsoft Store (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 estarán visibles en los registros de la 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 los llama Variables secretas, pero La acción de GitHub los llama Secretos cifrados. 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/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 }}
Una vez ejecutado este comando, la CLI para desarrolladores de Microsoft Store (versión preliminar) se configurará para usar las credenciales proporcionadas. Ahora puede usar la CLI para desarrolladores de Microsoft Store (versión preliminar) en la canalización de CI/CD.
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
