在 Debian 上进行 Flutter 多平台开发与实践
一 支持范围与总体结论
- Debian 作为开发机可用于构建与调试 Android、Web、Linux 桌面 等平台应用；iOS 的构建与签名必须在 macOS + Xcode 上完成；Windows 桌面构建通常在 Windows 或 GitHub Actions 等 CI 环境中完成。
- 自 Flutter 3.x 起，官方支持六大平台：Windows、macOS、Linux、Android、iOS、Web；在 Debian 上可直接覆盖其中 Android、Web、Linux 桌面 的完整开发链路。
- 对于 嵌入式 Linux，Flutter 官方未直接覆盖，但可借助社区 Embedder（如 flutter-elinux）在 Wayland 等显示后台运行。
二 在 Debian 上的环境准备与平台矩阵
- 环境准备
- 安装 Flutter SDK（稳定通道），并配置环境变量：将 $HOME/flutter/bin 加入 PATH。
- 安装系统依赖（示例）：clang、cmake、build-essential、pkg-config、libegl1-mesa-dev、libxkbcommon-dev、libgles2-mesa-dev、libwayland-dev、wayland-protocols、git、curl、wget、unzip。
- 运行 flutter doctor 检查并逐项修复（Android 工具链、Chrome/Web、Linux 桌面等）。
- 平台支持矩阵（在 Debian 上的可行性与限制）
| 平台 |
在 Debian 上开发 |
构建与运行要点 |
备注 |
| Android |
支持 |
配置 Android SDK/NDK 与设备/模拟器；使用 flutter run / flutter build apk |
需接受 Android 许可 |
| Web |
支持 |
安装 Chrome；使用 flutter run -d chrome / flutter build web |
调试建议用 Chrome |
| Linux 桌面 |
支持 |
启用 Linux 桌面支持；使用 flutter run -d linux / flutter build linux |
依赖 GTK/Wayland 等系统库 |
| iOS |
不支持 |
需在 macOS + Xcode 执行 flutter build ios |
无法在 Debian 上原生完成 |
| Windows |
不支持 |
建议在 Windows 或 CI 构建 flutter build windows |
交叉编译受限 |
| 嵌入式 Linux |
有条件支持 |
使用社区 flutter-elinux 等 Embedder；常见为 Wayland 后台 |
非官方方案，需自测与适配 |
三 常用构建命令与典型流程
- 创建与运行
- 创建项目：flutter create my_app
- 运行项目：flutter run（连接设备/模拟器或指定目标，如 -d linux / -d chrome）
- 构建产物
- Android：flutter build apk（产物在 build/app/outputs/flutter-apk/）
- Web：flutter build web
- Linux 桌面：flutter build linux
- 调试与测试
- 单元测试：flutter test
- 调试：使用 IDE 调试工具 或 DevTools
- 平台特定差异与能力扩展
- 使用 Platform 类或 Platform Channels 处理平台差异与系统能力接入。
四 进阶与注意事项
- 嵌入式 Linux 路线
- 采用社区 flutter-elinux 等 Embedder，面向 Wayland 显示服务进行适配与部署；注意插件兼容性与系统库版本匹配。
- 环境隔离与一致性
- 使用 Docker 封装构建环境，减少依赖冲突，便于在 CI 或不同机器上复现构建。
- 工具链与许可
- 运行 flutter doctor --android-licenses 接受 Android 许可协议；按需安装 Chrome 以支持 Web 调试与构建。
- 平台限制与协作
- iOS/Windows 构建不在 Debian 上完成，建议通过 macOS 节点或 GitHub Actions 等 CI 完成签名、归档与发布流程。