Debian上Flutter如何配置环境

Debian 上配置 Flutter 环境

一 准备与安装系统依赖

• 更新系统并安装常见构建工具与驱动依赖（适用于 Debian 11/12）：
  • sudo apt update && sudo apt upgrade -y
  • 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
• 说明：Flutter 的 Android/iOS/Web 开发需要这些图形与编译依赖；如使用模拟器或硬件加速，请确保显卡驱动与 Wayland/X11 正常。

二 安装 Flutter SDK

• 方式一 手动下载解压（推荐，便于多版本管理）
  • 下载稳定版 SDK（请替换为最新版本号）：
    • wget https://storage.googleapis.com/flutter_infra/releases/stable/linux/flutter_linux_v3.29.2-stable.tar.xz
  • 解压到目标目录（示例：/opt/flutter）：
    • sudo mkdir -p /opt/flutter
    • sudo tar xf flutter_linux_v3.29.2-stable.tar.xz -C /opt/flutter
  • 将 SDK 加入 PATH（针对 bash，如使用 zsh 请改为 ~/.zshrc）：
    • echo ‘export PATH=“$PATH:/opt/flutter/bin”’ >> ~/.bashrc
    • source ~/.bashrc
• 方式二 使用 Snap（更省事，版本可能滞后）
  • sudo apt install snapd -y
  • sudo snap install flutter --classic
• 验证安装：
  • flutter --version
  • flutter doctor
• 备注：Flutter SDK 已内置 Dart SDK，无需单独安装。

三 配置 Android 开发环境

• 安装 Android Studio（包含 Android SDK/Platform-Tools/Emulator 等组件）：
  • 从 Android Studio 官网下载 Linux 版本，解压至 /opt/android-studio 并按向导完成安装。
  • 在 Android Studio 中安装 Flutter 与 Dart 插件（Preferences → Plugins）。
• 配置环境变量（示例路径，按实际安装为准）：
  • echo ‘export ANDROID_SDK_ROOT=$HOME/Android/Sdk’ >> ~/.bashrc
  • echo ‘export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin:$ANDROID_SDK_ROOT/emulator’ >> ~/.bashrc
  • source ~/.bashrc
• 在 Android Studio 的 SDK Manager 中勾选并安装：
  • Android SDK Platform-Tools、Android SDK Build-Tools、至少一个 Android 版本平台（如 Android 14 (API 34)）、如需模拟器则勾选 Android Emulator。
• 接受 Android 许可协议：flutter doctor --android-licenses，全部选择 y。

四 国内镜像与网络优化（可选）

• 为加速 pub 包与 SDK 下载，可配置镜像（写入 ~/.bashrc 或 ~/.zshrc）：
  • echo ‘export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub’ >> ~/.bashrc
  • echo ‘export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter’ >> ~/.bashrc
  • source ~/.bashrc
• 如使用公司代理，请配置 HTTP_PROXY/HTTPS_PROXY 环境变量。

五 验证与创建项目

• 环境检查与修复：
  • flutter doctor（逐项解决报错，例如缺失 Android SDK/Platform-Tools/构建工具、未接受许可等）
• 创建并运行示例项目：
  • flutter create my_first_app
  • cd my_first_app
  • flutter run
• 常用维护命令：
  • flutter upgrade（升级 SDK）
  • flutter pub get（获取依赖）
  • flutter devices（查看可用设备/模拟器）
• 常见问题速查：
  • 运行模拟器失败：检查 KVM 是否启用、BIOS 虚拟化是否开启、系统是否安装 qemu-kvm 等组件。
  • 依赖下载慢或失败：确认镜像配置、网络代理与 DNS 设置。
  • 构建报错：确保 Build-Tools 与 Gradle 版本匹配，必要时执行 flutter clean 后重试。