1. 在 Ubuntu 16.04 上编 Android 7.0:先别急着敲 make
很多人第一次拿到 MT6799 开发板的 Android 7.0 源码,第一反应是找一条“一键编译”命令,结果在 source、lunch、make 三步里反复翻车。这套代码开发工具链真正的门槛不在命令本身,而在虚拟机、软件源、共享目录、依赖工具和并行度这些前置条件上。这一篇按我实际搭环境的顺序,从 Ubuntu 16.04 的源配置讲到 VMware Tools 安装、源码解压、lunch 选择、make -j 取值,再把三个最常见的编译报错拆成“现象—原因—解决”。新手可以照着命令走,熟手可以对照参数和坑位检查自己的脚本。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 虚拟机环境配置:软件源、共享目录与硬件参数一次配到位
编译 Android 7.0 这种量级的源码,虚拟机不是“能开机就行”。软件源决定依赖工具能不能装上,共享目录决定源码能不能顺利从主机搬进来,内存和 CPU 核心数直接决定后面 make -j 能开多大。这三件事任何一件没配好,后面都会以“玄学报错”的形式还回来。我习惯在装完系统后先把这三步做完,再碰源码。
2.1 软件源:先备份再换源,别跳过 update
Ubuntu 16.04 默认源在国内访问速度不稳定,编译前要装的依赖工具又不少,换一个响应快的镜像源能省很多等待。操作顺序很简单,但有两个细节容易被忽略:一是改之前必须备份,二是改完必须刷新索引。
bash复制# 先备份,改坏了能回滚
sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup
# 用文本编辑器打开源列表,把官方源替换为国内镜像站的 xenial 源
sudo gedit /etc/apt/sources.list
# 改完必须刷新索引,否则 apt 还在用旧缓存
sudo apt-get update
/etc/apt/sources.list 是 apt 的软件源清单,xenial 是 Ubuntu 16.04 的代号,换源时条目里的代号必须和系统版本对得上,否则 apt-get update 会报 404。备份文件 .backup 不是摆设,源地址写错、格式多一个空格都可能导致 apt 直接罢工,这时候把备份覆盖回去就能恢复。apt-get update 只刷新索引,不安装任何东西,但不执行它,后面的 apt-get install 会继续读旧缓存,表现就是“明明源里有这个包,就是装不上”。
我一般会把换源和 update 放在同一次操作里完成,中间不插别的命令。原因很简单:改完源不 update,相当于换了菜单却没让厨房知道,后面点菜全是错的。
2.2 共享文件夹:VMware Tools 装完再谈挂载
源码通常放在主机上,需要通过共享文件夹搬进虚拟机。共享文件夹的前提是 VMware Tools 已经装好,否则虚拟机里根本看不到主机共享出来的目录。安装包一般随虚拟机软件提供,复制到 Linux 环境后解压、进入目录、执行安装脚本:
bash复制tar zxvf VMwareTools-10.1.15-6627299.tar.gz
cd vmware-tools-distrib/
sudo ./vmware-install.pl
tar zxvf 里 z 表示走 gzip 解压,x 是释放,v 打印过程,f 指定文件名。进入 vmware-tools-distrib/ 后执行 vmware-install.pl,安装过程会连续提问,通常按提示输入 YES 并接受默认路径即可。安装完成后,主机侧在虚拟机设置里指定的共享目录才会出现在 Linux 的挂载点下。
这里有个顺序问题:必须先装 Tools,再配置共享文件夹,最后在 Linux 里确认目录可见。如果先配共享再装 Tools,有时需要重启虚拟机才能生效。我遇到过共享目录在文件管理器里能看到、但命令行 cd 不进去的情况,多半是挂载点没刷新,重启一次比反复折腾挂载命令省事。
2.3 硬件参数:内存和 CPU 核心决定 make -j 的上限
虚拟机软件比如 VMware 15.5,硬件设置里最影响编译的是内存和 CPU 核心数。Android 编译会同时拉起大量进程,内存不够时不会温和地变慢,而是直接抛 fork: Cannot allocate memory;CPU 核心数不够时 make -j 开大了也只是在排队。
我的分配习惯是:内存按宿主机物理内存的一半到三分之二给,CPU 核心数不超过宿主机的逻辑核心数。磁盘尽量放在 SSD 上,源码解压后占用空间不小,机械盘会让解压和编译都明显变慢。
bash复制# 查看虚拟机识别到的 CPU 核心数和内存
nproc
free -h
nproc 输出的是当前虚拟机可用的逻辑核心数,后面定 make -jN 的 N 时直接参考它。free -h 看内存总量和可用量,编译前保证可用内存足够,别让系统靠交换分区硬撑。这两个数字不是摆设,它们决定了第 4 章里并行度怎么取。
3. 工具链安装与源码准备:从共享目录到可编译的源码树
环境配好之后,下一步是把编译依赖装齐、把源码从共享目录搬到本地工作盘。这一步看起来只是复制粘贴,实际上决定了后面编译能不能顺利进入 make 阶段。依赖缺一个,可能在编译到某个模块时才报错;源码放在共享目录里直接编,性能和权限问题会混在一起,很难判断是代码问题还是环境问题。
3.1 依赖工具:Git、JDK 与编译基础包
Android 源码编译需要一组基础工具,材料里明确提到 Git、Java SDK、Android SDK、NDK 等,用 apt-get install 安装。实际动手时,我会先把最基础的部分装上,再根据编译日志补缺。
bash复制# 刷新索引后安装基础工具
sudo apt-get update
sudo apt-get install -y git default-jdk
git 用于源码管理和部分仓库操作,default-jdk 安装系统默认的 Java 开发包。Android 不同分支对 JDK 版本有要求,装完后用 java -version 确认一下,版本对不上就在编译前换掉,别等到编译中途才报 Java 相关的错。Android SDK、NDK 不是所有编译场景都必需,如果只是编系统镜像,可以先不装;如果配套工具需要,再按官方说明补。
依赖安装最忌讳“看着差不多就行”。apt-get install 一次装多个包时,只要有一个包名写错,整条命令都会失败,前面的包也不会装。所以我会把确认过的包放在一条命令里,不确定的单独装,报错时容易定位。
3.2 源码拷贝与解压:别在共享目录里直接编
源码从主机共享目录复制到 Linux 本地工作盘,再解压。共享目录适合传输,不适合直接作为编译目录,原因有两个:共享文件系统的性能和权限模型与本地 ext4 不一样,编译过程中大量小文件读写会明显变慢;某些编译步骤对文件权限有要求,共享挂载点上容易出权限错误。
bash复制# 从共享目录复制到本地工作盘,避免在共享挂载点上直接编译
cp /mnt/hgfs/share/<source_archive>.tar.gz ~/work/
cd ~/work
tar zxvf <source_archive>.tar.gz
# 进入解压后的源码根目录
cd <source_dir>
/mnt/hgfs/share/ 是共享目录的常见挂载位置,实际路径以虚拟机里看到的为准。cp 到 ~/work/ 是为了让后续解压和编译都发生在本地磁盘上。tar zxvf 的参数含义和前面装 VMware Tools 时一样,解压完成后必须 cd 进源码根目录,后面所有编译命令都依赖当前目录下有 build/envsetup.sh。
解压后先确认目录结构,尤其是 device/ 下对应厂商和设备的那一层。后面 lunch 选目标、排查 device-vendor.mk 相关报错,都要回到这个目录里找文件。目录结构不清楚,后面报错只能靠猜。
3.3 目录结构确认:device/vendor/device 在哪
Android 源码根目录下有几个关键位置:build/ 放编译系统脚本,device/ 放板级配置,out/ 是编译产物输出目录。device/ 下面一般按厂商和设备分层,形如 device/<vendor>/<device>/,板级的 device.mk、产品定义文件都在这一层。
bash复制# 确认源码根目录的关键结构
ls build/envsetup.sh
ls device/
build/envsetup.sh 存在,说明当前目录大概率是源码根目录,可以执行 source。device/ 下能看到厂商目录,说明板级配置已经解压到位。如果 device/ 是空的或者层级不对,先别急着编译,回头检查源码包是不是完整、解压时有没有中断。第 5 章的 TAREGT_BRM_PLATFORM is undefined 报错,根子就在这一层配置有没有被正确包含。
4. 编译流程:envsetup、lunch 与 make 的参数怎么定
前面都是准备工作,真正进入编译只有三步:source build/envsetup.sh、lunch <target_device_name>、make -jN。命令少不代表简单,lunch 选错目标会编出不属于这块板子的镜像,make -jN 的 N 取大了会把内存打爆。这一章把这三步拆开,说清楚每一步在做什么、参数怎么定。
4.1 source build/envsetup.sh 与 lunch 的选择逻辑
source build/envsetup.sh 的作用是把编译系统定义的命令和函数加载到当前 shell 会话里。注意是 source,不是直接执行脚本,直接执行会在子 shell 里跑完就退出,当前终端里根本不会有 lunch、m 这些命令。
bash复制# 加载编译环境,必须在源码根目录执行
source build/envsetup.sh
# 选择目标设备和编译变体
lunch <target_device_name>
lunch 的参数 <target_device_name> 要换成实际设备配置,材料里明确说“应替换为你的设备配置”。执行 lunch 不带参数时,通常会列出可选目标,从中找到对应这块开发板的条目。选错目标的典型表现是编译能跑完,但产物刷不进板子,或者启动后外设全不对。
lunch 选择的不只是设备,还包含编译变体,比如 user、userdebug、eng。变体影响调试权限和镜像行为,开发阶段一般用调试权限更全的变体,发布前再切到用户变体。这个选择在 lunch 参数里体现,具体写法以当前源码的 lunch 菜单为准。
4.2 make -jN 的 N 怎么定
make -jN 里的 N 是并行任务数。材料给的示例是 make -j4,这是一个保守值,适合核心数不多或内存偏紧的虚拟机。
bash复制# 保守并行度,先确认环境能跑通
make -j4
N 不是越大越好。每个并行任务都会占用内存,N 超过内存能支撑的上限时,系统会开始用交换分区,速度反而下降,严重时直接触发 fork: Cannot allocate memory。我的取值方法是:先看 nproc 的核心数,N 从核心数起步;如果编译过程中出现内存不足,就把 N 减半再试。比如 8 核但内存紧张,先用 make -j4,稳定后再尝试加。
make 不带参数时会用默认并行度,不同版本行为不一样,所以正式编译我习惯显式写 -jN,把并行度握在自己手里。第一次在新环境编译,用较小的 N 跑通比用大 N 赌运气更省时间。
4.3 编译过程看什么
make 启动后终端会滚动大量输出,真正有用的信息是错误行和它前面的模块名。编译失败时,最后几行往往只是汇总,比如 ninja: build stopped: subcommand failed.,根因在更上面的日志里。
bash复制# 把编译输出同时写到日志,方便失败后回查
make -j4 2>&1 | tee build.log
2>&1 把标准错误合并到标准输出,tee build.log 在屏幕上显示的同时写入文件。编译中断后,直接在 build.log 里搜 error:,找到第一条真正的错误,比盯着屏幕最后一页有效得多。这一步的习惯,直接决定第 5 章里的报错排查是五分钟还是五小时。
5. 编译报错排查:三个把编译卡死的坑,现象、原因与解决
Android 编译的报错有个特点:真正的原因往往不在最后一行。下面这几条是我在 Ubuntu 16.04 编 Android 7.0 时反复遇到的,按“现象—原因—解决”记下来,下次再碰到可以直接对号入座。
5.1 TAREGT_BRM_PLATFORM is undefined
现象:编译早期直接停下,提示 TAREGT_BRM_PLATFORM is undefined. Please make sure the device-vendor.mk is correctly included.,后面的编译根本没开始。
原因:板级配置没有正确包含 vendor 的 mk 文件。编译系统在解析产品配置时找不到 TAREGT_BRM_PLATFORM 这个变量,说明负责定义它的 device-vendor.mk 没有被引入。
解决:回到 device/<vendor>/<device>/ 目录,检查 device.mk,确认里面正确包含了 vendor 的 mk 文件。材料里的说法是“检查设备的配置文件(通常是 device/<vendor>/<device>/device.mk),确保它正确包含了 vendor 的 mk 文件”。改完不需要全量重编,重新执行 lunch 再 make 即可。
这个错的名字里 TAREGT 是源码里的拼写,搜报错时按原样搜,改成 TARGET 反而搜不到。
5.2 ninja: build stopped: subcommand failed
现象:编译跑了一段时间后中断,最后一行只给 ninja: build stopped: subcommand failed.,看不出哪个模块出了问题。
原因:ninja 只是构建调度器,某个子任务失败后它会停止并给出这条汇总信息,真正的错误在被调用的子命令输出里,通常在更上面的日志中。
解决:回到完整日志里搜 error: 或 FAILED:,找到第一条失败记录,确认是哪个模块、哪个源文件。定位到模块后,可以单独编译该模块验证修复,不必每次全量重跑。如果用了 tee build.log,直接 grep -n "error:" build.log 就能拿到行号。
bash复制# 从编译日志里定位第一条真正的错误
grep -n "error:" build.log | head
head 只取前几条,因为一个错误可能引发连锁报错,第一条才是根因。盯着最后一行 ninja 汇总信息改,基本改不动。
5.3 fatal: fork: Cannot allocate memory
现象:编译进行到一半突然报 fatal: fork: Cannot allocate memory,系统可能同时变得很卡。
原因:内存不足,无法创建新进程。make -jN 的并行任务同时运行时,每个任务都要占内存,N 超过内存承受能力就会触发这个错误。
解决:两条路,一是给虚拟机加内存,二是减小并行度。材料里的建议是“增加虚拟机的内存分配或者优化编译选项(如减少并行编译的线程数 make -jN,其中 N 应适当减小)”。
bash复制# 内存偏紧时降低并行度重试
make -j2
先降到 -j2 把编译跑完,确认不是代码问题,再根据内存余量逐步往上加。别在报错后原样重跑 make -j8,大概率还是同一处失败。
5.4 共享目录里直接编译导致变慢或权限错误
现象:编译速度异常慢,或者在某个步骤报文件权限相关的错误,换到本地目录后同样的源码却能编过。
原因:源码放在 /mnt/hgfs/ 这类共享挂载点上直接编译。共享文件系统的读写性能和权限模型与本地磁盘不同,编译过程大量小文件操作会被放大。
解决:把源码复制到本地工作盘再解压编译,共享目录只用来传输。第 3 章里的 cp 到 ~/work/ 就是干这个的。已经在大目录里编了一半的,把整个源码目录复制到本地后重新 lunch、make,不要试图在共享目录上修权限。
5.5 软件源没 update 导致依赖装不上
现象:apt-get install 报找不到包,或者装上的版本和预期不一致,但 sources.list 里明明写了对应的源。
原因:改完 sources.list 没有执行 apt-get update,apt 还在用旧索引。
解决:先 sudo apt-get update 刷新索引,再重新安装。如果 update 本身报错,检查源条目里的系统代号是不是 xenial,以及格式有没有多空格。改坏了就用第 2 章备份的 sources.list.backup 覆盖回去。
6. 加速与验证:先小并行度跑通,再逐步加 -j
新环境第一次编译,我从不直接上大并行度。先用 make -j2 或 make -j4 完整跑一遍,目的不是快,是确认软件源、共享目录、依赖工具、lunch 目标这几件事全部正确。这一步跑通后,再根据 nproc 和 free -h 的结果逐步加 N,每次加完观察有没有内存报错。血泪经验是:环境没验证就直接 make -j16,失败后根本分不清是内存不够还是配置错了。
编译日志一定要留。make -j4 2>&1 | tee build.log 这条习惯救过很多次,失败后 grep -n "error:" build.log | head 找第一条根因,比翻终端回滚高效得多。定位到模块后单独编该模块,别每次全量重跑。
产物验证看 out/ 下对应产品的输出目录,确认系统镜像生成时间是对应的这次编译。如果产物时间没变,说明编译其实没走到打包阶段,回头查日志里的中断点。
从那以后我每次在新虚拟机上编 Android,都强制先用小并行度完整跑一遍再调参,这个习惯比任何加速技巧都省时间。希望帮到你。
