在 Debian 上进行 Flutter 跨平台开发
一 支持范围与开发目标
- 在 Debian 上可直接完成 Android、Web、Linux 桌面 的开发与构建；iOS 因需要 Xcode，应在 macOS 上完成构建与签名。Flutter 官方支持的目标包含 Android、iOS、Web、Linux、macOS、Windows，其中 Linux 桌面（含 Debian） 可直接在本地构建与运行。对于 嵌入式 Linux，存在社区方案（如 flutter‑elinux），但属于非官方支持，稳定性需按场景评估。
二 环境准备与 SDK 安装
- 系统依赖（桌面/Android 常用）：
- 安装构建与图形依赖：sudo apt update && sudo apt install -y curl git cmake build-essential pkg-config libegl1-mesa-dev libxkbcommon-dev libgles2-mesa-dev libwayland-dev wayland-protocols
- 获取并配置 Flutter SDK：
- 下载 Linux 稳定版 SDK，解压至如 ~/flutter 或 /opt/flutter
- 配置环境变量（写入 ~/.bashrc 或 ~/.zshrc）：export PATH=“$PATH:/path/to/flutter/bin”，执行 source ~/.bashrc
- 说明：Flutter SDK 已包含 Dart SDK，无需单独安装
- 国内镜像（可选，加速 pub 与 SDK 下载）：
- 写入：export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
- 写入：export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter
- 验证与授权：
- 运行 flutter doctor 检查环境；如开发 Android，执行 flutter doctor --android-licenses 接受许可协议
三 创建项目与运行调试
- 创建项目：flutter create my_app && cd my_app
- 连接设备/启动模拟器后运行：flutter run（支持热重载）
- 常用调试命令：
- 查看设备：flutter devices
- 选择目标：flutter run -d <device_id|chrome|linux>
- 编辑器与工具：
- 推荐 VS Code 安装 Dart 与 Flutter 插件，或使用 Android Studio 的 Flutter/Dart 插件以获得更好的工程体验
四 构建与发布
- 常用构建命令（按需选择目标平台）：
- Android：flutter build apk 或 flutter build appbundle
- Web：flutter build web
- Linux 桌面：flutter build linux
- iOS：需在 macOS 执行 flutter build ios（涉及 Xcode 与签名）
- 产物路径与用途：
- APK：build/app/outputs/flutter-apk/app-release.apk
- App Bundle：build/app/outputs/bundle/release/app-release.aab
- Web：build/web（静态站点，可部署至 Nginx/对象存储等）
- Linux：生成 linux 目标可执行文件与相应资源，用于桌面分发与安装
五 兼容性与进阶建议
- 平台差异与能力边界：
- UI 一致性由 Widget 提供，但不同平台的 字体渲染、窗口管理、输入法 等存在差异，需实际机型/桌面环境测试与适配
- 需要调用系统能力时，使用 Platform Channels 与原生代码交互
- 桌面与图形环境：
- 在 Wayland/X11 不同会话下可能存在渲染/输入差异，建议在目标会话下充分测试
- 打包与分发：
- 桌面端可结合社区工具（如 flutter_to_debian）将应用打包为 .deb，便于 apt 渠道分发（社区方案，按项目评估）
- 嵌入式与性能：
- 嵌入式 Linux 可参考 flutter‑elinux（非官方），功能与稳定性依场景而定
- 对于 重图形/视频 场景，评估结合原生库（如 FFmpeg）或降低 Widget 树复杂度以优化性能
