Crear un paquete de solución de componentes de código

  • 15 minutos

Debe implementar un componente de código a un entorno de Microsoft Dataverse antes de usarlo en Power Apps o Power Pages. La primera tarea que debe llevar a cabo para implementar un componente es empaquetar el componente de código en una solución, lo que le permitirá importarlo a un entorno. Este paso se puede realizar de dos formas. Puede usar el comando CLI Push para crear una solución temporal que le permitirá enviar el componente a un entorno y facilitar las pruebas. Este enfoque resulta idóneo para su uso durante el desarrollo del componente. La otra opción es crear una solución para el componente e importarla por separado en su entorno de Dataverse. Esta opción es adecuada para utilizarla en canalizaciones de compilación o implementaciones manuales en un entorno que no sea el de desarrollo. Exploremos ambas opciones con más detalle.

En los siguientes pasos, practicará ambas técnicas mediante el componente de código que creó en el último tema o uno de los componentes de muestra disponibles.

Requisitos previos

Debe haber creado ya un proyecto de componente de código existente. Puede seguir estos pasos para cualquier otro proyecto de componente de código, como los Componentes de ejemplo.

Enviar un componente a un entorno de Dataverse durante la fase de desarrollo

Para enviar un componente de código mediante Power Platform CLI, siga estos pasos:

  1. Inicie Visual Studio Code y seleccione Explorador.

  2. Seleccione Abrir carpeta.

    Captura de pantalla del botón de abrir carpeta de Visual Studio Code

  3. Seleccione la carpeta de proyecto editable-pcf que había creado en el laboratorio anterior y elija Seleccionar carpeta.

  4. Seleccione la pestaña Power Platform y, a continuación, Agregar perfil de autenticación.

    Captura de pantalla de VSCode y del botón

  5. Busque una ventana emergente Iniciar sesión en su cuenta y seleccione la cuenta que desee usar. Introduzca el nombre de usuario apropiado, seleccione SIGUIENTE e introduzca la contraseña. Es posible que deba proporcionar MFA si se ha configurado en su inquilino.

    Captura de pantalla del inicio de sesión estándar de inquilinos de Microsoft

  6. El perfil que ha agregado se verá en Perfiles de autenticación, junto con los Entornos y soluciones asociados. Asegúrese de seleccionar el entorno adecuado en Entorno y soluciones. Habrá una estrella que podrá seleccionar. Asegúrese de que el entorno seleccionado también tenga habilitado el Component Framework en la sección Características del entorno del Centro de administración de Power Platform para el entorno seleccionado.

    Captura de pantalla de las secciones PERFILES DE AUTENTICACIÓN y ENTORNOS Y SOLUCIONES

  7. Seleccione Terminal y, luego, Nuevo terminal.

  8. Ejecute el comando siguiente para compilar el proyecto y asegúrese de que se compile correctamente.

    npm run build

    Captura de pantalla con los resultados de la ejecución del comando NOM RUN BUILD

  9. Envíe el control personalizado al entorno ejecutando el siguiente comando.

    pac pcf push --publisher-prefix msl

    Captura de pantalla de la compilación inicial e importación al entorno

    Observe en la imagen el cuadro rojo que indica las secciones Conectado como y Conectado a. Asegúrese de que coincidan con el PERFIL DE AUTENTICACIÓN y el ENTORNO seleccionados en los pasos anteriores.

  10. La solución debe importarse al entorno y publicarse.

    Captura de pantalla del terminal de Visual Studio Code

    Puede ignorar el mensaje de advertencia amarillo si lo recibe.

  11. Vaya a Power Apps Maker Portal y asegúrese de que se encuentra en el entorno correcto.

  12. Seleccione Soluciones.

  13. Debería ver una solución PowerAppsTools_msl. Seleccione la opción para abrir la solución.

    Captura de pantalla de una lista de soluciones ambientales con un rectángulo en torno a Power Apps Tools

  14. Debería aparecer el control personalizado que creó.

    Captura de pantalla de los componentes de una solución con un rectángulo rojo en torno a un control personalizado

Crear un archivo de solución con Power Platform CLI

Para crear un archivo de solución con Power Platform CLI, siga los siguientes pasos:

  1. Vuelva a Visual Studio Code y asegúrese de que el proyecto EDITABLE-PCF esté abierto.

  2. Vaya al terminal y a Símbolo del sistema.

  3. Ejecute el siguiente comando para crear una nueva carpeta.

    md Solution

  4. Cambie el directorio a la carpeta de la solución que ha creado. Ejecute el comando siguiente.

    cd Solution

  5. Inicialice el proyecto de solución de Dataverse con el siguiente comando:

    pac solution init --publisher-name mslearn --publisher-prefix msl

  6. Los componentes del proyecto de solución se agregarán durante la compilación. Para llevar a cabo esta tarea, utilice el siguiente comando:

    pac solution add-reference --path ..

  7. Para generar el archivo .zip de la solución, utilice Microsoft Build Engine o msbuild (forma abreviada). Solo necesitará usar el indicador /restore la primera vez que se compila el proyecto de solución. En cada compilación posterior, deberá ejecutar msbuild únicamente. La ruta a MSBuild.exe puede ser diferente en función de la versión de Visual Studio que haya instalado en su equipo.

    "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe\" /t:build /restore

  8. La compilación debería realizarse correctamente.

  9. Localice la carpeta de la Solución que ha creado y expándala.

  10. Expanda la carpeta bin\debug.

  11. El archivo solution.zip debería aparecer aquí.

    Captura de pantalla de la solución creada

Nota

Para ejecutar MSBuild, debe tener instalado Visual Studio o Visual Studio Build Tools. Puede instalar las herramientas de compilación desde Descargas de Visual Studio. Para obtener acceso a MSBuild, es posible que deba agregarlo al directorio de la ruta de acceso a las variables de entorno de Windows. Por ejemplo, Visual Studio 2022 almacena MSBuild en C:\Program Files (x86)\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin. También puede usar el símbolo del sistema para desarrolladores de Visual Studio para obtener acceso a MSBuild, o ejecutarlo con la ruta de acceso completa ("C:\Program Files (x86)\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin\MSBuild.exe"/t:build /restore).

El tipo de paquete de solución predeterminado es Administrado. Si desea exportar como No administrado (o Ambos), puede borrar el comentario (o quitar la marca de comentario) en la siguiente sección desde su Solutions.cdsproj y editar el nodo SolutionPackageType como corresponda:

   <!-- Solution Packager overrides un-comment to use: SolutionPackagerType Managed, Unmanaged, Both)-->
        <PropertyGroup>
        <SolutionPackageType>Unmanaged</SolutionPackageType>
        </PropertyGroup>

Puede establecer la configuración de msbuild en Release para emitir una compilación de producción, por ejemplo, msbuild /p:configuration=Release.

Puede importar manualmente el archivo zip que se encuentra en bin\Debug o bin\Release, según la configuración de su versión. También puede implementar sus componentes de código mediante programación, utilizando Power Platform CLI. Para obtener más información, consulte las secciones Conexión al entorno e Implementar componentes de código de la documentación Empaquetar un componente de código.