A
Air官方
编译时间是移植工程的隐性成本：全量构建以小时计时，迭代节奏就被构建拖着走。这篇讲构建缓存的两个主力手段：moc 与 ccache。
▍Qt 的 moc 问题
Qt 的元对象编译器（moc）处理信号槽机制：头文件生成元对象代码。它天然是增量友好的——头文件没变，生成的代码不变。坑在构建系统的依赖描述：如果依赖图没把头文件与 moc 产物正确关联，改了头文件 moc 没重跑，信号槽运行时找不到元信息，症状诡异（连接失败、属性访问崩溃）且编译期无报错。对策：用 Qt 官方构建集成（CMake 的 Qt 模块）而不是手写规则；怀疑元信息陈旧时清 moc 产物目录强制重生成。
▍ccache 的接入
编译缓存工具对交叉编译同样有效：命中缓存时编译步骤秒回。配置要点：缓存目录统一放快速盘；缓存大小设上限（默认偏小，几十 GB 起设）；关键的是缓存键要稳定——编译命令、宏定义、头文件内容一致才命中，因此构建脚本里别塞随机值（时间戳、绝对路径要规范化，编译目录固定）。团队共享缓存（网络缓存目录）能放大收益，注意按编译器版本分桶。
▍增量构建的信任问题
缓存与增量带来一个新风险：假绿——构建显示成功但产物是旧的。两个真实案例值得记：一是手动编译的目标文件塞静态库没走正规替换，链接器一直拿旧成员；二是构建系统把外链静态库列为顺序依赖，库变了主产物不重链。防御：关键 so 变更后做字节级核验（产物哈希对比）；定期全量重建对账（每周一次全量，产物与增量构建对比，不一致就修依赖图）。
▍分层缓存策略
框架栈（很少变）与应用代码（常变）分目录构建，框架层构建产物固化，应用层增量。改框架栈时才动框架目录。这个分层让日常迭代只编应用层，分钟级出包。
▍验收
增量构建产物的字节级正确性抽检；缓存命中率统计（命中低说明缓存键不稳，要修）；全量与增量产物一致性对账。
更多真实移植案例，欢迎到 apps 板块翻看 56 篇《鸿蒙PC适配全记录》系列实录。
▍Qt 的 moc 问题
Qt 的元对象编译器（moc）处理信号槽机制：头文件生成元对象代码。它天然是增量友好的——头文件没变，生成的代码不变。坑在构建系统的依赖描述：如果依赖图没把头文件与 moc 产物正确关联，改了头文件 moc 没重跑，信号槽运行时找不到元信息，症状诡异（连接失败、属性访问崩溃）且编译期无报错。对策：用 Qt 官方构建集成（CMake 的 Qt 模块）而不是手写规则；怀疑元信息陈旧时清 moc 产物目录强制重生成。
▍ccache 的接入
编译缓存工具对交叉编译同样有效：命中缓存时编译步骤秒回。配置要点：缓存目录统一放快速盘；缓存大小设上限（默认偏小，几十 GB 起设）；关键的是缓存键要稳定——编译命令、宏定义、头文件内容一致才命中，因此构建脚本里别塞随机值（时间戳、绝对路径要规范化，编译目录固定）。团队共享缓存（网络缓存目录）能放大收益，注意按编译器版本分桶。
▍增量构建的信任问题
缓存与增量带来一个新风险：假绿——构建显示成功但产物是旧的。两个真实案例值得记：一是手动编译的目标文件塞静态库没走正规替换，链接器一直拿旧成员；二是构建系统把外链静态库列为顺序依赖，库变了主产物不重链。防御：关键 so 变更后做字节级核验（产物哈希对比）；定期全量重建对账（每周一次全量，产物与增量构建对比，不一致就修依赖图）。
▍分层缓存策略
框架栈（很少变）与应用代码（常变）分目录构建，框架层构建产物固化，应用层增量。改框架栈时才动框架目录。这个分层让日常迭代只编应用层，分钟级出包。
▍验收
增量构建产物的字节级正确性抽检；缓存命中率统计（命中低说明缓存键不稳，要修）；全量与增量产物一致性对账。
更多真实移植案例，欢迎到 apps 板块翻看 56 篇《鸿蒙PC适配全记录》系列实录。
楼主
7 天前