حل المشكلات

الكود لا تتم ترجمته

قراءة تبويب البناء، والأسباب الخمسة المعتادة وراء ذلك.

ما تراه: تبويب البناء

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

التشخيصات هي تشخيصات clang حقيقية دون تعديل. موضع في كودك هو موضع في كودك: يُترجم الملف باسمه الخاص، فأرقام الأسطر أرقامك لا أرقام غلاف ما.

خطأ الرابط لا موضع له. يظهر ld.lld: error: undefined symbol: loop() كسطر بلا انتقال، لأنه لا يوجد ما يُنتقل إليه.

1. تضمين مفقود

الخطأ الأكثر شيوعًا، وله علامة خاصة به: يتوقف clang تمامًا عند ترويسة مفقودة. تتعامل لوحة البناء مع ذلك كفشل في البناء وتعرض التشخيص بدلًا من الإبلاغ عن انهيار، فابحث عن سطر file not found.

الترويسات المتوفرة هي ترويسات مشروعك فقط، ومكتباته، وترويسات بيئة التشغيل نفسها. البناء نفسه بلا اتصال بالشبكة: المكتبة تكون في المشروع قبل بدء البناء، أو لا تكون موجودة أصلًا.

The runtime's own include the stock libraries tutorials use most, under their usual names: Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h, Adafruit_SSD1306.h, Adafruit_NeoPixel.h, DHT.h, SoftwareSerial.h and TinyGPS++.h (القائمة، وما يغطيه كل منها). الترويسة المكتوبة بأحرف حالة مختلفة، كما يحدث كثيرًا في أكواد كُتبت على Windows أو Mac (servo.h, liquidcrystal_i2c.h), is read as the one Mokxi has. For any other library the Build tab names the Mokxi header that does the same job, or offers Install with the library's name: one tap fetches it from the Arduino Library Manager, with the libraries it depends on, puts it in the project and builds again. The Arduino Library Manager search under the code finds any library in the official index by name, header or what it does. A library that does not list your board installs with a warning, and you can still try it. Your own files go in with Add library.

2. دالة غير موجودة في بيئة التشغيل هذه

بيئة التشغيل من صنعنا: لغة C وC++ قائمة بذاتها مع واجهة API من مرجع لغة Arduino. وتحمل pinMode, digitalWrite, digitalRead, analogWrite, analogRead, millis, micros, delay, delayMicroseconds, pulseIn, shiftIn, shiftOut, tone, noTone, attachInterrupt, Serial بـ parseInt و readStringUntil, String، والفاصلة العائمة ومكتبة الرياضيات، واختبارات المحارف، و sprintf مع ما تستخدمه بقية شروح مكتبة C، بالإضافة إلى مشغّلات مشتركة للشاشات وشريط WS2812 (القائمة).

ليست avr-libc، ولا نواة Arduino، ولا ESP-IDF، ولا يتم جلب أي منها وقت البناء. قد لا يعمل استدعاء ينجح على لوحة Arduino حقيقية هنا (مثل analogRead على لوحة لا يُحاكى محوّلها)، وسيخبرك البناء بذلك.

3. الملف الخطأ هو main

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

4. تمت الترجمة، لكن «تشغيل» نفّذ شيئًا آخر

ثلاثة أشياء قد تحدث عند الضغط على «تشغيل»، وواحد منها فقط هو البناء:

  • تشغّل اللوحة مثالًا جاهزًا أو ملف ELF مرفوعًا، ولا تتم ترجمة أي شيء؛
  • تعيد اللوحة استخدام آخر بناء، لأنه لم يتغيّر بايت واحد من الملفات؛
  • تُبنى اللوحة.

ملف ELF رفعته لم يُبنَ من هذه الملفات، لذا هو الذي يعمل: يقول program الخاص باللوحة في لوحة الخصائص «ملف ELF مرفوع» ما دام موجودًا. إذا رفضه المحاكي، تعرض الرسالة خيار استخدم الكود بدلًا منه، الذي يعيد اللوحة إلى الكود في المحرر.

5. يترجم في Arduino IDE، لكن ليس هنا

أمران يقوم بهما Arduino IDE للكود تقوم بهما Mokxi أيضًا، لذا الكود المنسوخ من شرح لن يتعثر بهما.

  • يمكن استدعاء الدوال قبل تعريفها. يكتب Arduino IDE نموذجًا أوليًا لكل دالة في تبويبات .ino قبل ترجمتها، وMokxi تفعل ذلك أيضًا، لذا يمكن لـ loop() استدعاء دالة معرّفة في الأسفل. تُدمج عدة تبويبات .ino في ملف واحد، التبويب الرئيسي أولًا، كما يدمجها الـ IDE. تحصل قوالب الدوال على نموذجها الأولي مع سطر template <typename T> أمامها، كما يكتبه الـ IDE. بعض الدوال لا تحصل على نموذج أولي: الدوال داخل صنف أو نطاق أسماء، والقالب ذو معامل قالب افتراضي، والدالة التي أنواع معاملاتها معرّفة في أسفل الكود. لهذه، الاستدعاء قبل التعريف يعطي use of undeclared identifier، وتبويب البناء يذكر في أي سطر تقع الدالة: انقل الدالة، أو النوع الذي تستخدمه، فوق الكود الذي يستدعيها، أو ضع نموذجًا أوليًا من سطر واحد مثل void blinkTwice(); في الأعلى.
  • التحذيرات لا توقف البناء. تُترجم ملفاتك مع -Wall -Wextra، ويسرد تبويب البناء ما يجدانه، لكن الكود يُبنى ويعمل كما يحدث في الـ IDE. متغير أو معامل غير مستخدم، ومقارنة بين مُوقَّع وغير مُوقَّع (int i < sizeof(pins)) يمكن أن تنتظر. أما if (x = HIGH) فيستحق الإصلاح: علامة = مفردة تُسند قيمة، فالشرط صحيح دائمًا، وأنت تقصد ==.

ما يتبقى عادةً هو مكتبة لا توفرها Mokxi، أو دالة يتركها وقت تشغيل تلك اللوحة خارجًا: القسمان 1 و2 أعلاه.

يستعرض أخطاء البناء بكلمات بسيطة الرسائل الشائعة واحدة واحدة، وشرح أخطاء ترجمة Arduino يعرضها بصياغة GCC وصياغة clang معًا.

إذا توقف البناء الأول ولم يكمل

هو لا يتوقف، بل ينزّل. حجم سلسلة الأدوات نحو سبعين ميغابايت من clang، وتُنزَّل مرة واحدة ثم تبقى في ذاكرة المتصفح المؤقتة. الخطوات في تبويب البناء تخبرك بمكانها. الزيارة التالية تستغرق نحو ثانية ونصف، والتعديل والتشغيل بعدها يستغرق جزءًا من الثانية. إذا فشل التنزيل، انظر المحرر أو المترجم لا يحمّل.

ما زلت عالقًا

الترجمة في المتصفح هو العقد الكامل: قائمة الأوامر، ومفاتيح الذاكرة المؤقتة، وكيف يُجمَّع وقت التشغيل. أو راسلنا من /support مع التشخيص.