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:
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:
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, --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
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, --enableTelemetry
Habilite (vacío/true) o deshabilite (false) telemetría.
-v, --verbose
Imprima la salida detallada.
Configuración: uso del comando SetPDN
msstore settings setpdn <publisherDisplayName>
Argumentos
Argument
Descripción
publisherDisplayName
Propiedad Nombre para mostrar del publicador que se establecerá globalmente.
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
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-confirm
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
UWP
.NET MAUI
Flutter
Electron
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.lock) se usará para determinar qué administrador de paquetes usar, así que asegúrese de proteger el Yarn 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, --publisherDisplayName
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, --arch
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, --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
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, --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
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 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, --inputDirectory
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.
