在Ubuntu 20.04上为RK3588/RK3399交叉编译Flutter应用：一份避坑指南与完整配置流程-酒店常州论坛

在Ubuntu 20.04上为RK3588/RK3399交叉编译Flutter应用：一份避坑指南与完整配置流程

如果你正在为RK3588或RK3399这类国产ARM开发板搭建Flutter开发环境，那么交叉编译可能是你绕不开的一道坎。不同于x86平台上的常规开发，ARM架构的嵌入式设备往往需要特殊的工具链和配置。本文将带你从零开始，在Ubuntu 20.04上为这些开发板搭建完整的Flutter交叉编译环境，并分享我在实际项目中积累的关键技巧和常见问题解决方案。

1. 环境准备与工具链安装

在开始之前，确保你的开发机满足以下基本要求：

运行Ubuntu 20.04的x86_64主机
至少8GB RAM（16GB更佳）
50GB可用磁盘空间

首先安装基础开发工具：

sudo apt update sudo apt install -y unzip curl clang cmake pkg-config ninja-build

对于ARM64交叉编译，我们需要特定的工具链。Ubuntu 20.04官方仓库提供了多个版本的aarch64编译器，推荐使用gcc-10：

sudo apt install -y gcc-10-aarch64-linux-gnu g++-10-aarch64-linux-gnu

验证安装是否成功：

aarch64-linux-gnu-gcc-10 --version

如果看到类似gcc version 10.x.x的输出，说明工具链已正确安装。

2. 获取和配置Flutter for Embedded Linux

标准的Flutter SDK不支持直接交叉编译到嵌入式Linux平台，我们需要使用专门的分支。Sony维护的flutter-elinux是一个不错的选择：

git clone https://github.com/sony/flutter-elinux.git sudo mv flutter-elinux /opt/

然后配置环境变量。编辑/etc/environment文件，在PATH中添加Flutter路径：

PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/opt/flutter-elinux/bin/"

应用更改：

source /etc/environment

验证Flutter安装：

flutter-elinux --version

3. 创建和配置Flutter项目

创建一个新的Flutter项目：

mkdir demo1 cd demo1 flutter_elinux create demo

项目创建完成后，关键的配置集中在CMakeLists.txt文件中。我们需要进行几处重要修改：

在demo/elinux/CMakeLists.txt的开头添加：

set(CMAKE_EXE_LINKER_FLAGS "-fuse-ld=gold") set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g++-10)

注意：这两行必须放在project(runner LANGUAGES CXX)之前

在demo/elinux/runner/CMakeLists.txt中，添加必要的库链接：

set(FLUTTER_LIB ${CMAKE_CURRENT_SOURCE_DIR}/../flutter_lib/) target_link_libraries(${BINARY_NAME} PRIVATE ${FLUTTER_LIB}libffi.so ${FLUTTER_LIB}libwayland-cursor.so.0 ${FLUTTER_LIB}libxkbcommon.so.0 ${FLUTTER_LIB}libmali-wayland.so ${FLUTTER_LIB}libdrm.so.2 ${FLUTTER_LIB}libwayland-server.so.0 )

4. 获取和准备必要的库文件

RK3588/RK3399开发板通常使用Mali GPU，需要特定的图形库支持。这些库文件通常包括：

libmali-wayland.so
libwayland-*.so
libdrm.so.2
libxkbcommon.so.0
libffi.so

获取这些库的几种方法：

从开发板提取：

scp root@<board-ip>:/usr/lib/libmali-wayland.so ./flutter_lib/

从厂商SDK获取：大多数开发板厂商会提供完整的SDK，其中包含必要的库文件
自行交叉编译：对于开源库如Wayland，可以下载源码后交叉编译：

git clone https://gitlab.freedesktop.org/wayland/wayland cd wayland meson setup build --cross-file cross.txt ninja -C build

其中cross.txt内容示例：

[host_machine] system = 'linux' cpu_family = 'aarch64' cpu = 'aarch64' endian = 'little' [binaries] c = 'aarch64-linux-gnu-gcc-10' cpp = 'aarch64-linux-gnu-g++-10'

5. 常见问题与解决方案

5.1 链接器错误

问题：编译时出现undefined reference错误

解决方案：

确保所有依赖库都已正确放置在flutter_lib目录
检查库文件架构是否正确：
```
file flutter_lib/libmali-wayland.so
```
应显示ELF 64-bit LSB shared object, ARM aarch64

5.2 Wayland显示问题

问题：应用启动后无显示或显示异常

解决方案：

确保开发板已正确配置Wayland环境

检查环境变量：

export WAYLAND_DISPLAY=wayland-0 export XDG_RUNTIME_DIR=/run/user/0

5.3 性能优化

对于RK3588/RK3399这类嵌入式设备，性能调优很重要：

启用硬件加速：

export EGL_PLATFORM=wayland export MESA_GLSL_CACHE_DISABLE=false

减少Flutter引擎开销：在main()函数中添加：

void main() { debugDisableShadows = true; debugDisableClipLayers = true; runApp(MyApp()); }

6. 编译与部署

完成所有配置后，可以开始编译：

cd demo flutter-elinux build elinux --target-arch=arm64

编译完成后，可执行文件位于build/elinux/arm64/debug/bundle目录。将其复制到开发板：

scp -r build/elinux/arm64/debug/bundle root@<board-ip>:/home/root/

在开发板上运行：

cd /home/root/bundle ./demo

7. 进阶技巧与优化

7.1 减小应用体积

嵌入式设备通常存储空间有限，可以通过以下方式优化：

去除调试符号：
```
aarch64-linux-gnu-strip bundle/demo
```

使用Release模式编译：

flutter-elinux build elinux --target-arch=arm64 --release

7.2 自定义Flutter引擎

如果标准引擎不能满足需求，可以自行编译定制引擎：

git clone https://github.com/sony/flutter-elinux-engine.git cd flutter-elinux-engine ./flutter/tools/gn --linux --linux-cpu arm64 --target-sysroot /path/to/sysroot ninja -C out/linux_arm64/

7.3 远程调试

虽然嵌入式设备上难以直接调试，但可以通过以下方式辅助开发：

日志输出：

import 'dart:developer' as developer; developer.log('Debug message', name: 'my.app');

性能分析：
```
flutter-elinux analyze
```
内存检查：
```
valgrind --tool=memcheck ./demo
```

在实际项目中，我发现RK3588的性能表现相当不错，能够流畅运行中等复杂度的Flutter应用。而RK3399则需要更多的性能优化，特别是在图形渲染方面。建议在开发初期就考虑性能因素，避免后期大规模重构。

企业官网建设流程全解析