最近心血来潮想学学习一下FLutter,于是记录一下环境搭建时遇到的坑.

如果你已经有了 Flutter 的开发环境，可以跳过本篇。先声明一点： Flutter 虽然可以开发 Windows、Linux、Macos、Android、iOS 、web 六大主流平台的应用程序。但作为初学者，最好先在一端上学习 Flutter 的基础知识，不用过分追逐在每个平台上都跑一遍，本教程的所有代码均在windows和安卓设备上运行，其他设备的环境安装都大同小异，请自行参考官方文档的介绍进行安装(环境安装和配置）

FlutterSDK的下载与安装

对于Flutter而言最为重要的就是它的SDK地址如下：

:::infoArchive | Flutter

:::

根据操作系统的类型下载对应的版本这是选择稳定版本的文件，比如我现在的最新版本为3.24.0

下载后得到一个压缩文件，将这个文件解压后放到你想存放的路径下面

然后将这个解压后的文件添加到系统的环境变量中,我这里是存放D盘的根目录下面

另外由于网络原因，国外网站的依赖可能难以下载以后开发中需要的依赖包，我们需要将Flutter的下载源替换为国内的地址

PUB_HOSTED_URL=https://pub.flutter-io.cn
FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

上述步骤执行完成后，在系统的命令行中输入 flutter --version如果能够输出版本号，那么说明我们的Flutter SDK安装成功了

IDE环境的安装与配置

关于IDE的选择，个人偏向使用AndroidStudio，主要有以下几点原因

:::info

AndroidStudio 的调试功能非常强大，也方便查阅源码AndroidStudio 方便管理和下载 AndroidSDK，可以创建安卓模拟器AndroidStudio 是 Android 的官方开发工具，对 Android 开发比较友好

:::

当然如果你不喜欢Android Studio可以自行安装其他的IDE，如VSCODE等

登录Android Studio的官方网站，地址如下

:::info下载 Android Studio 和应用工具 - Android 开发者 | Android Developers ()

:::

下载后运行安装包，一直下一步即可安装成功。

首次启动时，Android Studio会引导你下载Android SDK在接受之后进行下载即可

下载完成后我们需要在Android Studio中下载两个插件Dart 和 Flutter，在Android Studio的插件商城中自行下载即可

创建flutter项目

插件安装完成之后，重启Android Studio，在新建项目的时候就会有创建Flutter项目的选项，在红框中选择我们之前下载的Flutter SDK的下载目录

点击create后就会创建出Flutter的默认计数器项目，在下一节中我们会对代码进行详细的分析。接下来让我将这

个项目运行到Android设备中。

创建android模拟器

在设置安卓模拟器之前，我们需要添加一个 ANDROID_HOME 的环境变量，值为 Android SDK 下载的目录的环境变量（如果你上面的步骤都是选择的默认安装那么，你的Android SDK的下载路径应该为C:\Users\你的用户名\AppData\Local\Android\Sdk）

设置完成之后在 Android Studio 中创建一个模拟器即可

点击 Create Virtual Device选项，点击后选择你想要屏幕尺寸

然后选择下载的镜像，大家最好和我选择同样的版本

安装完毕后，点击运行。然后点击上面菜单上的三角按钮即可将当前的Flutter项目运行到当前的模拟器上

至此我们的Flutter的开发环境的安装到此就全部完成了，现在我们可以开始学习之后的内容了。

常见问题如果你在上面的任何一个步骤中出现了问题，那么请打开你的命令行工具，然后输入flutter doctor -v

如果发现上述内容你也存在的话，那么请跟这个我接下来的步骤进行解决

打开 Android Studio，依次打开：Settings → 在搜索栏中输入 Android Sdk→选择Languages & Frameworks →Android SDK →找到Android SDK Command-line Tools 工具安装即可

接着解决第二个报错\ 管理员权限起一个命令行，键入：flutter doctor --android-licenses ，来同意安卓协议，无脑y+回车，直到出现：**All SDK package licenses accepted\ **之后再次输入flutter doctor -v

大功告成！（上图唯一的x是因为没有安装Visual Studio，如果你需要安装开发windows上的应用就需要安装）

如果将项目运行到模拟上时如果一直卡在这个步骤上。

请参考这个链接查看解决方案。

:::info

Flutter 卡在 "Running Gradle task 'assembleDebug'... "如何解决，网上大 - 掘金 ()

Gradle-加速Gradle下载 - 夜行过客 - 博客园 ()

:::

如果提示JAVA_HOME不存在，那么请自行安装java，这里不在赘述。

需要注意的是，电脑中运行到java版本需要和当前项目中指定的gradle版本相对应.

gradle版本可以查看项目的android →gradle→gradle→wrapper.properties中的distributionUrl的值来查看

可以看到这里我的版本为7.6.3，知道了项目的gradle版本，我们需要参考官方的来下载对应的java版本

运行项目报错：Error:Connection timed out: connect

打开项目里 gradle\wrapper\gradle-wrapper.properties 将distributionUrl=/distributio…

替换为国内的镜像地址，比如腾讯的地址\ /gradle/grad…

项目运行报错：ailed to apply plugin 'com.android.internal.application'. > Your project path contains non-ASCII characters. This will most likely cause the build to fail on Windows. Please move your project to a different directory.

如果碰到上面的错误，请项目的存放目录全部修改为中文