centos上flutter如何配置
小樊
31
2025-12-21 14:04:56
CentOS 上配置 Flutter 的可行方案
一 准备与系统依赖
- 更新系统并安装基础工具:
- sudo yum update -y
- sudo yum install -y wget git unzip which
- 若使用较老系统(如 CentOS 7),建议升级 Git,避免版本过低导致 Flutter 识别异常(如显示 0.0.0-unknown):
- 安装 WANDisco 源并升级:sudo yum -y install http://opensource.wandisco.com/centos/7/git/x86_64/wandisco-git-release-7-2.noarch.rpm && sudo yum -y update git
- 验证:git --version(建议 ≥ 2.x)
二 安装 Flutter SDK
- 方式一 手动下载解压(通用、可控)
- 前往 Flutter 官网获取 Linux 发行包链接,下载并解压(示例为 x86_64):
- wget https://storage.googleapis.com/flutter/releases/<版本号>/flutter_linux_x86_64-<版本号>.tar.xz
- tar -xf flutter_linux_x86_64-<版本号>.tar.xz -C /opt
- 配置 PATH(写入 ~/.bashrc 或 ~/.zshrc):
- echo ‘export PATH=$PATH:/opt/flutter/bin’ >> ~/.bashrc && source ~/.bashrc
- 方式二 使用 Snap(省去 Linux toolchain 的繁琐依赖)
- 安装 Snapd 并启用服务:
- sudo yum install -y epel-release && sudo yum install -y snapd
- sudo systemctl enable --now snapd.socket
- sudo ln -s /var/lib/snapd/snap /snap
- 安装 Flutter(经典模式):
- sudo snap install flutter --classic
- 使 PATH 生效:source /etc/profile 或重启;在 CI/Jenkins 中需显式加入:export PATH=$PATH:/var/lib/snapd/snap/bin
- 验证安装:flutter doctor(按提示逐项修复)
三 配置 Android 开发环境(可选)
- 安装 JDK(Flutter 3.x 建议 JDK 11;如使用较新 AGP 可能需 JDK 17):
- 例如 OpenJDK 11:sudo yum install -y java-11-openjdk-devel
- 安装 Android SDK(两种方式二选一)
- Android Studio 方式:下载安装 Android Studio,在 Preferences → System Settings → Android SDK 勾选所需组件(如 Android SDK Platform-Tools、Build-Tools、目标 API Level 等)
- 命令行方式(无图形界面/服务器常用):
- 下载命令行工具(Command-line Tools),解压到如 /usr/local/cmdline-tools
- 配置 SDK 根目录:export ANDROID_SDK_ROOT=/usr/local/sdk
- 安装组件(示例):
- yes | $ANDROID_SDK_ROOT/cmdline-tools/latest/bin/sdkmanager --sdk_root=$ANDROID_SDK_ROOT “platform-tools” “platforms;android-33” “build-tools;33.0.2”
- 配置环境变量(写入 ~/.bashrc 或 /etc/profile):
- export ANDROID_SDK_ROOT=$HOME/Android/Sdk # 或 /usr/local/sdk
- export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools:$ANDROID_SDK_ROOT/build-tools/<版本>:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin
- 接受许可协议:flutter doctor --android-licenses
- 验证:flutter doctor -v;adb devices 可列出设备
四 创建项目与运行
- 创建项目:flutter create my_app
- 进入目录:cd my_app
- 运行(桌面或已连接设备/模拟器):flutter run
- 构建 APK(Android):flutter build apk(如需发布,使用 --release)
五 常见问题与优化
- CentOS 7 上 Git 版本过旧导致 Flutter 识别异常:升级 Git(见上文)或使用 Snap 安装新版 Git
- Linux 桌面支持缺失(flutter doctor 报 Linux toolchain 问题):
- 安装构建依赖(示例):sudo yum install -y clang cmake ninja-build pkgconfig libgtk-3-devel liblzma-devel
- 或使用 Snap 安装 Flutter,可大幅减少手动依赖安装工作
- 国内网络加速(可选):
- 设置环境变量:export PUB_HOSTED_URL=https://pub.flutter-io.cn 与 export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
- CI/Jenkins 找不到 Flutter:
- 在构建脚本中显式加入 PATH:export PATH=$PATH:/var/lib/snapd/snap/bin:/opt/flutter/bin
- iOS 开发说明:CentOS 不支持 iOS,需使用远程 Mac 进行 iOS 构建与模拟器运行