flutter for Mac 配置遇到的问题及解决办法

本文详细介绍Flutter SDK的下载、环境变量配置、依赖项安装及常见问题解决,帮助开发者快速上手Flutter,实现跨平台应用开发。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

Flutter是谷歌的移动UI框架,可以快速在iOS和Android上构建高质量的原生用户界面。 Flutter可以与现有的代码一起工作。在全世界,Flutter正在被越来越多的开发者和组织使用,并且Flutter是完全免费、开源的。

Flutter中文网:https://flutterchina.club

1、获取Flutter SDK 下载地址
2、配置环境变量

在cmd下执行:

open .bash_profile

在bash_profile文件添加以下

#Add the flutter tool to your path
#export PATH="$PATH:pwd/flutter/bin"
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
export PATH=/Applications/flutter/bin:$PATH

注意/Applications/flutter为你的存放flutter文件夹的路径。
保存cmd下再执行

source ~/.bash_profile

3、查看是否完成

运行以下命令查看是否需要安装其它依赖项来完成安装:

flutter doctor

在这里插入图片描述

嘿嘿 有几个问题,我们依次解决
【1】、Android toolchain - develop for Android devices (Android SDK version 28.0.3)
! Some Android licenses not accepted. To resolve this, run: flutter doctor
–android-licenses
本机已安装了AndroidSDK,Android许可不被接受,需要执行以下命令,同意许可

flutter doctor --android-licenses

---------------------------------------
Accept? (y/N): y
All SDK package licenses accepted

【2】、Xcode - develop for iOS and macOS
✗ Xcode installation is incomplete; a full installation is necessary for iOS
development.
Download at: https://developer.apple.com/xcode/download/
Or install Xcode via the App Store.
Once installed, run:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
本机已安装了xcode,那就是需要执行以下命令

cmd
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license

再执行一下,看看这两个问题解决了没

flutter doctor

在这里插入图片描述

ok,已解决,继续解析以下问题
【3】、Android Studio (version 3.4)
✗ Flutter plugin not installed; this adds Flutter specific functionality.
✗ Dart plugin not installed; this adds Dart specific functionality.
本机已安装Android Studio,但是缺这两个插件,需要我们去安装一下。
打开Android Studio ->configure->Plugins
搜索flutter 进行install
在这里插入图片描述

搜索dart 进行install
在这里插入图片描述

【4】Connected device
! No devices available
本机连接设备,可忽略

再执行一下

flutter doctor

在这里插入图片描述

红叉问题都已解决

<think>好的,我现在需要回答用户关于Flutter在Android平台上常见的环境配置问题及解决方案的查询。首先,我得回顾用户提供的四个引用内容,看看里面有哪些相关的信息可以利用。 引用[1]提到“Android toolchain - develop for Android devices X Unable to locate Android SDK”,这显然是一个常见的环境配置问题,用户可能没有正确设置Android SDK的路径。解决方法应该是检查环境变量,确认ANDROID_HOME和PATH是否正确配置,并安装所需的SDK组件。 引用[2]详细说明了Flutter开发环境和Android开发环境的设置步骤,包括设置系统环境变量和Path,以及运行flutter doctor检查环境。这里的关键点在于环境变量的配置flutter doctor的诊断作用。需要提醒用户按照这些步骤操作,并根据提示解决问题。 引用[3]和[4]似乎更多涉及Flutter的状态管理和开发工具准备,可能和当前问题关联不大,但引用[4]提到MacOS环境下进行安卓开发,可能需要注意不同操作系统的路径差异,比如在Mac上Android SDK的默认路径可能与Windows不同。 接下来,我需要整理常见的Flutter Android环境配置问题,比如SDK路径未找到、许可证未接受、模拟器问题、依赖项缺失等。每个问题需要给出具体表现、原因和解决方法,并引用用户提供的参考资料中的相关内容,比如引用[1]和[2]中的步骤。 例如,针对无法定位Android SDK的问题,解决方案应包括设置ANDROID_HOME环境变量,并将tools和platform-tools目录添加到PATH中,同时运行flutter doctor --android-licenses来接受许可协议。这些步骤在引用[2]中有所提及。 另外,用户可能需要安装Android Studio或命令行工具,确保SDK组件如platforms和build-tools已安装。引用[4]提到的MacOS环境可能需要不同的路径设置,需要注意区分操作系统。 最后,总结问题,确保回答结构清晰,分点列出每个问题及其解决步骤,并在适当的地方添加引用标记。同时,生成的相关问题需要围绕环境配置展开,比如如何安装Android SDK、解决许可证问题配置模拟器等。</think>### Flutter Android 常见环境配置问题及解决方法 #### 1. **Android SDK 路径未正确配置** **问题表现**:运行 `flutter doctor` 时提示 *Unable to locate Android SDK*[^1]。 **原因**:系统环境变量未设置或路径错误。 **解决方法**: - 设置 `ANDROID_HOME` 环境变量,指向 Android SDK 安装目录(例如 Windows:`C:\Users\用户名\AppData\Local\Android\Sdk`,macOS:`~/Library/Android/sdk`)。 - 将 `$ANDROID_HOME/tools` 和 `$ANDROID_HOME/platform-tools` 添加到 `PATH` 环境变量[^2]。 - 重新启动终端后执行 `flutter doctor` 验证。 #### 2. **Android 许可证未接受** **问题表现**:`flutter doctor` 提示 *Android license status unknown*。 **解决方法**: 运行以下命令接受所有未签许可协议: ```bash flutter doctor --android-licenses ``` 按提示输入 `y` 确认接受。 #### 3. **缺失 Android 开发工具** **问题表现**:`flutter doctor` 显示 Android toolchain 存在红色警告(如缺少 `cmdline-tools` 或 `build-tools`)。 **解决方法**: - 通过 Android Studio 安装:打开 **Android Studio → SDK Manager → SDK Tools**,勾选以下项目: - Android SDK Command-line Tools - Android SDK Build-Tools - 对应版本的 Android Platform (如 Android 13.0 "Tiramisu") - 或使用命令行安装: ```bash sdkmanager "cmdline-tools;latest" "build-tools;34.0.0" "platforms;android-34" ``` #### 4. **模拟器未配置或无法识别** **问题表现**:`flutter doctor` 提示 *No devices available* 或模拟器启动失败。 **解决方法**: - 通过 Android Studio 创建虚拟设备:**AVD Manager → Create Virtual Device**,选择设备型号并安装系统镜像。 - 确保启用 BIOS 中的虚拟化技术(如 Intel VT-x 或 AMD-V)。 - 使用命令行启动模拟器: ```bash emulator -avd 设备名称 ``` #### 5. **Gradle 构建失败** **问题表现**:运行 `flutter run` 时出现 *Gradle task assembleDebug failed*。 **解决方法**: - 检查项目目录下的 `android/build.gradle`,确保 Gradle 版本与 Flutter 兼容。 - 清理 Gradle 缓存: ```bash cd android && ./gradlew clean ``` - 更新依赖项: ```bash flutter pub get ``` --- ### 相关问题 1. **如何在 Windows 系统中配置 Flutter 和 Android 开发环境?** 2. **如何通过命令行管理 Android 虚拟设备(AVD)?** 3. **Flutter 项目构建时如何解决 Gradle 版本冲突问题?** 4. **如何为 Flutter 应用配置不同 Android 版本的最小 SDK 要求?** --- **引用说明**: - 环境变量设置和 `flutter doctor` 诊断流程参考自 Flutter 官方文档和常见问题排查指南。 - Android SDK 路径配置问题与解决方案在开发社区中广泛讨论[^4]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值