在MacOS上构建Thorium浏览器的完整指南

在MacOS上构建Thorium浏览器的完整指南

thorium Chromium fork named after radioactive element No. 90. Windows and MacOS/Raspi/Android/Special builds are in different repositories, links are towards the top of the README.md. 项目地址: https://gitcode.com/gh_mirrors/th/thorium

前言

Thorium是一款基于Chromium的高性能浏览器，本文将详细介绍在MacOS系统上从源码构建Thorium浏览器的完整流程。无论你是开发者还是技术爱好者，通过本指南都能顺利完成构建过程。

系统要求

在开始之前，请确保你的Mac满足以下最低配置要求：

• 硬件：Intel或Apple Silicon芯片的Mac设备
• 操作系统：MacOS 10.15 (Catalina)或更高版本
• 开发工具：
  • Xcode开发环境
  • macOS SDK（通常随Xcode一起安装）
• 存储格式：APFS格式的存储卷（MacOS默认格式）

验证macOS SDK

执行以下命令检查已安装的SDK版本：

ls `xcode-select -p`/Platforms/MacOSX.platform/Developer/SDKs

建议使用最新版本的Xcode和SDK以获得最佳兼容性。

准备工作

1. 获取Thorium源代码

使用Git克隆Thorium仓库：

git clone --recursive <仓库地址>

2. 安装depot_tools

depot_tools是Chromium项目使用的工具集，包含构建所需的各类工具：

git clone <depot_tools地址>

将depot_tools添加到PATH环境变量中（建议添加到shell配置文件如~/.bash_profile或~/.zshrc）：

export PATH="$PATH:/path/to/depot_tools"

3. 获取Chromium代码

创建并进入Chromium目录：

mkdir chromium && cd chromium

使用fetch工具获取Chromium代码：

caffeinate fetch chromium

使用caffeinate可防止系统在长时间下载过程中进入休眠状态。如果不需要完整历史记录，可添加--no-history参数加速下载。

构建配置

1. 更新代码库

在Thorium目录下执行：

./trunk.sh

2. 检查版本

获取Thorium使用的Chromium版本：

./version.sh

此命令还会下载PGO(Profile Guided Optimization)性能优化配置文件，这对后续构建至关重要。

3. 设置构建环境

将Thorium源代码覆盖到Chromium目录：

./setup.sh --mac

对于Apple Silicon设备(M1/M2等)，同样使用--mac参数。

4. 配置GN构建参数

创建构建目录并编辑GN参数：

gn args out/thorium

在打开的编辑器中，根据你的处理器架构：

• Intel Mac：粘贴mac_args.gn内容
• Apple Silicon：粘贴mac_ARM_args.gn内容

特别注意修改PGO配置文件路径，指向之前version.sh下载的文件。

构建过程

1. 开始构建

执行以下命令开始构建Thorium浏览器：

autoninja -C out/thorium thorium chromedriver

autoninja会自动优化构建参数，提高构建效率。

2. 运行Thorium

构建完成后，可直接运行：

out/thorium/Thorium.app/Contents/MacOS/Thorium

3. 创建安装包

生成.dmg安装文件：

./create_dmg.sh

常见问题解决

1. 避免重复权限请求

每次运行开发者构建时，可能会遇到安全认证和网络权限请求。可通过以下参数避免：

--use-mock-security --disable-features=DialMediaRouteProvider

2. 提高git性能

Chromium代码库文件数量庞大，可通过以下方式优化git操作：

• 增加系统vnode缓存：

sudo sysctl kern.maxvnodes=$((512*1024))

• 启用git的未跟踪缓存：

git config core.untrackedCache true

• 启用git的fsmonitor：

git config core.fsmonitor true

3. Xcode许可协议

如果遇到Xcode许可协议问题，执行：

xcodebuild -license

4. 排除Spotlight索引

为避免Spotlight索引影响构建性能，可将Chromium目录添加到Spotlight的隐私排除列表中。

测试与调试

运行单元测试

构建测试目标：

autoninja -C out/thorium unit_tests

运行特定测试：

out/thorium/unit_tests --gtest_filter="BrowserListUnitTest.*"

代码更新

保持代码最新：

./trunk.sh

结语

通过以上步骤，你应该已经成功在MacOS上构建了Thorium浏览器。如果在构建过程中遇到问题，建议查阅详细的调试文档或寻求社区帮助。构建Chromium衍生项目需要耐心和细致的操作，但完成后你将获得一个完全自定义的高性能浏览器。

thorium Chromium fork named after radioactive element No. 90. Windows and MacOS/Raspi/Android/Special builds are in different repositories, links are towards the top of the README.md. 项目地址: https://gitcode.com/gh_mirrors/th/thorium