Compartilhar via

Tutorial: Introdução ao Fabric Extensibility Toolkit

Use este guia para começar a criar uma carga de trabalho do Microsoft Fabric com o Kit de Ferramentas de Extensibilidade. Você configura seu ambiente, executa o Starter-Kit em Codespaces do GitHub ou localmente e aprende as noções básicas necessárias para criar e publicar.

O que você cria

Você executa o Starter-Kit dentro do Fabric, explora seu manifesto e o uso da API do host, faz uma pequena alteração na interface do usuário e entende como os itens que sua carga de trabalho cria se comportam como artefatos nativos do Fabric.

Pré-requisitos

  • Acesso a um locatário do Fabric e a um workspace em que você pode criar itens
  • Uma conta do GitHub (necessária para codespaces)
  • Se estiver desenvolvendo localmente: um LTS Node.js recente e um gerenciador de pacotes (consulte o README para ferramentas exatas)
  • Acesso para criar um aplicativo do Microsoft Entra
  • Opcional: uma assinatura do Azure se você planeja hospedar seu aplicativo Web no Azure

Dica

O desenvolvimento local tem suporte nativo no Windows, macOS e Linux. Antes de executar scripts de instalação ou iniciar o servidor de desenvolvimento, examine e atenda aos pré-requisitos no Starter-Kit.

Observação

Você não precisa implantar nada em seu locatário para experimentar o Starter-Kit. Use o DevGateway durante o desenvolvimento para emular o host do Fabric.

Importante

Verifique se você tem acesso a um workspace do Fabric e seu locatário permite recursos de desenvolvedor. Habilite o Modo de Desenvolvedor do Fabric antes do teste.

Escolha seu caminho

Diagrama de Introdução aos Codespaces.

Para começar rapidamente, escolha uma das seguintes opções para acessar o código:

Opção 1: Iniciar em codespaces do GitHub

  1. Faça o fork do Starter-Kit Repository em sua conta do GitHub.
  2. Crie um Codespace do GitHub em sua bifurcação para começar a usar um ambiente de desenvolvimento baseado em nuvem.

Para obter mais informações sobre os Codespaces do GitHub, consulte a documentação do GitHub Codespaces.

Opção 2: Clonar e executar localmente

  1. Faça um fork do Starter-Kit Repository para a sua conta no GitHub.
  2. Clone o seu fork para o seu computador local:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Instale os pré-requisitos necessários para o desenvolvimento local:

Ferramentas necessárias:

Desenvolvimento assistido por IA

Esse repositório funciona bem com ferramentas de programação de pares de IA. Se você desenvolver localmente ou em codespaces do GitHub, poderá usar o GitHub Copilot ou outros assistentes de IA para acelerar tarefas como editar componentes do React, atualizar rotas ou gerar scaffolding de teste.

Dica

O repositório Starter-Kit é habilitado para IA e inclui instruções do GitHub Copilot que orientam você a adaptar o item Hello World às suas necessidades. Outras ferramentas de IA (por exemplo, Antropic Claude) podem seguir as mesmas diretrizes, mas devem ser configuradas para ler os arquivos de diretrizes ou documentos do repositório.

  • Use a IA para elaborar componentes de editor/exibição de itens e, em seguida, adaptar-se aos padrões de API de host usados no Starter-Kit.
  • Peça à IA para resumir o manifesto da carga de trabalho e propor conjuntos de permissões mínimos.
  • Em codespaces, o Copilot está disponível no navegador ou na área de trabalho do VS Code; mantenha o servidor de desenvolvimento em execução para ver as alterações instantaneamente.

Dica

Se você estiver interessado em ver o que outras pessoas criam, abra os Exemplos de Extensibilidade e implante-os em seu ambiente. Lá, você pode encontrar tipos de itens avançados que ajudam você a começar.

Práticas recomendadas

  • Bifurque o repositório: bifurque o repositório Starter-Kit e use sua bifurcação como base do seu projeto.
  • Mantenha em sincronia: mantenha seu fork em sincronia com o upstream para obter melhorias.
  • Manter a consistência da estrutura do projeto: preservar a estrutura do projeto do Starter-Kit e os padrões de organização para garantir a compatibilidade com atualizações futuras e manter a clareza do código.
  • Integração regular Starter-Kit: integre regularmente as alterações de código do Starter-Kit ao projeto para se beneficiar de correções de bugs, novos recursos e atualizações de segurança. Configure um processo para revisar e mesclar alterações upstream regularmente (mensal ou trimestral).
  • Valide os manifestos antecipadamente: valide o manifesto da carga de trabalho antecipadamente e siga as permissões de privilégio mínimo.
  • Usar contêineres de desenvolvimento: use um contêiner de desenvolvimento ou codespaces para um ambiente consistente e descartável.
  • Use scripts fornecidos: use os scripts fornecidos (Setup, StartDevServer, StartDevGateway) para automatizar a instalação e o fluxo de trabalho diário.

Próximas etapas

Depois de ter acesso ao código (em codespaces ou localmente), continue com o Guia de Instalação Detalhado para obter instruções passo a passo sobre:

  • Executando o script de configuração
  • Iniciando o ambiente de desenvolvimento
  • Habilitando recursos de desenvolvedor do Fabric
  • Testando seu primeiro item HelloWorld
  • Introdução à codificação
  • Dicas de desenvolvimento assistido por IA
  • Solução de problemas comuns

Recursos adicionais

  • Last updated on