تنظيم البناء

شغّل make من جذر المستودع. يُعرّف ملف Makefile الجذري الهدف الافتراضي ويضمّن هذه الملفات بالترتيب:

الملف	المسؤولية
config.mk	أعلام المترجم، أدلة البناء، قوائم المصادر لأدوات الفحص، الإعدادات الافتراضية للمنصة
native.mk	تبعيات الربط الأصلية الصريحة، الترجمة، تبعيات الترويسات المولّدة
workflows.mk	إطلاق المنتج، تجهيزات الأدلة، الخدمات المحلية، أوامر تكامل Brave
quality.mk	فحص انحدار البناء، أدوات الفحص، أدوات التعقيم، التنظيف

تبقى أسماء الأوامر الحالية ومسارات الملفات التنفيذية هي الواجهة العامة. تعكس كائنات التنفيذ مسارات المصادر داخل BUILD_DIR؛ وتتتبع ملفات .d المولّدة من المترجم الترويسات المباشرة والانتقالية للمشروع. لا يضيف zlib إلى أمر الربط سوى الملف التنفيذي لفاك الترميز. يترجم make native-probe-compile قائمة انتظار المتصفح المتتبعة دون مصدر اختبار منفصل.

يثبّت make bootstrap-dev-tools نفس إصدارات clang-format وRuff المثبّتة المستخدمة في CI داخل ~/.local/share/reb-tools، ويثبّت صيغ shellcheck وactionlint الناقصة باستخدام Homebrew. يفضّل Make تلك الأدوات المحلية المثبّتة تلقائيًا. يبني make deob-benchmark عامل Rust ويشغّل مجموعة المدونة الدلالية المحدودة مع أدلة التوقيت والذاكرة والتحويل وتغطية المصادر المتغيرة.

يفحص make lint التنسيق وتحذيرات Clippy لكلا بيانَي Rust. يتضمن عامل إزالة التعتيم جميع الأهداف بحيث يُفحص كود اختبار الانحدار الخاص به إلى جانب الملف التنفيذي الإنتاجي.

استخدم دليل بناء منفصل لمترجم مختلف أو مجموعة أعلام مختلفة:

make BUILD_DIR=build/debug OPT_CXXFLAGS='-O0 -g' all

لا يكتشف Make التغييرات في قيم أعلام سطر الأوامر في دليل بناء موجود. التغييرات في القواعد الأصلية أو ملفات إعداد المترجم تُبطل الكائنات الأصلية. يستخدم make sanitize دليل بناء نظيفًا خاصًا به.

يشغّل make native-build-test السكربت scripts/check-native-build.sh، الذي يبني ويشغّل ملفين تنفيذيين مستقلين في دليل مؤقت، ويتحقق من أن إعادة البناء لا تقوم بأي عمل، ويتحقق من أن تغيير ترويسة أحد المخرجات يُبطل مستهلكها دون إعادة بناء عرض الحدث. يتضمن make check فحص الانحدار هذا، ومعيار إزالة التعتيم الدلالي، ومجموعات اختبار Rust الخاصة بالخادم الخلفي وعامل إزالة التعتيم. كما يشغّل اختبار تكامل HTTP/CLI لحقائق المصدر مقابل عامل Rust/Oxc المبني؛ ويُحترم CARGO_TARGET_DIR عند تحديد موقع ذلك المساعد.

يترجم make native-proxy-policy-check ويشغّل مجموعة سياسة الوكيل/الحاوية الأصلية الخاصة بالتحضير فقط دون Chromium أو Cargo أو مآخذ توصيل أو متصفح. وهي مضمنة في make check وmake sanitize؛ ولا تُنشئ توجيهًا أو عزلاً حقيقيًا للمتصفح. راجع عقد الوكيل-الحاوية الأصلي المُصدَّر بإصدار.

يبني origin-trace-backend خدمة Rust HTTP، ومحلل VM، وواجهة سطر أوامر API. يشغّل ui تلك الخدمة بعد توليد الأدلة الحتمية. يستخدم backend-e2e ملفًا تعريفيًا متوافقًا مع Chromium قابلًا للتخلص منه وتجهيزات localhost اصطناعية؛ عيّن ORIGIN_TRACE_TEST_BROWSER لملف تنفيذي لمتصفح غير قياسي. تحزم عمليات بناء التطبيق ملفات Rust التنفيذية وأصول واجهة المستخدم الثابتة، دون أي اعتماد على وقت تشغيل Python.