Flutter从配置安装到填坑指南详解

点击上方蓝字关注公众号

码个蛋第281次推文

     作者：AWeiLoveAndroid

     博客：https://www.jianshu.com/u/f408bdadacce

目录

• Flutter安装

• 如果已经安装Fluttter，需要更新请看（不更新的就跳过此步）

• 配置环境变量

• 打开flutter命令行

• 几个flutter常用命令

• 开发工具的安装

• 运行一个demo app

• 遇到的一些问题

• 几个相关学习网站

在 Google I/O ’18 上，Google 向我们介绍了 Flutter —— 一款新的用于创建移动应用的开源库。

 Flutter是什么呢?它是Google使用Dart语言开发的移动应用开发框架，用来帮助开发者在iOS和Android平台上开发高性能、高质量的原生应用。Flutter是跨平台的免费开源UI框架，iOS和Android可以共用一套代码。

Flutter是基于Dart语言编写的。主要优点：

1.免费开源

2.利用保持状态的热重载（Hot Reload）、全新的响应式框架、丰富的控件以及集成的开    发工具这些特点进行快速开发。

3.通过可组合的控件集合、丰富的动画库以及分层可扩展的架构来实现富有感染力的灵活    界面设计。

4.借助可移植的 GPU 加速的渲染引擎以及高性能本地 ARM 代码运行时以达到跨设备跨      平台的高质量用户体验。

5.提高效率：使用一套代码同时开发Android和iOS。

6.可扩展性很强：Flutter框架本身提供了丰富的Material Design和Cupertino(iOS-flavor)  风格的控件，可自由扩展控件不受手机平台    控件的限制。

今年（2018年）2月，Flutter推出了第一个Beta版本。这真是个好事。期待正式版早日发布。最近研究了一下Flutter，这个工具从安装到运行经历了九九八十一难，好在终于成功运行起来了。下面看一下官方的Demo在Android模拟器的运行效果图：

 默认的Demo运行图

本文同步发布在github,更多关于Flutter的信息请点击

https://github.com/AweiLoveAndroid/Flutter-learning

下面就 详细的 讲一下我的安装之路和遇到的一些问题：

社会我韦哥，人好干货多。开始撸码！

0

Flutter安装

 

要安装并运行Flutter，你的开发环境必须满足这些最低要求：

这里以windows系统为例，
macos安装文档请查看：https://flutter.io/setup-macos/

linux安装文档请查看：https://flutter.io/setup-linux/

（一） 操作系统：Windows 7 SP1或更高版本（64位）

（二） 磁盘空间：400 MB（不包括IDE /工具的磁盘空间）。

（三） 对Android Studio的要求：需要安装3.0 或者更高的版本。

（四） Flutter支持的sdk环境：Android 4.1（API 16）或者更高版本。

（五） 对Android模拟器镜像的要求：推荐使用x86或者x86_64镜像。

（六） 工具：Flutter需要用到以下2个工具：

(1) PowerShell 5.0或更新版本

查看PowerShell有没有安装，可以点击电脑左下角 --> 控制面板 --> 程序 --> 程序和功能，找一下PowerShell，有时候安装了也可能找不到（我电脑就找不到），那就win + R,输入cmd回车，输入$PSVersionTable ，查看powershell版本。
如果报错说明没有安装PowerShell，请点击powershell官网 https://docs.microsoft.com/en-us/powershell/scripting/setup/installing-windows-powershell?view=powershell-6#upgrading-existing-windows-powershell

【注意:】关于命令行无法显示某些字符或者中文乱码问题的解决：

1、无法显示√或者×字符
原因是点阵字体搞的鬼。设置一下控制台字体就可以了。
在控制台标题右键，选择字体，把点阵字体改为其他字体就可以了。

2、cmd中文乱码的解决：

1. win+R 输入regedit 进入注册表 
2. 找到 `HKEY_CURRENT_USER\Console\%SystemRoot%_system32_cmd.exe` 
如果该项下已存在CodePage项，则把值改为十进制”65001”；
如果不存在，在该项下新建一个 DWORD（32位值），命名为“CodePage”，值设为“65001” 
3. 重启cmd后生效

3、PowerShell中文乱码的解决：

1. win+R 输入regedit 进入注册表
2. 找到 `HKEY_CURRENT_USER\Console\%SystemRoot%_system32_WindowsPowerShell_v1.0_powershell.exe` 下的项。
如果该项下已存在CodePage项，则把值改为十进制”65001”；
如果不存在，在该项下新建一个 DWORD（32位值），命名为“CodePage”，值设为“65001”
3. 重启PowerShell后生效

安装好之后，运行一下看看版本号，我这边的powershell版本号相关信息如下：

    PSVersion                      5.1.15063.1029
    PSEdition                      Desktop
    PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
    BuildVersion                   10.0.15063.1029
    CLRVersion                     4.0.30319.42000
    WSManStackVersion              3.0
    PSRemotingProtocolVersion      2.3
    SerializationVersion           1.1.0.1

(2) Git for Windows

使用git命令行（关于如何使用git，请查看我的博文 Git及GitHub快速入门图文全面详解）(https://www.jianshu.com/p/3f12bd3ccf2a)：

git clone -b beta https://github.com/flutter/flutter.git

运行过程截图：

1

如果已经安装Fluttter，需要更新请看（不更新的就跳过此步）：

 

要同时更新Flutter SDK和包，请使用以下命令：

flutter upgrade

2

配置环境变量

 

如果想在命令行中使用 flutter 命令，你需要添加flutter的路径到path中去。这个和配置java环境变量是同样的做法，找到flutter安装路径，比如我的是E:\develop\flutter\bin，我复制这个路径，右键我的电脑-->属性-->高级系统属性-->环境变量-->找到PATH，点击编辑-->在最后把刚复制的路径粘贴进来，-->一直保存确定就可以了。

接下来，使用flutter --version 查看一下版本号，看看环境变量配置好了没有。。如果如下图所示表示OK。

【大坑】注意：如果只输入flutter  或者输入flutter -version   那么flutter以为是下达了自动更新命令，会自动更新最新版本，这个一定要注意了。

3

打开flutter命令行

 

win + R 快捷键，输入cmd，回车，输入flutter doctor，回车。

这个命令初次运行可能会很慢，Flutter会自动安装所需依赖，并进行编译。建议科学上网。

安装过程截图：

输入flutter doctor命令

安装完成之后（这里没有安装Flutter和Dart插件，大家可以打开AS自己搜索安装，如何安装下文有介绍）

注意：

[√]这个是安装OK的，[X]是需要安装的，或者是已安装但是没有运行起来的。（具体这里面有标记[X]的那些项如何安装后文有详细讲解，这里简单提一下。）

这里面有四项内容：

• （1）Flutter 这是Flutter工具，就是刚才git下载的那个。

• （2）Android工具链，这里指的是SDK，会标注出SDK的最大版本号。

• （3）IDE工具的对应版本，比如我的是Android Studio 2.2版本（这个是下载安装的版本），Android Studio 3.2版本（这个是免安装的版本，所以也会显示出来），还有Intellij IDEA

• （4）已连接的设备，可以是模拟器，也可以是真机，如果已连接会显示出来。

4

几个flutter常用命令

 

查看版本号的命令使用截图如下：

以下是常用命令：

5

开发工具的安装

 

（一）AS

Flutter对Android Studio的要求：需要安装3.0 或者更高的版本。

关于AS安装，这个就不用说了，大家都安装了吧，jdk,sdk这些都配置好了吧.直接看下文好了。

（二） Flutter和Dart插件安装

Flutter需要Flutter和Dart插件才可以使用：

File --> settings --> Plugins --> Browse repositories，然后输入Flutter就可以下载了，Drat也是一样的道理。

Flutter插件安装：

Dart插件安装：

安装好之后重启一下AS就可以使用插件了。

6

运行一个demo app

 

Flutter支持的sdk环境：Android 4.1（API 16）或者更高版本。

Android模拟器：推荐使用x86或者x86_64镜像。

创建project过程和普通安卓项目是很类似的。

（一）打开AS，点击 File --> New Flutter Project，选择Flutter application

然后点击next，输入一个工程名字。

注意：项目名称必须是小写，单词之间用下划线隔开，你看我这样创建就给我提示错误了，报错的如图所示。

错误示范

（二）输入包名，点击next，点击finish，等待编译就可以了。如果没配置好，这个时候往往会报错。

注意：这里可以支持ios和kotlin，如果需要的话可以勾上。

（三）首先模拟器，然后选择要运行的项目，注意了，这里有一个MainActivity 和 main.dart，选择main.dart，然后点击绿色的三角号图标运行（或者点击菜单栏    Run）就可以了。

Run运行示意图

我用的AS3.2，我截个图，菜单栏跟以前版本有点不同，之前的AS版本可以在Build菜单找到编译选项的。

AS3.2编译菜单栏

如果代码有更改，可以点击黄色的闪电图标

点击它之后就可以进行热加载。

运行之后的截图：

工程目录结构：

7

遇到的一些问题

 

（一）卸载flutter相关环境

Dart的插件安装包在 C盘路径：
\AppData\Roaming\Pub\Cache\hosted\pub.dartlang.org文件夹里面
所以只需要找到Pub文件夹，删掉Pub文件夹。

flutter源代码文件，就是你在github下载下来的那个项目源代码，
比如我放在了E:\develop\flutter，我只需要把flutter这个文件夹删除就可以了。

C盘用户名下面有个.AndroidStudioXXX的文件夹，这个是AS的缓存目录，
比如我的是 C:\Users\luzhaowei.AndroidStudio2.2
打开，找到插件目录 C:\Users\luzhaowei.AndroidStudio2.2\config\plugins
把里面的Dart 和 flutter-intelliJ两个文件夹删掉

把环境变量里面的flutter和dart有关的设置删掉。

（二） 卸载flutter之后，命令行运行flutter doctor时，会有以下错误（以下是我的填坑指路全过程）：

注意：由于下载的国外的网站上的资料，需要科学上网！！！

首次运行报的错

自动重试

我退出命令行再运行，还是照样出错。

后来我想是不是BITS传输服务未开启，于是我一顿操作猛如虎，操作如下，打开BITS：

计算机 --> 右键 “管理” -->  服务和应用程序里面，点击“服务”，然后如下图所示：

然后选中图中标记的这个，右键点击“属性”，然后改成自动，确定。如下图所示：

然后我把刚下载的flutter文件夹删掉，重新执行git命令，下载flutter。（下好了之后记得配置环境变量）然后执行flutter doctor 命令，这次好一些了，但是命令行更新的很慢，一直停留在命令行，如图所示：

等了好久，终于出来了。

然后又是漫长的等待，在下载Material fonts这里出错了,于是我关掉了命令行，重新打开命令行，执行flutter doctor命令。

然后又是失败。。不等了，关闭命令行吧。

然后重新打开命令行，执行flutter doctor命令。经历了几个小时的折腾，终于环境安装好了！
看到下面那个对勾，表示flutter已经更新完成了。

然后重新打开命令行，执行flutter doctor -v命令，。看看还有什么需要安装的？（目前我安装的flutter最新版是0.4.4）,如下图所示：

新版的跟旧版的有区别，这里的每一项里面的小项都很详细的列举了类目，只要是正确安装了IDE，以及配置了jdk,sdk环境的，都会详细列出来。

Flutter支持Android Studio、VSCode以及  控制台+文本编辑器 的方式。如果你还安装了VSCode，命令行里面也会列举出来的。

【重点提示】按照提示来操作即可，哪个缺少（前面是 X 符号的）就配置哪一个。。一般来说，命令行会给你一些提示，比如需要使用什么命令操作，需要在哪个路径下面操作等。。

有3点需要特别注意的：

• Flutter，这里面有4个工具，缺一不可：Flutter本身的安装包，Framework（这是flutter的核心代码部分），Engine（flutter的引擎），Dart sdk。

• Android toolchain（开发Android设备的一些工具），这里是完整版的安装，有7个工具：sdk（sdk路径），ndk（ndk路径），Platform(android-27)以及build-tools（27.0.3），给sdk路径配置ANDROID_HOME环境变量，jdk配置路径，jdk运行环境版本，android licenses(协议)。

• Android Studio环境，包括安装包路径，Flutter插件，Dart插件，AS自带jdk版本号。
  我这里还安装了IDEA， 所以也会把它的环境列举出来。

下面是安装过程中出现的一些安装包缺少的问题：

↓这个 问题的原因：是sdk环境变量没配置，找到sdk路径，比如我的是E:\debelop\sdk，我复制这个路径，打开环境变量，新建一个变量，取名为ANDROID_HOME，然后在path变量里面最后加入;%ANDROID_HOME\%

↓这个 问题的原因：一些android licenses没有同意，按上面的要求在命令行输入flutter doctor --android-licenses，回车，然后会出现要你输入y/n 你只要输入y 回车就好了。

↓其他问题：基本都是开发工具的配置了，这个就不多说了，大家应该很熟悉了。

（三） Flutter插件不支持当前AS版本。当前的AS是3.2，我的gradle编译的api是27的，可能Flutter目前最高只能支持26，果然我在build.gradle里面的编译版本改成了26，重新编译一下，OK了。

（四）系统重装了，flutter工具也是重新安装的，由于没有备份C盘的之前下载的三方库，导致项目加载的时候重新加载一大堆三方库，很卡，下载用了很长时间（需要科学上网）。

【顺便说明一下三方库使用方式】：

Flutter使用外部开源包，打开pubspec.yaml文件，在如下加了中文注释之处添加依赖库：

dependencies:
  flutter:
    sdk: flutter

  cupertino_icons: ^0.1.2
  # 在这里添加依赖库，比这个是英文单词的库
  english_words：^3.1.0
  # 这个是图片选择的库
  image_picker: ^0.4.1

格式：库名称: ^库版本号

注意：冒号是中文标点，有一些库需要^，不要忘记^

可以在 pub.dartlang.org 上找到开源软件包。（需要翻墙）直接添加依赖，可能会很慢，

也可以直接去

https://pub.dartlang.org/packages/ 查找想要的依赖库，直接下载压缩包，然后复制到以下路径：

C:\Users\XXX\AppData\Roaming\Pub\Cache\hosted\pub.dartlang.org\ (使用依赖库安装完成后的本地路径也是这个)，建议把这个文件夹备份，以便系统出故障之后或者重装系统之后好还原。

（五）明明开启了模拟器，可是AS就是不显示模拟器，如下图所示：

然后新建了一个API 26的模拟器，然后命令行窗口提示以下错误：

（六） 编译一个demo居然安装包是30多M，这个也太坑了吧。。安卓原生的apk包最多就几M。但是这是debug模式下的apk包，签名打包后的release版本的包很小，大概几兆的样子。

（七）Flutter有一个Flutter Inspector的工具，主要是检查Widget的，可以用于诊断布局渲染问题，查看app当前的视图树结构。但是：这个视图树层次太深了，看起来很费劲有木有。。 详细使用描述可以参考官网文档：http://doc.flutter-dev.cn/inspector/

费了好大的劲截的图---- 完整的视图树

【备注：】不同电脑视图树工具显示不一样，可能跟cpu是x86或者x64有关，另外一台电脑就没有这么多层次了，用到了哪些控件就显示哪些，很明确清晰。如下图所示：

换台电脑显示就不一样了

8

几个相关学习网站

 

• Flutter源码github链接https://github.com/flutter/flutter

• Flutter官方文档 https://flutter.io/docs/

• Flutter中文文档 http://doc.flutter-dev.cn/

• Dart语言官方主页 https://www.dartlang.org/

• Dart语言中文社区 http://www.cndartlang.com/

• Dart中文官网 https://www.dart-china.org/
  

另外可以推荐下载nodejs和 yarn，以后使用yarn下载更新包很方便。（这个不是重点，了解就可以了）

• yarn官网  https://yarnpkg.com/zh-Hans/

• yarn中文网 https://yarn.bootcss.com/

• nodejs中文官网 https://nodejs.org/zh-cn/