如何配置Debian上的Flutter环境

在 Debian 上配置 Flutter 环境

一 准备系统与依赖

• 更新系统并安装构建与图形依赖，以及 Git、curl、wget、unzip 等工具：
  • 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 的 Linux/Android 开发需要这些底层图形与构建工具，以避免后续运行与构建时报错。

二 安装 Flutter SDK

• 方式一 手动下载并解压（推荐，便于多版本管理）
  • 下载稳定版 SDK（请替换为最新版本号）：
    • wget https://storage.googleapis.com/flutter_infra/releases/stable/linux/flutter_linux_3.24.5-stable.tar.xz
  • 解压到目标目录（示例：/opt/flutter）：
    • sudo mkdir -p /opt/flutter
    • sudo tar -xvf flutter_linux_3.24.5-stable.tar.xz -C /opt/flutter
  • 将 Flutter 加入 PATH（针对 bash，如使用 zsh 请改为 ~/.zshrc）：
    • echo ‘export PATH=$PATH:/opt/flutter/bin’ >> ~/.bashrc
    • source ~/.bashrc
• 方式二 使用 Snap（更省事，适合快速上手）
  • sudo apt install -y snapd
  • sudo snap install flutter --classic
• 验证安装：
  • flutter --version
  • flutter doctor
• 说明：手动方式更灵活；Snap 方式安装简单，但后续插件与自定义 SDK 路径管理不如手动方式直观。

三 配置 Android 开发环境（可选，用于 Android 构建与调试）

• 安装 Android Studio（包含 Android SDK、平台工具与模拟器）：
  • 下载 Linux 版 Android Studio 压缩包并解压到 /opt/android-studio，然后执行安装向导，按提示完成 SDK、Build-Tools、Platform-Tools、Emulator 的安装。
• 配置环境变量（示例路径，按你的实际安装路径调整）：
  • echo ‘export ANDROID_SDK_ROOT=/opt/android-studio’ >> ~/.bashrc
  • echo ‘export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin:$ANDROID_SDK_ROOT/platform-tools’ >> ~/.bashrc
  • source ~/.bashrc
• 在 Android Studio 中安装 Flutter 与 Dart 插件，便于项目创建、调试与热重载。
• 说明：Flutter 开发 Android 应用时需要 Android SDK 与工具链；Flutter 插件可提供项目模板、运行与调试入口。

四 国内镜像与网络加速（可选）

• 为加速包下载与 SDK 获取，可设置环境变量（写入 ~/.bashrc 后执行 source ~/.bashrc）：
  • 清华镜像（推荐）：
    • export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
    • export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter
  • 其他可用镜像：
    • export PUB_HOSTED_URL=https://pub.flutter-io.cn
    • export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
• 说明：镜像能显著提升在中国大陆的网络下载速度，避免 flutter pub get 或 flutter doctor 阶段长时间卡顿。

五 验证与创建项目

• 运行环境检查并逐项修复：
  • flutter doctor
  • 按提示安装缺失组件（如 Android SDK、Build-Tools、Platform-Tools、Emulator 等）。
• 创建并运行示例项目：
  • flutter create hello_flutter
  • cd hello_flutter
  • flutter run
• 常用维护命令：
  • flutter upgrade（升级 SDK）
  • flutter pub get（获取依赖）
• 说明：flutter doctor 会输出清晰的缺失项与修复指引；创建项目后可直接在已连接的设备或模拟器上运行。