Organización de la compilación

Ejecute make desde la raíz del repositorio. El Makefile raíz define el objetivo predeterminado e incluye estos archivos en orden:

Archivo	Responsabilidad
config.mk	Banderas del compilador, directorios de compilación, listas de fuentes para lint, valores predeterminados de plataforma
native.mk	Dependencias de enlace nativas explícitas, compilación, dependencias de encabezados generados
workflows.mk	Lanzamiento del producto, fixtures de evidencia, servicios locales, comandos de integración con Brave
quality.mk	Verificación de regresión de compilación, linters, sanitizadores, limpieza

Los nombres de comandos y las rutas de ejecutables existentes siguen siendo la interfaz pública. Los objetos de implementación reflejan las rutas de origen dentro de BUILD_DIR; los archivos .d generados por el compilador rastrean los encabezados directos y transitivos del proyecto. Solo el ejecutable del decodificador añade zlib a su comando de enlace. make native-probe-compile compila la cola de navegador rastreada sin un archivo fuente de prueba separado.

make bootstrap-dev-tools instala las mismas versiones fijadas de clang-format y Ruff usadas por CI en ~/.local/share/reb-tools, e instala las fórmulas faltantes de shellcheck y actionlint con Homebrew. Make prefiere automáticamente esas herramientas locales fijadas. make deob-benchmark compila el worker de Rust y ejecuta el corpus semántico acotado con evidencia de tiempos, memoria, transformación y cobertura de fuentes modificadas.

make lint verifica el formato y las advertencias de Clippy para ambos manifiestos de Rust. El worker de desofuscación incluye todos los objetivos para que su código de pruebas de regresión se verifique junto con el ejecutable de producción.

Use un directorio de compilación separado para un compilador o conjunto de banderas diferente:

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

Make no detecta cambios en los valores de las banderas de línea de comandos en un directorio de compilación existente. Los cambios en las reglas nativas o en los archivos de configuración del compilador sí invalidan los objetos nativos. make sanitize usa su propio directorio de compilación limpio.

make native-build-test ejecuta scripts/check-native-build.sh, que compila y ejecuta dos ejecutables independientes en un directorio temporal, verifica que una compilación repetida no realice trabajo y comprueba que un cambio en el encabezado de un artefacto invalide a su consumidor sin recompilar la demo de eventos. make check incluye esta verificación de regresión, el benchmark semántico de desofuscación y las suites de pruebas de Rust del backend y del worker desofuscador. También ejecuta la prueba de integración HTTP/CLI de source-facts contra el worker Rust/Oxc compilado; se respeta CARGO_TARGET_DIR al localizar ese helper.

make native-proxy-policy-check compila y ejecuta la suite de políticas de proxy/contenedor nativo solo de preparación sin Chromium, Cargo, sockets ni navegador. Está incluida en make check y make sanitize; no establece enrutamiento ni aislamiento real del navegador. Consulte el contrato versionado de proxy-contenedor nativo.

origin-trace-backend compila el servicio HTTP de Rust, el analizador de VM y la CLI de API. ui inicia ese servicio tras la generación determinista de evidencia. backend-e2e usa un perfil desechable compatible con Chromium y fixtures sintéticos de localhost; establezca ORIGIN_TRACE_TEST_BROWSER para un ejecutable de navegador no estándar. Las compilaciones de la aplicación empaquetan ejecutables de Rust y recursos estáticos de UI, sin dependencia del entorno de ejecución de Python.