Inicio rápido: Creación de la primera aplicación de código (versión preliminar)

Nota:

Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes de una versión oficial para que los clientes puedan obtener acceso anticipado y proporcionar comentarios.

En este inicio rápido, compile una aplicación de código, ejecútela localmente y, a continuación, publíquela. Estas instrucciones le guían para descargar una aplicación de código de ejemplo y usar la CLI de PAC para dirigirse a un entorno de Power Platform para publicar la aplicación. A continuación, publique la aplicación antes de ejecutar la aplicación hospedada en Power Platform.

Prerrequisitos

Nota:

Consulte los requisitos previos generales de la aplicación de código: Requisitos previos

Clonación del repositorio de PowerAppsCodeApps

Este repositorio tiene el inicio de una aplicación de TypeScript que ya incluye el SDK de Power Platform. Más adelante agregaremos instrucciones para que pueda empezar desde cero sin usar esta aplicación base.

git clone https://github.com/microsoft/PowerAppsCodeApps.git
cd PowerAppsCodeApps

Abrir el ejemplo HelloWorld

Abra el HelloWorld ejemplo mediante Visual Studio Code.

cd samples\HelloWorld
code .

Este proyecto de aplicación se creó con Vite y tiene dos adiciones notables:

• package.json tiene una referencia al SDK de Power Apps que ayuda a una aplicación a conectarse a conectores de Power Platform.
• PowerProvider.tsx que contiene una initialize() función que la aplicación usa para comunicarse con el host de Power Apps que la aplicación está lista para ejecutarse.

Autenticar la CLI de PAC e indicar el entorno de desarrollo.

En Visual Studio Code, abra una nueva ventana de terminal y use el comando pac auth create para crear un perfil de autenticación.

pac auth create --environment {environment id}

Todas las aplicaciones, flujos y agentes de Power Platform publican en un entorno. El comando de autenticación de la CLI de PAC le pide que se autentique con su identidad de Microsoft Entra y asegúrese de que la aplicación de código a la que agrega conexiones y publique en Power Platform vaya en el entorno especificado.

Instalación de dependencias

En la ventana del terminal, ejecute estos comandos:

npm install
pac code init --displayName 'Hello World'

• instalación de npm Instala las bibliotecas dependientes que se encuentran en el package.json archivo.
• pac code init Inicializa una aplicación de código en el directorio actual.

Ejecución en modo local

En la ventana del terminal, ejecute estos comandos:

npm run dev | pac code run

• npm run dev Ejecuta los scripts configurados en el package.json archivo con el valor de clave de dev. En este caso, el script es "concurrently \"vite\" \"pac code run\"".
• pac code run Ejecuta un servidor local para las conexiones que se cargan localmente en la aplicación.

Compilar e implementar en Power Apps

En la ventana del terminal, ejecute estos comandos:

npm run build | pac code push

• npm run build Ejecuta los scripts configurados en el archivo package.json con la clave de valor build. En este caso, el script es "tsc -b && vite build".
• pac code push Publica una nueva versión de una aplicación de código.

Si se ejecuta correctamente, este comando debe devolver una dirección URL de Power Apps para ejecutar la aplicación.

Opcionalmente, puede abrir Power Apps para ver la aplicación. Puede jugar, compartir o ver detalles desde allí.

¡Felicidades! ¡Ha subido con éxito su primer código!

Solución de problemas

Si se queda atascado o atascada en la pantalla de carga "capturando la aplicación" o ve una pantalla de error "Se ha superado el tiempo de espera en la aplicación", vuelva a comprobar:

• Que ha ejecutado npm run build
• No hay problemas en PowerProvider.tsx