Flutter

---

一、Arch Linux搭建Flutter开发环境

本文介绍如何在 Arch Linux 无桌面环境（纯 CLI） 下搭建完整 Flutter 开发环境，包括：

• Flutter SDK
• Android SDK 命令行工具链
• Chrome Web 调试环境
• Linux Desktop 编译环境
• 真机调试环境

最终实现无需安装 Android Studio，也可以完成 Flutter 应用开发。

---

1. 安装系统基础依赖

安装 Flutter、Android SDK 以及构建所需的基础工具。

安装依赖

执行：

sudo pacman -Syu

sudo pacman -S \
base-devel \
git \
curl \
unzip \
xz \
jdk17-openjdk \
chromium

安装内容说明：

软件包	用途
base-devel	Arch 编译工具链
git	获取 Flutter 源码
curl/unzip/xz	下载及解压工具
jdk17-openjdk	Android 构建环境
chromium	Flutter Web 调试

---

2. 安装 Flutter SDK

Flutter 官方推荐使用 Git 管理 SDK，可以方便切换版本。

创建工作目录

mkdir -p ~/workspace

克隆 Flutter Stable 分支

git clone \
https://github.com/flutter/flutter.git \
-b stable \
~/workspace/flutter

Flutter SDK 目录：

~/workspace/flutter

---

3. 安装 Android CLI 工具链

由于不使用 Android Studio，需要手动安装 Android SDK Command Line Tools。

3.1 安装 Android SDK 工具

使用 AUR：

yay -S \
android-sdk \
android-sdk-cmdline-tools-latest \
android-sdk-platform-tools \
android-sdk-build-tools

---

3.2 修复 Android SDK 权限

Arch Linux 默认 Android SDK 位于：

/opt/android-sdk

修改目录权限，使当前用户可以管理 SDK：

sudo chown -R $USER:$USER /opt/android-sdk

chmod -R 755 /opt/android-sdk

注意：这一步非常重要，否则后续 sdkmanager 下载组件时可能出现权限错误。

---

4. 配置环境变量

Flutter 和 Android SDK 需要加入系统 PATH。

编辑 Shell 配置文件：

如果使用 Bash：

vim ~/.bashrc

如果使用 Zsh：

vim ~/.zshrc

添加以下内容：

# =========================
# Flutter SDK
# =========================

export PATH="$HOME/workspace/flutter/bin:$PATH"


# =========================
# Android SDK
# =========================

export ANDROID_HOME=/opt/android-sdk

export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin

export PATH=$PATH:$ANDROID_HOME/platform-tools


# =========================
# Flutter Web 浏览器
# =========================

export CHROME_EXECUTABLE=/usr/bin/chromium


# =========================
# Flutter 国内镜像加速(可选)
# =========================

export PUB_HOSTED_URL="https://pub.flutter-io.cn"

export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

保存后刷新环境变量：

source ~/.bashrc

---

5. 初始化 Flutter 环境

5.1 指定 Android SDK 路径

告诉 Flutter Android SDK 所在位置：

flutter config \
--android-sdk /opt/android-sdk

---

5.2 安装 Android 平台组件

安装 Android API 36：

sdkmanager \
"platforms;android-36" \
"build-tools;28.0.3"

安装内容：

组件	用途
android-36	Android API 36 编译环境
build-tools 28.0.3	Gradle 构建工具

---

5.3 接受 Android License

执行：

flutter doctor --android-licenses

根据提示输入：

y

直到全部协议接受。

---

6. 安装 Linux Desktop 开发环境（可选）

如果需要编译 Linux 桌面应用，需要安装 GTK 和 C++ 工具链。

执行：

sudo pacman -S \
clang \
cmake \
ninja \
pkgconf \
gtk3

组件说明：

组件	用途
clang	C/C++ 编译器
cmake	项目构建
ninja	快速构建工具
pkgconf	依赖管理
gtk3	Linux GUI 框架

---

7. 环境检测

全部配置完成后执行：

flutter doctor -v

理想结果：

[✓] Flutter
[✓] Android toolchain
[✓] Chrome
[✓] Linux toolchain

可能出现：

[!] Android Studio (not installed)

这是正常情况。

因为本方案采用：

Flutter CLI
+
Android SDK CLI

不依赖 Android Studio。

---

Flutter 项目快速开始

1. 创建项目

flutter create my_first_app

---

2. 进入项目目录

cd my_first_app

---

3. Linux 桌面运行

flutter run -d linux

效果：

Flutter
 ↓
Linux Desktop App

---

4. Chrome Web 调试

flutter run -d chrome

效果：

Flutter
 ↓
Chromium Browser

---

真机调试

开启手机 USB 调试

手机：

设置
 ↓
开发者选项
 ↓
USB 调试

连接设备后：

adb devices

正常显示：

List of devices attached

xxxxxxxx    device

然后运行：

flutter run

即可直接部署到 Android 手机。

---

最终环境架构

Arch Linux
│
├── Flutter SDK
│       └── ~/workspace/flutter
│
├── Android SDK
│       └── /opt/android-sdk
│
├── Chromium
│       └── Flutter Web
│
├── GTK3 + Clang
│       └── Linux Desktop
│
└── adb
        └── Android 真机调试

---