แชร์ผ่าน


ใช้ Starter-Kit เพื่อเริ่มต้นใช้งาน

ใช้การเริ่มต้นใช้งานด่วนนี้เพื่อเรียกใช้ปริมาณงาน HelloWorld และทําให้สว่างขึ้นใน 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. เริ่มสภาพแวดล้อมการพัฒนา

เรียกใช้เซิร์ฟเวอร์นักพัฒนา (ส่วนหน้า + 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

คุณสามารถเข้าถึงปริมาณงานได้จากฮับปริมาณงาน (ค้นหาชื่อปริมาณงานของคุณ) หรือนําทางโดยตรง จากนั้นสร้างไอเท็ม Hello World

กระได:

  1. เปิด Fabric Workload Hub ค้นหาปริมาณงานของคุณ (เช่น 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 เรียกใช้สคริปต์