نماذج Windows App SDK
يستضيف هذا المستودع نماذج لـ Windows App SDK. ستتم إضافة نماذج للميزات المتنوعة التي يتم شحنها في Windows App SDK إلى هذا المستودع. لمزيد من المعلومات حول Windows App SDK، تفضل بزيارة وثائق Windows App SDK. لمعرفة المزيد حول تصميم Windows App SDK أو للمساهمة في المشروع أو تقديم مقترحات الميزات أو بدء المناقشات، قم بزيارة صفحة Windows App SDK GitHub.
قائمة العينات
دورة حياة التطبيق وخدمات النظام
- دورة حياة التطبيق: توضح هذه العينات تثبيت التطبيق باستخدام واجهات برمجة تطبيقات AppLifecycle. وهي تشمل الميزات التالية:
- التنشيط: توضح هذه العينات الدعم لأنواع التنشيط الغنية.
- المثيل: توضح هذه العينات دعم المثيل الفردي والانتقائي المتعدد.
- إشعارات الطاقة: توضح هذه العينات إشعارات حالة الطاقة/النظام لإدارة حمل عمل التطبيق.
- إعادة التشغيل: توضح هذه العينات إعادة تشغيل التطبيق بشكل متزامن باستخدام وسيطات إعادة تشغيل سطر الأوامر.
- هدف المشاركة: يوضح هذا النموذج تطبيقًا يمكن تنشيطه كهدف مشاركة.
البيانات والملفات
- إدارة الموارد: توضح هذه العينات إدارة موارد التطبيق باستخدام واجهات برمجة التطبيقات MRT Core.
النشر
- مدير النشر: يوضح هذا النموذج كيفية تهيئة معلومات النشر والوصول إليها لوقت تشغيل Windows App SDK.
- المثبت: يوضح هذا النموذج كيفية تشغيل مثبت Windows App SDK بدون نافذة وحدة التحكم.
- غير معبأ: توضح هذه العينات التهيئة التلقائية مع حزمة Windows App SDK من تطبيق غير تابع لـ MSIX (غير معبأ).
التبعيات الديناميكية
- DirectX: يوضح هذا النموذج كيفية استخدام واجهة برمجة تطبيقات التبعيات الديناميكية لتحميل حزمة إطار عمل DirectX Runtime MSIX ديناميكيًا.
الرسومات
- عرض النص: هذا النموذج عبارة عن معرض لواجهات برمجة التطبيقات DWriteCore التي توضح عرض النص.
إشعارات
- إشعارات الدفع: هذا نموذج لتطبيق يعرض إشعارات الدفع.
- إشعارات التطبيقات: هذا نموذج لتطبيق يعرض إشعارات التطبيقات.
مكونات وقت التشغيل
- عناصر التحكم المخصصة: يوضح هذا النموذج كيفية تأليف مكون Windows Runtime في C# باستخدام عناصر تحكم WinUI المخصصة.
واجهة المستخدم والإدخال
- Windowing: يوضح هذا النموذج كيفية إدارة نوافذ التطبيق باستخدام Windowing APIs.
- معرض الإدخال والتركيب في Windows: تعرض هذه المجموعة من العينات واجهات برمجة تطبيقات Microsoft.UI.Composition وMicrosoft.UI.Input.
- معرض WinUI 3: هذا نموذج لتطبيق يعرض كافة عناصر التحكم في WinUI 3 أثناء العمل.
متطلبات
تحتوي نماذج Windows App SDK على متطلبات النظام التالية:
Windows 10، الإصدار 1809 (النسخة 17763) أو الأحدث.
Visual Studio 2022 أو Visual Studio 2019 الإصدار 16.9 أو الأحدث، مع أحمال العمل والمكونات التالية:
- تطوير منصة ويندوز العالمية
- .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.
إصدارات العينات
سيتم تحديث العينات بإصدارات GA الخاصة بـ Windows App SDK. يتضمن الفرع main
أحدث العينات، والتي قد تتضمن أيضًا ميزات تجريبية أو معاينة. تتم تسمية فروع الإصدار المحددة release/xy
وتحتوي على عينات تشير إلى إصدار GA المطابق من Windows App SDK. يتضمن هذا المستودع حاليًا فروع الإصدار التالية:
- الإصدار/1.0
- الإصدار/0.8
- الإصدار/0.5
المساهمة
يتم توفير هذه العينات بواسطة فرق الميزات، ونحن نرحب بمساهمتك بشأن المشكلات والاقتراحات الخاصة بالعينات الجديدة. نحن نشجعك على تقديم مشكلة جديدة لأية تعليقات أو أسئلة!
يجب على مؤلفي العينات اتباع إرشادات العينات للبدء في تطوير عيناتهم. بالنسبة لنماذج Windows App SDK المستندة إلى WinUI، استخدم نماذج القوالب. يتوفر ملف VSIX للتنزيل في صفحة إصدارات Github هنا.
اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة المتداولة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.
بمجرد إضافة نموذج تطبيق جديد، يجب على مطوري Microsoft مراعاة تحديث مسار التجميع الداخلي إلى:
- تمكين إنشاء التطبيق النموذجي الجديد بانتظام.
- أضف حالة اختبار جديدة إلى برنامج تشغيل اختبار SampleTests TAEF الموجود للتحقق بانتظام من التشغيل الناجح لنموذج التطبيق مقابل أحدث إصدار من Windows App SDK.
راجع الوثائق الموجودة في مستودع التجميع الداخلي للحصول على الإرشادات، في مرحلتي BuildSampleApps وTestSampleApps.