1 引言
1.1 在深入开发 Firefox for Android 之前，构建一个稳定的开发环境是必不可少的准备步骤。与常规 Android 应用不同，Firefox Android（代号 Fenix）依赖 GeckoView、Rust 编译链和多平台工具链，对于操作系统和依赖要求更为严格。
1.2 本文将围绕如何在 Linux 系统下搭建 Firefox Android 的开发环境展开，基于 Mozilla 官方文档的指导与实际操作经验，提供详细流程与注意事项，帮助开发者顺利完成首次构建。
2 开发环境选择与前置条件
2.1 为什么选择 Linux
Firefox Android 的开发环境不支持 Windows 平台进行完整构建，主要原因如下：
- 构建过程中需使用多个 Unix-only 工具（如
make,autoconf）。 - Android 构建链中包含对 libc、LLVM、Rust 等的集成，Windows 支持不完善。
- Mozilla 官方推荐 Ubuntu/Debian 系为主要支持平台。
因此，本文基于 Ubuntu 24.04 Desktop 版本作为演示环境，推荐使用原生系统或高性能虚拟机进行构建。
3 获取 Firefox 源码与依赖配置
3.1 参考文档
- 官方环境准备文档：Firefox for Android — Firefox Source Docs documentation
- Linux 构建指南：Building Firefox On Linux — Firefox Source Docs documentation
3.2 安装 Python3 环境
Firefox 构建系统依赖 Python 3.8 以上版本：
bash复制编辑sudo apt update
sudo apt install python3 python3-pip python3-venv
python3 --version # 验证安装
建议安装版本在 3.8 ~ 3.12 之间，避免兼容性问题。
4 使用 bootstrap.py 进行环境引导
4.1 获取 bootstrap 脚本
Mozilla 提供了一个名为 bootstrap.py 的工具，自动处理源码获取与依赖安装：
下载脚本：
curl -LO https://raw.githubusercontent.com/mozilla-firefox/firefox/refs/heads/main/python/mozboot/bin/bootstrap.py
python3 bootstrap.py
执行脚本：
python3 bootstrap.py
注意：从此步开始，请确保环境具备持续外网访问能力，因为将下载多个依赖包和 Git 仓库。
4.2 执行流程说明
脚本运行后将依次出现如下提示：
- 选择项目目录名：默认为
firefox，可自定义（建议保持默认）。 - Git 最佳化配置：是否启用 Git 大对象缓存、提交模板等选项 → 输入
Y。
- 日志收集提示：是否允许上传匿名构建日志 → 推荐输入
Y，支持社区改进构建质量。
执行结束后，系统将提示成功进入 Desktop Artifact Mode（默认桌面构建模式），此为构建 Desktop Firefox 的快速模式。
5 切换至 Android 构建模式
5.1 配置移动端环境
执行以下命令切换目标构建类型：
bash复制编辑./mach bootstrap --no-interactive --application-choice="Firefox for Android"
此命令将配置 Android 构建链，包括：
- 下载 Android SDK 和 NDK（通常为 r21 或 r23）。
- 设置环境变量：
ANDROID_HOME,JAVA_HOME。 - 安装 Gradle、Rust 等依赖组件。
- 自动拉取
mozilla-unified仓库中相关 GeckoView 和 Fenix 子模块。
6 验证环境是否准备就绪
执行以下命令进行初步构建验证：
bash复制编辑./mach build
如果控制台输出 "Build complete" 字样，说明 Firefox for Android 的核心组件已经成功构建。
此外，还可以尝试启动 Android 模拟器或通过 adb 连接真机：
bash复制编辑./mach run -f fenix
此命令将在设备上部署并运行构建好的 Firefox Android 应用。
7 开发建议与注意事项
7.1 代理配置建议
若使用国内网络环境，建议配置 HTTP 代理（如 clash）以提高下载速度：
bash复制编辑export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
7.2 避免虚拟机资源不足
构建过程中若遇到 OOM killed 或内存不足情况，请保证至少：
- CPU：4 核心
- 内存：8GB+
- 磁盘：30GB 可用空间
8 后续工作：进入 Fenix 开发阶段
环境准备完成后，你可以开始进行以下开发工作：
- 修改 UI 或添加新功能：Fenix 项目目录位于
mobile/android/fenix。 - 开发插件支持：通过 WebExtension 接口开发并集成插件。
- 提交补丁至 mozilla-central：可参与 Firefox 官方开发流程。
9 结语
9.1 本文详细梳理了从零开始搭建 Firefox Android 开发环境的完整流程。通过安装 Python、获取 bootstrap 脚本、配置构建链，我们能够快速进入 GeckoView + Fenix 的实际开发阶段。
9.2 Firefox Android 是一个结构清晰、社区活跃的开源项目，适合想了解现代浏览器架构、Web 渲染内核、移动隐私技术的开发者深入学习。通过本文流程搭建完毕后，你将具备进行深度定制与参与 Mozilla 社区开发的完整基础。