1. 引言
在完成所有必要工具的安装和配置后,我们进入了Ungoogled Chromium编译过程的第一个关键阶段:获取源代码。本文将详细介绍如何正确获取和准备Ungoogled Chromium的源代码,为后续的编译工作打下基础。
2. 准备工作
2.1 环境检查
在开始之前,请确认:
- 已安装并配置好所有必要工具
- 系统有足够的磁盘空间(至少200GB)
- 使用管理员权限运行PowerShell
- 网络连接稳定
2.2 工作目录准备
选择一个合适的位置创建工作目录,路径中避免包含空格和特殊字符。
3. 克隆代码仓库
3.1 获取代码
打开PowerShell(管理员权限),执行以下命令:
git clone --recurse-submodules https://github.com/ungoogled-software/ungoogled-chromium-windows.git
cd ungoogled-chromium-windows
3.2 切换版本
选择对应的Chromium 127版本:
git checkout --recurse-submodules 127.0.6533.119-1.1
4. 获取Chromium源码
4.1 初始尝试
首先尝试直接获取源码:
python build.py
此时很可能遇到补丁应用失败的错误:
HEAD is now at e30d8fa Roll recipe dependencies (trivial).
error: patch failed: gclient.py:126
error: gclient.py: patch does not apply
error: patch failed: gclient_scm.py:925
error: gclient_scm.py: patch does not apply
error: patch failed: gsutil.py:25
error: gsutil.py: patch does not apply
Traceback (most recent call last):
File "C:\ungoogled-chromium-windows\ungoogled-chromium\utils\clone.py", line 310, in <module>
main()
File "C:\ungoogled-chromium-windows\ungoogled-chromium\utils\clone.py", line 306, in main
clone(args)
File "C:\ungoogled-chromium-windows\ungoogled-chromium\utils\clone.py", line 110, in clone
run(['git', 'apply'],
File "C:\Users\ym\AppData\Local\Programs\Python\Python310\lib\subprocess.py", line 524, in run
raise CalledProcessError(retcode, process.args,
subprocess.CalledProcessError: Command '['git', 'apply']' returned non-zero exit status 1.
Traceback (most recent call last):
File "C:\ungoogled-chromium-windows\build.py", line 323, in <module>
main()
File "C:\ungoogled-chromium-windows\build.py", line 178, in main
subprocess.run([sys.executable, str(Path('ungoogled-chromium', 'utils', 'clone.py')), '-o', 'build\\src', '-p', 'win32' if args.x86 else 'win64'], check=True)
File "C:\Users\ym\AppData\Local\Programs\Python\Python310\lib\subprocess.py", line 524, in run
raise CalledProcessError(retcode, process.args,
subprocess.CalledProcessError: Command '['C:\\Users\\ym\\AppData\\Local\\Programs\\Python\\Python310\\python.exe', 'ungoogled-chromium\\utils\\clone.py', '-o', 'build\\src', '-p', 'win64']' returned non-zero exit status 1.
4.2 使用压缩包方式
由于直接同步可能存在问题,我们使用压缩包方式获取源码:
python build.py --tarball
5. 注意事项
5.1 必要说明
- 必须使用管理员权限运行所有命令
- 下载过程可能持续数小时,取决于网络状况
- 解压过程同样耗时较长
- 确保7-Zip正确安装并可用
5.2 可能的问题
- 网络中断:重新运行命令会继续下载
- 空间不足:确保有足够的磁盘空间
- 权限问题:检查管理员权限
- 解压错误:检查7-Zip安装
6. 结语
通过本文的指导,我们完成了Ungoogled Chromium源码的获取工作。这是编译过程的第一个重要步骤,为后续的编译工作打下了基础。
在下一篇文章《Ungoogled Chromium127编译指南 Windows篇 - GN工具编译修复(八))》中,我们将详细介绍编译过程中可能遇到的各种问题及其解决方案。请确保源码已经正确获取和准备,这将帮助您更顺利地进行后续的编译工作。