Flutter环境安装 && 运行

2021-07-16

Flutter环境安装 && 运行

背景

Flutter环境配置到运行，问题备忘记录。比如遇到Android sdkmanager tool not found和Running Gradle task 'assembleDebug'...

Flutter安装

超级精简版

通过homebrew直接安装，可能需要外网

brew install flutter

手动，Flutter环境搭建

首先下载Flutter安装包，下载地址：https://flutter.dev/docs/development/tools/sdk/releases?tab=macos
其次，解压已下载文件，把文件放入指定目录中，注意：建议放入可以放入用户根目录下，因为后续需要指定bin文件地址，这个目录最好不会经常变动
然后，配置环境变量
打开terminal，如果是zsh，输入open .zshrc；（如果是bash，则输入open .baseprofile）在文件末尾添加如下代码，其中pwd为刚刚解压的flutter/bin文件地址，
1
export PATH="$PATH:`pwd`/flutter/bin"
同时，由于国内的原因，还可以添加以下两个环境变量
1
2
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
如下图：

编辑完成.zshrc（或者.bashprofile）文件后，保存关闭，运行
1
2
source .zshrc
// 编辑的如果是.bashprofile，则输入source .bashprofile
然后运行flutter doctor，即可判断flutter是否安装好。

编辑器安装

Android Studio
下载安装Android Studio后，还有是三个地方需要安装
- SDK Manager，安装SDK Platforms，根据实际常见添加需要的安卓版本
- AVD Manager，添加安卓模拟器
- Plugins，添加Flutter和Dart插件
如下图：
Xcode，直接下载安装，然后打开一次即可。
VSCode，打开VSCode的插件界面，搜索Flutter，安装即可。

校验环境

输入flutter doctor，根据提示判断环境是否安装好，可能会遇到问题，可参考下面的问题记录

输入flutter doctor --android-licenses，会有提示选择y/N，统统选择y即可。

创建项目

使用VSCode创建Flutter项目，打开VSCode（记得安装Flutter插件），同时按CMD+Shift+P，唤起快捷命令，输入Flutter，选择Flutter: New Applicaiton Project，如下图

wecom20210716-172146@2x.png

然后选择项目存放地址，项目名字，即可

运行模拟器

列举支持的模拟器

1
2
3


flutter emulator

结果如下：

screen shot 2021-07-16 at 13.50.49.png

打开指定的模拟器

1
2
3


flutter emulators --launch xxx

运行模拟器

1
2
3


flutter run

然后选择要运行的模拟器，如下：

wx20210716-151358@2x.png

问题记录

运行flutter doctor，报错：Android sdkmanager tool not found

修改：打开Android Studio，点击Config->SDK Manager，选中SDK Tools，取消勾选底部Hide Obsolete Packages，然后能看到Android SDK Tools(Obsolete)，勾选Apply，等下载完成即可。

wx20210716-153139@2x.png

运行flutter doctor --android-licenses，报错：Failed to install android-sdk: “java.lang.NoClassDefFoundError:

修改：打开Android Studio，点击Config->SDK Manager，选中SDK Tools，取消勾选底部Hide Obsolete Packages，能看到Android SDK Command-line Tools(latest)，勾选Apply，等下载完成即可。
启动模拟器卡在Running Gradle task 'assembleDebug'...

背景：配置好flutter环境之后，选择安卓模拟器，启动时，一致卡在Running Gradle task 'assembleDebug'...

原因：Gradle的Maven仓库在国外，因此需要使用阿里云的镜像地址。

修改：

andriod/build.gradle文件中repositories修改为


maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/jcenter' }
maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }

如下：
wx20210716-151922@2x.png