常见问题
以下是大家很容易忽视的几个问题。
环境要求,你需要注意 Flutter 的环境要求,很多人都会忽视这一点,导致在安装过程中遇到问题才会回头看环境要求,所以无论自己对配置如何了解,都需要按照官网的指引去检查每个配置项。
Flutter 下载,请尽量下载当前稳定版本,避免因为不稳定版本导致的其他环境要求,导致安装不成功。
Android Studio 工具安装,Flutter 的配置运行需要依赖 Android Studio 来完成,因此在安装之前可以先准备好 Android Studio 的安装配置,并且需要了解其中关于 Flutter 插件和 Dart 插件的安装,这些在 Flutter 官网有详细的解释说明。
Anroid Studio 出现 unable to access android sdk add-on list,出现这个问题,可以修改 Android Studio 安装目录 bin 下的 idea.properties 文件,在文件最后一行增加如下配置。
disable.android.first.run = true
Android Studio 网络代理,如果你的网络有代理,也需要进行配置,如果没有正确配置,将导致 Andorid Studio 提示 flutter pub upgrade 无法正常更新。
Flutter Doctor 核心点检查,需要认真检查其中的每一项,对于其中的问题项,Doctor 一般会提供具体的解决方案。
点击 Finish 长久未响应(或者执行 flutter pub upgrade 未响应),这种情况会出现“This is taking an unexpectedly long time”提示,如果出现这个提示,很大可能是你的镜像配置没有按要求配置。你可以参考以下这段配置,第一个是 Flutter 的命令行工具,第二个则是 Dart 的命令行工具,后面两个镜像配置很关键。
PATH=$PATH:/Users/用户名/Downloads/flutter-main/bin
PATH=$PATH:/Users/用户名/Downloads/flutter-main/bin/cache/dart-sdk/bin
PUB_HOSTED_URL=https://pub.flutter-io.cn
FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
- Flutter SDK path not given,如果在创建 Flutter 项目时候提示“ Flutter SDK path not given“,则点击 Flutter SDK path 路径,然后选择我们前面安装的 Flutter SDK 路径即可。
Mac 系统上注意的点
Mac 上的安装,我这里主要说明 Xcode 和 Mac 下的环境变量配置。
- Xcode 要升级到指定版本以上,由于 Flutter 需要应用 iOS 模拟器,因此对 Xcode 版本有一定要求。
- Mac 下设置环境变量,其中涉及一些环境变量的配置,虽然网上有很多方法,官网也有提供,但我推荐大家使用如下方法,永久设置。
sudo vim ~/.bash_profile
配置添加 Flutter 的安装路径,一般情况下会安装在你解压后运行的路径下。例如,下面我自己安装后的路径,安装完成后确定具体路径,然后在 bash_profile 文件中增加这行配置即可。
PATH=$PATH:/Users/用户名/Downloads/flutter-main/bin
最后再运行加载,并运行测试。
source ~/.bash_profile
flutter -h
Windows 系统上注意的点
Widows 系统安装需注意以下几点。
- 环境变量的设置,如果在 cmd 下没有 export 命令,前往系统属性下 -> 环境变量,然后新建,按照变量名为 PUB_HOSTED_URL ,变量值为 https://pub.flutter-io.cn ,以及变量名为 FLUTTER_STORAGE_BASE_URL ,变量值为 https://storage.flutter-io.cn 进行配置,对应到官方文档如下配置。
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
- 配置 Flutter 运行环境,下载完成 Flutter SDK ,并放到指定的 C:\src\ 下,然后再次配置环境变量,需要在环境变量名为 PATH 的字段后面增加分号分割,并在分号后增加如下路径。
C:\src\flutter\bin
- 如果出现安装 Android SDK 时无法勾选 SDK ,需要重新卸载安装。这里需注意,在卸载时需勾选删除当前用户本地 Android Studio 配置,然后重新安装时,选择非 Program Files 目录。