Brave编译指南2024 MacOS篇-更新与维护(七)

引言

在上一篇文章中,我们成功构建并运行了Brave浏览器。然而,浏览器开发是一个持续的过程,Brave和Chromium都在不断更新。本文将介绍如何保持你的Brave构建与最新版本同步,以及如何处理更新过程中可能遇到的问题。

1. 更新Brave源码

Brave提供了一个便捷的脚本来更新源码。这个脚本可以同步Brave和Chromium的代码,并更新相关依赖。

1.1 基本更新流程

Brave提供了 npm run sync 脚本来更新源码。它可以同步Brave和Chromium的代码,并更新相关依赖。运行以下命令更新源码:

复制代码
npm run sync

这个命令会执行以下操作:

  • 拉取最新的Brave代码
  • 更新Chromium到Brave指定的版本
  • 更新所有依赖项

1.2 常用更新标志

  • --force: 强制更新到最新远程提交,解决同步问题。
  • --init: 强制更新到 brave-browser/package.json 中指定的版本,适用于初始化。
  • --sync_chromium (true/false): 控制是否同步Chromium版本。
  • -D, --delete_unused_deps: 删除自上次同步以来被移除的依赖项。

例如,强制更新并同步Chromium:

bashCopynpm run sync -- --force --sync_chromium true

2. 处理与上游Chromium同步的问题

与上游Chromium同步可能会产生代码冲突,尤其在Brave对Chromium进行定制的部分。

2.1 解决冲突的步骤

  1. 运行 git pull 和 gclient sync 同步最新代码。
  2. 使用 git status 查看冲突文件。
  3. 编辑冲突文件并手动合并更改。
  4. 使用 git add 标记已解决的文件,然后提交更改。

2.2 使用合并工具

对于复杂的冲突,可以使用图形化合并工具如 meld 或 VS Code 的内置合并工具。

3. 重新编译和增量编译

3.1 完整重新编译

如果进行了大规模改动,或者同步了大量的上游更新,建议进行完整的重新编译:

复制代码
ninja -C out/Default chrome

完整编译时间较长,但可以确保所有模块均为最新状态。

3.2 增量编译

在日常开发过程中,可以使用增量编译来节省时间。增量编译只会重新编译发生变化的文件:

例如,增量编译 brave 模块:

复制代码
ninja -C out/Default brave

3.3 清理构建

如果遇到无法解决的编译错误,可以尝试清理构建目录并重新编译:

复制代码
gn clean out/Default
gn gen out/Default
ninja -C out/Default chrome

4. 打包与分发

在完成编译后,使用以下命令生成Brave浏览器的安装包:

复制代码
ninja -C out/Default chrome_builder_pkg

这将生成适用于macOS的 .dmg 安装包,位于 out/Default 目录下。你可以将此包用于测试或分发。

总结

本文详细介绍了如何更新和维护你的Brave浏览器构建,包括更新源码、处理与Chromium的同步问题、进行重新编译和增量编译,以及如何打包分发。通过这些步骤,你可以确保你的Brave构建始终保持最新,并能够有效地进行开发和测试。在下一篇文章中,我们将探讨如何为Brave项目做出贡献,包括如何提交补丁和参与社区讨论。

相关推荐
afumu1 天前
免费 API 满地都是,为什么还有人做「让网页 AI 干活」这种东西
javascript·chrome·浏览器
afumu1 天前
在 Chrome 扩展里抓网页 AI 的工具调用:patch fetch 和看 DOM,我两条路都跑过
javascript·chrome·浏览器
Frag0ut2 天前
Chrome 2026跨端同步全攻略:多设备无缝协同实战进阶指南
chrome·谷歌浏览器·跨端同步·多设备浏览器协同·密码多端同步·chrome接力浏览·多端数据流转
afumu2 天前
让本机 Agent 指挥浏览器里的多个网页 AI:一套 127.0.0.1 控制协议的设计取舍
chrome·typescript
P1Browser3 天前
账号触发平台安全审核?拆解标准申诉流程与材料清单
大数据·人工智能·安全·多账号管理·指纹浏览器·账户安全·运营合规
张彦峰ZYF4 天前
浏览器调试接口的官方化:从 chrome-devtools-mcp 看 Agent 原生工具层的形成
人工智能·chrome·agent·mcp·apache-2.0许可·devtools-mcp·调试闭环
MyBili4 天前
Chrome性能优化实战:让老旧浏览器重获流畅体验
chrome·性能优化·谷歌浏览器·内存管理·浏览器提速·老旧设备优化·卡顿解决
Frag0ut5 天前
Chrome PWA离线落地实战指南:2026 网页应用原生级体验全栈开发攻略
chrome·pwa·service worker·离线浏览·web应用开发·网页原生体验·前端离线缓存
MyBili6 天前
Chrome隐私安全配置:完整防护指南
大数据·chrome·谷歌浏览器·隐私安全·浏览器防护·cookie管理·上网痕迹清理