Organização do build

Execute make a partir da raiz do repositório. O Makefile raiz define o objetivo padrão e inclui estes arquivos na seguinte ordem:

Arquivo	Responsabilidade
config.mk	Flags do compilador, diretórios de build, listas de fontes para lint, padrões de plataforma
native.mk	Dependências explícitas de link nativo, compilação, dependências de cabeçalhos gerados
workflows.mk	Lançamento do produto, fixtures de evidência, serviços locais, comandos de integração com o Brave
quality.mk	Verificação de regressão do build, linters, sanitizers, limpeza

Os nomes de comandos e caminhos de executáveis existentes permanecem como a interface pública. Os objetos de implementação espelham os caminhos de origem dentro de BUILD_DIR; os arquivos .d gerados pelo compilador rastreiam cabeçalhos diretos e transitivos do projeto. Apenas o executável do decodificador adiciona zlib ao seu comando de link. make native-probe-compile compila a fila de navegador rastreada sem uma fonte de teste separada.

make bootstrap-dev-tools instala as mesmas versões fixadas de clang-format e Ruff usadas pela CI em ~/.local/share/reb-tools, e instala as fórmulas ausentes de shellcheck e actionlint com o Homebrew. O Make prefere automaticamente essas ferramentas locais fixadas. make deob-benchmark compila o worker em Rust e executa o corpus semântico limitado com evidências de tempo, memória, transformação e cobertura de fontes alteradas.

make lint verifica a formatação e os avisos do Clippy para ambos os manifestos Rust. O worker de desofuscação inclui todos os alvos, de modo que seu código de teste de regressão é verificado junto com o executável de produção.

Use um diretório de build separado para um compilador ou conjunto de flags diferente:

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

O Make não detecta alterações nos valores das flags de linha de comando em um diretório de build existente. Alterações nas regras nativas ou nos arquivos de configuração do compilador invalidam os objetos nativos. make sanitize usa seu próprio diretório de build limpo.

make native-build-test executa scripts/check-native-build.sh, que compila e executa dois executáveis independentes em um diretório temporário, verifica que um build repetido não realiza trabalho e confirma que uma alteração no cabeçalho de um artefato invalida seu consumidor sem recompilar a demonstração de eventos. make check inclui esta verificação de regressão, o benchmark semântico de desofuscação e as suítes de teste Rust do backend e do worker de desofuscação. Ele também executa o teste de integração HTTP/CLI de fatos de origem contra o worker Rust/Oxc compilado; CARGO_TARGET_DIR é respeitado ao localizar esse auxiliar.

make native-proxy-policy-check compila e executa a suíte de política de proxy/contêiner nativo somente de preparação sem Chromium, Cargo, sockets ou navegador. Ela está incluída em make check e make sanitize; não estabelece roteamento ou isolamento real de navegador. Consulte o contrato versionado de proxy-contêiner nativo.

origin-trace-backend compila o serviço HTTP em Rust, o analisador de VM e a CLI da API. ui inicia esse serviço após a geração determinística de evidências. backend-e2e usa um perfil descartável compatível com Chromium e fixtures sintéticas de localhost; defina ORIGIN_TRACE_TEST_BROWSER para um executável de navegador não padrão. Os builds de aplicativo empacotam executáveis Rust e ativos estáticos de UI, sem dependência de runtime Python.