Guía de implementación

Comience desde el repositorio deStarter-Kit para obtener una productividad rápida. La bifurcación del repositorio es la práctica recomendada: puede mantener la personalización en su bifurcación y usarla como base para su propio proyecto. El proyecto está preconfigurado para que pueda ejecutarse localmente de inmediato, y los scripts están disponibles para configurar todo para usted.

Prerrequisitos

El desarrollo local se admite en Windows, macOS y Linux. Instale o tenga acceso a:

Opcional

  • Contenedor de desarrollo/GitHub Codespaces. Si usa Codespaces, elija al menos una máquina de 8 núcleos y abra el espacio de código en VS Code localmente. A continuación, siga la guía de configuración en el repositorio.

Bifurque el Starter-Kit en su propia cuenta de GitHub para poder realizar un seguimiento y mantener los cambios.

git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit

2. Iniciar el entorno de desarrollo

Ejecute el script de instalación para configurar los requisitos previos (por ejemplo, Microsoft Entra aplicación, valores predeterminados). Use pwsh en macOS/Linux.

# From the repo root
pwsh ./scripts/Setup/Setup.ps1 -WorkloadName "Org.MyWorkload"

A continuación, inicie el entorno de desarrollo local y DevGateway:

# Terminal 1: start the local dev server (frontend + APIs)
pwsh ./scripts/Run/StartDevServer.ps1

# Terminal 2: register your local instance with Fabric
pwsh ./scripts/Run/StartDevGateway.ps1

3. Probar la configuración

En el portal de Fabric:

  • Asegúrese de que la configuración necesaria de desarrolladores para clientes esté habilitada en el portal de administración.
  • Active el modo desarrollador de Fabric para su cuenta.
  • Abra el centro de cargas de trabajo, busque la carga de trabajo (por ejemplo, Org.MyWorkload) y cree un elemento de Hola mundo en el área de trabajo de desarrollo.
  • Se abre el editor: compruebe que el elemento funciona según lo esperado y aparezca como un artefacto nativo en el área de trabajo.

4. Personalizar el código para sus necesidades

Realice pequeños cambios primero y compruebe de principio a fin:

  • Actualice el componente del editor (por ejemplo): Workload/app/items/HelloWorldItem/HelloWorldItemEditor.tsx
  • O genere un nuevo tipo de elemento con: ./scripts/Setup/CreateNewItem.ps1
  • Actualice el manifiesto según sea necesario y vuelva a ejecutarse localmente para comprobar el comportamiento.

Desarrollo asistido por IA

Este repositorio funciona bien con las herramientas de programación de pares de IA. Tanto si desarrolla localmente como en GitHub Codespaces, puede usar GitHub Copilot u otros asistentes de inteligencia artificial para acelerar tareas como editar componentes de React, actualizar rutas o generar scaffolding de prueba.

Sugerencia

El repositorio de Starter-Kit está habilitado para IA e incluye instrucciones de GitHub Copilot que lo guían en la adaptación del elemento Hola mundo a sus necesidades. Otras herramientas de inteligencia artificial (por ejemplo, Anthropic Claude) pueden seguir las mismas instrucciones, pero deben configurarse para leer los archivos de instrucciones o documentos del repositorio.

  • Utilice IA para redactar componentes de editor o de vista de elementos y luego adáptese a los patrones de API del host utilizados en el Starter-Kit.
  • Pida a AI que resuma el manifiesto de carga de trabajo y proponga conjuntos de permisos mínimos.
  • En Codespaces, Copilot está disponible en el explorador o en el escritorio de VS Code; mantenga el servidor de desarrollo en ejecución para ver los cambios al instante.

Sugerencia

Si le interesa ver lo que otros construyen, abra los Ejemplos de Extensibilidad e implante en su entorno. Allí puede encontrar tipos de elementos avanzados que le facilitarán el comienzo.

Iteración rápida y depuración en Fabric

El marco de extensibilidad está diseñado para un desarrollo rápido.

  • Con el servidor de desarrollo y DevGateway en ejecución, los cambios de código en la aplicación se reflejan inmediatamente al abrir el elemento dentro de Fabric.
  • Puede depurar mediante las herramientas de desarrollo del navegador mientras el trabajo está alojado en el iFrame de Fabric.
  • Itere rápidamente en la interfaz de usuario, las rutas y la configuración del manifiesto, y valide el comportamiento de extremo a extremo en su espacio de trabajo de Fabric.

procedimientos recomendados

  • Haz un fork del repositorio Starter-Kit y usa tu fork como base de tu proyecto.
  • Mantenga la bifurcación sincronizada con la cadena ascendente para recoger las mejoras.
  • Valide el manifiesto de carga de trabajo temprano y aplique permisos con privilegios mínimos.
  • Use un contenedor de desarrollo o Codespaces para un entorno coherente y descartable.
  • Use los scripts proporcionados (Setup, StartDevServer, StartDevGateway) para automatizar la configuración y el flujo de trabajo diario.
  • Last updated on