How EasyBox Transformed Baidu App’s Build Process: A Mobile Engineering Case Study

Overview

Baidu App has grown from a simple search tool into a super‑app with over a hundred business units, millions of lines of code, and a complex component ecosystem. The scale created engineering challenges such as long compile times, merge conflicts, and inefficient development workflows.

EasyBox Architecture

EasyBox is built from three core parts: the Installer (engineer workspace assembly), MGit (multi‑repo management), and LFS (binary management). The Installer uses a boxspec description to resolve component dependencies, generate projects, and combine them into a final Xcode workspace.

Practice

EasyBox’s development process emphasizes three optimization areas: standardized component management, strengthened engineering capabilities, and faster compilation.

1. Component Management All components (source or binary) are described by a boxspec file, enforcing semantic versioning and API checks before release. Binary releases are stored on a dedicated file server, keeping binaries out of source repositories.

2. Engineering Capabilities

Each component is built as an independent Xcode project, ensuring full compile isolation.

Two Xcode pitfalls are avoided: cross‑target file access and shared BUILD_PRODUCTS_DIR causing non‑deterministic builds.

Project files are generated from boxspec and are not tracked by Git, eliminating merge conflicts.

3. Multi‑repo Management MGit extends Git with multi‑repo commands while preserving familiar syntax. It uses Gerrit topics for atomic commits and enforces a "same‑branch" rule so all repositories stay on the same branch, preventing node‑sync issues.

Compilation Speed Improvements

Binaryization reduces the full build time of the main business from ~20 minutes to under 2 minutes by keeping only actively developed components in source form and the rest as pre‑built binaries. Configuration files Boxfile, Boxfile.overlay, and Boxfile.local control which components are source‑based.

Source‑mapping is achieved with the -fdebug-prefix-map flag, allowing the debugger to locate original sources even when binaries are built on a cluster. The Clang module cache and resource compile cache further cut down repetitive header parsing and asset compilation.

Principles

The team follows a "law‑first" approach: enforceable tool‑based constraints replace informal rules. Clear component boundaries, early problem exposure, and hierarchical design improve maintainability and onboarding for new developers.

Industry Comparison

Unlike CocoaPods, which struggles with large projects and compile isolation, EasyBox implements its own Xcode project generation and multi‑repo handling, offering stronger support for massive codebases.

Future

Since its launch, EasyBox has been adopted by several Baidu teams and will be open‑sourced. Ongoing work includes compatibility with other package managers and further automation of the development‑to‑release pipeline.