3. 编译 Android 5.1 固件¶

3.1. 下载 Android SDK¶

Android SDK 源码包比较大(约6.3G),可以通过如下方式获取源码包：

[下载链接]

下载完成后先验证一下 MD5 码：

$md5sum ~/firefly_rk3288_rk3128_android5.1_git_20211216.7z.001
$md5sum ~/firefly_rk3288_rk3128_android5.1_git_20211216.7z.002

3d7a59a84e059cd55a68304d47a5462b  firefly_rk3288_rk3128_android5.1_git_20211216.7z.001
1979bd263b51bec27ec10eceb500731b  firefly_rk3288_rk3128_android5.1_git_20211216.7z.002

确认无误后，就可以解压：

mkdir -p ~/proj/firefly_rk3288_android5.1
cd ~/proj/firefly_rk3288_android5.1
7z x ~/firefly_rk3288_rk3128_android5.1_git_20211216.7z.001 -r -o.
git reset --hard

以后就可以直接从 gitlab 处更新

git pull gitlab Firefly-RK3288:Firefly-RK3288

3.2. 编译方法¶

3.2.1. 整体编译¶

3.2.1.1. 公版编译¶

3.2.1.1.1. HDMI¶

Firefly-RK3288 编译

./FFTools/make.sh -d firefly-rk3288 -j8 -l rk3288_box-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3288_box-userdebug

Firefly-RK3288-Reload 编译

./FFTools/make.sh -d firefly-rk3288-reload -j8 -l rk3288_box-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3288_box-userdebug

3.2.2. 分步编译¶

编译 uboot

cd ~/proj/firefly_rk3288_android5.1/u-boot
make rk3288_defconfig
make -j8

编译 kernel

Firefly-RK3288:

cd ~/proj/firefly_rk3288_android5.1/kernel
make firefly_defconfig
make -j8 firefly-rk3288.img

Firefly-RK3288-Reload:

cd ~/proj/firefly_rk3288_android5.1/kernel
make firefly_defconfig
make -j8 firefly-rk3288-reload.img

编译 Android

cd ~/proj/firefly_rk3288_android5.1/
source build.sh
lunch rk3288_box-userdebug
make -j8
./mkimage.sh

3.2.3. 构建变体说明¶

默认的目标构建变体(TARGET_BUILD_VARIANT)为 userdebug。常用变体有三种，分别是用户(user)、用户调试(userdebug)和工程模式(eng)，其区别如下：

user
- 仅安装标签为 user 的模块
- 设定属性 ro.secure=1，打开安全检查功能
- 设定属性 ro.debuggable=0，关闭应用调试功能
- 默认关闭 adb 功能
- 打开 Proguard 混淆器
- 打开 DEXPREOPT 预先编译优化
userdebug
- 安装标签为 user、debug 的模块
- 设定属性 ro.secure=1，打开安全检查功能
- 设定属性 ro.debuggable=1，启用应用调试功能
- 默认打开 adb 功能
- 打开 Proguard 混淆器
- 打开 DEXPREOPT 预先编译优化
eng
- 安装标签为 user、debug、eng 的模块
- 设定属性 ro.secure=0，关闭安全检查功能
- 设定属性 ro.debuggable=1，启用应用调试功能
- 设定属性 ro.kernel.android.checkjni=1，启用 JNI 调用检查
- 默认打开 adb 功能
- 关闭 Proguard 混淆器
- 关闭 DEXPREOPT 预先编译优化

如果目标构建变体为 user，则 adb 无法获取 root 权限。要选择目标构建变体，可以在 make 命令行加入参数，例如：

make -j8 PRODUCT-rk3288_box-user
make -j8 PRODUCT-rk3288_box-userdebug
make -j8 PRODUCT-rk3288_box-eng

3.3. 烧写分区映像¶

上一步骤的 ./mkimage.sh 会重新打包 boot.img 和 system.img, 并将其它相关的映像文件拷贝到目录 rockdev/Image-rk3288_box/ 中。

以下列出一般固件用到的映像文件：
- boot.img ：Android 的初始文件映像，负责初始化并加载 system 分区。
- kernel.img ：内核映像。
- misc.img ：misc 分区映像，负责启动模式切换和急救模式的参数传递。
- recovery.img ：急救模式映像。
- resource.img ：资源映像，内含开机图片和内核的设备树信息。
- system.img ：Android 的 system 分区映像，ext4 文件系统格式。

请参照升级固件一文来烧写分区映像文件。如果使用的是 Windows 系统，将上述映像文件拷贝到 AndroidTool （Windows 下的固件升级工具）的 rockdev\Image 目录中，之后参照升级文档烧写分区映像即可，这样的好处是使用默认配置即可，不用修改文件的路径。

3.4. 打包成统一固件¶

编译完可以使用 Firefly 的脚本打包成统一固件，执行如下命令：

./FFTools/mkupdate/mkupdate.sh -l rk3288_box-userdebug

打包完成后固件会生成在 rockdev/Image-rk3288_box/ 目录

在 Windows 下打包统一固件 update.img 很简单，按上一步骤将文件拷贝到 AndroidTool 的 rockdev\Image 目录中，然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdev\Image 目录里。

update.img 方便固件的发布，供终端用户升级系统使用。一般开发时使用分区映像比较方便。