หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เริ่มต้นจาก Starter-Kit Repository เพื่อให้ทํางานได้อย่างรวดเร็ว การแยกที่เก็บเป็นแนวทางปฏิบัติที่ดีที่สุดที่แนะนํา คุณสามารถเก็บการกําหนดเองไว้ใน Fork และใช้เป็นฐานสําหรับโครงการของคุณเอง โปรเจ็กต์ได้รับการกําหนดค่าไว้ล่วงหน้าเพื่อให้คุณสามารถเรียกใช้ภายในเครื่องได้ทันที และสคริปต์จะพร้อมใช้งานเพื่อตั้งค่าทุกอย่างให้คุณ
ข้อกําหนดเบื้องต้น
การพัฒนาภายในรองรับบน 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: ใช้แอปที่มีอยู่หรือสิทธิ์ในการสร้างแอปใหม่
เลือกได้
- คอนเทนเนอร์สําหรับนักพัฒนา / GitHub Codespaces หากคุณใช้ Codespaces ให้เลือกเครื่อง 8 คอร์อย่างน้อยและเปิด codespace ใน VS Code ในเครื่อง จากนั้นทําตามคู่มือการตั้งค่าในที่เก็บ
1. ส้อมและโคลน Starter-Kit (แนะนํา)
แยก 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) และสร้างรายการ สวัสดี ทุกท่าน ในพื้นที่ทํางานการพัฒนาของคุณ - ตัวแก้ไขจะเปิดขึ้น—ตรวจสอบว่ารายการทํางานตามที่คาดไว้และปรากฏเหมือนสิ่งประดิษฐ์ดั้งเดิมในพื้นที่ทํางาน
4. ปรับแต่งรหัสตามความต้องการของคุณ
ทําการเปลี่ยนแปลงเล็กน้อยก่อนและตรวจสอบตั้งแต่ต้นจนจบ:
- อัปเดตคอมโพเนนต์ตัวแก้ไข (ตัวอย่างเช่น):
Workload/app/items/HelloWorldItem/HelloWorldItemEditor.tsx - หรือนั่งร้านประเภทไอเท็มใหม่ด้วย:
./scripts/Setup/CreateNewItem.ps1 - อัปเดตรายการของคุณตามต้องการและเรียกใช้อีกครั้งในเครื่องเพื่อตรวจสอบพฤติกรรม
การพัฒนาโดยใช้ AI ช่วย
ที่เก็บนี้ทํางานได้ดีกับเครื่องมือการเขียนโปรแกรมคู่ AI ไม่ว่าคุณจะพัฒนาในเครื่องหรือใน GitHub Codespaces คุณสามารถใช้ GitHub Copilot หรือผู้ช่วย AI อื่นๆ เพื่อเร่งงานต่างๆ เช่น การแก้ไขส่วนประกอบ React อัปเดตเส้นทาง หรือสร้างนั่งร้านทดสอบ
เคล็ดลับ
ที่เก็บ Starter-Kit เปิดใช้งาน AI และมีคําแนะนํา GitHub Copilot ที่แนะนําคุณตลอดการปรับรายการ สวัสดี ทุกท่าน ให้ตรงกับความต้องการของคุณ เครื่องมือ AI อื่นๆ (เช่น Anthropic Claude) สามารถทําตามคําแนะนําเดียวกันได้ แต่ต้องกําหนดค่าให้อ่านไฟล์คําแนะนําหรือเอกสารของที่เก็บ
- ใช้ AI เพื่อร่างส่วนประกอบตัวแก้ไขรายการ/ดู แล้วปรับให้เข้ากับรูปแบบ API โฮสต์ที่ใช้ใน Starter-Kit
- ขอให้ AI สรุปรายการปริมาณงานและเสนอชุดสิทธิ์ขั้นต่ํา
- ใน Codespaces Copilot พร้อมใช้งานในเบราว์เซอร์หรือเดสก์ท็อป VS Code ทําให้เซิร์ฟเวอร์ dev ทํางานเพื่อดูการเปลี่ยนแปลงทันที
เคล็ดลับ
หากคุณสนใจที่จะดูว่าผู้อื่นสร้างอะไร ให้เปิด ตัวอย่างความสามารถในการขยาย และปรับใช้กับสภาพแวดล้อมของคุณ คุณจะพบประเภทรายการที่หลากหลายที่ช่วยคุณเริ่มต้นได้ที่นั่น
การทําซ้ําและการดีบักอย่างรวดเร็วใน Fabric
เฟรมเวิร์กความสามารถในการขยายได้รับการออกแบบมาเพื่อการพัฒนาอย่างรวดเร็ว
- เมื่อเซิร์ฟเวอร์ dev และ DevGateway ทํางานอยู่ การเปลี่ยนแปลงโค้ดในแอปของคุณจะมีผลทันทีเมื่อคุณเปิดรายการภายใน Fabric
- คุณสามารถแก้ไขข้อบกพร่องได้โดยใช้เครื่องมือสําหรับนักพัฒนาของเบราว์เซอร์ในขณะที่ปริมาณงานโฮสต์อยู่ใน Fabric iFrame
- ทําซ้ํา UI เส้นทาง และการกําหนดค่ารายการได้อย่างรวดเร็ว และตรวจสอบพฤติกรรมแบบ end-to-end ในพื้นที่ทํางาน Fabric ของคุณ
แนวทางปฏิบัติที่ดีที่สุด
- แยกที่เก็บ Starter-Kit และใช้ส้อมของคุณเป็นฐานของโครงการของคุณ
- ซิงค์ส้อมของคุณกับต้นน้ําเพื่อรับการปรับปรุง
- ตรวจสอบรายการปริมาณงานของคุณตั้งแต่เนิ่นๆ และปฏิบัติตามสิทธิ์ที่มีสิทธิ์น้อยที่สุด
- ใช้คอนเทนเนอร์ dev หรือ Codespaces สําหรับสภาพแวดล้อมที่ใช้แล้วทิ้งที่สอดคล้องกัน
- ใช้สคริปต์ที่ให้มา (Setup, StartDevServer, StartDevGateway) เพื่อทําให้การตั้งค่าและเวิร์กโฟลว์รายวันเป็นไปโดยอัตโนมัติ