
1 引言
Firefox Android是Mozilla开发的一款培育在Android系统上运行的浏览器。该项目使用了C++和Java/Kotlin综合开发框架,属于复杂度较高的Android应用。
在上一文中,我们进行了瓶颈分析和项目切换与安装设置。本篇将续续添加编译过程部分,帮助您完成全部编译流程,得到可装备运行的APK文件。
2 编译流程概述
Firefox for Android项目由两部分组成:
- Firefox核心部分(以C++编写)
- Android前端和组装部分(以Gradle+Kotlin编写)
这两部分需要按照顺序进行编译,无法直接编译Android部分而不编译核心。这样的分层设计是出于对项目联合编译效率和模块化管理考虑。
实际上,所有的编译流程都是基于Mozilla的mach
工具来执行的,这个工具给了开发者构造、运行和调试的全过程支持。
2.1 编译Firefox C++核心部分
首先进入项目根目录,使用Mozilla自己的构建命令工具mach
来进行编译:
./mach build

这步操作会触发对Firefox实际核心代码的编译,包括对Gecko引擎和其他原生编码库的构建。
该步骤有时会因为内存不足、CPU性能较差而耗费十分钟或者以上,建议使用SSD硬盘和8核以上处理器的设备。
2.2 编译Android前端部分
当C++核心编译完成后,我们需要继续编译Android前端。Firefox Android项目使用Gradle来组织编译过程,命令如下:
./mach gradle fenix:assembleDebug

该命令将触发Fenix项目中指定目标的Debug构建模式。目前版本中默认为arm64-v8a构建。
这步操作会依赖Gradle Wrapper实现,首次运行时可能需要下载相关组件,包括Kotlin plugin、support libraries等,需要确保网络运行正常。
2.3 APK输出路径解析
当编译过程结束后,APK文件将保存在如下路径:
firefox/obj-aarch64-unknown-linux-android/gradle/build/mobile/android/fenix/outputs/apk/fenix/debug/
在该目录中,你将看到多个APK文件,包括含有不同构建目标和平台的版本:

fenix-fenix-arm64-v8a-debug.apk
fenix-fenix-armeabi-v7a-debug.apk
fenix-fenix-x86_64-debug.apk
其中 fenix-fenix-arm64-v8a-debug.apk
是选择arm64 Android设备时我们需要安装的那个APK。其他的APK为其他平台,如armeabi-v7a等,可以不理会。
你还可以给APK输出路径进行转编,比如将构建文件自动备份或同步到指定目录:
cp firefox/obj-aarch64-unknown-linux-android/gradle/build/mobile/android/fenix/outputs/apk/fenix/debug/fenix-fenix-arm64-v8a-debug.apk ~/Desktop/
然后我们吧apk安装到手机

打开后

3 额外说明
- 如编译过程中报错,首先确认NDK版本是Mozilla支持的版本,一般为
r25b
或r23
。 - 确保使用
--target=aarch64
或者在mozconfig里切换目标平台,否则构建APK时会有内核和应用无法匹配问题 - 在一些操作系统上如Ubuntu 22.04,可能需要手动安装OpenJDK 17用于支持Gradle编译
- 如果要进行线上打包release版,可使用
assembleRelease
命令构建安全签名的版本,需自行配置签名keystore
4 结言
通过本篇文章,我们完成了Firefox for Android项目的编译全流程,包括核心部分和Android前端部分。最终我们得到了适用于arm64平台的Debug APK文件。