Firefox Android 开发环境搭建全流程（四）

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文件。