自己动手编译Android(LineageOS)源码
一、编译LineageOS源码
准备
- 设备:小米 MIX2
- 设备代号:chiron
- Android版本:9.0
- PC配置:
- 系统:Ubuntu18.04
- 至少12G RAM
- 至少200GB 剩余硬盘空间
- 良好的网络环境
1.下载并解压SDK
sdk中包含fastboot和adb
下载
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
解压
unzip platform-tools-latest-linux.zip -d ~
添加到环境变量
gedit ~/.profile
输入:
# add Android SDK platform tools to path
if [ -d "$HOME/platform-tools" ] ; then
PATH="$HOME/platform-tools:$PATH"
fi
保存。
使改动生效:
source ~/.profile
2.安装依赖
安装必要库和工具
sudo apt-get install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5-dev libsdl1.2-dev libssl-dev libwxgtk3.0-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev
安装openjdk-8-jdk
sudo apt install -y openjdk-8-jdk
3.配置源
创建repo存放目录
mkdir -p ~/bin
创建源码存放目录
mkdir -p ~/android/lineage
× 注:请确保该目录所在的磁盘有足够的空间(至少200G)
安装repo
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
将~/bin
放入环境变量
gedit ~/.profile
加入:
# set PATH so it includes user's private bin if it exists
if [ -d "$HOME/bin" ] ; then
PATH="$HOME/bin:$PATH"
fi
使改动生效:
source ~/.profile
初始化repo
cd ~/android/lineage
repo init -u https://github.com/LineageOS/android.git -b lineage-16.0
× 注:这里的lineage-16.0是分支名,对应Android 9.0。更多分支请浏览:https://github.com/LineageOS/android
4.拉取源码
repo sync
5.配置源码
cd device/xiaomi
git clone https://github.com/LineageOS/android_device_xiaomi_chiron -b lineage-16.0 chiron
提取vendor信息
提取手机厂商的库。这一步将手机连接电脑,并保证手机能被adb
命令操控,还需要手机授予adb root权限。
adb shell su -c setenforce 0
cd chiron
./extract-files.sh
提取需要点时间,需耐心等待
拉取kernel
cd kernel/qcom
git clone https://github.com/LineageOS/android_kernel_qcom_msm8998 -b lineage-16.0 msm8998
配置构建环境
source build/envsetup.sh
配置设备信息
breakfast chiron
6.配置构建工具
配置ccache
gedit ~/.bashrc
加入:
export USE_CCACHE=1
使改动生效:
source ~/.bashrc
执行:
ccache -M 50G
来设置缓存大小
× 注:ccache默认在home目录,请确保home目录有足够的空间。如果想自定义ccache的目录,可以在~/.bashrc
文件里加入export CCACHE_DIR=/path/to/.ccache
。缓存大小根据自己硬盘大小设置,设置25G以上可以显著提高源码的构建速度。
配置jack
gedit ~/.bashrc
加入:
export ANDROID_JACK_VM_ARGS="-Dfile.encoding=UTF-8 -XX:+TieredCompilation -Xmx8G"
使改动生效:
source ~/.bashrc
7. 构建
构建整个源码
croot
brunch chiron
× 注:构建成功后,在源码目录执行cd $OUT
进入编译好的ROM的存放目录。lineage-16.0-xxxxxxxx-UNOFFICIAL-chiron.zip
为编译好的刷机包。
只构建某个模块
mmm <模块名>
例如构建frameworks中的base
mmm frameworks/base
打包成system.img
有时候我们只修改system里的模块,没必要编译整个源码,就只打包system.img
make snod
编译system
make systemimage
8.刷入手机(可选)
下载twrp
刷入trwp
刷入recovery前,要先解锁手机的bootloader,如何解锁,各个厂商不太一样,这里就不阐述了。
adb reboot bootloader
fastboot flash recovery twrp.img
fastboot reboot
刷入system.img
我们调试源码时,如果不想刷入整个ROM,可以只刷入system.img。以下命令将system.img刷入system分区
fastboot flash system system.img
刷入ROM
将编译好的刷机包,通过adb push
命令将刷机包传输到手机存储。进入twrp界面,擦除system分区,data分区。选择手机存储中的刷机包,刷入!!!
9.常见问题
(1) 编译目标设备为emulatorx86时在编译时出错,提示yasm找不到。
安装yasm
sudo apt-get install yasm
(2) adb命令提示没有权限
lsusb
找到类似一行:
Bus 001 Device 005: ID 18d1:4ee7 Google Inc.
编辑51-android.rules:
sudo gedit /etc/udev/rules.d/51-android.rules
输入类似的内容:
# MIX2 normal
SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="4ee7",MODE="0666",GROUP="plugdev"
# MIX2 fastboot
SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="d00d",MODE="0666",GROUP="plugdev"
×注:idVendor,idProduct分别为lsusb命令显示的ID。开机状态和fastboot模式都需要添加权限,所以,需要增加两行。
更改文件权限:
sudo chmod a+r /etc/udev/rules.d/51-android.rules
二、模拟器使用LineageOS
将emulator所在的目录加入环境变量
在源码目录,cd $OUT
设置模拟器路径
# 设置模拟器目录
if [ -d "/android_source_path/prebuilts/android-emulator/linux-x86_64" ] ; then
PATH="/android_source_path/prebuilts/android-emulator/linux-x86_64:$PATH"
fi
设置OUT目录
export ANDROID_PRODUCT_OUT=/android_source_path/out/target/product/emulatorx86
使用编译好的镜像启动(arm):
emulator64-arm -kernel ./prebuilts/qemu-kernel/arm64/kernel-qemu -sysdir $ANDROID_PRODUCT_OUT -system $ANDROID_PRODUCT_OUT/system.img -data $ANDROID_PRODUCT_OUT/userdata.img -ramdisk $ANDROID_PRODUCT_OUT/ramdisk.img
使用编译好的镜像启动(x86):
emulator64-x86 -kernel ./prebuilts/qemu-kernel/x86/kernel-qemu -sysdir $ANDROID_PRODUCT_OUT -system $ANDROID_PRODUCT_OUT/system.img -data $ANDROID_PRODUCT_OUT/userdata.img -ramdisk $ANDROID_PRODUCT_OUT/ramdisk.img