dmcs - عبر الإنترنت في السحابة

برنامج:

اسم

mcs - مترجم أحادي C #

موجز

MCS [خيار] [ملفات المصدر]

الوصف

mcs هو مترجم Mono C # ، وهو تطبيق لمواصفات لغة ECMA-334.
يمكنك تمرير خيار واحد أو أكثر لقيادة المترجم ومجموعة من الملفات المصدر. إضافي
يمكن توفير الخيارات أو الوسائط في ملف الرد. تتم الإشارة إلى ملفات الاستجابة بواسطة
إلحاق الرمز @ باسم ملف الاستجابة.

• MCS يتم استخدام برنامج التحويل البرمجي للتجميع مقابل أحدث إصدار من Mono Base Class Library و
تنفذ بالكامل مواصفات C # 1.0 و 2.0 و 3.0 و 4.0.

راجع قسم الحزم لمزيد من المعلومات.

يقبل برنامج التحويل البرمجي Mono C # نفس خيارات سطر الأوامر التي يستخدمها برنامج التحويل البرمجي لـ Microsoft C #
يفعل. يمكن أن تبدأ هذه الخيارات بشرطة مائلة أو شرطة (/ المحددة هي نفسها التي تم التحقق منها).
بالإضافة إلى ذلك ، يتم دعم بعض الخيارات المشابهة لـ GNU ، تلك التي تبدأ بـ "-". كل MCS محددة
تتوفر العلامات غير المتوفرة في مترجم Microsoft C # فقط مع الامتداد
خيارات نمط جنو.

يجب أن تنتهي ملفات المصدر C # بامتداد ".cs". يتطلب تجميع شفرة المصدر C #
يتم توفير جميع الملفات التي تشكل مكتبة أو وحدة نمطية أو ملف تنفيذي في الأمر
خط. لا يوجد دعم للترجمة الجزئية. لتحقيق فوائد جزئية
التجميع ، يجب عليك تجميع البرامج في التجميعات الخاصة بهم ، والرجوع إليها لاحقًا
لهم بعلامة "-r".

يقوم برنامج التحويل البرمجي Mono C # بإنشاء صور (ملفات exe.) تحتوي على كود بايت CIL يمكن أن يكون
يتم تنفيذه بواسطة أي نظام يطبق آلة افتراضية Common Language Infrastructure
مثل محرك Microsoft .NET runtime على Windows أو محرك Mono runtime على نظام Unix
الأنظمة. لا ترتبط الملفات التنفيذية بوحدة معالجة مركزية معينة أو نظام تشغيل.

يشير المحول البرمجي Mono C # بشكل افتراضي إلى ثلاثة تجميعات فقط: mscorlib.dll و System.dll
و System.Xml.dll. إذا كنت تريد الرجوع إلى مكتبات إضافية ، فيجب عليك تحديدها يدويًا
باستخدام خيار سطر الأوامر -pkg: أو خيار سطر الأوامر -r:. بدلا من ذلك إذا
تريد الحصول على جميع مكتبات النظام ، يمكنك استخدام سطر الأوامر -pkg: dotnet
الخيار.

OPTIONS

--حول
يعرض معلومات حول مترجم Mono C #

- addmodule: MODULE1 [، MODULE2]
يشمل الوحدات المحددة في التجميع الناتج. يتم إنشاء الوحدات بواسطة
استدعاء المترجم باستخدام الخيار -target: module

-التحقق، تم فحصه +
يضبط وضع الترجمة الافتراضي على "محدد". هذا يجعل كل العمليات الحسابية
محدد (الافتراضي غير محدد).

-التحقق-
يضبط وضع الترجمة الافتراضي على "غير محدد". هذا يجعل كل الرياضيات
العمليات التي لم يتم التحقق منها (هذا هو الإعداد الافتراضي).

-clscheck- ، -clscheck +
تعطيل أو تمكين عمليات التحقق من مواصفات اللغة العامة (CLS) (يتم تمكينها
بشكل افتراضي).

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

-صفحة الشفرة: ID
يحدد صفحة التعليمات البرمجية المستخدمة في معالجة ملفات الإدخال من النقطة التي تكون عليها
المحدد في. بشكل افتراضي ، ستتم معالجة الملفات المعتمدة على البيئة
صفحة التعليمات البرمجية الأصلية. سيكتشف المترجم تلقائيًا أيضًا ملفات Unicode التي
لها علامة بايت مضمنة في البداية.

الترميزات الشائعة الأخرى هي 28591 (لاتيني 1) و 1252 (ISO-8859-1) و 65001 (UTF-8).

يدعم MCS اثنين من الاختصارات: يمكن استخدام "utf8" لتحديد utf-8 بدلاً من
باستخدام التشفير 65001 و "إعادة التعيين" يستعيد المعالجة التلقائية لصفحات التعليمات البرمجية.
هذه الاختصارات غير متوفرة في مترجم Microsoft.

-تعريف: SYMLIST ، - د: SYMLIST
يعرّف الرمز المدرج بواسطة القائمة المفصولة بفاصلة منقوطة SYMLIST SYMBOL. هذا
يمكن اختباره في الكود المصدري بواسطة المعالج المسبق ، أو يمكن استخدامه بالطرق
التي تم تمييزها باستخدام السمة الشرطية.

-ديبوغ ، -ديبوغ +
توليد معلومات التصحيح. للحصول على تتبعات المكدس بمعلومات التصحيح ،
تحتاج إلى استدعاء وقت التشغيل الأحادي بعلامة "--debug". التصحيح
يتم تخزين المعلومات في ملف MDB موجود في نفس مجلد الإخراج الذي تم إنتاجه
التجمع.

-ديبغ-
لا تقم بإنشاء معلومات تصحيح الأخطاء.

-delaysign +
قم فقط بتضمين المفتاح العام strongname في التجميع. يجب أن يكون التوقيع الفعلي
يتم إجراؤه في مرحلة لاحقة باستخدام أداة SN. هذا مفيد لحماية المفتاح الخاص
أثناء التطوير. لاحظ أنه لا يمكن إجراء توقيع التأخير إلا باستخدام مفتاح قوي
ملف (ليس حاوية مفتاح). الخيار مكافئ لتضمين [التجميع:
AssemblyDelaySign (صحيح)] في شفرة المصدر الخاصة بك. خيار المترجم له الأسبقية
على الصفات.

-تأخر-
تقصير. Strongname (تسجيل) التجميع باستخدام ملف مفتاح الاسم القوي (أو
حاوية). الخيار مكافئ لتضمين [التجميع: AssemblyDelaySign
(خطأ)] في شفرة المصدر الخاصة بك. الخيار المترجم له الأسبقية على السمات.

-doc: FILE
يستخرج وثائق C # / XML من الكود المصدري ويخزنها في ملف
ملف.

-تقرير خطأ
يتم تجاهل هذه العلامة من قبل مترجم Mono C # وهي موجودة فقط للسماح لـ MCS بأن تكون
تستخدم كبديل CSC لـ msbuild / xbuild.

--مميت
يستخدم هذا لتصحيح المترجم. هذا يجعل خطأ انبعاث ملف
الاستثناء الذي يمكن أن يكتشفه مصحح الأخطاء.

-ملف
يتم تجاهل هذه العلامة من قبل مترجم Mono C # وهي موجودة فقط للسماح لـ MCS بأن تكون
تستخدم كبديل CSC لـ msbuild / xbuild.

-fullpaths
أي خطأ في التعليمات البرمجية المصدر أو تحذير صادر عن المترجم يتضمن اسم الملف فقط بواسطة
تقصير. يتسبب هذا الخيار في قيام المحول البرمجي بإصدار مسار ملف مطلق بدلاً من ذلك.

-keyfile: KEYFILE
Strongname (تسجيل) تجميع الإخراج باستخدام زوج المفاتيح الموجود في المحدد
ملف مفتاح الاسم القوي (snk). مطلوب زوج مفاتيح كامل بشكل افتراضي (أو عند استخدام
التأخير-). يمكن استخدام ملف يحتوي على المفتاح العام فقط مع delaysign +. ال
الخيار يكافئ تضمين [assembly: AssemblyKeyFile ("KEYFILE")] في ملف
مصدر الرمز. الخيار المترجم له الأسبقية على السمات.

-حاوية المفاتيح: حاوية
Strongname (تسجيل) تجميع الإخراج باستخدام زوج المفاتيح الموجود في المحدد
حاوية. لاحظ أنه يتم تجاهل delaysign + عند استخدام حاويات المفاتيح. الخيار هو
بما يعادل تضمين [assembly: AssemblyKeyName ("CONTAINER")] في مصدرك
شفرة. الخيار المترجم له الأسبقية على السمات.

الإصدار: TEXT
يحدد الخيار إصدار اللغة المراد استخدامها. مجموعة الميزات هي
مختلفة في كل إصدار C #. يمكن استخدام هذا المفتاح لإجبار المترجم على
السماح فقط بمجموعة فرعية من الميزات. القيم الممكنة هي:

الترتيب
إرشاد المترجم لاستخدام أحدث إصدار. المكافئ هو حذف
التبديل (هذا افتراضيًا وفقًا لمواصفات لغة C # 4.0).

ISO-1 تقييد المترجم لاستخدام الميزات القياسية ISO الأولى فقط. استخدام
ميزات مثل الأدوية الجنسية والفئات الثابتة والأساليب المجهولة ستؤدي إلى
خطأ.

ISO-2 تقييد المحول البرمجي لاستخدام ميزات ISO القياسية الثانية فقط. هذا
يسمح باستخدام الأدوية الجنيسة والفئات الثابتة والمكررات والأساليب المجهولة
على سبيل المثال.

3 تقييد المترجم لاستخدام الميزات المتوفرة فقط في C # 3.0 (a
مجموعة شاملة من ISO-1 و ISO-2).

4 تقييد المترجم لاستخدام الميزات المتوفرة في C # 4.0 فقط
تخصيص.

تجريبي
لتمكين الميزات غير المستقرة من الإصدارات القادمة للغة.

لاحظ أن هذه العلامة تقيد فقط ميزات اللغة المتوفرة لـ
مبرمج. يمكن التحكم في إصدار التجميعات المنتجة باستخدام SDK الخيار.

-lib: قائمة المسار
كل مسار محدد في القائمة المفصولة بفواصل سيوجه المحول البرمجي للبحث
للمكتبات في هذا المسار المحدد.

-L PATH
يوجه المترجم للبحث عن مكتبات في المسار المحدد. مسارات متعددة
يمكن توفيرها باستخدام الخيار عدة مرات.

-الفئة الرئيسية
يخبر المترجم الذي يحتوي على CLASS نقطة الدخول. مفيد عندما تكون كذلك
تجميع عدة فصول بطريقة رئيسية.

-نوستدليب ، -نوستدليب +
استخدم هذه العلامة إذا كنت تريد تجميع المكتبة الأساسية. هذا يجعل المترجم
تحميل الأنواع الداخلية من التجميع الجاري تجميعه.

-noconfig ، -noconfig +
تعطيل تكوين المحول البرمجي الافتراضي ليتم تحميله. المترجم افتراضيا
يحتوي على مراجع لتجمعات النظام.

-علم: قائمة التحذير
يجعل المحول البرمجي يتجاهل التحذيرات المحددة في القائمة المفصولة بفواصل WARNLIST>

-تحسين ، -تحسين + ، -تحسين-
يتحكم في تحسينات إنشاء كود المترجم على الكود. باستخدام-Optimize أو
-تحسين + سيؤدي إلى تشغيل التحسينات ، -تحسين- سيوقف تشغيله. الافتراضي في
mcs هو تحسين-. يمكن مزج الخيار مع -debug ولكن للحصول على أفضل تصحيح للأخطاء
تجربة فمن المستحسن ترك الخيارات معطلة.

- خارج: FNAME ، -o اسم الملف
يسمي ملف الإخراج الذي سيتم إنشاؤه.

- نقول
تستخدم لقياس الأداء. سيقوم المترجم بتحليل ملفات الإدخال الخاصة به فقط.

-pkg: package1 [، packageN]
التجميعات المرجعية للحزم المحددة.

سيستدعي المترجم pkg-config --libs في مجموعة الحزم المحددة في
سطر الأوامر للحصول على مكتبات وأدلة لتجميع التعليمات البرمجية.

يستخدم هذا عادةً مع مكونات الطرف الثالث ، مثل هذا:

$ MCS -pkg: gtk-Sharp demo.cs

-pkg: دوت نت
سيوجه هذا المترجم إلى الرجوع إلى مكتبات النظام. *
متوفر في تثبيت نموذجي لإطار عمل dotnet ، لاحظ أن هذا يحدث
لا تشمل جميع مكتبات Mono ، فقط النظام. * منها. هذا ال
اختصار مناسب لتلك التعليمات البرمجية.

-منصة: ARCH
تستخدم لتحديد النظام الأساسي المستهدف. القيم الممكنة هي:
anycpu32bitpreferred أو arm أو x86 أو x64 أو itanium. الخيار الافتراضي هو anycpu.

-المصدر: RESOURCE [، ID]
يتضمّن في ملف المورد المحدد. يمكن استخدام المعرف الاختياري لإعطاء رقم مختلف
اسم المورد. إذا لم يتم تحديده ، فسيكون اسم المورد هو اسم الملف.

-Linkresource: RESOURCE [، ID]
روابط إلى المورد المحدد. يمكن استخدام المعرف الاختياري لإعطاء اسم لملف
مورد مرتبط.

-r: ASSEMBLY1 [، ASSEMBLY2] ، -مرجع ASSEMBLY1 [، ASSEMBLY2]
مرجع التجميعات المسماة. استخدم هذا لاستخدام الفئات من التجميع المسمى في
برنامجك. سيتم تحميل التجميع من أي من دليل النظام حيث
جميع التجميعات تعيش ، أو من المسار المحدد صراحة مع الخيار -L.

يمكنك أيضًا استخدام فاصلة منقوطة لفصل التجميعات بدلاً من الفاصلة.

-المرجع: ALIAS = ASSEMBLY
دعم مرجع الاسم المستعار الخارجي لـ C #.

إذا كان لديك تجميعات مختلفة توفر نفس الأنواع ، فإن الاسم المستعار الخارجي
يتيح لك الدعم تقديم أسماء يمكن لبرنامجك استخدامها لإخبار هؤلاء
appart. سيتم عرض الأنواع من ASSEMBLY على أنها ALIAS ، ثم على مصدر C #
كود ، ما عليك القيام به:

الاسم المستعار الخارجي ALIAS ؛
لإحضاره إلى مساحة الاسم الخاصة بك. على سبيل المثال ، للتعامل مع مكتبتين للرسومات
التي تحدد "Graphics.Point" ، واحدة في "OpenGL.dll" وواحدة في "Postscript.dll" ، أنت
سوف يستدعي المترجم مثل هذا:

mcs -r: Postscript = Postscript.dll -r: OpenGL = OpenGL.dll

وفي كود المصدر الخاص بك ، ستكتب:

اسم مستعار خارجي بوستسكريبت ؛
الاسم المستعار الخارجي OpenGL ؛

فئة X {
// هذا هو Graphics.Point من Postscrip.dll
Postscript.Point p = Postscript.Point () الجديدة ؛

// هذا هو Graphics.Point من OpenGL.dll
OpenGL.Point p = new OpenGL.Point () ؛
}

-العودة: نمط ، --يعيد تنفيذ نمط
هل تجميع متكرر باستخدام النمط المحدد. في يونكس ، سوف تكون القشرة
أداء globbing ، لذلك قد ترغب في استخدامه على النحو التالي:

$ mcs -recurse: "*. cs"

-sdk: الإصدار
يستخدم لتحديد إصدار تجميعات مكتبة الفئة الأساسية المستخدمة في التحويل البرمجي.
القيم المحددة مسبقًا التالية صالحة: 2 ، 4 (افتراضي) بالإضافة إلى أي قيمة مخصصة.
رقم الإصدار المحدد مسبقًا يعني القيمة المخصصة التي سيحاول mcs تحديدها
البحث عن مكتبات الفئة الأساسية في موقع التثبيت الأحادي PREFIX / lib / mono / .

--الصدف
يبدأ المترجم في الوضع التفاعلي ، مما يوفر قشرة C # للتعليمات و
التعبيرات. الاختصار هو استخدام ملف CSHARP الأمر مباشرة.

--تتبع المكدس
يولد تتبع مكدس في وقت الإبلاغ عن الخطأ ، وهو مفيد لتصحيح أخطاء
مترجم.

-الهدف: النوع ، -t: النوع
تستخدم لتحديد الهدف المطلوب. القيم الممكنة هي: exe (عادي
قابل للتنفيذ) ، winexe (نماذج Windows القابلة للتنفيذ) ، مكتبة (مكتبات المكونات) و
وحدة (مكتبة جزئية).

- الطابع الزمني
علامة تصحيح أخرى. يُستخدم لعرض الأوقات في نقاط مختلفة في
عملية التجميع.

-غير آمنة ، -غير آمن +
تمكن من تجميع التعليمات البرمجية غير الآمنة.

-v تصحيح. يقوم بتشغيل تحليل yacc المطول.

--الإصدار
يظهر نسخة المترجم.

- تحذير ، - تحذير +
سيتم الإبلاغ عن جميع تحذيرات المجمعين على أنها أخطاء.

-خطأ تحذير: W1 ، [Wn] ، -warnaserror +: W1، [Wn]
يتعامل مع تحذير أو أكثر من تحذيرات المترجم على أنها أخطاء.

-خطأ تحذير-: W1، [Wn]
يعيّن تحذيرًا واحدًا أو أكثر للمترجم ليتم تهديده دائمًا كتحذيرات. يصبح
مفيد عند استخدامه مع -warnaserror.

- تحذير: المستوى
يضبط مستوى التحذير. 0 هو أدنى مستوى تحذير ، و 4 هو أعلى مستوى. ال
الافتراضي هو 4.

-win32res: FILE
تحديد ملف مورد Win32 (.res) ليتم تجميعه في التجميع الناتج.

-win32icon: FILE
يرفق الرمز المحدد في FILE على الإخراج في التجميع الناتج.

-- استخدم هذا لإيقاف تحليل الخيار ، والسماح بتمرير المعلمات ذات المظهر الخيار
في سطر الأوامر.

لأي لبس مكتبات

عند الرجوع إلى التجميع ، إذا كان اسم التجميع هو المسار ، فسيحاول المترجم
لتحميل التجميع المحدد في المسار. إذا لم يحدث ذلك ، فسيحاول المترجم
تحميل التجميع من الدليل الحالي ، دليل قاعدة المترجم وإذا كان
لم يتم العثور على التجميع في أي من تلك الأماكن في الدلائل المحددة كوسيطات لـ
-lib: وسيطة الأمر.

يستخدم المترجم مسار المكتبة لتحديد موقع المكتبات ، ويمكنه الرجوع إلى المكتبات
من حزمة معينة إذا تم استخدام هذا الدليل. لتبسيط استخدام الحزم ، فإن ملف
يتضمن C # compiler الخيار -pkg: سطر الأوامر الذي يستخدم لتحميل محدد
مجموعات المكتبات.

يتم تخزين المكتبات المرئية للمترجم بالنسبة لبادئة التثبيت الموجودة أسفل
PREFIX / lib / mono / يسمى PACKAGEBASE والإعدادات الافتراضية لـ mcs و gmcs و smcs هي
يتبع:

MCS مراجع الدليل PACKAGEBASE / 1.0

GMCS مراجع الدليل PACKAGEBASE / 2.0

com.smcs مراجع الدليل PACKAGEBASE / 2.1

هذه هي ملفات تعريف وقت التشغيل الوحيدة الموجودة. على الرغم من وجود أدلة أخرى (مثل
3.0 و 3.5) هذه ليست ملفات تعريف وقت تشغيل حقًا ، فهي مجرد عناصر نائبة لمزيد من المعلومات
المكتبات التي تقوم على أساس 2.0.

سيقوم موفرو البرامج بتوزيع البرامج المثبتة نسبة إلى PACKAGEBASE
الدليل. تم دمج هذا في غاكوتيل أداة لا تثبّت الجمهور فقط
التجميعات في ذاكرة التخزين المؤقت للتجميع العمومي (GAC) ولكنها تقوم أيضًا بتثبيتها في ملف
دليل PACKAGEBASE / PKG (حيث يكون PKG هو الاسم الذي تم تمريره إلى علامة -package إلى gacutil).

بصفتك مطورًا ، إذا كنت تريد استهلاك مكتبات Gtk # ، فيمكنك استدعاء المترجم
مثله:

$ MCS -pkg: gtk-sharp-2.0 main.cs

الخيار -pkg: يوجه المترجم لجلب تعريفات gtk-sharp-2.0 من
pkg-config ، هذا يعادل تمرير ناتج:

$ pkg-config --libs gtk-sharp-2.0

عادة ما يشير هذا فقط إلى المكتبات من PACKAGEBASE / PKG.

على الرغم من وجود أسماء دليل لـ 3.0 و 3.5 ، فإن هذا لا يعني أن هناك 3.0
و 3.5 طبعات أو ملفات تعريف المترجم. هذه مجرد مكتبات جديدة يجب أن تكون كذلك
تتم الإشارة إليها يدويًا إما باستخدام حق -pkg: استدعاء ، أو بالرجوع إلى ملف
المكتبات مباشرة.

خاص التعاريف

• TRACE و DEBUG التعريفات لها معنى خاص للمترجم.

بشكل افتراضي ، لا يتم استدعاء الأساليب والخصائص في فئة System.Diagnostics.Trace
تم إنشاؤه ما لم يتم تعريف رمز TRACE (إما من خلال "#define TRACE") في ملف
شفرة المصدر ، أو باستخدام --حدد TRACE في سطر الأوامر.

بشكل افتراضي ، لا يتم استدعاء الأساليب والخصائص في فئة System.Diagnostics.Debug
تم إنشاؤه ما لم يتم تعريف رمز DEBUG (إما من خلال "#define DEBUG") في ملف
شفرة المصدر ، أو باستخدام --حدد DEBUG في سطر الأوامر.

لاحظ أن تأثير تعريف TRACE و DEBUG يعد إعدادًا عامًا ، حتى لو كانا كذلك
معرف فقط في ملف واحد.

تفكيك الدعم

عند استخدام علامة "-debug" ، ستقوم MCS بإنشاء ملف بملحق mdb
يحتوي على معلومات التصحيح للتجميع الذي تم إنشاؤه. هذا الملف يستهلك من قبل
المصحح الأحادي (mdb).

البيئة المتغيرات

MCS_COLORS
إذا تم تعيين هذا المتغير ، فإنه يحتوي على سلسلة في شكل "المقدمة ، الخلفية"
يحدد اللون الذي سيتم استخدامه لعرض الأخطاء في بعض المحطات.

الخلفية اختيارية ويتم تعيينها افتراضيًا على الخلفية الطرفية الحالية. ال
الألوان المحتملة للمقدمة هي: أسود، أحمر، أحمر فاتح، الأخضر، اخضر فاتح،
الأصفر، أصفر فاقع، أزرق ، أزرق لامع ، أرجواني ، أرجواني لامع ، سماوي ، سماوي لامع ،
الرمادي والأبيض والأبيض الفاتح.

الألوان الممكنة للخلفية هي: أسود ، أحمر ، أخضر ، أصفر ، أزرق ، أرجواني ،
سماوي ورمادي وأبيض.

على سبيل المثال ، يمكنك تعيين هذه المتغيرات من قوقعتك:
تصدير MCS_COLORS
MCS_COLORS = أخطاء = أبيض ناصع ، أحمر

يمكنك تعطيل نظام الألوان المدمج عن طريق تعيين هذا المتغير على "تعطيل".

الملاحظات

أثناء التجميع ، يحدد برنامج التحويل البرمجي MCS رمز __MonoCS__ ، ويمكن استخدامه بواسطة
تعليمات ما قبل المعالج لتجميع رمز خاص بالمترجم Mono C #. يرجى ملاحظة ذلك
هذا الرمز مخصص للاختبار فقط للمترجم ، وليس مفيدًا للتمييز بين التجميع
أو منصات النشر.

مؤلفون

تمت كتابة المترجم Mono C # بواسطة ميغيل دي إيكازا ورافي براتاب ومارتن باوليج وماريك
سفر ورجاء هريناث. تم تمويل التطوير من قبل Ximian و Novell و Marek Safar.

استخدم dmcs عبر الإنترنت باستخدام خدمات onworks.net