Thorium 调试基础设施详解Debug 构建参数、构建脚本与 UI Debug Shell 实战指南【免费下载链接】thoriumChromium fork named after radioactive element No. 90. Source code and Linux releases. Windows/MacOS/ARM builds served in different repos, links are towards the top of the README.md.项目地址: https://gitcode.com/GitHub_Trending/th/thorium本文围绕 Thorium 仓库infra/DEBUG目录的调试基础设施展开如何配置 Debug 构建的 GN 参数、如何用构建脚本在 Linux 和 Windows 上生成带符号的 Debug 版本、如何使用独立打包的 Thorium UI Debug Shell 查看与测试原生 UI 资源以及 Linux 平台调试 Chromium 系浏览器的实用技巧。读完之后你可以独立完成一次 Thorium Debug 构建定位到多进程架构下任意子进程的崩溃现场并系统性地理解每一项调试相关构建参数的作用与取舍。1. 调试基础设施的定位与组成infra/DEBUG目录是 Thorium 官方提供的调试DEBUG构建基础设施由 GN 构建参数文件与构建/运行脚本两部分组成用途是生成用于调试、测试和检查debugging、testing、and inspection的 Thorium Debug 版本。目录内核心文件如下文件作用infra/DEBUG/README.md调试基础设施总览本文的主体文档infra/DEBUG/ABOUT_GN_ARGS.md逐项解释 Thorium 各*.gn参数文件中每一行参数的含义infra/DEBUG/debug_args.gnLinux x64 的 Debug 构建参数示例infra/DEBUG/build_debug_linux.sh构建 Linux Debug 版 Thorium含 UI Debug Shellinfra/DEBUG/build_debug_win.sh在 Linux 上交叉构建 Windows Debug 版 Thoriuminfra/DEBUG/build_debug_shell_linux.sh仅构建独立的 Thorium UI Debug ShellLinuxinfra/DEBUG/build_debug_shell_win.sh仅构建独立的 Thorium UI Debug ShellWindows 目标infra/DEBUG/Thorium_Debug_Shell.sh启动 Linux 版 UI Debug Shell 的包装脚本infra/DEBUG/DEBUG_SHELL_README.mdUI Debug Shell 的详细使用说明infra/DEBUG/DEBUGGING.md在 Linux 上调试 Thorium 的 GDB/rr/日志/测试等技巧上游 Chromium 文档的改编版infra/DEBUG/mac_x64_debug_args.gn、infra/DEBUG/mac_ARM_debug_args.gn、infra/DEBUG/win_debug_args.gnmacOSx64/ARM与 Windows 平台的 Debug 参数README 中给出两条重要前提直接决定 Debug 构建的工作流Debug 构建无法用于任何平台的安装程序构建cannot build installers for any platform with a debug buildDebug 构建会使//out/thorium目录膨胀到约 6–7 GB强烈建议在调试结束后运行仓库根目录的 clean.sh 脚本把该目录从 ~6–7 GB 缩减到 ~1–2 GB 的合理体积。2. 构建入口四个脚本各自构建什么2.1 完整 Debug 构建build_debug_linux.sh / build_debug_win.sh运行 build_debug_linux.sh 或build_debug_win.sh会同时构建Thorium UI Debug Shellviews_examples_with_content 目标与 Thorium 本体。Linux 脚本的核心构建命令位于脚本第 46 行autoninja -C /out/thorium chrome chrome_sandbox chromedriver \ thorium_shell thorium_ui_debug_shell clear_key_cdm -j$参数说明对照 infra/DEBUG/build_debug_linux.sh脚本用法为build_debug_linux.sh 并行任务数-j$即透传该参数--help可查看帮助chromeThorium 浏览器主程序chrome_sandboxsetuid 沙箱辅助程序chromedriverWebDriver 自动化驱动便于编写自动化测试thorium_shell即 content_shell 形态的 Thorium 精简外壳调试 Web 内容时比完整浏览器更轻thorium_ui_debug_shellUI Debug Shell见第 4 节clear_key_cdmClearKey CDM用于在不依赖 Widevine 的情况下调试 DRM/加密媒体流通过CR_DIR环境变量可以覆盖默认的 Chromium 源码位置脚本在未设置时回退到$HOME/chromium/srcinfra/DEBUG/build_debug_linux.sh#L33-L40NINJA_SUMMARIZE_BUILD1让 ninja 输出汇总信息方便观察构建进度。Windows 版脚本 build_debug_win.sh 的目标列表为chrome chromedriver thorium_shell setup mini_installer thorium_ui_debug_shell clear_key_cdm即面向 Windows 交叉构建在 Linux 上执行。2.2 产物收集生成可直接分发的 Thorium_UI_Debug_Shell 目录两个build_debug_*.sh脚本在构建完成后会把一整套运行期依赖复制到out/thorium/Thorium_UI_Debug_Shell/目录中Linux 版见 infra/DEBUG/build_debug_linux.sh#L49-L85其中包括主程序thorium_ui_debug_shell、启动脚本Thorium_Debug_Shell.sh、以及由DEBUG_SHELL_README.md复制成的README.md运行所需资源locales、test_fonts、resources、ui、icudtl.dat、content_resources.pak、v8_context_snapshot.bin、ui_resources_100_percent.pak、ui_test*.pak、views_examples_resources.pak等图形与媒体相关动态库Linux 版拷贝libEGL.so、libGLESv2.so、libvk_swiftshader.so、libvulkan.so.1、vk_swiftshader_icd.json并把libffmpeg.so放入lib/子目录Windows 版则拷贝对应的.dlllibEGL.dll、libGLESv2.dll、vk_swiftshader.dll、vulkan-1.dll、ffmpeg.dll与blink_test_plugin.dll图标16–256 px 全套 PNG与ClearKeyCdm目录Linux 下还包括libclearkeycdm.so。正如 README 所述这个目录包含全部产物和说明文档适合直接压缩后分发给用户复现问题。两个build_debug_shell_*.sh脚本仅构建 UI Debug Shell 而非整个 Thorium还会额外拷贝崩溃分析工具minidump_stackwalk与dump_syms见 infra/DEBUG/build_debug_shell_linux.sh#L46-L46 及 L85-L86并执行zip -r ../Thorium_UI_Debug_Shell.zip *生成压缩包infra/DEBUG/build_debug_shell_linux.sh#L90-L91一步到位产出可分发的 zip。README 同时给出更灵活的手动构建方式来自 DEBUG_SHELL_README.md# 构建完整 Thorium Debug Shell autoninja -C out/thorium chrome chromedriver thorium_shell setup mini_installer thorium_ui_debug_shell # 或只构建 Debug Shell排除 Thorium 本体 autoninja -C out/thorium thorium_ui_debug_shell2.3 启动方式Linux 上运行打包好的 Shell 使用 Thorium_Debug_Shell.sh它把当前目录下的lib/加入LD_LIBRARY_PATH然后以./thorium_ui_debug_shell --debug $启动并透传所有附加命令行参数。Windows 上则直接运行thorium_ui_debug_shell.exe。两种方式都通过程序顶部的下拉菜单选择要测试/查看的 UI 资源对于需要外部文件的项目例如查看.icon文件可以在窗口底部的输入框中填入文件的完整路径加载。3. Debug 构建参数逐项解析debug_args.gninfra/DEBUG/debug_args.gn 是 Linux x64 平台 Debug 构建的完整参数样例。构建 Thorium/Chromium 时你通过gn args out/thorium编辑的参数文件正是被 ninjaChromium 构建系统解析并应用的构建参数Thorium 维护了多套参数文件且因平台与是否 Debug 构建而不同。下表按 debug_args.gn 的实际内容分组说明并对照 ABOUT_GN_ARGS.md 中的官方解释3.1 SIMD 指令集基线use_sse3 true use_sse41 true use_sse42 true use_avx true use_avx2 false use_avx512 false use_fma falseDebug 构建以 SSE3/SSE4.1/SSE4.2 AVX 为指令集基线关闭 AVX2/AVX512/FMA。Thorium 的发行版本身按 AVX2/AVX512/SSE2/SSE3/SSE4.x 等指令集分级提供独立构建见仓库 other/ 目录Debug 版取一个保守且通用的基线保证在主流 x64 机器上可直接运行调试。3.2 目标平台target_os linux target_cpu x64target_os决定目标操作系统linux、win、mac、chromeos、fuchsiatarget_cpu决定目标 CPUx86、x64、arm、arm64、mipsel、mips64el、ppc二者组合即可实现交叉编译。使用 arm/arm64 时应同时设置//thorium/build/config/arm.gni中的编译器选项按 ABOUT_GN_ARGS.md 的说明。3.3 Debug 构建的标志性开关参数取值说明源自 ABOUT_GN_ARGS.mdis_debugtrue把调试构造debugging constructs链接进二进制Debug 构建必开is_official_buildfalse非官方构建官方构建会启用额外优化并把chrome://version、chrome://settings/help中的 Developer 显示为 Officialenable_strippingfalse调试构建禁止剥离符号否则无法在 GDB 中解析栈帧dcheck_always_ontrue无论is_debug/is_official_build如何强制启用 DCHECK 断言。Thorium 在发布构建中默认关闭它以换取性能/体积Debug 构建中必须打开exclude_unwind_tablesfalse保留栈展开unwind表供调试器回溯调用栈发布构建中 Thorium 默认开启该选项以省体积symbol_level/v8_symbol_level/blink_symbol_level2/2/2符号级别选项为 0/1/2Debug 构建全部取 2最全符号v8_symbol_level与blink_symbol_level分别独立于symbol_level控制 V8JS 引擎与 Blink渲染引擎的符号级别发布构建中设为 0 以优化性能use_debug_fissiontrue调试符号分离debug fissionDEBUGGING.md 中提到若需显著加快 GDB 加载时间可在 GN 参数中设use_debug_fissionfalse代价是链接时间变长enable_iterator_debugging未在示例中显式设置启用 C 迭代器调试仅在is_debug true时生效enable_debugallocation—已废弃DEPRECATED历史上为二进制中的调试构造分配额外头部空间enable_precompiled_headersfalse预编译头可加快编译但 Thorium 出于可复现性考虑禁用并确保 Thorium 的.h文件被对应的.cc正确#include3.4 安装程序与体积相关enable_linux_installer false # Debug 构建禁用 .deb/.rpm/.snap 安装程序生成仅 Linux enable_distro_version_check false # 禁用 Linux 安装程序的发行版支持检查 enable_nacl false # 禁用 Native Client为体积关闭且正在被上游废弃 enable_reporting false # 禁用上报组件enable_linux_installer与enable_distro_version_check在 Debug 构建中一律禁用——这与 README 中Debug 构建无法构建任何平台安装程序的结论一致而is_component_build是否拆分共享库会进一步影响安装程序生成Thorium 在 Debug 构建中也显式关闭它见 3.7 节示例中的取值差异。3.5 媒体解码栈media_use_ffmpeg true # 使用 Chromium 的 ffmpeg 实现处理媒体库/流 media_use_libvpx true # 软件解码 VP8/VP9 等 enable_hls_demuxer true # 启用 HLS 解复用上游 INCOMPLETEThorium 为可用性开启 proprietary_codecs true # 构建 H.264/H.265(HEVC)/FLAC 等专有编解码器 ffmpeg_branding Chrome # 设置 ffmpeg 内部 BRANDING 头须与 proprietary_codecstrue 搭配 enable_ffmpeg_video_decoders true# 软件 ffmpeg 视频解码器作为 VAAPI/VDPAU 等硬解不可用时的回退 is_component_ffmpeg true # 将 ffmpeg 构建为共享库便于用户替换 libffmpeg.so use_webaudio_pffft true # 音频 FFT 使用 pffft 库macOS 除外其原生 FFT 库更快 use_vaapi true # 启用 VAAPIWindows 上应关闭 enable_platform_hevc true # 硬件 HEVC 解码/编码能力也是启用 H.265 的前提 enable_hevc_parser_and_hw_decoder true # HEVC 解析与解复用 platform_has_optional_hevc_decode_support true enable_platform_ac3_eac3_audio true enable_platform_dolby_vision true enable_platform_encrypted_dolby_vision true enable_platform_mpeg_h_audio true enable_platform_dts_audio true enable_mse_mpeg2ts_stream_parser true # 实验性 MPEG-TS 流解析 use_text_section_splitting true调试媒体功能时这套参数保证了 H.264/H.265/AC3/DTS/Dolby Vision/HLS/MPEG-TS 等常见格式在 Debug 构建中均可用。另有两个实验性参数值得注意ffmpeg_branding的合法取值是Chromium/Chrome/Chromeos而is_chancie_wancie_buildExperimental 组参数可构建 CrOS 版 ffmpeg 用于测试例如在 Linux 上启用 HEVC但会破坏 Windows/Android/Fuchsia 构建且会覆盖Chromeos 仅允许在 CrOS 构建的内部检查。3.6 Widevine 与 DRM 调试enable_library_cdms true enable_widevine true bundle_widevine_cdm false # 不打包 Widevine使其作为组件独立更新并支持 Widevine 补丁 enable_cdm_host_verification false ignore_missing_widevine_signing_cert true # 忽略无签名证书导致的 Widevine 主机校验失败 enable_media_drm_storage true # 允许 Widevine 用 LocalStorage 保存 DRM 文件如 Amazon Prime按 ABOUT_GN_ARGS.md 的解释bundle_widevine_cdm关闭时 Widevine 作为组件从 Google 服务器下载到用户 profile 目录可以独立于 Thorium 版本更新同时在 Linux 上可使用 Thorium 的 Widevine 补丁配合构建目标中的clear_key_cdm见 2.1 节Debug 构建覆盖了两类 DRM 调试路径商业 Widevine 与开源 ClearKey。3.7 构建系统级参数is_component_build true # 将大量组件拆分为共享库避免末尾漫长的链接步骤 treat_warnings_as_errors false # 调试阶段容忍警告避免构建因无关警告失败 use_lld true # 使用 LLVM lld 链接器除非使用 MOLD 等其他链接器应始终启用 is_clang true use_icf false # 关闭 ICF相同代码折叠 is_cfi false # 关闭控制流完整性 clang_use_chrome_plugins false # 注释标明Set to false for Polly build use_thin_lto false thin_lto_enable_optimizations false chrome_pgo_phase 0 # 0无 PGO1仅插桩2完整 PGO v8_enable_fast_torque true v8_enable_wasm_simd256_revec true use_v8_context_snapshot true # 单独构建 V8 函数模板与上下文的 .bin 快照 enable_rust true init_stack_vars_zero false disable_fieldtrial_testing_config true # 禁用 field trialThorium 出于稳定性/隐私/可复现性考虑 enable_resource_allowlist_generation false enable_profiling false # 关闭 PGO *.profdata 生成相关插桩 enable_reporting false这里体现了 Debug 与发布构建的核心取舍Thorium 发布构建默认use_thin_lto true且chrome_pgo_phase 2完整 PGOpgo_data_path指向trunk.sh下载的.profdata而 Debug 构建把chrome_pgo_phase降为 0、关闭 thinLTO牺牲运行时性能换取可读的符号与单步调试能力。is_component_build true在 debug_args.gn 中为true官方 Debug 参数而 ABOUT_GN_ARGS.md 说明 Thorium 的正式发布构建即使在 Debug 场景下也默认关闭组件构建且正是该参数决定 Debug 构建是否生成安装程序。3.8 WebRTC 与实验性功能rtc_use_h264 true # WebRTC 使用 H.264须搭配 proprietary_codecstrue rtc_use_h265 true rtc_build_examples true # 构建示例 RTC 数据Useful for debugging发布构建中为省体积关闭 rtc_enable_avx2 true enable_vr true # 启用 WebVR/WebXR enable_discovery true enable_hangout_services_extension false use_avx true见 3.1rtc_build_examples是典型的Debug 开启、发布关闭的参数它生成调试用的示例 RTC 数据。enable_hls_sample_aes等其他平台相关参数如 CrOS 专属的enable_ink、enable_cros_media_app会破坏非 CrOS 构建在 Linux Debug 样例中均未启用修改此类参数前应先阅读 ABOUT_GN_ARGS.md 中对应的平台警告。4. Thorium UI Debug Shell 深入讲解4.1 它是什么按 DEBUG_SHELL_README.md 的定义UI Debug Shell 是一个构建在views_examples与content_shell之上的特殊程序整合了大量用于测试、查看和调试 Thorium UI 资源的选项。它构建的目标是views_examples_with_content并会被重命名为thorium_ui_debug_shell若只构建views_examples则不包含 content_shell 链接可通过下拉菜单中的 WebView 选项访问 content_shell 形态的视图。4.2 主要用途查看与测试.icon矢量图标作者构建它的原始动机是查看和测试 Chromium 原生 UI 图标*.icon格式。这些图标在 Chromium 源码树中的分布位置引用自 DEBUG_SHELL_README.md//chromium/src/ui/views/vector_icons 大多数原生 UI views 子组件 //chromium/src/ui/views/window/vector_icons 顶栏Top Chrome相关图标 //chromium/src/components/vector_icons 影响多个构建目标的组件图标 //chromium/src/chrome/app/vector_icons 仅浏览器使用的图标 //chromium/src/ash/resources/vector_icons ChromiumOS 上 Chromium 使用的图标 //chromium/src/chromeos/ui/vector_icons ChromiumOS 专属图标 //chromium/src/chromecast/ui/vector_icons ChromeCast 专属图标本仓库中也保留了 Thorium 自己的向量图标与 UI 补丁例如 src/components/vector_icons/ 目录42 个文件含 Thorium 定制的.icon文件以及 UI 定制补丁 other/thorium-2024-ui.patch 与 other/thorium_webui.patch——当你需要在 UI Debug Shell 中核实的正是这类本地改动时可直接对照这些路径。4.3 打包与分发现象学从两个build_debug_shell_*.sh脚本可以看出产物包的组织方式以 infra/DEBUG/build_debug_shell_linux.sh 为例autoninja -C out/thorium thorium_ui_debug_shell minidump_stackwalk dump_syms -j$—— 三个目标分别对应主程序、minidump 转 core 的工具、符号 dump 工具复制运行时依赖同 2.2 节清单Linux 版还会把ClearKeyCdm/_platform_specific/linux_x64/libclearkeycdm.so放入lib/zip -r ../Thorium_UI_Debug_Shell.zip *—— 生成可直接分发的压缩包。包内附带的minidump_stackwalk与dump_syms意味着当用户用该包复现崩溃生成 minidump 后你可以离线将其转换为带完整符号的栈回溯这正是第 5 节调试流程的关键一环。5. Linux 上的调试实战技巧DEBUGGING.md 精要infra/DEBUG/DEBUGGING.md 是上游 Chromium Linux 调试指南的改编版仅将 Chromium 相关名称替换为 Thorium是拿到 Debug 构建后真正调试的操作手册。以下按主题归纳其核心内容。5.1 GDB 基本要求GDB ≥ 7.7 是硬性要求旧版本会解析不了符号或直接段错误沙箱会干扰内部符号化器可临时用--no-sandbox仅限临时或使用外部符号化器tools/valgrind/asan/asan_symbolize.py在 Ubuntu 等启用 Yama LSM 的发行版上需先放开 ptrace 限制否则会报 Could not attach to processecho 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope基础浏览器进程调试gdb -tui -exr --args out/thorium/thorium --disable-seccomp-sandbox http://google.com5.2 多进程技巧把渲染进程/GPU 进程送进 GDBThorium 自己 fork 出渲染器直接抓进程较难文档给出的方案是用--renderer-cmd-prefixthorium --no-sandbox --renderer-cmd-prefixxterm -title renderer -e gdb --args要点--no-sandbox是必需的否则 seccomp 会在启动时杀掉渲染器或 setuid 沙箱阻止 xterm 执行xterm必须带否则 gdb 会与主进程抢同一个终端如需渲染器自动启动加-ex run。文档还给了若干延伸技巧选择性调试多个渲染器把 prefix 指向一个交互式 shell 脚本每个子进程启动时提示y to debug按 y 才进入 gdb否则直接执行选择性断点用 gdb 命令文件分别为浏览器/渲染器加载不同断点gdb -x ~/debug/browser --args thorium --no-sandbox --disable-hang-monitor \ --renderer-cmd-prefixxterm -title renderer -e gdb -x ~/debug/renderer --args 附加到运行中的渲染器ps aux | grep thorium信息量有限推荐pstree -p | grep thorium查看进程树区分浏览器进程与渲染进程线程也可在 Thorium 内置任务管理器Tools 菜单中右键启用 Process ID 列。注意默认情况下沙箱进程不能被调试器附加需要传--allow-sandbox-debuggingGPU 子进程把--renderer-cmd-prefix换成--gpu-launcherbrowser_tests 拉起的浏览器改用环境变量BROWSER_WRAPPER例如BROWSER_WRAPPERxterm -title renderer -e gdb --eval-commandrun \ --eval-commandquit --args out/Debug/browser_tests --gtest_filterPrint单进程模式多数场景下gdb --args thorium --single-process并加--disable-gpu比多进程方案简单得多但插件进程无法放进浏览器进程内仍需--plugin-launcherIPC 调试设置环境变量CHROME_IPC_LOGGING1或在 gdb 中set environment CHROME_IPC_LOGGING 1若出现 unknown 消息可检查chrome/common/logging_chrome.cc中的 IPC 消息头列表是否过期日志默认日志级别会隐藏LOG(INFO)加--log-level0 --enable-loggingstderr新版还需--v1核心转储ulimit -c unlimited让 Thorium 进程全部落 core部分沙箱子进程仍需--allow-sandbox-debugging若是卡死而非崩溃可kill -6 [PID]发 SIGABRT 触发 core dump 拿回溯rr 时间旅行调试录制后支持反向单步/反向 continue文档以blink::NGBlockNode::Layout断点 watch宽度字段 rc回溯为例完整演示多进程场景用rr -f [PID]zygote fork 出的渲染器或rr -p [PID]其他进程加快 GDB 启动build/gdb-add-index out/Debug/browser_tests预建索引或在 GN 参数中设use_debug_fissionfalse以链接时间换加载速度测试环境用 Xvfb/openbox 组合Xvfb :6.0 -screen 0 1280x1024x24 DISPLAY:6.0 openbox 复刻 try bot 的窗口管理器环境调试 UI 测试超时时把--test-timeout、--ui-test-action-timeout、--ui-test-terminate-timeout调大browser_tests调试单个用例加--single-process-tests --gtest_filterMyTestName。5.3 符号与符号文件Breakpad minidump文档指向minidump_to_core.md的流程与 UI Debug Shell 包内附带的minidump_stackwalk/dump_syms工具链对应符号化栈回溯沙箱会干扰内部符号化器优先外部符号化器--no-sandbox仅作临时手段且不应在 waterfall bot 上使用沙箱测试是必需的gdbinitgdb 7 可用 Python pretty-printer 美化 Chromium 类型输出文档中给出了打印std::stringps与宽字符串pws的~/.gdbinit片段。6. 典型工作流串联把上述组件串起来一个完整的 Thorium Debug 调试闭环是准备按 Thorium 的构建文档完成源码与 depot_tools 准备本仓库根目录提供 setup.sh、get_repo.sh 等入口脚本确认out/thorium下 args 与 infra/DEBUG/debug_args.gn或对应平台的 mac/win debug args一致构建运行build_debug_linux.sh jobs或 Windows 交叉构建build_debug_win.sh jobs在out/thorium得到带完整符号的thorium、thorium_shell、thorium_ui_debug_shell与ClearKeyCdm复现/检查排查 UI 资源/图标问题 → 运行Thorium_UI_Debug_Shell包Linux 下./Thorium_Debug_Shell.sh从下拉菜单逐项检查外部资源用完整路径加载排查 Web 内容/渲染问题 →thorium_shell或完整thorium加--log-level0 --enable-loggingstderr --v1排查 DRM/HEVC 等媒体问题 → 利用clear_key_cdm与enable_hls_demuxer/enable_platform_hevc等参数组合验证解码路径抓现场按第 5 节用 GDB/--renderer-cmd-prefix/pstree/rr/core dump 定位进程与调用栈用户侧复现则用build_debug_shell_*.sh生成的 zip 包 minidump_stackwalk离线符号化收尾调试结束后运行 clean.sh 清理//out/thorium把目录从 6–7 GB 恢复到 1–2 GB 量级。7. 适用前提与限制本文所有参数与脚本均对应当前仓库infra/DEBUG目录的实际内容debug_args.gn是 Linux x64 样例macOSx64/ARM与 Windows 请分别使用同目录下的mac_x64_debug_args.gn、mac_ARM_debug_args.gn、win_debug_args.gnDebug 构建不能用于任何平台的安装程序构建且产物体积巨大6–7 GB 输出目录务必规划磁盘空间并在结束后运行clean.shis_chancie_wancie_build、CrOS 专属媒体参数等会破坏跨平台构建使用前应参照 ABOUT_GN_ARGS.md 的平台警告与作者说明DEBUGGING.md 中引用的部分工具与流程如 JsDbg、gdb-add-index、use_debug_fission依赖 Chromium 源码树中的工具路径是否可用以你所构建的具体版本为准需要 Google Sync、翻译等服务的功能依赖 API Keygoogle_api_key/google_default_client_id/google_default_client_secret公开仓库中默认置空调试此类功能时需自行申请并按 ABOUT_GN_ARGS.md 说明配置。【免费下载链接】thoriumChromium fork named after radioactive element No. 90. Source code and Linux releases. Windows/MacOS/ARM builds served in different repos, links are towards the top of the README.md.项目地址: https://gitcode.com/GitHub_Trending/th/thorium创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Thorium 调试基础设施详解Debug 构建参数、构建脚本与 UI Debug Shell 实战指南【免费下载链接】thoriumChromium fork named after radioactive element No. 90. Source code and Linux releases. Windows/MacOS/ARM builds served in different repos, links are towards the top of the README.md.项目地址: https://gitcode.com/GitHub_Trending/th/thorium本文围绕 Thorium 仓库infra/DEBUG目录的调试基础设施展开如何配置 Debug 构建的 GN 参数、如何用构建脚本在 Linux 和 Windows 上生成带符号的 Debug 版本、如何使用独立打包的 Thorium UI Debug Shell 查看与测试原生 UI 资源以及 Linux 平台调试 Chromium 系浏览器的实用技巧。读完之后你可以独立完成一次 Thorium Debug 构建定位到多进程架构下任意子进程的崩溃现场并系统性地理解每一项调试相关构建参数的作用与取舍。1. 调试基础设施的定位与组成infra/DEBUG目录是 Thorium 官方提供的调试DEBUG构建基础设施由 GN 构建参数文件与构建/运行脚本两部分组成用途是生成用于调试、测试和检查debugging、testing、and inspection的 Thorium Debug 版本。目录内核心文件如下文件作用infra/DEBUG/README.md调试基础设施总览本文的主体文档infra/DEBUG/ABOUT_GN_ARGS.md逐项解释 Thorium 各*.gn参数文件中每一行参数的含义infra/DEBUG/debug_args.gnLinux x64 的 Debug 构建参数示例infra/DEBUG/build_debug_linux.sh构建 Linux Debug 版 Thorium含 UI Debug Shellinfra/DEBUG/build_debug_win.sh在 Linux 上交叉构建 Windows Debug 版 Thoriuminfra/DEBUG/build_debug_shell_linux.sh仅构建独立的 Thorium UI Debug ShellLinuxinfra/DEBUG/build_debug_shell_win.sh仅构建独立的 Thorium UI Debug ShellWindows 目标infra/DEBUG/Thorium_Debug_Shell.sh启动 Linux 版 UI Debug Shell 的包装脚本infra/DEBUG/DEBUG_SHELL_README.mdUI Debug Shell 的详细使用说明infra/DEBUG/DEBUGGING.md在 Linux 上调试 Thorium 的 GDB/rr/日志/测试等技巧上游 Chromium 文档的改编版infra/DEBUG/mac_x64_debug_args.gn、infra/DEBUG/mac_ARM_debug_args.gn、infra/DEBUG/win_debug_args.gnmacOSx64/ARM与 Windows 平台的 Debug 参数README 中给出两条重要前提直接决定 Debug 构建的工作流Debug 构建无法用于任何平台的安装程序构建cannot build installers for any platform with a debug buildDebug 构建会使//out/thorium目录膨胀到约 6–7 GB强烈建议在调试结束后运行仓库根目录的 clean.sh 脚本把该目录从 ~6–7 GB 缩减到 ~1–2 GB 的合理体积。2. 构建入口四个脚本各自构建什么2.1 完整 Debug 构建build_debug_linux.sh / build_debug_win.sh运行 build_debug_linux.sh 或build_debug_win.sh会同时构建Thorium UI Debug Shellviews_examples_with_content 目标与 Thorium 本体。Linux 脚本的核心构建命令位于脚本第 46 行autoninja -C /out/thorium chrome chrome_sandbox chromedriver \ thorium_shell thorium_ui_debug_shell clear_key_cdm -j$参数说明对照 infra/DEBUG/build_debug_linux.sh脚本用法为build_debug_linux.sh 并行任务数-j$即透传该参数--help可查看帮助chromeThorium 浏览器主程序chrome_sandboxsetuid 沙箱辅助程序chromedriverWebDriver 自动化驱动便于编写自动化测试thorium_shell即 content_shell 形态的 Thorium 精简外壳调试 Web 内容时比完整浏览器更轻thorium_ui_debug_shellUI Debug Shell见第 4 节clear_key_cdmClearKey CDM用于在不依赖 Widevine 的情况下调试 DRM/加密媒体流通过CR_DIR环境变量可以覆盖默认的 Chromium 源码位置脚本在未设置时回退到$HOME/chromium/srcinfra/DEBUG/build_debug_linux.sh#L33-L40NINJA_SUMMARIZE_BUILD1让 ninja 输出汇总信息方便观察构建进度。Windows 版脚本 build_debug_win.sh 的目标列表为chrome chromedriver thorium_shell setup mini_installer thorium_ui_debug_shell clear_key_cdm即面向 Windows 交叉构建在 Linux 上执行。2.2 产物收集生成可直接分发的 Thorium_UI_Debug_Shell 目录两个build_debug_*.sh脚本在构建完成后会把一整套运行期依赖复制到out/thorium/Thorium_UI_Debug_Shell/目录中Linux 版见 infra/DEBUG/build_debug_linux.sh#L49-L85其中包括主程序thorium_ui_debug_shell、启动脚本Thorium_Debug_Shell.sh、以及由DEBUG_SHELL_README.md复制成的README.md运行所需资源locales、test_fonts、resources、ui、icudtl.dat、content_resources.pak、v8_context_snapshot.bin、ui_resources_100_percent.pak、ui_test*.pak、views_examples_resources.pak等图形与媒体相关动态库Linux 版拷贝libEGL.so、libGLESv2.so、libvk_swiftshader.so、libvulkan.so.1、vk_swiftshader_icd.json并把libffmpeg.so放入lib/子目录Windows 版则拷贝对应的.dlllibEGL.dll、libGLESv2.dll、vk_swiftshader.dll、vulkan-1.dll、ffmpeg.dll与blink_test_plugin.dll图标16–256 px 全套 PNG与ClearKeyCdm目录Linux 下还包括libclearkeycdm.so。正如 README 所述这个目录包含全部产物和说明文档适合直接压缩后分发给用户复现问题。两个build_debug_shell_*.sh脚本仅构建 UI Debug Shell 而非整个 Thorium还会额外拷贝崩溃分析工具minidump_stackwalk与dump_syms见 infra/DEBUG/build_debug_shell_linux.sh#L46-L46 及 L85-L86并执行zip -r ../Thorium_UI_Debug_Shell.zip *生成压缩包infra/DEBUG/build_debug_shell_linux.sh#L90-L91一步到位产出可分发的 zip。README 同时给出更灵活的手动构建方式来自 DEBUG_SHELL_README.md# 构建完整 Thorium Debug Shell autoninja -C out/thorium chrome chromedriver thorium_shell setup mini_installer thorium_ui_debug_shell # 或只构建 Debug Shell排除 Thorium 本体 autoninja -C out/thorium thorium_ui_debug_shell2.3 启动方式Linux 上运行打包好的 Shell 使用 Thorium_Debug_Shell.sh它把当前目录下的lib/加入LD_LIBRARY_PATH然后以./thorium_ui_debug_shell --debug $启动并透传所有附加命令行参数。Windows 上则直接运行thorium_ui_debug_shell.exe。两种方式都通过程序顶部的下拉菜单选择要测试/查看的 UI 资源对于需要外部文件的项目例如查看.icon文件可以在窗口底部的输入框中填入文件的完整路径加载。3. Debug 构建参数逐项解析debug_args.gninfra/DEBUG/debug_args.gn 是 Linux x64 平台 Debug 构建的完整参数样例。构建 Thorium/Chromium 时你通过gn args out/thorium编辑的参数文件正是被 ninjaChromium 构建系统解析并应用的构建参数Thorium 维护了多套参数文件且因平台与是否 Debug 构建而不同。下表按 debug_args.gn 的实际内容分组说明并对照 ABOUT_GN_ARGS.md 中的官方解释3.1 SIMD 指令集基线use_sse3 true use_sse41 true use_sse42 true use_avx true use_avx2 false use_avx512 false use_fma falseDebug 构建以 SSE3/SSE4.1/SSE4.2 AVX 为指令集基线关闭 AVX2/AVX512/FMA。Thorium 的发行版本身按 AVX2/AVX512/SSE2/SSE3/SSE4.x 等指令集分级提供独立构建见仓库 other/ 目录Debug 版取一个保守且通用的基线保证在主流 x64 机器上可直接运行调试。3.2 目标平台target_os linux target_cpu x64target_os决定目标操作系统linux、win、mac、chromeos、fuchsiatarget_cpu决定目标 CPUx86、x64、arm、arm64、mipsel、mips64el、ppc二者组合即可实现交叉编译。使用 arm/arm64 时应同时设置//thorium/build/config/arm.gni中的编译器选项按 ABOUT_GN_ARGS.md 的说明。3.3 Debug 构建的标志性开关参数取值说明源自 ABOUT_GN_ARGS.mdis_debugtrue把调试构造debugging constructs链接进二进制Debug 构建必开is_official_buildfalse非官方构建官方构建会启用额外优化并把chrome://version、chrome://settings/help中的 Developer 显示为 Officialenable_strippingfalse调试构建禁止剥离符号否则无法在 GDB 中解析栈帧dcheck_always_ontrue无论is_debug/is_official_build如何强制启用 DCHECK 断言。Thorium 在发布构建中默认关闭它以换取性能/体积Debug 构建中必须打开exclude_unwind_tablesfalse保留栈展开unwind表供调试器回溯调用栈发布构建中 Thorium 默认开启该选项以省体积symbol_level/v8_symbol_level/blink_symbol_level2/2/2符号级别选项为 0/1/2Debug 构建全部取 2最全符号v8_symbol_level与blink_symbol_level分别独立于symbol_level控制 V8JS 引擎与 Blink渲染引擎的符号级别发布构建中设为 0 以优化性能use_debug_fissiontrue调试符号分离debug fissionDEBUGGING.md 中提到若需显著加快 GDB 加载时间可在 GN 参数中设use_debug_fissionfalse代价是链接时间变长enable_iterator_debugging未在示例中显式设置启用 C 迭代器调试仅在is_debug true时生效enable_debugallocation—已废弃DEPRECATED历史上为二进制中的调试构造分配额外头部空间enable_precompiled_headersfalse预编译头可加快编译但 Thorium 出于可复现性考虑禁用并确保 Thorium 的.h文件被对应的.cc正确#include3.4 安装程序与体积相关enable_linux_installer false # Debug 构建禁用 .deb/.rpm/.snap 安装程序生成仅 Linux enable_distro_version_check false # 禁用 Linux 安装程序的发行版支持检查 enable_nacl false # 禁用 Native Client为体积关闭且正在被上游废弃 enable_reporting false # 禁用上报组件enable_linux_installer与enable_distro_version_check在 Debug 构建中一律禁用——这与 README 中Debug 构建无法构建任何平台安装程序的结论一致而is_component_build是否拆分共享库会进一步影响安装程序生成Thorium 在 Debug 构建中也显式关闭它见 3.7 节示例中的取值差异。3.5 媒体解码栈media_use_ffmpeg true # 使用 Chromium 的 ffmpeg 实现处理媒体库/流 media_use_libvpx true # 软件解码 VP8/VP9 等 enable_hls_demuxer true # 启用 HLS 解复用上游 INCOMPLETEThorium 为可用性开启 proprietary_codecs true # 构建 H.264/H.265(HEVC)/FLAC 等专有编解码器 ffmpeg_branding Chrome # 设置 ffmpeg 内部 BRANDING 头须与 proprietary_codecstrue 搭配 enable_ffmpeg_video_decoders true# 软件 ffmpeg 视频解码器作为 VAAPI/VDPAU 等硬解不可用时的回退 is_component_ffmpeg true # 将 ffmpeg 构建为共享库便于用户替换 libffmpeg.so use_webaudio_pffft true # 音频 FFT 使用 pffft 库macOS 除外其原生 FFT 库更快 use_vaapi true # 启用 VAAPIWindows 上应关闭 enable_platform_hevc true # 硬件 HEVC 解码/编码能力也是启用 H.265 的前提 enable_hevc_parser_and_hw_decoder true # HEVC 解析与解复用 platform_has_optional_hevc_decode_support true enable_platform_ac3_eac3_audio true enable_platform_dolby_vision true enable_platform_encrypted_dolby_vision true enable_platform_mpeg_h_audio true enable_platform_dts_audio true enable_mse_mpeg2ts_stream_parser true # 实验性 MPEG-TS 流解析 use_text_section_splitting true调试媒体功能时这套参数保证了 H.264/H.265/AC3/DTS/Dolby Vision/HLS/MPEG-TS 等常见格式在 Debug 构建中均可用。另有两个实验性参数值得注意ffmpeg_branding的合法取值是Chromium/Chrome/Chromeos而is_chancie_wancie_buildExperimental 组参数可构建 CrOS 版 ffmpeg 用于测试例如在 Linux 上启用 HEVC但会破坏 Windows/Android/Fuchsia 构建且会覆盖Chromeos 仅允许在 CrOS 构建的内部检查。3.6 Widevine 与 DRM 调试enable_library_cdms true enable_widevine true bundle_widevine_cdm false # 不打包 Widevine使其作为组件独立更新并支持 Widevine 补丁 enable_cdm_host_verification false ignore_missing_widevine_signing_cert true # 忽略无签名证书导致的 Widevine 主机校验失败 enable_media_drm_storage true # 允许 Widevine 用 LocalStorage 保存 DRM 文件如 Amazon Prime按 ABOUT_GN_ARGS.md 的解释bundle_widevine_cdm关闭时 Widevine 作为组件从 Google 服务器下载到用户 profile 目录可以独立于 Thorium 版本更新同时在 Linux 上可使用 Thorium 的 Widevine 补丁配合构建目标中的clear_key_cdm见 2.1 节Debug 构建覆盖了两类 DRM 调试路径商业 Widevine 与开源 ClearKey。3.7 构建系统级参数is_component_build true # 将大量组件拆分为共享库避免末尾漫长的链接步骤 treat_warnings_as_errors false # 调试阶段容忍警告避免构建因无关警告失败 use_lld true # 使用 LLVM lld 链接器除非使用 MOLD 等其他链接器应始终启用 is_clang true use_icf false # 关闭 ICF相同代码折叠 is_cfi false # 关闭控制流完整性 clang_use_chrome_plugins false # 注释标明Set to false for Polly build use_thin_lto false thin_lto_enable_optimizations false chrome_pgo_phase 0 # 0无 PGO1仅插桩2完整 PGO v8_enable_fast_torque true v8_enable_wasm_simd256_revec true use_v8_context_snapshot true # 单独构建 V8 函数模板与上下文的 .bin 快照 enable_rust true init_stack_vars_zero false disable_fieldtrial_testing_config true # 禁用 field trialThorium 出于稳定性/隐私/可复现性考虑 enable_resource_allowlist_generation false enable_profiling false # 关闭 PGO *.profdata 生成相关插桩 enable_reporting false这里体现了 Debug 与发布构建的核心取舍Thorium 发布构建默认use_thin_lto true且chrome_pgo_phase 2完整 PGOpgo_data_path指向trunk.sh下载的.profdata而 Debug 构建把chrome_pgo_phase降为 0、关闭 thinLTO牺牲运行时性能换取可读的符号与单步调试能力。is_component_build true在 debug_args.gn 中为true官方 Debug 参数而 ABOUT_GN_ARGS.md 说明 Thorium 的正式发布构建即使在 Debug 场景下也默认关闭组件构建且正是该参数决定 Debug 构建是否生成安装程序。3.8 WebRTC 与实验性功能rtc_use_h264 true # WebRTC 使用 H.264须搭配 proprietary_codecstrue rtc_use_h265 true rtc_build_examples true # 构建示例 RTC 数据Useful for debugging发布构建中为省体积关闭 rtc_enable_avx2 true enable_vr true # 启用 WebVR/WebXR enable_discovery true enable_hangout_services_extension false use_avx true见 3.1rtc_build_examples是典型的Debug 开启、发布关闭的参数它生成调试用的示例 RTC 数据。enable_hls_sample_aes等其他平台相关参数如 CrOS 专属的enable_ink、enable_cros_media_app会破坏非 CrOS 构建在 Linux Debug 样例中均未启用修改此类参数前应先阅读 ABOUT_GN_ARGS.md 中对应的平台警告。4. Thorium UI Debug Shell 深入讲解4.1 它是什么按 DEBUG_SHELL_README.md 的定义UI Debug Shell 是一个构建在views_examples与content_shell之上的特殊程序整合了大量用于测试、查看和调试 Thorium UI 资源的选项。它构建的目标是views_examples_with_content并会被重命名为thorium_ui_debug_shell若只构建views_examples则不包含 content_shell 链接可通过下拉菜单中的 WebView 选项访问 content_shell 形态的视图。4.2 主要用途查看与测试.icon矢量图标作者构建它的原始动机是查看和测试 Chromium 原生 UI 图标*.icon格式。这些图标在 Chromium 源码树中的分布位置引用自 DEBUG_SHELL_README.md//chromium/src/ui/views/vector_icons 大多数原生 UI views 子组件 //chromium/src/ui/views/window/vector_icons 顶栏Top Chrome相关图标 //chromium/src/components/vector_icons 影响多个构建目标的组件图标 //chromium/src/chrome/app/vector_icons 仅浏览器使用的图标 //chromium/src/ash/resources/vector_icons ChromiumOS 上 Chromium 使用的图标 //chromium/src/chromeos/ui/vector_icons ChromiumOS 专属图标 //chromium/src/chromecast/ui/vector_icons ChromeCast 专属图标本仓库中也保留了 Thorium 自己的向量图标与 UI 补丁例如 src/components/vector_icons/ 目录42 个文件含 Thorium 定制的.icon文件以及 UI 定制补丁 other/thorium-2024-ui.patch 与 other/thorium_webui.patch——当你需要在 UI Debug Shell 中核实的正是这类本地改动时可直接对照这些路径。4.3 打包与分发现象学从两个build_debug_shell_*.sh脚本可以看出产物包的组织方式以 infra/DEBUG/build_debug_shell_linux.sh 为例autoninja -C out/thorium thorium_ui_debug_shell minidump_stackwalk dump_syms -j$—— 三个目标分别对应主程序、minidump 转 core 的工具、符号 dump 工具复制运行时依赖同 2.2 节清单Linux 版还会把ClearKeyCdm/_platform_specific/linux_x64/libclearkeycdm.so放入lib/zip -r ../Thorium_UI_Debug_Shell.zip *—— 生成可直接分发的压缩包。包内附带的minidump_stackwalk与dump_syms意味着当用户用该包复现崩溃生成 minidump 后你可以离线将其转换为带完整符号的栈回溯这正是第 5 节调试流程的关键一环。5. Linux 上的调试实战技巧DEBUGGING.md 精要infra/DEBUG/DEBUGGING.md 是上游 Chromium Linux 调试指南的改编版仅将 Chromium 相关名称替换为 Thorium是拿到 Debug 构建后真正调试的操作手册。以下按主题归纳其核心内容。5.1 GDB 基本要求GDB ≥ 7.7 是硬性要求旧版本会解析不了符号或直接段错误沙箱会干扰内部符号化器可临时用--no-sandbox仅限临时或使用外部符号化器tools/valgrind/asan/asan_symbolize.py在 Ubuntu 等启用 Yama LSM 的发行版上需先放开 ptrace 限制否则会报 Could not attach to processecho 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope基础浏览器进程调试gdb -tui -exr --args out/thorium/thorium --disable-seccomp-sandbox http://google.com5.2 多进程技巧把渲染进程/GPU 进程送进 GDBThorium 自己 fork 出渲染器直接抓进程较难文档给出的方案是用--renderer-cmd-prefixthorium --no-sandbox --renderer-cmd-prefixxterm -title renderer -e gdb --args要点--no-sandbox是必需的否则 seccomp 会在启动时杀掉渲染器或 setuid 沙箱阻止 xterm 执行xterm必须带否则 gdb 会与主进程抢同一个终端如需渲染器自动启动加-ex run。文档还给了若干延伸技巧选择性调试多个渲染器把 prefix 指向一个交互式 shell 脚本每个子进程启动时提示y to debug按 y 才进入 gdb否则直接执行选择性断点用 gdb 命令文件分别为浏览器/渲染器加载不同断点gdb -x ~/debug/browser --args thorium --no-sandbox --disable-hang-monitor \ --renderer-cmd-prefixxterm -title renderer -e gdb -x ~/debug/renderer --args 附加到运行中的渲染器ps aux | grep thorium信息量有限推荐pstree -p | grep thorium查看进程树区分浏览器进程与渲染进程线程也可在 Thorium 内置任务管理器Tools 菜单中右键启用 Process ID 列。注意默认情况下沙箱进程不能被调试器附加需要传--allow-sandbox-debuggingGPU 子进程把--renderer-cmd-prefix换成--gpu-launcherbrowser_tests 拉起的浏览器改用环境变量BROWSER_WRAPPER例如BROWSER_WRAPPERxterm -title renderer -e gdb --eval-commandrun \ --eval-commandquit --args out/Debug/browser_tests --gtest_filterPrint单进程模式多数场景下gdb --args thorium --single-process并加--disable-gpu比多进程方案简单得多但插件进程无法放进浏览器进程内仍需--plugin-launcherIPC 调试设置环境变量CHROME_IPC_LOGGING1或在 gdb 中set environment CHROME_IPC_LOGGING 1若出现 unknown 消息可检查chrome/common/logging_chrome.cc中的 IPC 消息头列表是否过期日志默认日志级别会隐藏LOG(INFO)加--log-level0 --enable-loggingstderr新版还需--v1核心转储ulimit -c unlimited让 Thorium 进程全部落 core部分沙箱子进程仍需--allow-sandbox-debugging若是卡死而非崩溃可kill -6 [PID]发 SIGABRT 触发 core dump 拿回溯rr 时间旅行调试录制后支持反向单步/反向 continue文档以blink::NGBlockNode::Layout断点 watch宽度字段 rc回溯为例完整演示多进程场景用rr -f [PID]zygote fork 出的渲染器或rr -p [PID]其他进程加快 GDB 启动build/gdb-add-index out/Debug/browser_tests预建索引或在 GN 参数中设use_debug_fissionfalse以链接时间换加载速度测试环境用 Xvfb/openbox 组合Xvfb :6.0 -screen 0 1280x1024x24 DISPLAY:6.0 openbox 复刻 try bot 的窗口管理器环境调试 UI 测试超时时把--test-timeout、--ui-test-action-timeout、--ui-test-terminate-timeout调大browser_tests调试单个用例加--single-process-tests --gtest_filterMyTestName。5.3 符号与符号文件Breakpad minidump文档指向minidump_to_core.md的流程与 UI Debug Shell 包内附带的minidump_stackwalk/dump_syms工具链对应符号化栈回溯沙箱会干扰内部符号化器优先外部符号化器--no-sandbox仅作临时手段且不应在 waterfall bot 上使用沙箱测试是必需的gdbinitgdb 7 可用 Python pretty-printer 美化 Chromium 类型输出文档中给出了打印std::stringps与宽字符串pws的~/.gdbinit片段。6. 典型工作流串联把上述组件串起来一个完整的 Thorium Debug 调试闭环是准备按 Thorium 的构建文档完成源码与 depot_tools 准备本仓库根目录提供 setup.sh、get_repo.sh 等入口脚本确认out/thorium下 args 与 infra/DEBUG/debug_args.gn或对应平台的 mac/win debug args一致构建运行build_debug_linux.sh jobs或 Windows 交叉构建build_debug_win.sh jobs在out/thorium得到带完整符号的thorium、thorium_shell、thorium_ui_debug_shell与ClearKeyCdm复现/检查排查 UI 资源/图标问题 → 运行Thorium_UI_Debug_Shell包Linux 下./Thorium_Debug_Shell.sh从下拉菜单逐项检查外部资源用完整路径加载排查 Web 内容/渲染问题 →thorium_shell或完整thorium加--log-level0 --enable-loggingstderr --v1排查 DRM/HEVC 等媒体问题 → 利用clear_key_cdm与enable_hls_demuxer/enable_platform_hevc等参数组合验证解码路径抓现场按第 5 节用 GDB/--renderer-cmd-prefix/pstree/rr/core dump 定位进程与调用栈用户侧复现则用build_debug_shell_*.sh生成的 zip 包 minidump_stackwalk离线符号化收尾调试结束后运行 clean.sh 清理//out/thorium把目录从 6–7 GB 恢复到 1–2 GB 量级。7. 适用前提与限制本文所有参数与脚本均对应当前仓库infra/DEBUG目录的实际内容debug_args.gn是 Linux x64 样例macOSx64/ARM与 Windows 请分别使用同目录下的mac_x64_debug_args.gn、mac_ARM_debug_args.gn、win_debug_args.gnDebug 构建不能用于任何平台的安装程序构建且产物体积巨大6–7 GB 输出目录务必规划磁盘空间并在结束后运行clean.shis_chancie_wancie_build、CrOS 专属媒体参数等会破坏跨平台构建使用前应参照 ABOUT_GN_ARGS.md 的平台警告与作者说明DEBUGGING.md 中引用的部分工具与流程如 JsDbg、gdb-add-index、use_debug_fission依赖 Chromium 源码树中的工具路径是否可用以你所构建的具体版本为准需要 Google Sync、翻译等服务的功能依赖 API Keygoogle_api_key/google_default_client_id/google_default_client_secret公开仓库中默认置空调试此类功能时需自行申请并按 ABOUT_GN_ARGS.md 说明配置。【免费下载链接】thoriumChromium fork named after radioactive element No. 90. Source code and Linux releases. Windows/MacOS/ARM builds served in different repos, links are towards the top of the README.md.项目地址: https://gitcode.com/GitHub_Trending/th/thorium创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
