Condividi tramite

Esercitazione: Inizia con Fabric Extensibility Toolkit

Usare questa guida per iniziare a creare un carico di lavoro di Microsoft Fabric con Extensibility Toolkit. È possibile configurare l'ambiente, eseguire il Starter-Kit in GitHub Codespaces o in locale e apprendere le nozioni di base necessarie per compilare e pubblicare.

Cosa costruisci

Si esegue lo Starter-Kit all'interno di Fabric, si esplora il manifesto e l'uso dell'API host, si apporta una piccola modifica dell'interfaccia utente e si comprende il comportamento degli elementi creati dal carico di lavoro come elementi nativi di Fabric.

Prerequisiti

  • Accesso a un tenant di Fabric e a un'area di lavoro in cui è possibile creare elementi
  • Un account GitHub (obbligatorio per Codespaces)
  • Se si sviluppa in locale: una recente Node.js LTS e una gestione pacchetti (vedere readME per gli strumenti esatti)
  • Accesso per creare un'applicazione Microsoft Entra
  • Facoltativo: una sottoscrizione di Azure se si prevede di ospitare l'app Web in Azure

Suggerimento

Lo sviluppo locale è supportato in modo nativo in Windows, macOS e Linux. Prima di eseguire script di installazione o avviare il server di sviluppo, esaminare e soddisfare i prerequisiti in Starter-Kit.

Annotazioni

Non è necessario distribuire alcun elemento nel tenant per provare Starter-Kit. Usare DevGateway durante lo sviluppo per emulare l'host Fabric.

Importante

Assicurarsi di avere accesso a un Fabric workspace e che il tenant permetta le funzionalità per sviluppatori. Abilita la Modalità sviluppatore Fabric prima di eseguire il test.

Scegliere il percorso

Diagramma di Introduzione a Codespaces.

Per iniziare rapidamente, selezionare una delle opzioni seguenti per accedere al codice:

Opzione 1: Iniziare in GitHub Codespaces

  1. Effettua un fork del Starter-Kit Repository sul tuo account GitHub.
  2. Creare un gitHub Codespace nel fork per iniziare a usare un ambiente di sviluppo basato sul cloud.

Per altre informazioni su GitHub Codespaces, vedere la documentazione di GitHub Codespaces.

Opzione 2: Clonare ed eseguire localmente

  1. Esegui un fork del Starter-Kit Repository nel tuo account GitHub.
  2. Clona il tuo fork sul computer locale.
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Installare i prerequisiti necessari per lo sviluppo locale:

Strumenti necessari:

Sviluppo assistito dall'intelligenza artificiale

Questo repository funziona bene con gli strumenti di programmazione in coppia con l'intelligenza artificiale. Indipendentemente dal fatto che si sviluppi in locale o in GitHub Codespaces, è possibile usare GitHub Copilot o altri assistenti di intelligenza artificiale per accelerare le attività come la modifica di componenti React, le route di aggiornamento o la generazione dello scaffolding dei test.

Suggerimento

Il repository Starter-Kit è abilitato per l'intelligenza artificiale e include istruzioni di GitHub Copilot che consentono di adattare l'elemento Hello World alle proprie esigenze. Altri strumenti di intelligenza artificiale (ad esempio, Anthropic Claude) possono seguire le stesse indicazioni, ma devono essere configurati per leggere i file di indicazioni o la documentazione del repository.

  • Usare l'intelligenza artificiale per creare bozze di componenti dell'editor/visualizzazione degli elementi e quindi adattarsi ai modelli api host usati nello Starter-Kit.
  • Chiedere all'intelligenza artificiale di riepilogare il manifesto del carico di lavoro e proporre set di autorizzazioni minimi.
  • In Codespaces, Copilot è disponibile nel browser o nel desktop di VS Code; mantenere il server di sviluppo in esecuzione per visualizzare immediatamente le modifiche.

Suggerimento

Se sei interessato a vedere cosa creano gli altri, apri gli Esempi di Estendibilità e distribuiscili al proprio ambiente. È possibile trovare tipi di elementi avanzati che consentono di iniziare.

Procedure consigliate

  • Creare una copia tramite fork del repository: creare una copia tramite fork del repository Starter-Kit e usare il fork come base del progetto.
  • Mantieni sincronizzato: Assicurati che il fork sia sincronizzato con l'upstream per raccogliere i miglioramenti.
  • Mantenere la coerenza della struttura del progetto: mantenere i modelli di progetto e organizzazione dello Starter-Kit per garantire la compatibilità con gli aggiornamenti futuri e mantenere la chiarezza del codice.
  • Integrazione regolare Starter-Kit: integrare regolarmente le modifiche del codice dal Starter-Kit al progetto per trarre vantaggio dalle correzioni di bug, dalle nuove funzionalità e dagli aggiornamenti della sicurezza. Configurare un processo per esaminare e unire le modifiche upstream a intervalli regolari (mensile o trimestrale).
  • Convalidare i manifesti in anticipo: convalidare il manifesto del carico di lavoro in anticipo e seguire le autorizzazioni con privilegi minimi.
  • Usare i contenitori di sviluppo: usare un contenitore di sviluppo o Codespaces per un ambiente coerente e eliminabile.
  • Usare gli script forniti: usare gli script forniti (programma di installazione, StartDevServer, StartDevGateway) per automatizzare la configurazione e il flusso di lavoro giornaliero.

Passaggi successivi

Dopo aver ottenuto l'accesso al codice (in Codespaces o localmente), continuare con la Guida dettagliata all'installazione per istruzioni dettagliate su:

  • Esecuzione dello script di installazione
  • Avvio dell'ambiente di sviluppo
  • Abilitazione delle funzionalità per sviluppatori di Fabric
  • Testare il tuo primo elemento HelloWorld
  • Introduzione alla scrittura di codice
  • Suggerimenti per lo sviluppo assistito dall'intelligenza artificiale
  • Risoluzione dei problemi comuni

Risorse aggiuntive

  • Last updated on