Compartir a través de

Tutorial: Introducción al kit de herramientas de extensibilidad de Fabric

Use esta guía para empezar a crear una carga de trabajo de Microsoft Fabric con el Kit de herramientas de extensibilidad. Configure el entorno, ejecute el Starter-Kit en GitHub Codespaces o localmente y conozca los conceptos básicos que necesita para compilar y publicar.

Lo que construyes

Ejecuta Starter-Kit dentro de Fabric, explora el manifiesto y el uso de la API del host, realiza un pequeño cambio en la interfaz de usuario y comprende cómo los elementos que crea tu carga de trabajo se comportan como artefactos nativos de Fabric.

Prerrequisitos

  • Acceso a un inquilino de Fabric y un área de trabajo donde puede crear elementos
  • Una cuenta de GitHub (necesaria para Codespaces)
  • Si desarrolla localmente: un Node.js LTS reciente y un administrador de paquetes (consulte el archivo LÉAME para obtener herramientas exactas).
  • Acceso para crear una aplicación de Microsoft Entra
  • Opcional: una suscripción de Azure si planea hospedar la aplicación web en Azure

Sugerencia

El desarrollo local se admite de forma nativa en Windows, macOS y Linux. Antes de ejecutar scripts de instalación o iniciar el servidor de desarrollo, revise y cumpla los requisitos previos en Starter-Kit.

Nota:

No es necesario implementar nada en tu entorno para probar Starter-Kit. Use DevGateway durante el desarrollo para emular el host de Fabric.

Importante

Asegúrese de que tiene acceso a un área de trabajo de Fabric y que su inquilino permita funciones de desarrollador. Se habilita el modo de desarrollador de Fabric antes de las pruebas.

Elección de la ruta de acceso

Diagrama de Introducción a Codespaces.

Para empezar a trabajar rápidamente, elija una de las siguientes opciones para acceder al código:

Opción 1: Iniciar en GitHub Codespaces

  1. Haga un fork del Repositorio Starter-Kit en su cuenta de GitHub.
  2. Cree un Codespace de GitHub en tu bifurcación para empezar con un entorno de desarrollo basado en la nube.

Para más información sobre GitHub Codespaces, consulte la documentación de GitHub Codespaces.

Opción 2: Clonar y ejecutar localmente

  1. Haga un fork del repositorio Starter-Kit en su cuenta de GitHub.
  2. Clone la bifurcación en la máquina local:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Instale los requisitos previos necesarios para el desarrollo local:

Herramientas necesarias:

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 Starter-Kit está habilitado para IA e incluye instrucciones de GitHub Copilot que le ayudan a adaptar el elemento Hello World 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.

procedimientos recomendados

  • Bifurque el repositorio: Haga un fork del repositorio Starter-Kit y use este fork como base de su proyecto.
  • Manténgase sincronizado: mantenga la bifurcación sincronizada con la cadena ascendente para recoger mejoras.
  • Mantener la coherencia de la estructura del proyecto: conserve la estructura del proyecto y los patrones de organización de Starter-Kit para garantizar la compatibilidad con las actualizaciones futuras y mantener la claridad del código.
  • Integración de Starter-Kit normal: integre periódicamente los cambios de código del Starter-Kit en el proyecto para beneficiarse de correcciones de errores, nuevas características y actualizaciones de seguridad. Configure un proceso para revisar y combinar los cambios ascendentes de forma periódica (mensual o trimestral).
  • Validar los manifiestos anticipadamente: valide de forma anticipada el manifiesto de carga de trabajo y siga los permisos con privilegios mínimos.
  • Usar contenedores de desarrollo: use un contenedor de desarrollo o Codespaces para un entorno coherente y descartable.
  • Usar scripts proporcionados: use los scripts proporcionados (Setup, StartDevServer, StartDevGateway) para automatizar la configuración y el flujo de trabajo diario.

Pasos siguientes

Una vez que tenga acceso al código (ya sea en Codespaces o localmente), continúe con la Guía de configuración detallada para obtener instrucciones paso a paso sobre:

  • Ejecución del script de instalación
  • Inicio del entorno de desarrollo
  • Habilitación de las características para desarrolladores de Fabric
  • Prueba del primer elemento HelloWorld
  • Introducción a la codificación
  • Sugerencias de desarrollo asistidas por IA
  • Solución de problemas habituales

Recursos adicionales

  • Last updated on