可参考官方文档:https://flutter.dev/docs/get-started/install,或者 Flutter中文网翻译的文档:https://flutterchina.club/get-started/install/。
以下是我搭建环境的一些记录。
在macOS上搭建Flutter开发环境
由于我mac上已经安装了Xcode和IDEA,如果没有安装的话,请安装Xcode、IEDA(或者Android Studio),具体参考macOS install #Platform setup
系统要求
要安装并运行Flutter,您的开发环境必须满足以下最低要求:
- 操作系统: macOS (64-bit)
- 磁盘空间: 2.8 GB (不包括Xcode或Android Studio的磁盘空间).
- 工具: Flutter使用git进行安装和升级。我们建议安装Xcode,它包含git,但你也可以单独安装git。
如果使用的是最新的Apple M1处理器,Developing with Flutter on Apple Silicon可能对你有用,因为已经对它进行了支持。
获取Flutter SDK
1.去flutter官网下载其最新的stable安装包,转到下载页 。或者去Flutter github项目(flutter) 下载 stable的 release包。
2.解压安装包到你想安装的目录,如:
cd ~/development
unzip ~/Downloads/flutter_macos_2.0.1-stable.zip</pre>
3.添加flutter
相关工具到path中:
export PATH="$PATH:`pwd`/flutter/bin"</pre>
运行 flutter doctor
运行以下命令查看是否需要安装其它依赖项来完成安装:
flutter doctor
该命令检查环境并在终端窗口中显示报告。Dart SDK已经在捆绑在Flutter里了,没有必要单独安装Dart。 仔细检查命令行输出以获取可能需要安装的其他软件或进一步需要执行的任务(以粗体显示)
一般的错误会是xcode或Android Studio版本太低、或者没有ANDROID_HOME
环境变量等,请按照提示解决。
更新环境变量
-
vi ~/.bash_profile 配置flutter环境变量,运行
source $HOME/.bash_profile 生效。
#Flutter
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
export PATH=PATH_TO_FLUTTER_GIT_DIRECTORY/flutter/bin:$PATH</pre>
注意:PATH_TO_FLUTTER_GIT_DIRECTORY
为flutter的路径。比如我的是 ~/development
- 验证 flutter/bin 是否已经在PATH中,使用命令
echo $PATH
- 验证 flutter 命令是否能够使用,
which flutter
升级、回退到指定版本
要同时更新Flutter SDK和你的依赖包,在你的应用程序根目录(包含pubspec.yaml
文件的目录)中运行flutter upgrade
命令:
flutter upgrade
升级你的依赖包
修改了pubspec.yaml
文件,或者只想更新应用依赖的包(不包括Flutter SDK),请使用以下命令:
-
flutter packages get
获取pubspec.yaml
文件中列出的所有依赖包 -
flutter packages upgrade
获取pubspec.yaml
文件中列出的所有依赖包的最新版本
回退到指定版本
找到Flutter SDK放置的地方。在终端CD到对应目录。然后 git reset到指定版本,如:
cd ~/development/flutter
git reset --hard 0af027f80543302c65f99e1c1a2f3b3cbb8d04f3
接着在终端输入 flutter doctor 启动。
同理,升级flutter也可以用git 拉取到指定的stable版本,或者直接到github下载release包解压并替换,然后执行flutter doctor即可。
配置IDE
如使用的是Android Studio或者IntelliJ IDE,
需要安装两个插件:
-
Flutter
插件: 支持Flutter开发工作流 (运行、调试、热重载等). -
Dart
插件: 提供代码分析 (输入代码时进行验证、代码补全等).
步骤:
-
启动IDE
-
打开插件首选项(Preferences>Plugins on macOS)
-
查找到Flutter和Dart插件,并install
-
重启IDE后,插件生效
遇到的问题
使用flutter 命令时,出现“Waiting for another flutter command to release the startup lock...”
,参考 https://blog.csdn.net/u010358168/article/details/84826707
解决方案:
- 关闭IDE (⚠️:如果关闭之后flutter命令正常使用,就不需要进行下面的操作了)
- 打开flutter安装目录/bin/cache
- 删除lockfile文件
- 再执行flutter相关命令
使用flutter doctor命令时,一直卡在“Running "flutter pub get" in flutter_tools... ”
,原因是国内下载镜像资源的问题,需要配置镜像源:
//命令行输入
vim ~/.bash_profile
//添加下面三行,保存
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
export PATH=~/development/flutter/bin:$PATH //下载的flutterSDK的路径
//命令行输入
source ~/.bash_profile
执行flutter doctor时,报错“Could not determine java version”
,没有找到java版本,由于没有安装JDK,没有配置java_home环境变量。
解决办法:
-
下载JDK,https://www.oracle.com/cn/java/technologies/javase-jdk15-downloads.html (⚠️:下载并安装后,正常的话就可以了,先试下java命令是否可用。)
-
配置环境变量
vi ~/.bash_profile
//添加环境变量配置项,保存
JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk15.0.2_181.jdk/Contents/Home
PATH=$JAVA_HOME/bin:$PATH:.
CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:.
export JAVA_HOME
export PATH
export CLASSPATH
//命令行输入
source ~/.bash_profile
CocoaPods 1.9.1 out of date (1.10.0 is recommended). CocosPods过时,推荐使用 1.10.0(其实是一定要更新到1.10.0,因为使用最新的Flutter SDK 2.0.1,如果没更新,编译成iOS应用时会报错)。
解决方案:
- 升级Ruby环境,sudo gem update --system
- 更新cocoapods,sudo gem install -n /usr/local/bin cocoapods
- 更新repo,pod repo update 或 pod install --repo-update
注意:pod repo update 如果报错“[!] CocoaPods was not able to update the aliyun
repo. If this is an unexpected issue and persists you can inspect it running pod repo update --verbose
”,请按提示输入命令行:
pod repo update --verbose
网友评论