这是本简书第一篇文章,打算所有文章都只专注于 Flutter 研究,就从这篇文章开启 Flutter 之旅吧。
说明:本文以 Mac 系统和 Android studio 为例。虽然官网已经有比较详细的搭建过程,本文目的主要是精简搭建过程,并且介绍可能遇到的坑。以求以最快的速度搭建稳定的开发环境。
-
大部分软件开发环境的搭建都是类似的,回想 java、Android 等开发环境,我们可以总结关键步骤为:
下载 SDK:目的是能够在本地调用 api 以及能提供运行环境
配置环境变量:让系统能够识别该环境
安装 IDE:快速开发(写代码)的工具
Flutter 也不例外,接下来我们就基于以上步骤,来完成 Flutter 环境的搭建
下载 SDK
到官网下载 SDK ,官方提供了 Windows、Mac、Linux三个系统的 SDK,地址:Flutter sdk 官方下载
-
以 Mac 系统为例,下载后为 zip 文件,将该文件解压到你喜欢的目录即可
- 比如,我解压到 Library 目录,可使用如下命令:
cd ~/Library
unzip ~/Downloads/flutter_macos_v1.5.4-hotfix.2-stable.zip
- 此后,就会在 Library 目录下生成 flutter 目录,里面存放的就是 SDK 文件了,需要注意的是,Flutter SDK 已经包含了 Dart SDK(Dart 为 Flutter 开发使用的语言)。所以无需再下载 Dart SDK 了。
配置环境变量
配置环境变量的目的,是可以在系统任意位置,使用 Flutter 相关命令
-
配置过程为:
打开系统配置文件:vim ~/.bash_profile (如果不熟悉 vim,也可以直接使用 open ~/.bash_profile 打开并编辑)
添加 Flutter SDK 路径:
export PATH=/Users/<你的系统名称>/Library/flutter/bin:$PATH
- 使用命令:source ~/.bash_profile 刷新配置使之生效
注意: 如果你使用终端是zsh,终端启动时 ~/.bash_profile 将不会被加载,解决办法就是修改 ~/.zshrc ,在其中添加:source ~/.bash_profile
- 通过命令,验证 flutter 路径是否已在PATH中:echo $PATH,如果输出的信息中包含配置的 flutter/bin 路径,即为配置成功
-
然后运行如下 Flutter 命令来查看是否还需要安装其它依赖,该命令也会给出当前环境的检查报告,比如 是否安装了 Android Studio 或 Xcode,如有异常,会给出说明,所以要认真查看输出内容:
flutter doctor
- 需要注意的是,该命令执行需要一定的时间,回车后可能无法立即输出内容,所以耐心等待一会(一般不到一分钟)
安装 IDE
IDE 能够为我们提供高效便捷的开发工具,比如 eclipse、Idea、Android studio 等都是常见的 IDE。
Flutter 暂时没有专用的 IDE,但又可以通过简单配置,让 XCode 或 Android Studio 成为其 IDE
-
以 Android Studio 为例,只需要安装两个插件,就可以用来开发 Flutter 了
依次进入 Android Studio -> Preferences -> Plugins,搜索并安装 Flutter 插件(该插件会提示需要安装 Dart 插件,确定即可)。
然后重启 Android studio,在 File -> New 中就出现了 New Flutter Project...
至此,环境搭建成功!新建一个工程,然后在模拟器或者真机上运行试试吧。
踩坑
在运行时如果提示 adb 版本太低,此时进入 SDK Manager 里,选择 SDK Tools,选中 Android SDK Platform-Tools 进行升级即可
常见的还有下面错误:
Error writing "build/flutter_assets/AssetManifest.json" to DevFS: HttpException: Connection closed before full header was received, uri = http://127.0.0.1:64529/KPceaPEjwB4=/
Error writing "build/flutter_assets/FontManifest.json" to DevFS: HttpException: Connection closed before full header was received, uri = http://127.0.0.1:64529/KPceaPEjwB4=/
解决办法是在命令行运行:flutter doctor --android-licenses,然后一直 Accept 就行
这个问题一般在运行 flutter doctor 命令时会有提示:
[!] 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
- 看到如下界面,一切大功告成