Ubuntu 手动搭建 Flutter 开发环境指南

本文记录在 Ubuntu/Bash 环境下手动配置 Flutter SDK 与 Android 命令行工具链（Command Line Tools）的全过程。此方案不依赖 Android Studio，便于将开发环境迁移到 VS Code 等轻量IDE环境。

1. 预备环境安装

在开始配置开发套件之前，必须确保系统具备基础的编译工具和 Java 运行环境。Android 构建系统依赖于 Java 17。

执行命令

sudo apt-get update -y && sudo apt-get upgrade -y
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa openjdk-17-jdk
# 校验环境
which java

2. Flutter SDK 部署

Flutter SDK 的核心是其二进制命令集。

本文将 Flutter 安装在 /opt/develop 下，便于多用户访问。

执行步骤

1. 下载地址：Flutter SDK 官方手册

根据官方手册下载最新版本 Flutter

1. 解压与配置：

# 1. 创建并授权目录
sudo mkdir -p /opt/develop
sudo chown $USER:$USER /opt/develop
# 2. 解压 Flutter (请根据实际下载的文件名修改)
# tar -xf <sdk_zip_path> -C <destination_directory_path>
tar -xf ~/Downloads/flutter_linux_*.tar.xz -C /opt/develop/

环境变量映射

将 Flutter bin 目录添加到系统 PATH 中，以便在任意终端调用。

echo 'export PATH="/opt/develop/flutter/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# 校验环境
flutter --version
dart --version
# 禁用遥测分析
flutter --disable-analytics
dart --disable-analytics

---

3. Android 工具链配置 (Command Line Tools)

由于不安装 Android Studio，需要手动集成管理 Android SDK 的工具。

组件概述

• cmdline-tools: 包含 sdkmanager（包管理器）和 avdmanager（模拟器管理器）。
• platform-tools: 包含 adb（安卓调试桥），用于电脑与手机通信。
• build-tools: 包含 aapt 和 dx，负责将代码编译为 APK。
• platforms: 对应 Android 系统版本（如 API 36），提供运行时的库支持。

安装步骤

1. 下载地址：Android Studio 官网 (Command line tools)

2. 构建官方要求的目录层级：

注意： cmdline-tools 必须包含一个名为 latest 的层级，否则 sdkmanager 无法工作。

mkdir -p /opt/develop/android_sdk/cmdline-tools/latest

下载并解压后，将解压出的内容移入其中，最终sdkmanager路径应为 /opt/develop/android_sdk/cmdline-tools/latest/bin/sdkmanager

最终的目录树参考：

android_sdk/
└── cmdline-tools/
    └── latest/
        ├── bin/
        │   └── sdkmanager  <-- 执行文件
        ├── lib/
        └── source.properties

环境变量配置

编辑 ~/.bashrc，追加 Android SDK 配置：

cat << 'EOF' >> ~/.bashrc

# Android SDK configuration
export ANDROID_HOME=/opt/develop/android_sdk
export PATH="$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools"
EOF

---

4. SDK 组件管理与协议签署

sdkmanager 是整个 Android 开发环境的核心。

常用命令用法

• 查看可用包与版本：sdkmanager --list
• 查看已安装包与版本：sdkmanager --list_installed
• 安装指定版本：sdkmanager "platforms;android-XX" "build-tools;XX.X.X"
• 卸载旧版本：sdkmanager --uninstall "platforms;android-33"

执行安装

告知 Flutter SDK 路径并补全 Android 依赖：

flutter config --android-sdk /opt/develop/android_sdk/
sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0"

签署 Android 许可协议

运行以下命令并连续按 y 确认：

flutter doctor --android-licenses

---

5. 环境自检清单

运行 flutter doctor。预期结果应为：

• [✓] Flutter: 已安装。
• [✓] Android toolchain: 版本显示正确，且 licenses 已签署。
• [!] Linux toolchain: 若仅做手机端开发，此项感叹号可安全忽略。

通过以上步骤，系统已建立一套完全受控、基于命令行的 Flutter 开发环境（不使用NDK）。

NDK环境配置

sudo apt install clang cmake ninja-build pkg-config libgtk-3-dev

---

6. 调试、日志与问题排查

当环境配置完成后，通过 VS Code 进行开发调试。

1. 安装插件：在 VS Code 扩展商店搜索并安装 Flutter (Dart 会自动安装)。
2. 连接 SDK：Ctrl + Shift + P -> 输入 Flutter: Change SDK -> 指向 /opt/develop/flutter。
3. 真机调试：

• 手机开启“开发者选项”和“USB 调试”。
• 连接电脑，VS Code 右下角识别出手机型号。
• F5 开始运行并享受 Hot Reload。

调试命令

• 运行应用：在 VS Code 中按 F5，或者在终端执行 flutter run。
• 实时监控手机报错/查看详细堆栈：执行 flutter logs。
• 清理编译缓存：如果项目运行出现莫名其妙的错误，先运行 flutter clean。
• 代码质量问题分析：flutter analyze
• 强制指定架构打包：针对 64 位手机（当前主流）执行 flutter build apk --debug --target-platform android-arm64 -v。
• 生成包含所有架构的单个 APK (Fat APK)：flutter build apk --release
• 拆分架构打包 (Split per ABI) ：强烈推荐，目前最常用的优化方案，命令会一次性产出多个 APK，每个 APK 只包含特定架构的代码。flutter build apk --split-per-abi，产物位置：build/app/outputs/flutter-apk/
  • app-arm64-v8a-release.apk：适用于大多数现代 64 位手机（主流）。
  • app-armeabi-v7a-release.apk：适用于较旧的 32 位手机。
  • app-x86_64-release.apk：适用于模拟器或极少数 x86 手机。
• 查看完整详情：flutter doctor -v。

---

7. 补充内容

后续复用建议：
未来更换机器，只需要把 /opt/develop 整个文件夹压缩备份，到新机器解压并修改 ~/.bashrc 里的路径即可快速恢复。

辅助建议：
项目若使用了 Firebase，可通过 npm install -g firebase-tools 安装 Firebase CLI，从而实现通过终端直接分发测试包的需求。