Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Tämän oppaan avulla voit aloittaa Microsoft Fabric -kuormituksen luomisen Extensibility Toolkitin avulla. Määrität ympäristösi, suoritat Starter-Kit GitHub Codespacesissa tai paikallisesti ja opit rakentamisen ja julkaisemisen perusteet.
Mitä rakennat
Suoritat aloituspaketin Fabricissa, tutkit sen luettelotiedoston ja isännän ohjelmointirajapinnan käyttöä, teet pienen käyttöliittymämuutoksen ja ymmärrät, miten kuormituksesi luomat kohteet toimivat alkuperäisten Fabric-artefaktien tavoin.
Vaatimukset
- Pääsy Fabric-vuokraajaan ja työtilaan, jossa voit luoda kohteita
- GitHub-tili (vaaditaan Codespacesissa)
- Jos kehitetään paikallisesti: äskettäinen LTS-Node.js ja paketinhallinta (katso tarkat työkalut README-tiedostosta)
- Pääsy Microsoft Entra -sovelluksen luomiseen
- Valinnainen: Azure-tilaus, jos aiot isännöidä verkkosovellustasi Azuressa
Juomaraha
Paikallista kehitystä tuetaan natiivisti Windowsissa, macOS:ssä ja Linuxissa. Ennen kuin suoritat asennuskomentosarjoja tai käynnistät kehityspalvelimen, tarkista ja täytä aloituspaketin edellytykset.
Note
Sinun ei tarvitse lähettää mitään vuokralaisellesi kokeillaksesi aloituspakettia. Käytä DevGatewayta kehityksen aikana Fabric-isännän emulointiin.
Tärkeää
Varmista, että sinulla on Fabric-työtilan käyttöoikeus ja että vuokraajasi sallii kehittäjäominaisuudet. Ota Fabric Developer Mode käyttöön ennen testausta.
Valitse polkusi
Aloittaaksesi nopeasti, valitse jokin seuraavista vaihtoehdoista koodin käyttämiseksi:
Vaihtoehto 1: Aloita GitHub Codespacesissa
- Haarauta Starter-Kit Repository GitHub-tilillesi.
- Luo haaralle GitHub-kooditila aloittaaksesi pilvipohjaisen kehitysympäristön.
Lisätietoja GitHub Codespacesista löytyy GitHub Codespaces -dokumentaatiosta.
Vaihtoehto 2: Kloonaa ja suorita paikallisesti
- Haarauta Starter-Kit Repository GitHub-tilillesi.
- Kloonaa haarukkasi paikalliseen koneeseen:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
- Asenna vaaditut edellytykset paikalliselle kehitykselle:
Tarvittavat työkalut:
- Node.js LTS: Lataa Node.js
- PowerShell 7 (pwsh macOS/Linuxissa): Asenna PowerShell
- .NET SDK (macOS:lle käytä x64-versiota): Download .NET
- VS Code tai vastaava editori: Lataa VS Code
- Azure CLI (used only for Microsoft Entra app creation): Install Azure CLI
Tekoälyavusteinen kehitys
Tämä arkisto toimii hyvin tekoälypariohjelmointityökalujen kanssa. Kehitätpä sitten paikallisesti tai GitHub Codespacesissa, voit käyttää GitHub Copilotia tai muita tekoälyavustajia nopeuttaaksesi tehtäviä, kuten React-komponenttien muokkaamista, reittien päivittämistä tai testitelineiden luomista.
Juomaraha
Starter-Kit-säilö on tekoälyä tukeva ja sisältää GitHub Copilot -ohjeet, jotka opastavat sinua mukauttamaan Hello World -kohdetta tarpeisiisi. Muut tekoälytyökalut (esimerkiksi Anthropic Claude) voivat noudattaa samaa ohjeistusta, mutta ne täytyy konfiguroida lukemaan varaston ohjetiedostoja tai dokumentteja.
- Käytä tekoälyä alkioeditorin/-komponenttien luonnosteluun ja mukautumiseen aloituspaketissa käytettyihin isäntä-API-malleihin.
- Pyydä tekoälyä tekemään yhteenveto kuormituksen luettelosta ja ehdottamaan vähimmäiskäyttöoikeusjoukkoja.
- Codespacesissa Copilot on käytettävissä selaimessa tai VS Code -työpöydällä; Pidä kehityspalvelin käynnissä, jotta näet muutokset välittömästi.
Juomaraha
Jos olet kiinnostunut näkemään, mitä muut rakentavat, avaa laajennettavuusmallit ja ota ne käyttöön ympäristössäsi. Sieltä löydät monipuolisia kohdetyyppejä, jotka auttavat sinua pääsemään alkuun.
Parhaat käytännöt
- Haaruta repositorio: Forkaa Starter-Kit -repositorio ja käytä haarukkaasi projektisi pohjana.
- Pysy synkassa: Pidä haarukka synkassa ylävirran kanssa saadaksesi parannuksia.
- Yllä projektirakenteen johdonmukaisuus: Säilytä Starter-Kitin projektirakenne ja organisaatiomallit yhteensopivuuden varmistamiseksi tulevien päivitysten kanssa ja koodin selkeyden ylläpitämiseksi.
- Säännöllinen Starter-Kit-integraatio: Integroi säännöllisesti Starter-Kit koodimuutokset projektiisi, jotta saat bugikorjauksia, uusia ominaisuuksia ja tietoturvapäivityksiä. Luo prosessi, jossa tarkastellaan ja yhdistä ylävirran muutoksia säännöllisesti (kuukausittain tai neljännesvuosittain).
- Vahvista manifestit ajoissa: Vahvista työkuormamanifestisi ajoissa ja noudata vähiten etuoikeuden käyttöoikeuksia.
- Käytä dev-kontteja: Käytä dev-konttia tai kooditiloja johdonmukaisen, kertakäyttöisen ympäristön luomiseksi.
- Käytä annettuja skriptejä: Käytä annettuja skriptejä (Setup, StartDevServer, StartDevGateway) automatisoidaksesi asennuksen ja päivittäisen työnkulun.
Seuraavat vaiheet
Kun sinulla on pääsy koodiin (joko Codespace-tilassa tai paikallisesti), jatka yksityiskohtaisen asennusoppaan avulla, josta saat vaiheittaiset ohjeet seuraavista ohjeista:
- Asennusskriptin suorittaminen
- Kehitysympäristön aloittaminen
- Fabric-kehittäjäominaisuuksien käyttöönotto
- Testaat ensimmäistä HelloWorld-esinettäsi
- Koodauksen aloittaminen
- Tekoälyavusteisia kehitysvinkkejä
- Yleisten ongelmien vianetsintä
Lisäresurssit
- Tutustu arkkitehtuuriin ja siihen, miten isäntä, sovelluksesi ja Fabric-palvelut ovat vuorovaikutuksessa
- Lue rakennetta ja parhaita käytäntöjä luetteloluettelon yleiskatsauksesta
- Ymmärrä työkuormamanifestin rakenne ja konfiguraatio
- Kehitä DevGatewayn kanssa paikallista testausta varten
- Julkaise työkuormasi , kun olet valmis jakamaan sen laajasti