Ubuntu24.04.1下flutter doctor无法定位Android SDK及平台缺失问题

当前问题 #

• 无法定位Android SDK
• /usr/local/android-sdk/platforms目录为空，未找到有效Android SDK平台
• 无法确定Android Studio版本

已执行的操作 #

• 初始执行./sdkmanager --list_installed仅显示安装了platform-tools 35.0.2，随后通过以下命令安装指定组件：

cd /usr/local/android-sdk/cmdline-tools/latest/bin
sudo ./sdkmanager "emulator"
sudo ./sdkmanager "build-tools;35.0.0"
sudo ./sdkmanager "cmdline-tools;latest"

当前./sdkmanager --list_installed已确认上述组件安装完成。

• 已在~/.bashrc末尾配置环境变量：

export ANDROID_HOME=/usr/local/android-sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

• 执行tree -dL 2 /usr/local/android-sdk确认无platforms目录，问题仍未解决。

修复措施 #

1. 安装Android SDK平台组件 #

platforms目录为空是因为未安装具体的SDK平台版本，执行以下命令安装常用的Android 14（API 34）平台：

cd /usr/local/android-sdk/cmdline-tools/latest/bin
sudo ./sdkmanager "platforms;android-34"

安装完成后，platforms目录会自动生成并包含对应平台文件。

2. 确保环境变量生效并补全路径 #

• 先让已配置的环境变量立即生效：

source ~/.bashrc

• 验证环境变量是否正确：

echo $ANDROID_HOME
echo $PATH | grep android-sdk

• 建议将cmdline-tools路径也加入~/.bashrc，确保工具可全局调用：

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

添加后再次执行source ~/.bashrc生效。

3. 修复Android SDK目录权限 #

使用sudo安装组件可能导致目录权限异常，Flutter无法正常访问，修改目录所有者为当前用户：

sudo chown -R $USER:$USER /usr/local/android-sdk

4. 让Flutter明确指定Android SDK路径 #

若环境变量仍未被Flutter识别，直接通过命令指定SDK路径：

flutter config --android-sdk /usr/local/android-sdk

5. 处理Android Studio版本识别问题 #

• 若未安装Android Studio，可忽略此提示；若已安装，需确保Android Studio的SDK路径与ANDROID_HOME一致，或通过命令指定Studio路径：

flutter config --android-studio-dir /path/to/android-studio

• 若不需要Android Studio，可关闭该检查：

flutter config --no-android-studio

完成以上操作后，执行flutter doctor -v验证修复结果。

内容的提问来源于stack exchange，提问作者surfmuggle