Tutorial: Mulai menggunakan Fabric Extensibility Toolkit

Gunakan panduan ini untuk mulai membangun beban kerja Microsoft Fabric dengan Extensibility Toolkit. Anda menyiapkan lingkungan, menjalankan Starter-Kit di GitHub Codespaces atau secara lokal, dan mempelajari dasar-dasar yang perlu Anda bangun dan terbitkan.

Apa yang Anda bangun

Anda menjalankan Starter-Kit di dalam Fabric, menjelajahi manifes dan penggunaan API hostnya, membuat perubahan UI kecil, dan memahami bagaimana item yang dibuat beban kerja Anda berperilaku seperti artefak Fabric asli.

Prasyarat

  • Akses ke penyewa Fabric dan ruang kerja tempat Anda dapat membuat item
  • Akun GitHub (diperlukan untuk Codespace)
  • Jika mengembangkan secara lokal: Node.js LTS terbaru dan manajer paket (lihat README untuk alat yang tepat)
  • Akses untuk membuat Aplikasi Microsoft Entra
  • Opsional: langganan Azure jika Anda berencana untuk menghosting aplikasi web Anda di Azure

Petunjuk / Saran

Pengembangan lokal didukung secara asli di Windows, macOS, dan Linux. Sebelum menjalankan skrip penyiapan atau memulai server dev, tinjau dan penuhi prasyarat di Starter-Kit.

Nota

Anda tidak perlu menginstal apa pun ke akun tenant Anda untuk mencoba Starter-Kit. Gunakan DevGateway selama pengembangan untuk meniru host Fabric.

Penting

Pastikan Anda memiliki akses ke ruang kerja Fabric dan penyewa Anda memungkinkan fitur pengembang. Anda mengaktifkan Mode Pengembang Fabric sebelum pengujian.

Pilih jalur Anda

Diagram Mulai menggunakan Codespace.

Untuk memulai dengan cepat, pilih salah satu opsi berikut untuk mengakses kode:

Opsi 1: Mulai di GitHub Codespaces

  1. Fork repositoriStarter-Kit ke akun GitHub Anda.
  2. Buat GitHub Codespace di fork Anda untuk memulai lingkungan pengembangan berbasis cloud.

Untuk informasi selengkapnya tentang GitHub Codespaces, lihat dokumentasi GitHub Codespaces.

Opsi 2: Kloning dan jalankan secara lokal

  1. Fork repositoriStarter-Kit ke akun GitHub Anda.
  2. Kloning fork Anda ke komputer lokal Anda:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Instal prasyarat yang diperlukan untuk pengembangan lokal:

Alat yang diperlukan:

Pengembangan yang dibantu AI

Repositori ini berfungsi dengan baik dengan alat pemrograman pasangan AI. Baik Anda mengembangkan secara lokal atau di GitHub Codespaces, Anda dapat menggunakan GitHub Copilot atau asisten AI lainnya untuk mempercepat tugas seperti mengedit komponen React, memperbarui rute, atau menghasilkan perancah pengujian.

Petunjuk / Saran

Repositori Starter-Kit diaktifkan AI dan menyertakan instruksi GitHub Copilot yang memandu Anda mengadaptasi item Hello World dengan kebutuhan Anda. Alat AI lainnya (misalnya, Anthropic Claude) dapat mengikuti panduan yang sama, tetapi harus dikonfigurasi untuk membaca file atau dokumen panduan repositori.

  • Gunakan AI untuk menyusun komponen editor/tampilan item lalu beradaptasi dengan pola API host yang digunakan dalam Starter-Kit.
  • Minta AI untuk meringkas manifes beban kerja dan mengusulkan set izin minimal.
  • Di Codespaces, Copilot tersedia di browser atau desktop VS Code; jaga agar server pengembangan tetap berjalan untuk melihat perubahan secara instan.

Petunjuk / Saran

Jika Anda tertarik untuk melihat apa yang dibangun orang lain membuka Sampel Ekstensibilitas dan menyebarkannya ke lingkungan Anda. Di sana Anda dapat menemukan jenis item kaya yang membantu Anda memulai.

Praktik terbaik

  • Fork repositori: Fork repositori Starter-Kit dan gunakan fork Anda sebagai basis proyek Anda.
  • ** Tetap sinkron: Jaga agar fork Anda tetap sinkron dengan upstream untuk mengadopsi peningkatan.
  • Pertahankan konsistensi struktur proyek: Pertahankan struktur proyek Starter-Kit dan pola organisasi untuk memastikan kompatibilitas dengan pembaruan di masa mendatang dan pertahankan kejelasan kode.
  • Integrasi Starter-Kit reguler: Mengintegrasikan perubahan kode secara teratur dari Starter-Kit ke dalam proyek Anda untuk mendapatkan manfaat dari perbaikan bug, fitur baru, dan pembaruan keamanan. Siapkan proses untuk meninjau dan menggabungkan perubahan upstream secara teratur (bulanan atau triwulanan).
  • Memvalidasi manifes lebih awal: Validasi manifes beban kerja Anda lebih awal dan ikuti izin hak istimewa terkecil.
  • Gunakan kontainer dev: Gunakan kontainer dev atau Codespaces untuk lingkungan yang konsisten dan sekali pakai.
  • Gunakan skrip yang disediakan: Gunakan skrip yang disediakan (Penyiapan, StartDevServer, StartDevGateway) untuk mengotomatiskan penyiapan dan alur kerja harian.

Langkah selanjutnya

Setelah Anda memiliki akses ke kode (baik di Codespace atau secara lokal), lanjutkan dengan Panduan Penyiapan Terperinci untuk instruksi langkah demi langkah tentang:

  • Menjalankan skrip penyetelan
  • Memulai lingkungan pengembangan
  • Mengaktifkan fitur pengembang Fabric
  • Menguji item HelloWorld pertama Anda
  • Mulai menggunakan pengkodan
  • Tips pengembangan yang dibantu AI
  • Pemecahan masalah umum

Sumber daya tambahan

  • Last updated on