Herramientas de componentes de Power Apps
Al crear un componente de código de Power Apps, usa una combinación de herramientas para optimizar los pasos necesarios de principio a fin.
| Paso | Descripción | Herramientas |
|---|---|---|
| Crear | Cree e inicialice el proyecto de componente utilizando una plantilla. | Interfaz de la línea de comandos (CLI) de Power Platform |
| Implementar | Describa e implemente el comportamiento y el estilo de los componentes. | Editor de código o entorno de desarrollo integrado (IDE) de su elección |
| Compilar | Valide y transpile el código TypeScript, y personalice el manifiesto del componente. | Power Platform CLI o Visual Studio Code |
| Depurar | Valide y solucione problemas de comportamiento de componentes sin implementarlo en un entorno de Dataverse. | Power Platform CLI |
| Paquete | Cree un archivo de solución de Dataverse y empaquete el componente como parte de esa solución. | Power Platform CLI y Visual Studio msbuild |
Echemos un vistazo a algunas de las herramientas que usamos.
Power Platform CLI
Power Platform CLI (interfaz de la línea de comandos) es una herramienta de línea de comandos enfocada a desarrolladores que proporciona comandos para crear código personalizado. Actualmente, esto incluye componentes de código y complementos. La herramienta también tiene comandos de administrador de entorno disponibles para la administración de entornos. También puede utilizar los comandos solution y package para implementar la administración del ciclo de vida de las aplicaciones con soluciones.
La CLI solo utiliza unos pocos pasos para instalar. Puede asegurarse de disponer de la última versión utilizando el siguiente comando de actualización:
pac install latest
Cuando comience a crear su componente de código, use la CLI para estructurar sus archivos iniciales usando una plantilla. El siguiente comando es un ejemplo de a inicialización de un componente usando la plantilla de campos:
pac pcf init --namespace Contoso --name Slider --template field
Uno de los requisitos previos para instalar la CLI es instalar el administrador de paquetes de nodos (npm). Utilice el npm para administrar dependencias y crear su componente de código. Al utilizar el comando init, este crea un archivo package.json configurado con las dependencias para su componente de código y diversos comandos, como build, que usará durante el desarrollo de su componente. El primer comando npm que ejecuta después de inicializar el componente es install. Este comando descarga todas las bibliotecas necesarias para respaldara Power Apps Component Framework.
npm install
También puede solicitar que cuando se ejecute la inicialización, también ejecute la instalación de npm al agregar --run-npm-install a las opciones del comando init.
pac pcf init --namespace Contoso --name Slider --template field --run-npm-install
A medida que desarrolle su componente de código, puede verificar si hay problemas de código utilizando el siguiente comando de compilación:
npm run build
Este comando valida su manifiesto, ejecuta el transpilador de TypeScript y le informa de cualquier problema.
También hay disponible un conjunto de prueba para probar su componente de código localmente, sin tener que implementarlo en un entorno. Puede iniciar el conjunto de prueba con su componente de código, utilizando el siguiente comando de inicio:
npm start
También puede habilitar el modo de observación usando el comando npm start watch. Si realiza cambios en su código en el modo de observación, el conjunto de prueba los detecta automáticamente sin necesidad de reiniciar.
Para acelerar la prueba de componentes de código, la CLI puede autenticarse en su entorno de desarrollo e insertar su componente de código para probarlo en aplicaciones reales. El siguiente comando compilará e insertará la última versión de su componente de código en su entorno de desarrollo de Dataverse actualmente configurado.
pac pcf push --publisher-prefix dev
Herramientas para Visual Studio Code
La extensión de Power Platform para Visual Studio Code incluye la compatibilidad de la interfaz de la línea de comandos (CLI) DE Power Platform para que funcione en el contexto del entorno del editor. Puede instalar la extensión desde Visual Studio Marketplace. Una vez instalada, puede usar el comando CLI pac desde la ventana del terminal.
Herramientas para Visual Studio
Puede instalar estas herramientas mediante la instalación independiente o como parte de la instalación de Visual Studio. Puedes encontrarlas en Descargar Visual Studio 2022 para Windows y Mac.
El comando msbuild se usa al empaquetar su componente como parte de una solución de Power Apps para la implementación en un entorno de Dataverse. Por ejemplo, los siguientes comandos inicializan una nueva solución para su componente y crean un archivo de proyecto msbuild que gestiona la creación de archivos de solución de salida durante una compilación.
pac solution init --publisher-name Contoso --publisher-prefix contoso ‑‑outputDirectory vssolution
Para que su componente de código esté empaquetado en la solución, debe agregar una referencia a su componente. Esto garantiza que, cuando se ejecute una compilación, su componente se incluya en la solución de salida que se genere. El siguiente comando agrega la referencia:
pac solution add-reference --path \<path to your Power Apps component framework project\>
Puede usar el comando msbuild para generar los archivos de solución con las referencias de solución configuradas. El siguiente comando ejecuta la compilación la primera vez:
msbuild /t:build /restore
Sugerencia
Si recibe un error que indica que no se reconoce el comando msbuild, intente ejecutar el comando desde el símbolo del sistema para desarrolladores para Visual Studio. Este acceso directo se crea como parte de una instalación de Visual Studio o de herramientas para Visual Studio.
Después de la primera compilación, bastará con ejecutar el comando msbuild para regenerar los archivos de la solución. Los archivos de solución generados se encuentran en la carpeta \bin\debug\ (o \bin\release), una vez que la compilación se haya completado correctamente. Una vez que el archivo ZIP de salida esté listo, puede Importar la solución en Dataverse manualmente o implementarla automáticamente con las Microsoft Power Platform Build Tools.
Elegir un IDE
Recomendamos utilizar Visual Studio Code o Visual Studio para escribir sus componentes. Pero puede utilizar cualquier IDE que elija para crear componentes de código de Power Apps personalizados.