project system

نظام مشروع .NET للاستوديو المرئي

يطلق	يبني	امتثال	نشر	التوطين
رئيسي

يحتوي هذا المستودع على نظام مشروع .NET لـ Visual Studio المكتوب أعلى إطار عمل نظام المشروع المشترك (CPS). في Visual Studio 2017 و Visual Studio 2019 و Visual Studio 2022 ، يتم استخدام نظام المشروع هذا لأنواع المشروع .NET Core [SDK] (C# و F# و Visual Basic) والمشاريع المشتركة (C# و Visual Basic). على المدى الطويل ، سيكون نظام المشروع هذا أساسًا لكل أنواع مشاريع C# و F# و Visual Basic. للحصول على قائمة باختلافات الميزات بين أنظمة المشروع ، راجع مقارنة الميزات.

أنظمة مشروع C# و Visual Basic Visual ( CSPROJ.DLL و MSVBPRJ.DLL ) تم شحنها لأول مرة مع Visual Studio .NET في عام 2002. لقد خدمونا جيدًا ولكنهم:

• الأصلي والقائم على كوم
• خيوط واحدة ومرتبطة بخيط واجهة المستخدم
• من الصعب تمديدها خارج التجميع من خلال استخدام <ProjectTypeGuids> وأنواع الفرعية (النكهات)
• تطبيقات منفصلة لمشاريع C# و Visual Basic

نظام مشروع .NET الحالي هو:

• تم إدارتها وإدارتها على أساس الواجهة
• متعدد الخيوط وقابل للتطوير وسريع الاستجابة
• من السهل تمديد وتكوين عبر إطار التمديد المدارة (MEF). يمكن أن تساهم العديد من الأطراف ، بما في ذلك الأطراف الثالثة ، في نظام مشروع واحد.
• تطبيق واحد لمشاريع C# و F# و Visual Basic

ما هو نظام المشروع؟

يجلس نظام المشروع بين ملف مشروع على القرص (على سبيل المثال ، .csproj و .vbproj ) وميزات Visual Studio المختلفة بما في ذلك ، على سبيل المثال لا الحصر ، Explorer ، المصممين ، الأخطاء ، خدمات اللغة ، البناء والنشر. يحدث جميع التفاعل تقريبًا مع الملفات الموجودة في ملف المشروع من خلال نظام المشروع.

هناك العديد من التقنيات التي تتجمع لتعويض نظام مشروع .NET:

• يوفر MSBUILD تنسيق المحرك والتنسيق.
• يوفر SDK واجهة سطر الأوامر لبناء وتشغيل وتفاعل مع مشاريع .NET ، إلى جانب مهام وأهداف MSBuild اللازمة.
• يوفر نظام المشروع المشترك لبنات البناء الأساسية لنظام المشروع بما في ذلك (على سبيل المثال لا الحصر) لشجرة المشروع وتنسيق البناء والتصحيح وتكامل الاستوديو البصري.
• يوفر Roslyn دعم اللغة C# و Visual Basic بما في ذلك المترجمين ، والانtrominsense ، و refactorings ، والمحللون ، وإصلاحات التعليمات البرمجية.
• يوفر Visual F# Tools دعم اللغة F#.

كيف أقوم ببناء المستودع؟

تم بناء هذا المستودع على .NET Framework ويتطلب إصدار .NET Framework من MSBuild للبناء بنجاح. بالإضافة إلى ذلك ، هناك اعتماد على Visual Studio SDK حيث يتم تجميع نظام مشروع .NET كملحق Visual Studio للنشر في Visual Studio.

فيما يلي كيفية الحصول على المكونات اللازمة:

• تثبيت أحدث استوديو Visual
  • حدد أعباء العمل هذه أثناء التثبيت:
    • .NET Desktop Build Tools
    • تطوير تمديد الاستوديو البصري

بعد تثبيت المكونات الضرورية ، ما عليك سوى تشغيل ملف الدُفعات build.cmd بجذر المستودع. سيؤدي ذلك إلى بناء واختبار وتجميع المستودع بشكل مناسب.

build.cmd أعلام

يتم إعادة توجيه جميع وسيطات سطر الأوامر إلى Build.CMD إلى MSBuild. هناك بعض الخصائص الخاصة التي أنشأناها لبناء هذا الريبو.

• للمشاريع:
  • /p:SrcProjects=[true or false] : يتضمن المشاريع داخل دليل SRC . الافتراضي: true
  • /p:TestProjects=[true or false] : يتضمن المشاريع ضمن دليل الاختبارات . الافتراضي: true
  • /p:SetupProjects=[true or false] : يتضمن المشاريع ضمن دليل الإعداد . الافتراضي: true
• للأهداف:
  • /p:Restore=[true or false] : يدير هدف الاستعادة لاكتساب تبعيات المشروع. الافتراضي: true
  • /p:Build=[true or false] : يدير هدف البناء لتجميع المشاريع في التجميعات. الافتراضي: true
  • /p:Rebuild=[true or false] : يدير هدف إعادة البناء الذي ينظف ويبني المشاريع. الافتراضي: false
  • /p:Test=[true or false] : يقوم بتشغيل هدف الاختبار لتنفيذ مشاريع اختبار Xunit. الافتراضي: true
  • /p:Pack=[true or false] : يقوم بتشغيل هدف الحزمة لتجميع المشاريع في حزم nuget. الافتراضي: true

كيف يمكنني الانخراط والمساهمة؟

نرحب بكم لتجربة الأشياء ، وملفات المشكلات ، وتقديم طلبات الميزات ، والانضمام إلينا في محادثات التصميم. إذا كنت تبحث عن شيء ما للعمل عليه ، ألق نظرة على مشكلات المساعدة المطلوبة للحصول على مكان رائع للبدء. أيضا ، تحقق من دليل المساهمة لدينا.

اعتمد هذا المشروع مدونة قواعد سلوك مقتبسة من العهد المساهم لتوضيح السلوك المتوقع في مجتمعنا. تم اعتماد مدونة السلوك هذه من قبل العديد من المشاريع الأخرى. لمزيد من المعلومات ، راجع مدونة قواعد سلوك المساهمين.

علامات تجارية

قد يحتوي هذا المشروع على علامات تجارية أو شعارات للمشاريع أو المنتجات أو الخدمات. يخضع الاستخدام المعتمد للعلامات التجارية أو الشعارات Microsoft ويجب أن يتبعوا إرشادات Microsoft التجارية والعلامة التجارية. يجب ألا يسبب استخدام العلامات التجارية Microsoft أو الشعارات في إصدارات معدلة من هذا المشروع الارتباك أو يعني رعاية Microsoft. يخضع أي استخدام للعلامات التجارية أو الشعارات من طرف ثالث لسياسات تلك الطرف الثالث.

جمع البيانات

قد يقوم البرنامج بجمع معلومات عنك واستخدامك للبرنامج وإرساله إلى Microsoft. قد تستخدم Microsoft هذه المعلومات لتوفير الخدمات وتحسين منتجاتنا وخدماتنا. يمكنك إيقاف تشغيل القياس عن بعد كما هو موضح في "برنامج تحسين تجربة عملاء Visual Studio". هناك أيضًا بعض الميزات في البرنامج التي قد تمكنك و Microsoft من جمع البيانات من مستخدمي التطبيقات الخاصة بك. إذا كنت تستخدم هذه الميزات ، فيجب عليك الامتثال للقانون المعمول به ، بما في ذلك تقديم إشعارات مناسبة لمستخدمي التطبيقات الخاصة بك مع نسخة من بيان خصوصية Microsoft. يقع بيان الخصوصية الخاص بنا على https://go.microsoft.com/fwlink/؟linkid=824704. يمكنك معرفة المزيد حول جمع البيانات واستخدامها في وثائق المساعدة وبيان الخصوصية لدينا. يعمل استخدامك للبرنامج كموافقتك على هذه الممارسات.