Ubuntu上Flutter如何快速上手

Ubuntu 上 Flutter 快速上手指南

一 安装与配置

• 使用 Snap 一键安装（推荐）
  • 安装命令：sudo snap install flutter --classic
  • 安装后可直接运行：flutter doctor 检查环境
• 手动安装（便于多版本管理）
  • 下载 Flutter SDK（Linux x64）：https://docs.flutter.cn/get-started/install/linux
  • 解压到如：~/DevTools/flutter
  • 配置环境变量（~/.zshrc 或 ~/.bashrc）：
    • export PATH=$PATH:~/DevTools/flutter/bin
• 国内镜像（可选，提升依赖下载速度）
  • export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
  • export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter
• 安装 Android Studio（用于 Android 与工具链）
  • 可用 Snap：sudo snap install android-studio --classic
  • 或在 Android Studio 中安装 Flutter 与 Dart 插件（首次使用建议安装）

二 系统依赖与 Android 许可

• 安装 Linux 桌面与构建依赖（用于桌面端运行与构建）
  • sudo apt install clang cmake ninja-build libgtk-3-dev -y
• 安装与配置 JDK（Android 工具链需要）
  • 推荐 OpenJDK 11：sudo apt install openjdk-11-jdk
  • 验证：java -version
• 同意 Android SDK 许可
  • 运行：flutter doctor --android-licenses，全部输入 y 直至完成
• 验证整体环境
  • 运行：flutter doctor，确保关键项（Android toolchain、Android Studio、Linux toolchain、Chrome）均为 ✓

三 创建项目与运行

• 创建项目
  • 终端：flutter create hello_world
  • 进入目录：cd hello_world
• 运行与热重载
  • 查看设备：flutter devices
  • 运行：flutter run（保存代码后按 r 热重载，按 R 热重启）
• 选择目标平台
  • 可用目标包含：Android、Chrome（Web）、Linux 桌面
  • 指定设备：flutter run -d
• 示例输出
  • 首次运行会下载 Gradle 依赖并构建，成功后应用会在设备或浏览器中启动

四 常见问题与快速修复

• Linux 工具链缺失
  • 报错含 “clang++/CMake/ninja/GTK 3.0 dev libraries required”
  • 解决：sudo apt install clang cmake ninja-build libgtk-3-dev -y
• Android 许可未接受
  • 解决：flutter doctor --android-licenses（全程 y）
• 找不到 Chrome（Web 开发）
  • 安装 Chrome 或在环境中设置 CHROME_EXECUTABLE
• 设备未授权或未识别（USB 调试）
  • 手机开启开发者选项与 USB 调试，首次连接点“允许”
  • 命令行执行 adb devices 确认状态；必要时检查 /etc/udev/rules.d/51-android.rules 与用户组权限