需先确认银河麒麟架构(ARM64/x86_64),再依次安装基础依赖、手动部署Dart SDK、下载适配版Flutter SDK、启用Linux桌面支持并配置Android开发环境,最后通过flutter doctor验证。

如果您希望在银河麒麟操作系统上搭建Flutter开发环境,以支持全平台(包括桌面、移动及Web)应用开发,则需针对其ARM或x86_64架构特性进行适配性配置。以下是完成该任务的具体步骤:
一、确认系统架构与基础依赖
Flutter官方SDK未直接提供ARM64 Linux原生包,但可通过兼容模式或社区构建版本运行;同时需确保系统已安装必要的编译工具链与图形库支持,为后续Dart运行时及Flutter引擎初始化奠定基础。
1、打开终端,执行 uname -m 查看当前CPU架构(如 aarch64 或 x86_64)。
2、运行 sudo apt update && sudo apt install clang cmake ninja-build pkg-config libgtk-3-dev libblkid-dev liblzma-dev 安装构建依赖。
3、验证是否已安装 curl 和 git,若未安装则执行 sudo apt install curl git。
二、安装Dart SDK(独立方式)
Flutter SDK内置Dart,但部分麒麟OS镜像中因安全策略限制自动解压,建议先手动部署稳定版Dart运行时,确保flutter doctor能正确识别语言环境。
1、访问 https://dart.dev/get-dart/archive 获取最新LTS版Dart压缩包URL(例如 dart-sdk-3.4.4-linux-x64.tar.gz 或对应ARM版本)。
2、使用 curl -O [下载链接] 下载压缩包。
3、执行 tar xf dart-sdk-*.tar.gz 解压至 /opt/dart-sdk 目录。
4、将 /opt/dart-sdk/bin 加入PATH:编辑 ~/.bashrc,追加 export PATH="/opt/dart-sdk/bin:$PATH",然后运行 source ~/.bashrc。
三、获取并配置Flutter SDK
银河麒麟V10(ARM版)需采用Flutter社区维护的ARM64适配分支,而x86_64版本可直接使用Flutter官网Linux归档包;两种路径均需跳过默认的git clone方式,改用离线压缩包部署以规避网络与权限问题。
1、前往 https://github.com/flutter/flutter/releases 下载 flutter_linux_arm64.tar.xz(ARM)或 flutter_linux_x64.tar.xz(x86_64)。
2、解压至用户主目录:tar -xf flutter_linux_*.tar.xz -C ~。
3、将 ~/flutter/bin 加入PATH:在 ~/.bashrc 中添加 export PATH="$HOME/flutter/bin:$PATH",并执行 source ~/.bashrc。
4、运行 flutter precache 预加载引擎二进制文件(此步可能耗时较长,需保持网络通畅)。
四、启用麒麟OS桌面平台支持
Flutter 3.16+ 原生支持Linux桌面,但银河麒麟基于GTK3且禁用systemd-user,需手动启用X11后端并替换默认窗口管理器调用逻辑,否则run命令将报错“Failed to initialize window”。
1、执行 flutter config --enable-linux-desktop 启用Linux桌面支持。
2、创建项目后进入目录,运行 flutter create --platforms=linux,web,android . 显式声明目标平台。
3、修改 linux/CMakeLists.txt,将 find_package(GTK3 REQUIRED) 替换为 find_package(GTK3 3.22 REQUIRED)(适配麒麟V10预装GTK版本)。
4、在运行前设置环境变量:export DISPLAY=:0 && export XDG_SESSION_TYPE=x11。
五、配置Android开发支持(可选)
若需同时开发Android应用,须绕过麒麟OS对32位库的默认屏蔽,并适配OpenJDK 17与Android Studio的ARM兼容版本;此过程不依赖Snap或Flatpak,全部通过APT与手动解压完成。
1、安装OpenJDK 17:sudo apt install openjdk-17-jdk,并设置 JAVA_HOME 指向 /usr/lib/jvm/java-17-openjdk-*/。
2、从 https://developer.android.com/studio#downloads 下载 android-studio-2024.2.1.19-linux.tar.gz(ARM64兼容版)。
3、解压至 /opt/android-studio,运行 /opt/android-studio/bin/studio.sh 初始化SDK Manager。
4、在终端中执行 flutter config --android-sdk /opt/android-sdk 指向SDK路径,并运行 flutter doctor --android-licenses 接受全部协议。

















