Chet

مترجم تشيت - C لدلفي

CHET هو مترجم .h-to-.pas مدعوم من Libclang لـ Delphi.

سمات

على عكس بعض المترجمين الآخرين ، يستخدم Chet برنامج التحويل البرمجي Clang لتحليل ملفات الرأس ، مما يؤدي إلى ترجمات أكثر دقة تتطلب تعديلات يدوية أقل.

بعض الميزات البارزة هي:

• يترجم أنواع بيانات C مثل الهياكل والاتحاد والعوالم والطباعة والأنواع الإجرائية وأنواع غير شفافة.
• يترجم وظائف C إلى إجراءات أو وظائف Delphi.
• يحاول ترجمة تصريحات #define إلى الثوابت حيثما أمكن ذلك.
• يولد ملف .pas واحد لدليل كامل من ملفات .h . هذا يقلل من المشكلات بسبب التبعيات بين ملفات الرأس.
• يولد الإخراج لمنصات متعددة (Winsows و MacOS و Linux و iOS و Android) إذا رغبت في ذلك.
• يمكنك تخصيص عملية التحليل Clang من خلال توفير وسيطات سطر الأوامر للمترجم.
• يمكنك تخصيص إخراج بعض عمليات التحويل.
• يحتفظ بأي تعليقات وثائق على نمط doxygen إذا رغبت في ذلك ، أو يحولها إلى تعليقات XMLDOC أو تعليقات PASDOC.
• يوفر واجهة المستخدم الرسومية لتكوين عملية التحويل ، ويسمح لك بحفظ إعدادات التحويل إلى ملف مشروع .chet لإعادة الاستخدام.

القيود

• يعمل Chet فقط مع ملفات C Veader ، وليس مع ملفات رأس C ++.
• يتم ترجمة جميع الوظائف غير المحددة في ملفات الرأس ويفترض أنها متوفرة في المكتبة الثابتة أو الديناميكية للمشروع. هذا لا يجب أن يكون هو الحال. (لا يتم ترجمة الوظائف المحفوظة أبدًا لأنها لا تتوفر أبدًا في المكتبة.)
• نظرًا لأن Clang يستخدم لتحليل ملفات الرأس ، فهذا يعني أن Clangs Preprocessor يتم تشغيله أيضًا لأداء تحليل مشروط (مسترشدين بتوجيهات #ifdef ). هذا جيد وسيء. إنه جيد لأنه يحسن دقة التحويل. ولكن يمكن أن يكون سيئًا لأنه يستخدم النظام الذي يعمل عليه Chet لتحديد بعض المسارات الشرطية. على سبيل المثال ، نظرًا لأن CHET يعمل على Windows ، فسيتم تحليل الكود في الأقسام #ifdef _WIN32 ولكن تخطي أي رمز في أقسام للمنصات الأخرى.

متطلبات

نظرًا لأن Chet يستخدم برنامج التحويل البرمجي الفعلي ، فستحتاج إلى تثبيت بيئة C (الحد الأدنى) ، بالإضافة إلى LLVM مع Clang. يجب أن تكون Clang قادرة على العثور على رؤوس النظام لبيئة التطوير. ستكون هذه عادةً متوفرة إذا كان لديك نسخة من Visual Studio مع تثبيت Visual C ++. إن الطبعة المجانية (المجتمع) من Visual Studio تكفي.

يمكنك تشغيل Chet أولاً للتحقق من أي أخطاء تتعلق بالتبعيات المفقودة. إذا حصلت على أي أخطاء تبعية عند تشغيل المترجم ، فيمكنك تنزيل التبعيات هنا:

• ينصح LLVM مع clang (clang for windows (64 بت)).
• Visual Studio IDE (يكفي إصدار المجتمع المجاني ؛ تأكد من تثبيت دعم C ++).

يمكنك استخدام تطبيق Windows Chet 64 بت مسبقًا في دليل Bin .

إذا كنت ترغب في تجميع Chet بنفسك ، فأنت بحاجة أيضًا إلى libclang لـ Delphi والتأكد من أن Delphi IDE يمكن أن تجدها (سيجدها مشروع Chet تلقائيًا إذا كان دليل Neslib.Clang في نفس مستوى دليل Chet ).

مساهمات

شكرا لك على هذه المساهمات:

• Michał sznajder لتحسين تحويلات char.
• chiptamer لإضافة دعم لإعلانات const المكتوبة.
• Jarrod Davis لإضافة دعم ما بعد المعالجة.
• Alexey.T لإضافة دعم لحقول البتات المعبأة في بنية C ، وسائل التعيينات المعرفة من قبل المستخدم ، والقدرة على تجاهل ملفات رأس معينة.

دليل المستخدم

تشيت واضحة جدا. في كثير من الحالات ، تحتاج فقط إلى توفير دليل مع ملفات رأس ، اسم ملف .pas الإخراج وحدد "Run Header Translator (F9)".

لمزيد من التحكم في عملية التحويل ، يمكنك تحديد الخيارات المختلفة ، الموضحة أدناه.

قائمة طعام

يمكن حفظ أي خيارات تكوين تقوم بتعيينها في ملف تكوين .chet (وهو ملف INI بسيط). يتيح لك ذلك تحميل الإعدادات لاحقًا لإعادة تشغيل التحويل (على سبيل المثال ، عند إصدار إصدارات جديدة من ملفات الرأس). يمكنك تحميل وحفظ خيارات التكوين هذه باستخدام قائمة File .

للمساعدة في تكوين بعض الإعدادات لجلسة جديدة ، حدد File | New Project... (Ctrl+N) . يمكنك إدخال اسم المشروع وستقوم CHET بتكوين بعض الإعدادات بناءً على الاسم الذي تدخله (على الرغم من أنه يمكنك دائمًا تعديل هذه الإعدادات لاحقًا).

قائمة Run مثلما هو الحال مع Run Header Translator ، والتي يمكنك أيضًا تنشيطها باستخدام F9 .

صفحة المشروع

تحتوي صفحة المشروع على أهم خيارات التكوين:

• دليل مع ملفات رأس C : حدد الدليل مع ملفات .h المصدر هنا. قد يكون الدليل بالنسبة للدليل الذي يحتوي على ملف مشروع .chet . انقر فوق الزر ... للتصفح للحصول على دليل. يوصى بعدم استخدام الدليل مع رمز مصدر C الأصلي. بدلاً من ذلك ، انسخ ملفات الرأس إلى دليل منفصل فقط لأغراض التحويل. هذا يجعل من الأسهل حذف ملفات الرأس التي لا تريد تحويلها ، أو إجراء تعديلات على ملفات الرأس لأغراض التحويل.
• قم بتضمين الدلائل الفرعية : حدد هذا المربع إذا تم نشر ملفات الرأس عبر أدلة متعددة. في هذه الحالة ، سوف يبحث Chet في جميع الدليل الفرعي للدليل المعطى أيضًا.
• ملف pascal الهدف : حدد اسم ملف .pas الذي سيتم إنشاؤه. سيتم إنشاء ملف Pascal واحد مشترك لجميع ملفات الرأس المحسورة. قد يكون الاسم بالنسبة للدليل الذي يحتوي على ملف مشروع .chet . انقر فوق الزر ... لفتح مربع حوار حفظ.
• قائمة الوحدة المفصولة بفاصلة "الاستخدام" : إذا كانت ملفات الرأس تعتمد على الإعلانات في بعض وحدات Delphi الأخرى (مثل Windows.Winapi ) ، فيمكنك سرد هذه الوحدات هنا. ستضاف إلى شرط استخدام ملف Pascal الذي تم إنشاؤه.

صفحة المنصات

في هذه الصفحة ، تحدد الأنظمة الأساسية التي تريد استهدافها ، وكيف تريد تكوينها.

• ثابت المكتبة : حدد اسم الثابت لاستخدامه في اسم المكتبة. على سبيل المثال ، إذا كان لديك مكتبة تسمى "mylib.dll" ، فيمكن أن يكون اسم هذا الثابت LIB_MYLIB ، لذلك سيتم إنشاء الإعلان التالي: const LIB_MYLIB = 'mylib.dll' .

التالي هي مربعات الاختيار لجميع الأنظمة الأساسية التي تريد استهدافها (Windows 32 بت ، ونظام التشغيل Windows 64 بت ، و MACOS 32 بت ، و 64 بت Linux ، و iOS و Android). لكل منصة تقوم بفحصها ، يجب عليك إدخال الخيارات التالية:

• اسم المكتبة : اسم المكتبة الديناميكية أو الثابتة للمنصة **. **
• البادئة (_PU) : بادئة اسم الوظيفة لاستخدامها في النظام الأساسي. هذا يمكن أن يترك عادة فارغا. ولكن ، بناءً على كيفية بناء المكتبة ، قد تكون جميع أسماء الوظائف مسبوقة (عادةً مع حرف واحد _ ).

صفحة خيارات التحليل

هنا يمكنك تخصيص عملية التحليل clang.

• تجاهل أخطاء التحليل : حدد هذا المربع لتجاهل أي أخطاء تحليل وحاول ترجمة ملفات الرأس على أي حال. لاحظ أن هذا يمكن أن يؤدي إلى إخراج غير صحيح ، لذلك يجب عليك عمومًا ترك هذه الخيارات دون رادع. قد تجد هذا الخيار مفيدًا كخيار مؤقت للتحقق من وجود أخطاء تحليل. عادة ، سيتوقف Clang عن التحليل بعد مواجهته أول خطأ فادح. من خلال التحقق من هذا المربع ، سيظهر جميع أخطاء التحليل (حتى الحد الأقصى) ، حتى تتمكن من معالجة هذه الأخطاء ثم فك هذا المربع مرة أخرى.
• وسيطات سطر الأوامر لتمريرها إلى Clang : حدد أي وسيطات سطر الأوامر لتمريرها إلى مترجم Clang هنا. عادة ما لا توجد حاجة لذلك ، ولكن قد تتطلب بعض مشاريع C بعض وسيطات سطر الأوامر لتحليل النجاح. تتمثل الوسائط الأكثر شيوعًا في سطر الأوامر التي قد تحتاجها في إضافة المعالجة المسبقة ( -D<define> ) وتتضمن مسارات البحث ( -I<path> ). هناك أزرار منفصلة لتسهيل إضافة هذه. ارجع إلى وثائق Clang للحصول على معلومات حول وسيطات سطر الأوامر المتاحة.

خيارات التحويل

هذا هو المكان الذي تقوم فيه بتخصيص الإخراج الذي تم إنشاؤه.

• اتفاقية الاتصال : حدد اتفاقية الاتصال لاستخدامها لجميع الوظائف المترجمة. يمكنك الاختيار بين cdecl و stdcall . في جميع الحالات تقريبًا ، يجب عليك استخدام اتفاقية استدعاء cdecl الافتراضية. استخدم stdcall فقط لنظام التشغيل Windows 32 بت الذي تعرفه يتم تجميعه مع اتفاقية استدعاء STDCALL. هذه عادة ما تكون فقط نظام Windows DLL's. معظم الطرف الثالث يستخدم DLL CDECL.
• معالجة التعليقات : هنا تحدد كيفية التعامل مع تعليقات الوثائق (انظر أيضًا الملاحظات أدناه):
  • احتفظ بالتعليقات كما هو (افتراضي): لا تقم بتحويل التعليقات ، ولكن احتفظ بها بأسلوبها الأصلي (doxygen).
  • إزالة التعليقات : ستتم إزالة جميع التعليقات.
  • تحويل التعليقات إلى نمط XMLDOC (تجريبي) : يحول التعليقات على غرار Doxygen إلى تعليقات نمط XMLDOC (نمط الوثائق الافتراضية لـ Delphi). هذه الميزة لا تزال قيد الإنشاء وتعتبر تجريبية.
  • تحويل التعليقات إلى نمط Pasdoc (تجريبي) : يحول التعليقات على غرار Doxygen إلى تعليقات نمط Pasdoc. هذه الميزة لا تزال قيد الإنشاء وتعتبر تجريبية.
• قم بتحويل "char" إلى : نوع C char غامض ، يمكن استخدامه كصاحب عدد صحيح 8 بت أو حرف في سلسلة نصية. يتم دائمًا تحويل الإصدارات signed char و unsigned char إلى Shortint و Byte على التوالي. ولكن عندما لا يتم تحديد موقّع ، لديك الخيارات التالية:
  • UTF8CHAR (افتراضي): تحويل char إلى منصة UTF8Char .
  • Shortint : تحويل char إلى Shortint موقّع 8 بت.
  • بايت : تحويل char إلى Byte 8 بت غير موقعة.
• معالجة الكلمات المحجوزة : قد تستخدم ملفات الرأس معرفات تتعارض مع الكلمات المحجوزة في دلفي (مثل begin procedure ). هنا تحدد كيف تريد تحويل هذه المعرفات:
  • أضف "و" (افتراضي): بادئة المعرف مع ampersand.
  • أضف "_" الرائدة : بادئة المعرف مع السطح السفلي.
  • أضف "_" : أضف ترابطًا إلى نهاية المعرف.
• تعامل مع التوجيهات ككلمات محفوظة : ما إذا كنت تعامل توجيهات دلفي ككلمات محفوظة أيضًا (تم فحصها بشكل افتراضي). من الناحية الفنية ، يُسمح لك باستخدام العديد من التوجيهات (مثل public ) كمعرفات في دلفي ، لكنها تبدو غريبة ويعاملها Thightlight Tightlight بشكل مختلف. لذلك عادة ما تريد التعامل مع هذه الكلمات المحجوزة أيضًا.
• معالجة التعداد : لديك خيار تحويل التعدادات بطريقتين:
  • قم بتحويل إلى نوع مخصص (افتراضي): قم بتحويل إلى نوع من Delphi.
  • قم بتحويل إلى نوع عدد صحيح وثوابت : قم بتحويل اسم النوع نفسه إلى عدد صحيح (كما هو الحال في type MyEnum = Integer; ) وإنشاء ثوابت لكل خيار في التعداد. قد يكون هذا أكثر قابلية للتطبيق لبعض المكتبات.
• إعلانات غير قابلة للعلاج : على الرغم من أفضل الجهود ، قد لا تكون Chet قادرة على تحويل جميع الإعلانات (خاصة #define ، انظر الملاحظات أدناه). هنا تحدد كيفية التعامل مع هذه:
  • اكتب عنصر Tode (افتراضي): يكتب تعليق TODO على رمز مصدر Delphi ، بالإضافة إلى إصدار تم تعليقه من الإعلان الأصلي. تذكر أنه يمكنك عرض قائمة بجميع TODO في Delphi IDE عن طريق تحديد View | Tool Windows | To-Do List .
  • التعليق على الإعلان الأصلي : يكتب نسخة معلنة من الإعلان الأصلي إلى رمز مصدر دلفي.
  • تجاهل الإعلان : يتجاهل الإعلان ولا يكتب أي شيء إلى رمز مصدر دلفي.

لاحظ أن تعليقات الوثائق على نمط Doxygen فقط يتم تحليلها بواسطة Clang. هذه هي التعليقات التي تتبع أي من هذه الاتفاقيات التنسيق:

• /// Comment (with 3 slashes)
• /** Comment (with two stars) */
• /*! Comment (with exclamation point) */
• ///< Comment (applies to preceding declaration)
• /**< Comment (applies to preceding declaration) */
• /*!< Comment (applies to preceding declaration) */

يحاول Chet تحويل إعلانات #define إلى الثوابت إن أمكن. هذا يعمل فقط إذا:

• DEFINE لا يشبه الوظيفة. وهذا هو ، وحدات الماكرو مثل #define ABS(x) (x < 0) ? -x : x لا يمكن ترجمتها.
• يستخدم Define تعبيرًا يستخدم فقط تعريفات أخرى وحرفية. على سبيل المثال: سيتم تحويل #define FOO 3<<BAR إلى const FOO = 3 shl BAR .

تجاهل الصفحة

هنا يمكنك تحديد قائمة من الرموز التي يجب تجاهلها. لن تترجم هذه الرموز.

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

لاحظ أن الرموز حساسة للحالة.

صفحة ترجمة

تحتوي الصفحة النهائية على زر واحد فقط "Run Header Translator" (والذي يمكنك أيضًا تنشيطه باستخدام F9 ). يوضح تقدم عملية الترجمة ، وكذلك أي أخطاء حدثت أثناء تحليل ملفات الرأس.

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

رخصة

تم ترخيص Chet بموجب ترخيص BSD المبسط. انظر الترخيص. txt للحصول على التفاصيل.