Udostępnij przez

Samouczek: Rozpoczęcie pracy z zestawem narzędzi Fabric Extensibility Toolkit

Użyj tego przewodnika, aby rozpocząć budowanie obciążenia w Microsoft Fabric za pomocą zestawu narzędzi Extensibility Toolkit. Środowisko można skonfigurować, uruchomić Starter-Kit w usłudze GitHub Codespaces lub lokalnie i poznać podstawowe informacje potrzebne do kompilowania i publikowania.

Co tworzysz

Uruchamiasz Starter-Kit wewnątrz Fabric, eksplorujesz jego manifest i użycie interfejsu API hosta, wprowadzasz niewielką zmianę UI i rozumiesz, jak elementy tworzone przez obciążenie zachowują się jak natywne artefakty Fabric.

Wymagania wstępne

  • Dostęp do dzierżawy Fabric i przestrzeni roboczej, w której można tworzyć elementy.
  • Konto usługi GitHub (wymagane dla usługi Codespaces)
  • Jeśli programuje się lokalnie: najnowsze _Node.js LTS_ i menedżer pakietów (zobacz plik Readme, aby uzyskać dokładne informacje o narzędziach)
  • Dostęp do tworzenia aplikacji firmy Microsoft Entra
  • Opcjonalnie: subskrypcja platformy Azure, jeśli planujesz hostować aplikację internetową na platformie Azure

Wskazówka

Programowanie lokalne jest obsługiwane natywnie w systemach Windows, macOS i Linux. Przed uruchomieniem skryptów konfiguracji lub uruchomieniem serwera deweloperskiego przejrzyj i spełnij wymagania wstępne w zestawie startowym.

Uwaga / Notatka

Nie musisz instalować niczego w dzierżawie, aby wypróbować Zestaw Startowy. Użyj metody DevGateway podczas programowania, aby emulować hosta sieci szkieletowej.

Ważne

Upewnij się, że masz dostęp do obszaru roboczego Fabric, a twój tenant zezwala na funkcje programistyczne. Przed rozpoczęciem testowania włączasz tryb dewelopera Fabric.

Wybierz ścieżkę

Diagram przedstawiający wprowadzenie do usługi Codespaces.

Aby szybko rozpocząć pracę, wybierz jedną z następujących opcji dostępu do kodu:

Opcja 1. Uruchamianie w usłudze GitHub Codespaces

  1. Sforkuj Repozytorium Starter-Kit na swoje konto GitHub.
  2. Utwórz GitHub Codespace na swoim forku, aby rozpocząć pracę w środowisku deweloperskim opartym na chmurze.

Aby uzyskać więcej informacji na temat usługi GitHub Codespaces, zobacz dokumentację usługi GitHub Codespaces.

Opcja 2. Klonowanie i uruchamianie lokalnie

  1. Rozgałęź repozytorium Starter-Kit na swoim koncie GitHub.
  2. Sklonuj fork na maszynę lokalną:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Zainstaluj wymagane wymagania wstępne dotyczące programowania lokalnego:

Wymagane narzędzia:

Programowanie wspomagane przez sztuczną inteligencję

To repozytorium dobrze współpracuje z narzędziami do programowania w parach z wykorzystaniem sztucznej inteligencji. Niezależnie od tego, czy programujesz lokalnie, czy w usłudze GitHub Codespaces, możesz użyć narzędzia GitHub Copilot lub innych asystentów sztucznej inteligencji, aby przyspieszyć zadania, takie jak edytowanie składników react, aktualizowanie tras lub generowanie szkieletu testowego.

Wskazówka

Repozytorium Starter-Kit ma wbudowane funkcje sztucznej inteligencji i zawiera instrukcje korzystania z narzędzia GitHub Copilot, które prowadzą Cię krok po kroku przez dostosowanie projektu Hello World do Twoich potrzeb. Inne narzędzia sztucznej inteligencji (na przykład Anthropic Claude) mogą postępować zgodnie z tymi samymi wskazówkami, ale muszą być skonfigurowane do odczytywania plików wskazówek lub dokumentacji repozytorium.

  • Użyj sztucznej inteligencji, aby utworzyć wersję roboczą komponentów edytora i widoku elementów, a następnie dostosuj je do wzorców interfejsu API hosta stosowanych w Starter-Kit.
  • Poproś sztuczną inteligencję o podsumowanie manifestu obciążenia i zaproponuj minimalne zestawy uprawnień.
  • W usłudze Codespaces copilot jest dostępny w przeglądarce lub na pulpicie programu VS Code; zachowaj uruchomiony serwer deweloperski, aby natychmiast zobaczyć zmiany.

Wskazówka

Jeśli chcesz zobaczyć, co inni tworzą, otwórz przykłady rozszerzalności i wdróż je w swoim środowisku. W tym miejscu można znaleźć różnorodne typy elementów, które ułatwiają rozpoczęcie pracy.

Najlepsze rozwiązania

  • Sforsowanie repozytorium: Sforsuj Starter-Kit i użyj swojego odgałęzienia jako podstawy projektu.
  • Zachowaj synchronizację: Utrzymuj swoje rozgałęzienie w synchronizacji z głównym repozytorium, aby przejąć ulepszenia.
  • Zachowaj spójność struktury projektu: zachowaj strukturę projektu i wzorce organizacji zestawu startowego, aby zapewnić zgodność z przyszłymi aktualizacjami i zachować przejrzystość kodu.
  • Regularna integracja Starter-Kit: Regularnie integruj zmiany kodu z Starter-Kit z projektem, aby korzystać z poprawek błędów, nowych funkcji i aktualizacji zabezpieczeń. Skonfiguruj proces regularnego przeglądania i scalania zmian nadrzędnych (co miesiąc lub co kwartał).
  • Wczesne weryfikowanie manifestów: zweryfikuj manifest obciążenia wcześnie i postępuj zgodnie z zasadą najmniejszych uprawnień.
  • Używanie kontenerów deweloperskich: użyj kontenera deweloperskiego lub usługi Codespaces w spójnym, jednorazowym środowisku.
  • Użyj dostarczonych skryptów: użyj podanych skryptów (Setup, StartDevServer, StartDevGateway), aby zautomatyzować konfigurację i codzienny przepływ pracy.

Dalsze kroki

Po uzyskaniu dostępu do kodu (w środowisku Codespaces lub lokalnie) przejdź do szczegółowego przewodnika konfiguracji , aby uzyskać instrukcje krok po kroku:

  • Uruchamianie skryptu instalacji
  • Uruchamianie środowiska projektowego
  • Włączanie funkcji deweloperskich usługi Fabric
  • Testowanie pierwszego elementu HelloWorld
  • Wprowadzenie do kodowania
  • Wskazówki dotyczące programowania wspomaganego przez sztuczną inteligencję
  • Rozwiązywanie typowych problemów

Dodatkowe zasoby

  • Last updated on