Introducción

Completado

Cuando edite una aplicación de lienzo en Estudio de Microsoft Power Apps, se mostrará una representación visual de la aplicación.

Captura de pantalla de una aplicación de lienzo en Power Apps Studio

Puede arrastrar y soltar un control en la pantalla, usar la barra de fórmulas para editar expresiones y usar el panel Propiedades para editar los valores de las propiedades de control. La mayoría de los creadores utiliza estas herramientas para crear y modificar aplicaciones.

Puede guardar una copia de una aplicación de lienzo en su equipo como un solo archivo con una extensión .msapp. Si la aplicación de lienzo forma parte de una solución de Microsoft Dataverse, puede utilizar la CLI (interfaz de la línea de comandos) de Microsoft Power Platform para descargar la solución y extraer la aplicación. El archivo de la aplicación es autónomo y representa la aplicación completa, incluidas las pantallas, los controles, los componentes, las conexiones, las fórmulas, etc. Sin embargo, internamente, la aplicación contiene numerosos archivos independientes, cada uno de los cuales describe una parte de la aplicación. Puede ejecutar el comando unpack de la CLI de Power Platform para extraer estos archivos. Una vez que se hayan descomprimido los archivos, podrá editar la mayoría de ellos con cualquier editor de texto. En la siguiente captura de pantalla se muestra un ejemplo de la misma aplicación abierta en Microsoft Visual Studio Code después de haberla desempaquetado.

Captura de pantalla del editor de Visual Studio Code con una carpeta abierta que contiene archivos individuales para la aplicación de lienzo

Al desempaquetar la aplicación de lienzo en archivos de texto individuales, se habilitarán los siguientes escenarios, en los que puede:

  • Editar el código fuente directamente en un editor de texto en lugar de hacerlo en un diseñador visual. Por ejemplo, una búsqueda y reemplazo global es más eficiente en un editor de texto.

  • Almacenar los archivos de texto individuales en el control de código fuente, lo que le permitirá realizar un seguimiento muy preciso de los cambios de una aplicación. Por ejemplo, puede volver a evaluar cuándo se cambió una etiqueta en una aplicación de X a Y y quién introdujo el cambio.

  • Utilizar herramientas de desarrollo automatizadas que se basen en el código fuente, como análisis de código estático, generadores de código, plantillas, etc.

El origen de la aplicación se representa mediante un subconjunto de YAML, que es un lenguaje de serialización de datos fácil de usar para los usuarios. Más adelante, en este módulo, abordaremos cómo trabajar con YAML.

CLI de Power Platform

CLI de Power Platform (o CLI) es una herramienta de línea de comandos que se puede utilizar en muchas tareas administrativas y de desarrollo en Microsoft Power Platform, como desarrollar componentes de Power Apps component framework, gestionar entornos, trabajar con soluciones y portales y mucho más. Puede usar la CLI desde un símbolo del sistema sencillo, como parte de una compilación automatizada o desde un terminal en Visual Studio Code.

Este módulo se centra en la funcionalidad de aplicación de lienzo y solución de la CLI de Power Platform. Puede revisar las demás capacidades y cómo funcionan en la documentación del producto. Puede descargar e instalar la CLI de Power Platform. Si ya tiene instalada la CLI, asegúrese de haber descargado la versión más reciente; solo tiene que ejecutar el comando siguiente:

pac install latest

Comando canvas unpack

Cuando descargue una aplicación de lienzo de la nube, recuerde que es un solo archivo con la extensión .msapp. El comando canvas unpack usa ese archivo como entrada y lo desempaqueta en varios archivos que representan las diferentes partes de la aplicación. Por ejemplo, cada pantalla de la aplicación tendrá su propio archivo en la salida del comando.

Para desempaquetar el archivo .msapp de una aplicación de lienzo, ejecute el siguiente comando:

pac canvas unpack --msapp "Account Manager.msapp" --sources src

El conmutador identifica la carpeta de salida de destino con la siguiente estructura de carpetas.

Diagrama de la jerarquía de archivos individuales de la aplicación de lienzo

El comando canvas pack

El comando canvas pack es lo opuesto del comando canvas unpack, puesto que empaqueta la carpeta que contiene archivos individuales en un único archivo .msapp. Para empaquetar la aplicación para que esté lista para cargarse en la nube o para que esté incluida en una solución, ejecute el comando siguiente:

pac canvas pack --msapp "Account Manager.msapp" --sources src

Comandos de solución

Puede obtener el archivo .msapp de la aplicación de lienzo en el portal de creadores; para ello, tendrá que descargar la aplicación individual. Si usa soluciones para almacenar las aplicaciones y flujos, la solución exportada contendrá el archivo .msapp de cada aplicación de lienzo de la solución. Al usar la CLI y ejecutar el comando solution unpack, puede extraer los archivos .msapp individuales de la solución. En el siguiente ejemplo se muestra el comando solution unpack:

pac solution unpack --solution-zip C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

La carpeta SampleSolutionUnpacked contendrá una subcarpeta CanvasApps que incluye el archivo .msapp de cada aplicación incluida en la solución.

Al igual que el comando canvas pack, el comando solution pack vuelve a ensamblar los archivos en una solución que puede importar a un entorno de nube. En el siguiente ejemplo se muestra el comando solution pack:

pac solution pack --solution-zip C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

Power Platform y la extensión de código

La extensión de Microsoft Power Platform le permite usar la CLI de Power Platform desde Visual Studio Code. Cuando instale la extensión, se instalará la CLI de Power Platform más reciente para usarla en una ventana de terminal de Visual Studio Code.

Captura de pantalla de Visual Studio Code con una ventana de terminal abierta y el uso del comando pac que se muestra en esa ventana

Si usa la extensión, podrá empaquetar y desempaquetar las aplicaciones de lienzo sin salir de Visual Studio Code. Utilice los mismos comandos que se han comentado anteriormente con la CLI independiente.

Control de código fuente

Al desempaquetar una aplicación de lienzo se crean numerosos archivos; esto le permite enviar los archivos individuales al control de origen para cada cambio. Estos pasos pueden convertirse en parte de su estrategia general destinada a la gestión del ciclo de vida de la aplicación (ALM) con Microsoft Power Platform. Al enviar los archivos individuales al control de código fuente, obtiene un mejor seguimiento granular de los cambios que ha introducido. Específicamente, si confirma solo el archivo .msapp, la única diferencia entre las versiones a tener en cuenta es que "algo" ha cambiado. Al desempaquetar y confirmar los archivos individuales, puede obtener diferencias línea por línea y puede resaltar los cambios de cada confirmación. En combinación con el seguimiento del elemento de trabajo, también obtendrá la trazabilidad de los requisitos hasta el cambio que se introdujo para dar soporte al elemento de trabajo.

En el resto del módulo, se aborda cómo trabajar con el control de código fuente desde la aplicación de lienzo.