Tutorial: Comece com o Fabric Extensibility Toolkit

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

O que você constrói

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 criados pela sua carga de trabalho se comportam como artefatos nativos do Fabric.

Pré-requisitos

  • Acesso a um locatário do Fabric e um espaço de trabalho onde você pode criar itens
  • Uma conta GitHub (necessária para Codespaces)
  • Se estiver desenvolvendo localmente: um LTS Node.js recente e um gerenciador de pacotes (consulte o LEIA-ME para obter as ferramentas exatas)
  • Acesso para criar uma Aplicação Microsoft Entra
  • Opcional: uma assinatura do Azure se você planeja hospedar seu aplicativo Web no Azure

Sugestão

O desenvolvimento local é suportado nativamente no Windows, macOS e Linux. Antes de executar scripts de instalação ou iniciar o servidor de desenvolvimento, revise e satisfaça os pré-requisitos no Starter-Kit.

Observação

Não precisas de disponibilizar nada ao teu inquilino para experimentares o Kit de Iniciação. Use o DevGateway durante o desenvolvimento para emular o host Fabric.

Importante

Verifique se você tem acesso a um espaço de trabalho do Fabric e se seu locatário permite recursos de desenvolvedor. Você ativa o Modo de Desenvolvedor do Fabric antes dos testes.

Escolha o seu caminho

Diagrama de Introdução ao Codespaces.

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

Opção 1: Iniciar nos espaços de código do GitHub

  1. Faça um fork do Starter-Kit Repository para a sua conta no GitHub.
  2. Crie um Codespace GitHub no seu fork para começar com um ambiente de desenvolvimento baseado na cloud.

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

Opção 2: Clone e execute localmente

  1. Faça um fork do Starter-Kit Repository para a sua conta no GitHub.
  2. Clone o seu fork para a sua máquina 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

Este repositório funciona bem com ferramentas de programação de pares de IA. Quer você desenvolva localmente ou no GitHub Codespaces, você pode usar o GitHub Copilot ou outros assistentes de IA para acelerar tarefas como editar componentes do React, atualizar rotas ou gerar andaimes de teste.

Sugestão

O repositório Starter-Kit é habilitado para IA e inclui instruções do GitHub Copilot que o orientam na adaptação do item Hello World às suas necessidades. Outras ferramentas de IA (por exemplo, o Anthropic Claude) podem seguir as mesmas orientações, mas têm de ser configuradas para ler os ficheiros ou documentos de orientação do repositório.

  • Use a IA para elaborar componentes de edição/visualização de itens e, em seguida, adapte-se aos padrões de API do host usados no Starter-Kit.
  • Peça à IA para resumir o manifesto da carga de trabalho e propor conjuntos de permissões mínimos.
  • No 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.

Sugestão

Se você estiver interessado em ver o que outras pessoas criam, abra os Exemplos de extensibilidade e implante-os em seu ambiente. Ali podes encontrar tipos de itens ricos que te ajudam a começar.

Melhores práticas

  • Faça um fork do repositório: Faça um fork do repositório Starter-Kit e use o seu fork como base do seu projeto.
  • Mantenha-se sincronizado: Mantenha o seu fork sincronizado com o upstream para captar melhorias.
  • Manter a consistência da estrutura do projeto: Preservar a estrutura do projeto e os padrões organizacionais do Kit de Início para garantir a compatibilidade com futuras atualizações e manter a clareza do código.
  • Integração Starter-Kit regular: Integre regularmente alterações de código do Starter-Kit no seu projeto para beneficiar de correções de bugs, novas funcionalidades e atualizações de segurança. Estabeleça um processo para rever e fundir modificações de upstream regularmente (mensal ou trimestralmente).
  • Valide os manifestos antecipadamente: Valide o seu manifesto de carga de trabalho cedo e siga as permissões de privilégio mínimo.
  • Utilizar contentores de desenvolvimento: Utilize um contentor de desenvolvimento ou Codespaces para um ambiente consistente e descartável.
  • Use os scripts fornecidos: Use os scripts fornecidos (Setup, StartDevServer, StartDevGateway) para automatizar a configuração e o fluxo de trabalho diário.

Próximos passos

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

  • Executar o script de configuração
  • Início do ambiente de desenvolvimento
  • Ativação das funcionalidades de programador do Fabric
  • A testar o teu primeiro item HelloWorld
  • Começar a programar
  • Dicas de desenvolvimento assistido por IA
  • Solução de problemas comuns

Recursos adicionais

  • Last updated on