在 Debian 上运行 Flutter 项目的完整步骤
一 准备环境
- 更新系统并安装构建与图形依赖：
- sudo apt update && sudo apt upgrade
- sudo apt install -y clang cmake build-essential pkg-config libegl1-mesa-dev libxkbcommon-dev libgles2-mesa-dev libwayland-dev wayland-protocols git curl wget unzip
- 可选：安装桌面环境相关库（部分 Linux 桌面/窗口系统集成需要）：sudo apt install -y libgtk-3-dev
- 说明：上述依赖覆盖 Flutter 在 Linux 桌面端所需的编译链与 EGL/OpenGL/Wayland 组件，可减少运行时报错。
二 安装 Flutter SDK
- 方式一（推荐）手动下载并解压：
- 下载 Linux 版 SDK（.tar.xz 或 .zip），解压到如 ~/flutter 或 /opt/flutter
- 配置环境变量（~/.bashrc 或 ~/.zshrc）：export PATH=“$PATH:$HOME/flutter/bin”
- 使配置生效：source ~/.bashrc 或 source ~/.zshrc
- 方式二 使用 Snap（经典通道）：
- sudo apt install snapd
- sudo snap install flutter --classic
- 验证安装：flutter doctor（按提示安装缺失组件，如 Android SDK/命令行工具、Chrome/Chromium、VS Code/Android Studio 等）。
三 运行与调试
- 创建或进入项目：
- 新建：flutter create my_app && cd my_app
- 已有：cd <你的项目目录>
- 获取依赖：flutter pub get
- 选择设备并运行：flutter devices 查看可用设备；flutter run 启动调试（可加 -d 指定设备）
- 常用调试：热重载（保存或按 r）、热重启（R）、查看日志（flutter logs）。
四 构建发布包
- Android：
- 调试包：flutter build apk
- 发布包：flutter build apk --release
- 产物路径：build/app/outputs/flutter-apk/app-release.apk
- 如需签名发布，先生成密钥库：
- keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
- 构建时通过 --release 并使用 keystore 配置完成签名
- iOS：
- 需在 macOS + Xcode 环境构建（flutter build ios），Debian 上无法直接完成。
五 常见问题与依赖管理
- 依赖管理（项目内）：
- 添加/更新依赖：编辑 pubspec.yaml 后执行 flutter pub get
- 升级依赖：flutter pub upgrade（可加 --major-versions 等策略）
- 查看依赖树：flutter pub deps
- Linux 端常见报错与处理：
- 缺少图形/窗口系统库：安装 libegl1-mesa-dev、libgles2-mesa-dev、libwayland-dev、libxkbcommon-dev、libgtk-3-dev 等
- 权限问题：避免对 SDK 目录使用 0777，按需设置用户可写即可
- 环境不完整：flutter doctor 逐项修复（Android SDK、浏览器、IDE 插件等）。
