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项目做出贡献，包括如何提交补丁和参与社区讨论。