Compilar y lanzar una aplicación de escritorio para Windows

Un enfoque conveniente para distribuir aplicaciones de Windows es la Microsoft Store. Esta guía proporciona un recorrido paso a paso para empaquetar y desplegar una aplicación Flutter de esta manera.

Antes de comenzar el proceso de lanzamiento de una aplicación de escritorio de Flutter para Windows en la Microsoft Store, primero confirma que cumple con las Políticas de la Microsoft Store.

También debes unirte a la Microsoft Partner Network para poder enviar aplicaciones.

Gestiona el ciclo de vida de una aplicación en el Microsoft Partner Center.

Primero, reserva el nombre de la aplicación y asegúrate de que existan los derechos requeridos sobre el nombre. Una vez que se reserva el nombre, la aplicación se aprovisionará para servicios (como notificaciones push) y puedes comenzar a agregar complementos.

Las opciones como el precio, la disponibilidad, las clasificaciones de edad y la categoría deben configurarse junto con el primer envío y se conservan automáticamente para los envíos posteriores.

Para poder publicar una aplicación en la Microsoft Store, primero debes empaquetarla. Los formatos válidos son .msix, .msixbundle, .msixupload, .appx, .appxbundle, .appxupload y .xap.

Consulta Empaquetado MSIX para aprender sobre el empaquetado de aplicaciones de escritorio de Flutter para Windows.

Ten en cuenta que cada producto tiene una identidad única, que la Store asigna.

Si el paquete se está compilando manualmente, debes incluir sus detalles de identidad manualmente durante el empaquetado. La información esencial se puede recuperar del Partner Center utilizando las siguientes instrucciones:

1. En el Partner Center, navega a la aplicación.
2. Selecciona Product management.
3. Recupera el nombre de identidad del paquete, el editor y el nombre para mostrar del editor haciendo clic en Product identity.

Después de empaquetar manualmente la aplicación, envíala manualmente al Microsoft Partner Center. Puedes hacer esto creando un nuevo envío, navegando a Packages y subiendo el paquete de la aplicación creado.

Además de crear y desplegar el paquete manualmente, puedes automatizar el proceso de compilación, empaquetado, control de versiones y despliegue utilizando herramientas de CI/CD después de haber enviado la aplicación a la Microsoft Store por primera vez.

Codemagic CI/CD utiliza el paquete pub msix para empaquetar aplicaciones de escritorio de Flutter para Windows.

Para aplicaciones Flutter, utiliza el Codemagic Workflow Editor o codemagic.yaml para empaquetar la aplicación y desplegarla en el Microsoft Partner Center. Las opciones adicionales (como la lista de capacidades y recursos de idioma contenidos en el paquete) se pueden configurar utilizando este paquete.

Para la publicación, Codemagic utiliza la API de envío del Partner Center; por lo tanto, Codemagic requiere asociar las cuentas de Azure Active Directory y del Partner Center.

GitHub Actions puede utilizar la Microsoft Dev Store CLI para empaquetar aplicaciones en un MSIX y publicarlas en la Microsoft Store. La GitHub Action setup-msstore-cli instala la CLI para que la Action pueda usarla para el empaquetado y la publicación.

Dado que el empaquetado del MSIX utiliza el paquete pub msix, el pubspec.yaml del proyecto debe contener un nodo msix_config adecuado.

Debes crear un directorio de Azure AD desde el Dev Center con permiso de administrador global.

La GitHub Action requiere secretos de entorno del Partner Center. AZURE_AD_TENANT_ID, AZURE_AD_ClIENT_ID y AZURE_AD_CLIENT_SECRET son visibles en el Dev Center siguiendo las instrucciones para la Windows Store Publish Action. También necesitas el secreto SELLER_ID, que se puede encontrar en el Dev Center bajo Account Settings > Organization Profile > Legal Info.

La aplicación ya debe estar presente en el Microsoft Dev Center con al menos un envío completo, y se debe ejecutar msstore init una vez dentro del repositorio antes de que se pueda realizar la Action. Una vez completado, ejecutar msstore package . y msstore publish en una GitHub Action empaqueta la aplicación en un MSIX y la sube a un nuevo envío en el Dev Center.

Los pasos necesarios para la publicación de MSIX se asemejan a los siguientes

- uses: microsoft/setup-msstore-cli@v1
​
- name: Configure the Microsoft Store CLI
  run: msstore reconfigure --tenantId $ --clientId $ --clientSecret $ --sellerId $
​
- name: Install Dart dependencies
  run: flutter pub get
​
- name: Create MSIX package
  run: msstore package .
​
- name: Publish MSIX to the Microsoft Store
  run: msstore publish -v

Para las aplicaciones publicadas en la Microsoft Store, el número de versión debe establecerse durante el proceso de empaquetado.

El número de versión predeterminado de la aplicación es 1.0.0.0.

Para las aplicaciones no publicadas en la Microsoft Store, puedes establecer las versiones del archivo ejecutable y del producto de la aplicación. La versión de archivo predeterminada del ejecutable es 1.0.0.1, y su versión de producto predeterminada es 1.0.0+1. Para actualizarlas, navega al archivo pubspec.yaml y actualiza la siguiente línea:

version: 1.0.0+1

El nombre de compilación consiste en tres números separados por puntos, seguidos de un número de compilación opcional que se separa por un +. En el ejemplo anterior, el nombre de compilación es 1.0.0 y el número de compilación es 1.

El nombre de compilación se convierte en los primeros tres números de las versiones del archivo y del producto, mientras que el número de compilación se convierte en el cuarto número de las versiones del archivo y del producto.

Tanto el nombre como el número de compilación se pueden sobrescribir en flutter build windows especificando --build-name y --build-number, respectivamente.

Para actualizar el icono de una aplicación de escritorio de Flutter para Windows antes del empaquetado, utiliza las siguientes instrucciones:

1. En el proyecto Flutter, navega a windows\runner\resources.
2. Reemplaza el app_icon.ico por el icono deseado.
3. Si el nombre del icono es distinto de app_icon.ico, procede a cambiar el valor de IDI_APP_ICON en el archivo windows\runner\Runner.rc para que apunte a la nueva ruta.

Al empaquetar con el paquete pub msix, la ruta del logotipo también se puede configurar dentro del archivo pubspec.yaml.

Para actualizar la imagen de la aplicación en el listado de la Store, navega al paso del listado de la Store del envío y selecciona Store logos. Desde allí, puedes subir el logotipo con un tamaño de 300 x 300 píxeles.

Todas las imágenes subidas se conservan para envíos posteriores.

Antes de la publicación en la Microsoft Store, primero valida el paquete de la aplicación localmente.

Windows App Certification Kit es una herramienta incluida en el Windows Software Development Kit (SDK).

Para validar la aplicación:

1. Inicia Windows App Cert Kit.
2. Selecciona el paquete de escritorio de Flutter para Windows (.msix, .msixbundle, etc.).
3. Elige un destino para el informe de prueba.

El informe puede contener advertencias e información importantes, incluso si la certificación se aprueba.