统信UOS如何入门安装Flutter SDK及开发环境？

本文共计1065个文字，预计阅读时间需要5分钟。

如果您在统信UOS系统上尝试搭建Flutter，请确保遵循以下步骤：

一、使用Git克隆官方稳定分支（推荐AMD64平台）

该方法适用于统信UOS x86_64（AMD64）版本，通过Git获取经过验证的稳定分支代码，避免手动下载压缩包校验失败或网络中断问题。

1、打开终端，执行以下命令安装Git（如未预装）：
sudo apt update && sudo apt install -y git

2、创建无中文、无空格的安装目录，例如：
mkdir -p $HOME/development/flutter

3、进入目录并克隆Flutter官方稳定分支：
cd $HOME/development/flutter
git clone -b stable https://github.com/flutter/flutter.git .

4、配置国内镜像环境变量（关键步骤，否则后续pub依赖拉取将超时）：
echo 'export PUB_HOSTED_URL="https://pub.flutter-io.cn"' >> $HOME/.bashrc
echo 'export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"' >> $HOME/.bashrc
source $HOME/.bashrc

5、将Flutter bin目录加入PATH：
echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> $HOME/.bashrc
source $HOME/.bashrc

二、使用Gitee镜像加速下载（适用于网络受限场景）

当GitHub访问不稳定时，Gitee提供了Flutter仓库的同步镜像，可显著提升下载成功率，尤其适合企业内网或教育网用户。

1、确保已安装curl与unzip：
sudo apt install -y curl unzip

2、创建SDK安装路径：
mkdir -p $HOME/sdk/flutter

3、从Gitee镜像下载并解压（以3.29.3稳定版为例）：
curl -L https://gitee.com/mirrors/Flutter/repository/archive/stable.zip -o flutter-stable.zip
unzip flutter-stable.zip -d $HOME/sdk/

4、重命名解压后的文件夹为flutter：
mv $HOME/sdk/Flutter-* $HOME/sdk/flutter

5、配置环境变量并生效：
echo 'export FLUTTER_HOME=$HOME/sdk/flutter' >> $HOME/.bashrc
echo 'export PATH="$FLUTTER_HOME/bin:$PATH"' >> $HOME/.bashrc
source $HOME/.bashrc

三、ARM64平台专用方案：采用社区ARM64适配版Android Studio + Flutter SDK

统信UOS在华为鲲鹏、飞腾等国产ARM64设备上运行时，需使用原生ARM64构建的开发工具链，否则Android Studio无法启动或Flutter doctor会报“platform-tools not found”错误。

1、下载社区维护的ARM64版Android Studio：
wget https://github.com/moneytoo/AndroidStudio-ARM64/releases/download/2023.1.1/android-studio-2023.1.1-arm64.tar.gz

2、解压并安装到系统级路径：
tar -xzf android-studio-2023.1.1-arm64.tar.gz
sudo mv android-studio /opt/

3、启动Android Studio并完成首次配置（勾选Android SDK、Platform-Tools、Command-line Tools）

4、单独下载适配OpenHarmony与ARM64的Flutter SDK（非官方主干）：
git clone -b oh-3.27.4-dev https://gitcode.com/openharmony-tpc/flutter_flutter.git $HOME/sdk/flutter-oh

5、设置专用环境变量指向该SDK：
echo 'export FLUTTER_HOME_ARM64=$HOME/sdk/flutter-oh' >> $HOME/.bashrc
echo 'export PATH="$FLUTTER_HOME_ARM64/bin:$PATH"' >> $HOME/.bashrc
source $HOME/.bashrc

四、验证与补全Android工具链（必需步骤）

即使Flutter SDK安装成功，统信UOS默认不包含Android构建所需的关键组件，必须手动补全cmdline-tools与Android SDK Platform-Tools，否则flutter doctor将始终显示[X] Android toolchain错误。

1、确认Android SDK路径（通常为/opt/android-sdk或$HOME/Android/Sdk）：
ls -l /opt/android-sdk/cmdline-tools/latest/bin/sdkmanager 2>/dev/null || echo "cmdline-tools缺失，请执行下一步"

2、若缺失，手动创建目录并下载最新cmdline-tools：
mkdir -p $HOME/Android/Sdk/cmdline-tools/latest
cd $HOME/Android/Sdk/cmdline-tools/latest
wget https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip
unzip commandlinetools-linux-11076708_latest.zip -d $HOME/Android/Sdk/cmdline-tools/latest

3、接受所有Android SDK许可证：
$HOME/Android/Sdk/cmdline-tools/latest/bin/sdkmanager --licenses

4、安装必要组件：
$HOME/Android/Sdk/cmdline-tools/latest/bin/sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"

5、设置ANDROID_HOME环境变量：
echo 'export ANDROID_HOME=$HOME/Android/Sdk' >> $HOME/.bashrc
echo 'export PATH="$ANDROID_HOME/platform-tools:$PATH"' >> $HOME/.bashrc
source $HOME/.bashrc

五、执行最终诊断并启用鸿蒙支持（如需混合开发）

统信UOS用户若计划开发鸿蒙兼容应用，需额外启用OpenHarmony构建支持，该步骤依赖特定Flutter SDK分支及DevEco Studio协同配置。

1、关闭所有终端，重新打开一个终端窗口

2、运行诊断命令：
flutter --version

3、检查是否识别鸿蒙支持：
flutter doctor -v | grep -A5 "HarmonyOS"

4、若输出中未显示[✓] HarmonyOS support installed，需切换至含OH支持的SDK分支：
cd $FLUTTER_HOME
git fetch origin oh-3.27.4-dev
git checkout oh-3.27.4-dev
flutter upgrade --force

5、配置DevEco Studio中的OpenHarmony SDK路径（需提前在D:\HarmonyOS\OpenHarmony\Sdk或对应路径完成下载）