matspfeiffer/flutter

docker-flutter

该Docker镜像无需在开发机上安装Flutter和Android SDK，已包含所有就绪工具，包括Android 9 Pixel模拟器。通过shell别名可实现与本地安装无差异的使用体验，也可作为VSCode的devcontainer使用。

支持的标签

• https://github.com/matsp/docker-flutter/blob/master/stable/Dockerfile
• https://github.com/matsp/docker-flutter/tree/master/beta
• https://github.com/matsp/docker-flutter/tree/master/dev

入口点

• flutter（默认）
• flutter-android-emulator
• flutter-web

依赖项

运行flutter-android-emulator入口点时，主机需支持KVM并安装xhost。

flutter（默认）

在当前目录执行例如flutter help（附加参数将传递给容器中的flutter）：

shell
docker run --rm -e UID=$(id -u) -e GID=$(id -g) --workdir /project -v "$PWD":/project matspfeiffer/flutter help

若未设置UID和GID，文件将归属于UID=1000和GID=1000。

flutter（连接USB设备）

可通过以下方式连接USB设备：

shell
docker run --rm -e UID=$(id -u) -e GID=$(id -g) --workdir /project -v "$PWD":/project --device=/dev/bus -v /dev/bus/usb:/dev/bus/usb matspfeiffer/flutter devices

flutter-android-emulator

为获得最佳性能，需挂载主机的X11目录、DRI和KVM设备以实现硬件加速：

shell
xhost local:$USER && docker run --rm -ti -e UID=$(id -u) -e GID=$(id -g) -p 42000:42000 --workdir /project --device /dev/kvm --device /dev/dri:/dev/dri -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY -v "$PWD":/project --entrypoint flutter-android-emulator  matspfeiffer/flutter

flutter-web

应用将在localhost:8090提供服务：

shell
docker run --rm -ti -e UID=$(id -u) -e GID=$(id -g) -p 42000:42000 -p 8090:8090  --workdir /project -v "$PWD":/project --entrypoint flutter-web matspfeiffer/flutter

VSCode devcontainer

该镜像可用于VSCode的devcontainer中开发，并启动Android模拟器或Web服务器。Android模拟器需要硬件加速，因此不同操作系统的最佳实践有所差异。

Linux #1（X11和KVM转发）

对于使用Linux的开发者，推荐此方法，因其整体更简洁。

在VSCode项目中添加.devcontainer/devcontainer.json：

json
{
  "name": "Flutter",
  "image": "matspfeiffer/flutter",
  "extensions": ["dart-code.dart-code", "dart-code.flutter"],
  "runArgs": [
    "--device",
    "/dev/kvm",
    "--device",
    "/dev/dri:/dev/dri",
    "-v",
    "/tmp/.X11-unix:/tmp/.X11-unix",
    "-e",
    "DISPLAY"
  ]
}

VSCode启动容器后，执行flutter emulators --launch flutter_emulator启动模拟器，之后即可选择该设备调试Flutter代码。

Linux #2、Windows和MacOS（使用主机模拟器）

在VSCode项目中添加.devcontainer/devcontainer.json：

json
{
  "name": "Flutter",
  "image": "matspfeiffer/flutter",
  "extensions": ["dart-code.dart-code", "dart-code.flutter"]
}

启动本地Android模拟器，然后重新连接并执行以下命令使设备通过网络可访问：

shell
adb tcpip 5555

在Docker容器中连接设备：

shell
adb connect host.docker.internal:5555

现在可选择该设备开始调试。

FAQ

为什么不使用Alpine？

Alpine基于musl而非glibc。Flutter打包的Dart二进制文件链接到glibc，因此Flutter SDK与Alpine不兼容——虽可修复，但非本镜像的核心目标。

为什么使用OpenJDK 8？

更高版本中，Android工具的sdkmanager在获取Maven依赖时会抛出错误。