当前位置：首页 > news >正文

告别编译焦虑：手把手教你用瑞芯微原厂脚本编译RK3568 Android11镜像（附环境配置避坑指南）

news 2026/5/22 11:10:00

告别编译焦虑：RK3568 Android11镜像编译实战手册

第一次拿到瑞芯微RK3568开发板时，那种既兴奋又忐忑的心情至今记忆犹新。作为一款中高端AIoT芯片，RK3568的性能和扩展性确实令人期待，但原厂提供的Android11 BSP包那庞大的代码量和复杂的编译流程，也着实让不少开发者望而生畏。本文将从一个实战者的角度，带你一步步完成从环境配置到镜像生成的全过程，避开那些我踩过的坑。

1. 编译环境搭建：从零开始的Ubuntu配置

编译Android系统对主机环境有着严苛的要求，这也是许多新手第一个容易栽跟头的地方。不同于普通应用开发，系统级编译需要考虑更多底层依赖和硬件限制。

1.1 硬件与系统要求

最低配置（能编译但体验较差）：
- CPU：4核以上（建议8核）
- 内存：16GB（建议32GB）
- 存储：300GB可用空间（建议SSD）
推荐配置：
- CPU：8核及以上
- 内存：32GB
- 存储：500GB NVMe SSD

提示：虚拟机编译性能损失较大，建议使用物理机。如果必须用虚拟机，请确保分配足够资源并开启VT-x/AMD-V虚拟化支持。

1.2 基础软件包安装

在Ubuntu 18.04/20.04上执行以下命令安装必备工具链：

sudo apt update && sudo apt upgrade -y sudo apt install -y git-core gnupg flex bison gperf build-essential \ zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \ lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev \ libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig python

特别容易遗漏的是这些32位兼容库，它们对Android编译至关重要但不会自动安装。我曾经因为漏装lib32z1-dev导致一连串莫名其妙的链接错误，花了整整一天才排查出来。

1.3 Java环境配置

RK3568的Android11需要OpenJDK 8：

sudo apt install -y openjdk-8-jdk

验证安装：

java -version # 应显示类似：openjdk version "1.8.0_312"

如果系统中有多个Java版本，需要设置默认版本：

sudo update-alternatives --config java sudo update-alternatives --config javac

2. 源码获取与repo工具使用

瑞芯微的BSP包通常以repo形式管理，这比直接下载完整源码更灵活，但也增加了初学者的学习成本。

2.1 初始化repo环境

首先获取repo工具并配置：

mkdir ~/bin curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo chmod a+x ~/bin/repo

将repo添加到PATH中：

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc source ~/.bashrc

2.2 同步RK3568 Android11源码

创建工作目录并初始化仓库：

mkdir rk3568_android11 && cd rk3568_android11 repo init -u https://gitlab.com/rockchip-linux/manifest.git -b android11

这个步骤可能会因为网络问题失败，可以尝试替换为国内镜像源：

repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/lineageOS/LineageOS/android.git -b lineage-18.1

同步代码（这是一个漫长的过程）：

repo sync -j4 --no-tags --no-clone-bundle

注意：-j后面的数字表示并行任务数，应根据CPU核心数调整。太大会导致网络或磁盘I/O瓶颈，太小则同步速度慢。

2.3 源码目录结构解析

瑞芯微的BSP在标准AOSP基础上添加了若干关键目录：

目录	说明
device/rockchip/rk3568	设备特定配置
kernel/	Linux内核源码
u-boot/	U-Boot引导程序
RKTools/	瑞芯微专用工具
vendor/rockchip	厂商闭源库

其中device/rockchip/rk3568/BoardConfig.mk是最重要的配置文件之一，定义了芯片特性、分区表等关键信息。

3. 编译配置与执行

有了正确的源码和环境，接下来就是最关键的编译环节。瑞芯微提供的一键编译脚本build.sh简化了流程，但理解其背后的机制同样重要。

3.1 环境变量初始化

每次开始编译前都需要执行：

source build/envsetup.sh lunch rk3568_r-userdebug

这组命令做了三件重要的事：

加载编译所需的各种函数和别名
设置目标设备为RK3568
配置编译类型为userdebug（可调试版本）

3.2 一键编译脚本解析

原厂提供的build.sh支持多种参数组合：

./build.sh -UKAu

参数分解：

-U：编译U-Boot
-K：编译Kernel
-A：编译Android
-u：生成update.img

更详细的参数说明：

参数	功能	使用场景
-C	使用Clang编译内核	需要LLVM工具链
-p	打包镜像	最终生成可烧写文件
-o	生成OTA包	系统升级用
-d	指定设备树	多设备支持
-j	并行任务数	加速编译

3.3 编译过程监控

编译过程中有几个关键点需要关注：

内存使用：Android编译是内存大户，建议使用htop监控。如果发现频繁swap，应该减少-j参数值。
首次编译时间：根据硬件配置不同，完整编译可能需要2-6小时。后续增量编译会快很多。
常见错误处理：
- Out of memory：减少-j参数，或增加swap空间
- Missing library：根据错误提示安装对应开发包
- Java版本错误：确保使用的是OpenJDK 8

4. 镜像生成与烧写

编译成功的标志是在out/target/product/rk3568_r/目录下生成了一系列镜像文件。

4.1 关键镜像文件说明

文件	作用	是否必须
boot.img	内核和初始ramdisk	是
system.img	Android系统分区	是
vendor.img	厂商定制内容	是
userdata.img	用户数据分区	首次烧写可选
update.img	完整升级包	烧写工具专用

瑞芯微还提供了一些特有文件：

MiniLoaderAll.bin：低阶加载器
parameter.txt：分区表定义
rk3568_loader_*.bin：芯片专用加载器

4.2 使用RKTools打包

原厂提供的打包工具位于RKTools/linux/Linux_Pack_Firmware/下：

./mkupdate.sh

这个脚本会：

校验各分区镜像
根据parameter.txt组织分区结构
生成可用于烧写的update.img

4.3 烧写到开发板

瑞芯微推荐使用AndroidTool进行烧写：

开发板进入Loader模式（通常按住Recovery键上电）
运行AndroidTool
选择生成的update.img
点击"执行"开始烧写

烧写过程中常见的几个问题：

设备无法识别：检查USB线、驱动是否安装
烧写失败：尝试降低烧写速度或更换USB口
启动卡LOGO：可能是boot.img不匹配，尝试重新编译

5. 高级技巧与问题排查

经过几次完整编译后，你会发现有些步骤可以优化，有些错误会反复出现。这里分享一些实战经验。

5.1 加速编译的方法

ccache配置：在~/.bashrc中添加：
```
export USE_CCACHE=1 export CCACHE_DIR=/path/to/ccache ccache -M 50G
```
首次编译后，后续编译可提速30%-70%。
选择性编译：
- 只编译某个模块：mmm path/to/module
- 重新打包镜像：make snod
分布式编译：使用distcc工具可以跨多台机器分布式编译，适合团队环境。

5.2 常见错误解决方案

问题1：java.lang.OutOfMemoryError: GC overhead limit exceeded

解决方案：在build/core/main.mk中添加：

JAVA_OPTS := -Xmx4096m

问题2：ninja: build stopped: subcommand failed

这通常是依赖问题，尝试：

make clean repo sync ./build.sh -UKAu

问题3：未定义的硬件相关符号

检查内核配置是否正确：

make ARCH=arm64 rockchip_defconfig make ARCH=arm64 menuconfig

5.3 自定义系统修改

常见的定制需求和方法：

添加新设备：
- 复制device/rockchip/rk3568为新目录
- 修改BoardConfig.mk和device.mk
- 添加专属内核配置

修改系统属性：编辑build.prop：

adb pull /system/build.prop # 修改后 adb remount adb push build.prop /system/

预装应用：在device/rockchip/common/apps/下添加APK，修改device.mk

6. 性能优化与调试

系统编译成功后，下一步就是优化和调试了。RK3568作为一款性能强劲的芯片，合理配置可以发挥更大潜力。

6.1 内核参数调优

关键内核配置选项：

CONFIG_HZ=1000 CONFIG_PREEMPT=y CONFIG_ARM64_VA_BITS=48 CONFIG_SCHED_TUNE=y

可以通过menuconfig调整：

cd kernel make ARCH=arm64 rockchip_defconfig make ARCH=arm64 menuconfig

6.2 GPU性能优化

RK3568的Mali-G52 GPU需要正确配置：

确保内核中启用：

CONFIG_MALI_MIDGARD=y CONFIG_MALI_G52_SUPPORT=y

在device.mk中添加：

PRODUCT_PACKAGES += \ libGLES_mali \ gralloc.rk30board

设置合适的GPU频率：

&gpu { operating-points = < 800000 1000000 500000 850000 300000 750000 >; };

6.3 系统级调试工具

瑞芯微提供了一些有用的调试工具：

rkdeveloptool：

sudo rkdeveloptool ld # 列出设备 sudo rkdeveloptool db loader.bin # 下载loader

rkflash.sh：
```
./rkflash.sh /dev/sdX parameter.txt
```

系统日志：

adb logcat -b all -v threadtime > log.txt dmesg | grep rk

7. 持续集成实践

对于需要频繁编译的场景，建立自动化流程可以大幅提高效率。

7.1 基础CI配置

使用Jenkins的典型流程：

代码同步：

stage('Sync') { sh 'repo sync -c -j4 --no-tags' }

环境设置：

stage('Setup') { sh ''' source build/envsetup.sh lunch rk3568_r-userdebug ''' }

编译：

stage('Build') { sh './build.sh -UKAu -j$(nproc)' }

7.2 自动化测试

编译后可以添加自动测试：

adb install app-debug.apk adb shell am instrument -w com.example.test/androidx.test.runner.AndroidJUnitRunner

7.3 镜像分发

使用Python脚本自动上传镜像：

import paramiko ssh = paramiko.SSHClient() ssh.connect('server', username='user', password='pass') sftp = ssh.open_sftp() sftp.put('update.img', '/var/www/images/latest.img') sftp.close()

8. 扩展与进阶

掌握了基础编译后，可以尝试更高级的开发。

8.1 内核模块开发

示例Makefile：

obj-m += hello.o KDIR := /path/to/kernel PWD := $(shell pwd) all: make -C $(KDIR) M=$(PWD) modules

加载测试：

adb push hello.ko /data/local/tmp/ adb shell insmod /data/local/tmp/hello.ko adb shell dmesg | grep hello

8.2 设备树覆盖

创建overlay dts：

/dts-v1/; /plugin/; &i2c1 { status = "okay"; sensor@48 { compatible = "ti,tmp112"; reg = <0x48>; }; };

编译和应用：

dtc -@ -I dts -O dtb -o overlay.dtbo overlay.dts adb push overlay.dtbo /vendor/overlays/

8.3 性能分析工具

推荐工具链：

perf：系统级性能分析

perf stat -e cycles,instructions,cache-misses ls

systrace：图形化分析

python systrace.py -o trace.html sched freq idle

RKNN Toolkit：AI加速分析

from rknn.api import RKNN rknn = RKNN() rknn.load_rknn('model.rknn')

9. 社区资源与支持

遇到难题时，这些资源可能会帮到你：

官方渠道：
- 瑞芯微开发者社区
- GitHub上的linux-rockchip仓库
第三方资源：
- Armbian论坛的RK3568板块
- XDA开发者论坛
本地支持：
- 开发板供应商的技术支持
- 本地嵌入式Linux用户组

10. 从编译到产品化

当原型开发完成后，产品化还需要考虑：

OTA升级系统：
- 生成OTA包：./build/tools/releasetools/ota_from_target_files
- 实现recovery更新逻辑
安全加固：
- 启用Verified Boot
- 加密敏感分区
生产测试：
- 开发工厂测试程序
- 实现自动化烧写流水线
长期维护：
- 建立版本控制系统
- 制定更新策略