header-optimization

Reduce C++ header dependencies by removing unused includes and replacing them with forward declarations where safe. This cuts parsing workload and speeds up compilation, especially in large codebases like ace_engine or OpenHarmony workflows.

Move inline implementations out of C++ headers by extracting method bodies longer than three lines into cpp files. This preserves business logic while reducing header parsing overhead and improving build performance across ace_engine development.

Use forward declarations instead of includes in C++ headers when you only reference a type by pointer or reference and do not need its full definition. This dependency reduction technique significantly reduces compile time.

You can safely refactor C++ headers for OpenHarmony and ace_engine workflows using structural-only changes such as header splitting, forward-declaration conversion, and PIMPL. The process preserves business logic and stages modifications with git add.

Verify C++ header refactoring through compile-analysis, which supports standalone compilation verification. This ensures dependency reduction and inline extraction changes remain structurally safe without altering business logic.

Header splitting helps C++ build performance by isolating constants and enums into separate files, reducing unnecessary parsing in dependent translation units. This advanced refactoring option complements dependency reduction and PIMPL techniques.