Χρησιμοποιήστε το Starter-Kit για να ξεκινήσετε και να λειτουργήσετε

Χρησιμοποιήστε αυτήν τη γρήγορη εκκίνηση για να εκτελέσετε τον φόρτο εργασίας HelloWorld και να τον φωτίσετε στο Fabric. Βασίζεται στις βέλτιστες πρακτικές και απλοποιεί τα βήματα για γρήγορη κωδικοποίηση.

Σημαντικό

Βεβαιωθείτε ότι έχετε πρόσβαση σε έναν χώρο εργασίας Fabric και ότι ο μισθωτής σας επιτρέπει δυνατότητες προγραμματιστή. Μπορείτε να ενεργοποιήσετε τη λειτουργία προγραμματιστή Fabric πριν από τη δοκιμή.

1. Κλωνοποιήστε το repo

Ξεκινήστε διαχωρίζοντας το αποθετήριο Starter-Kit Repo και, στη συνέχεια, κλωνοποιήστε το στον τοπικό σας υπολογιστή.

git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit

2. Εκτελέστε το σενάριο εγκατάστασης

Το σενάριο εγκατάστασης αυτοματοποιεί τις περισσότερες ρυθμίσεις παραμέτρων (εγγραφή εφαρμογής, προεπιλογές κ.λπ.).

# From the repo root
pwsh ./scripts/Setup/Setup.ps1 -WorkloadName "Org.MyWorkload"
  • Το WorkloadName πρέπει να ακολουθεί το μοτίβο Organization.WorkloadName. Για ανάπτυξη, χρησιμοποιήστε Org.[YourWorkloadName].
  • Εάν επαναχρησιμοποιείτε μια υπάρχουσα εφαρμογή Microsoft Entra, βεβαιωθείτε ότι τα URI ανακατεύθυνσης SPA έχουν διαμορφωθεί όπως περιγράφεται στον οδηγό μη αυτόματης ρύθμισης αποθετηρίων.
  • Σε macOS/Linux, χρησιμοποιήστε το pwsh για την εκτέλεση σεναρίων.

3. Ξεκινήστε το περιβάλλον ανάπτυξης

Εκτελέστε τον διακομιστή ανάπτυξης (front end + API) και καταχωρήστε την τοπική παρουσία σας στο Fabric μέσω DevGateway.

# Terminal 1: start local dev server
pwsh ./scripts/Run/StartDevServer.ps1

# Terminal 2: start DevGateway to register your local instance with Fabric
pwsh ./scripts/Run/StartDevGateway.ps1

4. Ενεργοποιήστε τις δυνατότητες προγραμματιστή στο Fabric

Στην πύλη Fabric:

  • Στην πύλη διαχείρισης, βεβαιωθείτε ότι οι ρυθμίσεις προγραμματιστή μισθωτή που απαιτούνται από το κιτ εργαλείων είναι ενεργοποιημένες.
  • Στις Ρυθμίσεις προγραμματιστή, ενεργοποιήστε τη Λειτουργία προγραμματιστή Fabric για τον λογαριασμό σας.

5. Δοκιμάστε το στοιχείο HelloWorld

Μπορείτε να αποκτήσετε πρόσβαση στον φόρτο εργασίας από το Workload Hub (αναζητήστε το όνομα του φόρτου εργασίας σας) ή να πλοηγηθείτε απευθείας. Στη συνέχεια, δημιουργήστε ένα στοιχείο Hello World.

Βήματα:

  1. Ανοίξτε Fabric Κέντρο φόρτου εργασίας, εντοπίστε τον φόρτο εργασίας σας (για παράδειγμα, Org.MyWorkload).
  2. Επιλέξτε τον τύπο στοιχείου Hello World και επιλέξτε τον χώρο εργασίας ανάπτυξης.
  3. Ανοίγει ο επεξεργαστής. Επιβεβαιώστε ότι το στοιχείο λειτουργεί όπως αναμένεται.

6. Ξεκινήστε την κωδικοποίηση

Αλλάξτε το στοιχείο HelloWorld ή δημιουργήστε ένα νέο:

  • Ενημερώστε το πρόγραμμα επεξεργασίας: Workload/app/items/HelloWorldItem/HelloWorldItemEditor.tsx
  • Ή σκαλωσιά ένα νέο αντικείμενο με το σενάριο: ./scripts/Setup/CreateNewItem.ps1

Αντιμετώπιση προβλημάτων

  • Πολιτική PowerShell: Χαλαρώστε προσωρινά την πολιτική εκτέλεσης εάν δεν ξεκινούν οι δέσμες ενεργειών.
  • Πιο πρόσφατο PowerShell: Εγκαταστήστε/ενημερώστε το PowerShell εάν δείτε σφάλματα εγκατάστασης.
  • Κατάργηση αποκλεισμού σεναρίων: Εάν σας ζητηθεί, επιτρέψτε την εκτέλεση .ps1 αρχείων.
  • Υπάρχουσα εφαρμογή Microsoft Entra: Διαμορφώστε τα URI ανακατεύθυνσης SPA σύμφωνα με τον μη αυτόματο οδηγό στο αποθετήριο.
  • macOS/Linux: Χρησιμοποιήστε το pwsh για την εκτέλεση των σεναρίων.
  • Last updated on