ตัวอย่าง SDK ของแอป Windows
พื้นที่เก็บข้อมูลนี้โฮสต์ตัวอย่างสำหรับ Windows App SDK ตัวอย่างฟีเจอร์ต่างๆ ที่จัดส่งใน Windows App SDK จะถูกเพิ่มไปยังที่เก็บนี้ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Windows App SDK โปรดไปที่เอกสาร Windows App SDK หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการออกแบบ Windows App SDK หรือมีส่วนร่วมในโครงการ สร้างข้อเสนอคุณลักษณะ หรือเริ่มการสนทนา โปรดไปที่หน้า Windows App SDK GitHub
รายชื่อตัวอย่าง
วงจรการใช้งานแอปและบริการระบบ
- วงจรการใช้งานของแอพ: ตัวอย่างเหล่านี้สาธิตการสร้างอินสแตนซ์ของแอพโดยใช้ AppLifecycle API ประกอบด้วยคุณสมบัติดังต่อไปนี้:
- การเปิดใช้งาน: ตัวอย่างเหล่านี้แสดงให้เห็นถึงการสนับสนุนสำหรับประเภทการเปิดใช้งานที่หลากหลาย
- การสร้างอินสแตนซ์: ตัวอย่างเหล่านี้แสดงให้เห็นถึงการรองรับอินสแตนซ์หลายอินสแตนซ์แบบเดี่ยวและแบบเลือก
- การแจ้งเตือนพลังงาน: ตัวอย่างเหล่านี้สาธิตการแจ้งเตือนสถานะพลังงาน/ระบบสำหรับการจัดการปริมาณงานของแอป
- รีสตาร์ท: ตัวอย่างเหล่านี้สาธิตการรีสตาร์ทแอปพร้อมกันด้วยอาร์กิวเมนต์การรีสตาร์ทบรรทัดคำสั่ง
- แบ่งปันเป้าหมาย: ตัวอย่างนี้สาธิตแอปที่สามารถเปิดใช้งานเป็นเป้าหมายการแชร์ได้
ข้อมูลและไฟล์
- การจัดการทรัพยากร: ตัวอย่างเหล่านี้สาธิตการจัดการทรัพยากรแอปโดยใช้ MRT Core API
การปรับใช้
- Deployment Manager: ตัวอย่างนี้สาธิตวิธีการเริ่มต้นและเข้าถึงข้อมูลการปรับใช้สำหรับรันไทม์ Windows App SDK
- โปรแกรมติดตั้ง: ตัวอย่างนี้สาธิตวิธีการเปิดตัวติดตั้ง Windows App SDK โดยไม่มีหน้าต่างคอนโซล
- ไม่รวมแพ็คเกจ: ตัวอย่างเหล่านี้สาธิตการกำหนดค่าเริ่มต้นอัตโนมัติด้วยแพ็คเกจ Windows App SDK จากแอปพลิเคชันที่ไม่ใช่ MSIX (ไม่มีแพ็คเกจ)
การพึ่งพาแบบไดนามิก
- DirectX: ตัวอย่างนี้สาธิตวิธีใช้ Dynamic Dependencies API เพื่อโหลดแพ็คเกจเฟรมเวิร์ก DirectX Runtime MSIX แบบไดนามิก
กราฟิก
- การแสดงข้อความ: ตัวอย่างนี้คือแกลเลอรีของ DWriteCore API ที่สาธิตการแสดงข้อความ
การแจ้งเตือน
- การแจ้งเตือนแบบพุช: นี่คือแอปตัวอย่างที่แสดงการแจ้งเตือนแบบพุช
- การแจ้งเตือนของแอป: นี่คือแอปตัวอย่างที่แสดงการแจ้งเตือนของแอป
ส่วนประกอบรันไทม์
- การควบคุมแบบกำหนดเอง: ตัวอย่างนี้แสดงวิธีการสร้าง Windows Runtime Component ใน C# ด้วยการควบคุม WinUI แบบกำหนดเอง
ส่วนต่อประสานผู้ใช้และการป้อนข้อมูล
- Windowing: ตัวอย่างนี้สาธิตวิธีจัดการหน้าต่างแอปโดยใช้ Windowing API
- แกลเลอรีอินพุตและองค์ประกอบของ Windows: คอลเลกชันตัวอย่างนี้นำเสนอ Microsoft.UI.Composition และ Microsoft.UI.Input API
- แกลเลอรี WinUI 3: นี่คือแอปตัวอย่างที่แสดงการทำงานของส่วนควบคุม WinUI 3 ทั้งหมด
ความต้องการ
ตัวอย่าง Windows App SDK มีข้อกำหนดของระบบดังต่อไปนี้:
Windows 10 เวอร์ชัน 1809 (รุ่น 17763) หรือใหม่กว่า
Visual Studio 2022 หรือ Visual Studio 2019 เวอร์ชัน 16.9 หรือใหม่กว่า โดยมีปริมาณงานและส่วนประกอบต่อไปนี้:
- การพัฒนาแพลตฟอร์ม Windows สากล
- .NET Desktop Development (จำเป็นแม้ว่าคุณจะสร้างแอป C++ Win32 เท่านั้น)
- การพัฒนาเดสก์ท็อปด้วย C++ (จำเป็นแม้ว่าคุณจะสร้างแอป .NET เท่านั้น)
- Windows SDK เวอร์ชัน 2004 (รุ่น 19041) หรือใหม่กว่า สิ่งนี้ถูกติดตั้งด้วย Visual Studio ตามค่าเริ่มต้น
การสร้างตัวอย่าง .NET C# ด้วย Windows App SDK 1.1 ยังต้องใช้ .NET SDK เวอร์ชันใดเวอร์ชันหนึ่งต่อไปนี้หรือใหม่กว่า:
- 6.0.202
- 6.0.104
- 5.0.407
- 5.0.213
โปรดดูเอกสารเกี่ยวกับข้อกำหนดของระบบและเครื่องมือสำหรับการพัฒนาแอป Windows สำหรับรายการข้อกำหนดโดยละเอียดสำหรับการพัฒนาแอปด้วย Windows App SDK
โดยใช้ตัวอย่าง
หากต้องการใช้ตัวอย่างกับ Git ให้โคลนพื้นที่เก็บข้อมูล WindowsAppSDK-Samples โดยการเรียกใช้ git clone https://github.com/microsoft/WindowsAppSDK-Samples.git
จากพร้อมท์คำสั่ง จากนั้นคุณสามารถนำทางไปยังไดเร็กทอรีของตัวอย่างและเปิดไฟล์โซลูชันใน Visual Studio
วิธีที่ง่ายที่สุดในการใช้ตัวอย่างเหล่านี้โดยไม่มี Git คือการดาวน์โหลดไฟล์ ZIP เลือก ดาวน์โหลด ZIP จากดรอปดาวน์การดาวน์โหลด คลายซิปไฟล์เก็บถาวรทั้งหมด และเปิดตัวอย่างใน Visual Studio
การกำหนดเวอร์ชันตัวอย่าง
ตัวอย่างจะได้รับการอัปเดตด้วย Windows App SDK รุ่น GA สาขา main
ประกอบด้วยตัวอย่างล่าสุด ซึ่งอาจรวมถึงคุณลักษณะการทดลองหรือการแสดงตัวอย่างด้วย สาขาการเผยแพร่เฉพาะจะมีชื่อว่า release/xy
และมีตัวอย่างที่อ้างอิงถึงเวอร์ชัน GA ที่สอดคล้องกันของ Windows App SDK ปัจจุบันที่เก็บนี้มีสาขาการเผยแพร่ต่อไปนี้:
- ปล่อย/1.0
- ปล่อย/0.8
- ปล่อย/0.5
มีส่วนร่วม
ตัวอย่างเหล่านี้จัดทำโดยทีมงานฟีเจอร์ และเรายินดีรับฟังความคิดเห็นของคุณเกี่ยวกับปัญหาและข้อเสนอแนะสำหรับตัวอย่างใหม่ เราขอแนะนำให้คุณยื่นประเด็นใหม่สำหรับข้อเสนอแนะหรือคำถาม!
ผู้เขียนตัวอย่างควรปฏิบัติตามแนวทางตัวอย่างเพื่อเริ่มพัฒนาตัวอย่างของตน สำหรับตัวอย่าง Windows App SDK ที่ใช้ WinUI ให้ใช้เทมเพลตตัวอย่าง ไฟล์ VSIX พร้อมให้ดาวน์โหลดในหน้าเผยแพร่ Github ที่นี่
โครงการนี้ได้นำหลักจรรยาบรรณของ Microsoft Open Source มาใช้ สำหรับข้อมูลเพิ่มเติม โปรดดูคำถามที่พบบ่อยเกี่ยวกับหลักจรรยาบรรณหรือติดต่อ [email protected] หากมีคำถามหรือความคิดเห็นเพิ่มเติม
เมื่อเพิ่มแอปตัวอย่างใหม่แล้ว นักพัฒนา Microsoft จะต้องพิจารณาอัปเดตไปป์ไลน์ Aggregator ภายในเป็น:
- เปิดใช้งานการสร้างแอปตัวอย่างใหม่เป็นประจำ
- เพิ่มกรณีการทดสอบใหม่ให้กับไดรเวอร์ทดสอบ SampleTests TAEF ที่มีอยู่เพื่อตรวจสอบการเปิดใช้งานแอปตัวอย่างที่ประสบความสำเร็จเป็นประจำกับ Windows App SDK เวอร์ชันล่าสุด
โปรดดูเอกสารประกอบบนพื้นที่เก็บข้อมูล Aggregator ภายในสำหรับคำแนะนำใน BuildSampleApps และ TestSampleApps Stages