Κοινή χρήση μέσω

Οδηγός εφαρμογής

Ξεκινήστε από το Starter-Kit Repository για να γίνετε γρήγορα παραγωγικοί. Η διακλάδωση του αποθετηρίου είναι η συνιστώμενη βέλτιστη πρακτική—μπορείτε να διατηρήσετε την προσαρμογή σας στο πιρούνι σας και να τη χρησιμοποιήσετε ως βάση για το δικό σας έργο. Το έργο είναι προρυθμισμένο ώστε να μπορείτε να το εκτελέσετε τοπικά αμέσως και υπάρχουν διαθέσιμα σενάρια για να ρυθμίσετε τα πάντα για εσάς.

Προαπαιτούμενα

Η τοπική ανάπτυξη υποστηρίζεται σε Windows, macOS και Linux. Εγκαταστήστε ή αποκτήστε πρόσβαση σε:

  • Node.js LTS: Λήψη Node.js
  • PowerShell 7 (pwsh σε macOS/Linux): Εγκαταστήστε το PowerShell
  • .NET SDK (για macOS χρησιμοποιήστε τη δομή x64): Λήψη .NET
  • VS Code ή παρόμοιο πρόγραμμα επεξεργασίας: Κατεβάστε το VS Code
  • Μισθωτής Fabric και ένας χώρος εργασίας που μπορείτε να χρησιμοποιήσετε: Πύλη Fabric
  • Εκχωρημένοι πόροι Fabric που έχουν εκχωρηθεί σε αυτόν τον χώρο εργασίας: Εκχωρημένοι πόροι Fabric
  • Azure CLI (χρησιμοποιείται μόνο για τη δημιουργία εφαρμογών Microsoft Entra): Εγκατάσταση Azure CLI
  • Εφαρμογή Microsoft Entra: είτε χρησιμοποιήστε μια υπάρχουσα εφαρμογή είτε άδεια για να δημιουργήσετε μια νέα

Προαιρετικό

  • Dev container / Χώροι κώδικα GitHub. Εάν χρησιμοποιείτε Codespaces, επιλέξτε τουλάχιστον ένα μηχάνημα 8 πυρήνων και ανοίξτε τον χώρο κωδικών στο VS Code τοπικά. Στη συνέχεια, ακολουθήστε τον οδηγό εγκατάστασης στο αποθετήριο.

Διαχωρίστε το Starter-Kit στον δικό σας λογαριασμό GitHub, ώστε να μπορείτε να παρακολουθείτε και να διατηρείτε τις αλλαγές σας.

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

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

Εκτελέστε τη δέσμη ενεργειών εγκατάστασης για να ρυθμίσετε τις παραμέτρους των προϋποθέσεων (για παράδειγμα, εφαρμογή Microsoft Entra, προεπιλογές). Χρήση pwsh σε macOS/Linux.

# From the repo root
pwsh ./scripts/Setup/Setup.ps1 -WorkloadName "Org.MyWorkload"

Στη συνέχεια, ξεκινήστε το περιβάλλον τοπικής ανάπτυξης και το DevGateway:

# Terminal 1: start the local dev server (frontend + APIs)
pwsh ./scripts/Run/StartDevServer.ps1

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

3. Δοκιμάστε τη ρύθμισή σας

Στην πύλη Fabric:

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

4. Προσαρμόστε τον κώδικα στις ανάγκες σας

Κάντε πρώτα μικρές αλλαγές και επαληθεύστε από άκρη σε άκρη:

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

Ανάπτυξη με τη βοήθεια AI

Αυτό το αποθετήριο λειτουργεί καλά με εργαλεία προγραμματισμού ζευγών AI. Είτε αναπτύσσετε τοπικά είτε σε χώρους κώδικα GitHub, μπορείτε να χρησιμοποιήσετε το GitHub Copilot ή άλλους βοηθούς τεχνητής νοημοσύνης για να επιταχύνετε εργασίες όπως η επεξεργασία στοιχείων React, η ενημέρωση διαδρομών ή η δημιουργία δοκιμαστικών ικριωμάτων.

Φιλοδώρημα

Το αποθετήριο Starter-Kit είναι ενεργοποιημένο με AI και περιλαμβάνει οδηγίες GitHub Copilot που σας καθοδηγούν στην προσαρμογή του στοιχείου Hello World στις ανάγκες σας. Άλλα εργαλεία τεχνητής νοημοσύνης (για παράδειγμα, το Anthropic Claude) μπορούν να ακολουθήσουν τις ίδιες οδηγίες, αλλά πρέπει να ρυθμιστούν ώστε να διαβάζουν τα αρχεία καθοδήγησης ή τα έγγραφα του αποθετηρίου.

  • Χρησιμοποιήστε AI για να σχεδιάσετε στοιχεία επεξεργασίας/προβολής στοιχείων και, στη συνέχεια, να προσαρμοστείτε στα μοτίβα API κεντρικού υπολογιστή που χρησιμοποιούνται στο Starter-Kit.
  • Ζητήστε από την τεχνητή νοημοσύνη να συνοψίσει τη δήλωση φόρτου εργασίας και να προτείνει ελάχιστα σύνολα δικαιωμάτων.
  • Στο Codespaces, το Copilot είναι διαθέσιμο στο πρόγραμμα περιήγησης ή στην επιφάνεια εργασίας VS Code. Διατηρήστε τον διακομιστή προγραμματιστών σε λειτουργία για να βλέπετε τις αλλαγές αμέσως.

Φιλοδώρημα

Εάν ενδιαφέρεστε να δείτε τι δημιουργούν οι άλλοι, ανοίξτε τα δείγματα επεκτασιμότητας και αναπτύξτε τα στο περιβάλλον σας. Εκεί μπορείτε να βρείτε πλούσιους τύπους αντικειμένων που σας βοηθούν να ξεκινήσετε.

Γρήγορη επανάληψη και εντοπισμός σφαλμάτων στο Fabric

Το πλαίσιο επεκτασιμότητας έχει σχεδιαστεί για ταχεία ανάπτυξη.

  • Με τον διακομιστή dev και το DevGateway σε λειτουργία, οι αλλαγές κώδικα στην εφαρμογή σας αντικατοπτρίζονται αμέσως όταν ανοίγετε το στοιχείο σας μέσα στο Fabric.
  • Μπορείτε να κάνετε εντοπισμό σφαλμάτων χρησιμοποιώντας τα εργαλεία προγραμματισμού του προγράμματος περιήγησής σας ενώ ο φόρτος εργασίας φιλοξενείται στο Fabric iFrame.
  • Επαναλάβετε γρήγορα το περιβάλλον εργασίας χρήστη, τις δρομολογήσεις και τη διαμόρφωση δήλωσης και επικυρώστε τη συμπεριφορά από άκρο σε άκρο στον χώρο εργασίας σας Fabric.

Βέλτιστες πρακτικές

  • Διακλαδώστε το αποθετήριο Starter-Kit και χρησιμοποιήστε το πιρούνι σας ως βάση του έργου σας.
  • Διατηρήστε το πιρούνι σας σε συγχρονισμό με το upstream για να λάβετε βελτιώσεις.
  • Επικυρώστε νωρίς τη δήλωση φόρτου εργασίας σας και ακολουθήστε τα δικαιώματα ελάχιστων δικαιωμάτων.
  • Χρησιμοποιήστε ένα κοντέινερ προγραμματιστών ή Codespaces για ένα συνεπές περιβάλλον μιας χρήσης.
  • Χρησιμοποιήστε τις παρεχόμενες δέσμες ενεργειών (Setup, StartDevServer, StartDevGateway) για να αυτοματοποιήσετε τη ρύθμιση και την καθημερινή ροή εργασιών.
  • Last updated on