flutter-elinux 编译linux arm64程序

本文介绍了在嵌入式Linux系统中运行Flutter应用的方法。通过使用官方Flutter SDK或第三方flutter-elinux工具，可以生成支持多种后端(X11、Wayland等)的ARM64程序。文章详细讲解了本地编译运行、交叉编译的步骤，并提供了常见问题的解决方案。重点指出无需自行生成engine和embedded，只需flutter-elinux+clang+sysroot即可完成编

CodeOfCC

724人浏览 · 2026-01-07 12:41:44

CodeOfCC · 2026-01-07 12:41:44 发布

flutter嵌入式系列

前言

flutter是可以在嵌入式linux中运行的。官方的flutter sdk可以生成基于x11 gtk的arm64程序。使用第三方sdk，flutter-elinux则可以生成x11、wayland、gbm、eglstream的arm64程序。flutter-elinux提供完整的依赖库，不需要自己生成engine、embedded。只需要：flutter-elinux+clang+sysroot，即可以生成flutter arm64程序。

一、安装flutter-elinux

参考https://github.com/sony/flutter-elinux.git

git clone https://github.com/sony/flutter-elinux.git
sudo mv flutter-elinux /opt/
export PATH=$PATH:/opt/flutter-elinux/bin

安装必要的工具

sudo apt install unzip curl clang cmake pkg-config

ubuntu 18.04可能需要安装新版本git：《Ubuntu使用ppa源安装最新版git》，编译可能需要新版本cmake：ubuntu安装新版本cmake

二、本机编译运行

具体可以参考https://github.com/sony/flutter-elinux.git。
本机为Ubuntu的情况。

1、调试运行

如下代码是创建一个sample项目，并以wayland后端方式运行。
注：需要有对应的backend支持，比如elinux-wayland需要运行weston。elinux-x11需要运行x11。

flutter-elinux create sample
cd sample
flutter-elinux run -d elinux-wayland

2、生成

注：需要有对应的backend支持，比如wayland需要运行weston。x11需要运行x11，gbm需要drm支持，eglstream需要NVIDIA支持。
安装需要的包

sudo apt update
sudo apt install clang cmake build-essential \
            pkg-config libegl1-mesa-dev \
            libxkbcommon-dev libgles2-mesa-dev
sudo apt install libwayland-dev wayland-protocols
sudo apt install libdrm-dev libgbm-dev libinput-dev libudev-dev libsystemd-dev

flutter-elinux create sample
cd sample
flutter-elinux build elinux --target-backend-type=gbm --release

三、交叉编译

主机为Ubuntu x64
参考https://github.com/sony/flutter-elinux/wiki/Building-flutter-apps的Case 1

在这里插入图片描述

因为上述链接已经讲的很详细，本文不再赘述，只给出遇到问题的解决方案。

1、docker run 缺少镜像

需要先运行。

docker pull arm64v8/ubuntu:18.04

2、docker run 警告且无法进入bash

ubuntu22.04 不会出现，ubuntu18.04会有此问题。按照下列方式运行。

docker run -it -v /usr/bin/qemu-aarch64-static:/usr/bin/qemu-aarch64-static arm64v8/ubuntu:18.04

3、编译缺少libfontconfig

重新进入docker中安装，然后重新拷贝sysroot

找到之前的容器ID

sudo docker ps -a

docker exec it [容器ID] bash
apt install libfontconfig
exit

四、运行

架构为arm64、release模式生成的代码在build/elinux/arm64/release/bundle
本机的可以直接运行，交叉编译的只需将bundle目录拷贝到目标机器上。
运行

./sample -b .

注：直接运行可以查看所有参数

./sample

总结

以上就是今天讲述的内容，flutter编译嵌入式arm64程序探索过程比较艰辛，尤其是容易被误导需要生成flutter的engine和embedded，这部分工作量很大，但是并没有作用。除非有特殊需求，正常情况使用预编译的so即可。整个编译过程只需要flutter-elinux，不需要额外的工具链，完全参考wiki即可。本文的作用只是作为一个指引，以及给出一些小问题的解决方案。