Flutter Windows 下的安卓环境搭建

1,196 阅读7分钟

Flutter 是 Google 开源的应用开发框架,仅通过一套代码库,就能构建精美的、原生平台编译的多平台应用(当然我不说你也知道)。

为什么是Flutter? 因为我不会安卓。 为什么是Windows? 因为我没有Mac。

以下环境配置,根据最新版 Flutter 进行,亲测可行,当然具体问题也请具体分析。

一、获取 Flutter SDK

flutter.cn/docs/get-st…

1、下载 Flutter SDK

image.png

具体的系统配置要求,本文不再赘述,查看官网要求即可,只有两个小点需要注意

  • 请勿将 Flutter 放置到有特殊字符或空格的路径下
  • 请勿将 Flutter 安装在需要高权限的文件夹内,例如 C:\Program Files

2、配置 path 环境变量

如果你想在 Windows 控制台中运行 Flutter 命令,需要按照下面的步骤来将 Flutter 的运行文件路径加入到 PATH 环境变量。

  • 在开始菜单的搜索功能键入「env」,然后选择 编辑系统环境变量

  • 用户变量 一栏中,检查是否有 Path 这个条目:

    • 如果存在这个条目,以 ; 分隔已有的内容,加入 flutter\bin 目录的完整路径。
    • 如果不存在的话,在用户环境变量中创建一个新的 Path 变量,然后将 flutter\bin 所在的完整路径作为新变量的值。

3、运行 flutter doctor 命令

配置好环境变量之后,命令行即可执行上述标题命令

image.png 上述命令会检查你的现有环境,并将检测结果以报告形式呈现出来,你可以根据提示一步一步完成自己的环境配置(当然你只需要关注安卓环境)。

4、配置资源镜像

如果你在国内使用 Flutter,那么你可能需要找一个与官方同步的可信的镜像站点,帮助你的 Flutter 命令行工具到该镜像站点下载其所需的资源。你需要为此设置两个环境变量 PUB_HOSTED_URLFLUTTER_STORAGE_BASE_URL,主要可以解决项目环境依赖下载不下来的尴尬问题,当然,如果你游戏一个稳定的梯子当我没说,也可以忽略这一步骤:

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

二、JDK

JDK(Java Development Kit)是 Java 开发套件的简称,既然要做原生应用,而且是基于 Android 的,所以需要安装 JDK。 请选择一个适合本地操作系统的安装包(操作系统 + 位数,例如: Windows x64

下载时,提示需要登陆,我们可以先注册 Oracle 账户,登陆后再下载

下载完成后,双击安装包,开始安装(一直下一步就好,无需特殊配置)。

版本建议选择 java11

www.oracle.com/java/techno…

安装完成之后,使用 java --version 检查是否成功

java --version

image.png

如果查找不到命令,则配置环境变量(路径因人而异)

image.png

三、Android Studio

请做好心理准备,这一安装过程相当漫长,你懂得(请保证自己有一个稳定的快速的梯子),如果没有的话,我也只能对你的环境说一声阿门了。

developer.android.google.cn/studio

1、基础安装篇

  • 下载 Android Studio
  • 下载完成后,双击安装包。Android Studio Setup 将显示在屏幕上,点击 Next 继续
  • 选择你需要安装的组件,需要安装 Android Studio 和 Android Virtual Device(安卓虚拟设备)。需要 2.7GB 的空间,这里使用默认设置,一路点击 Next 继续

image.png

完成安装后:

image.png

image.png

image.png

image.png

左侧标记的依赖,记得点击之后,选择右侧的 Accept 后,选择 Finish

image.png

image.png

此时会开始安装依赖,当然不要担心,即使安装失败,也可以在 IDE 内再次重新安装;

进入主页面后,选择新建项目(目的一样是为了安装一些需要的依赖):

image.png

下方列出一些需要安装的依赖项:

image.png

SDK Platforms

根据自己的需要安装即可,常用的也就是 9 ~ 13

image.png

SDK Tools

这里略显麻烦,会着重列出一些:

image.png

安卓 SDK 建议勾选上 29 的版本:

image.png

image.png

image.png

截图有些依赖,本人没有更新,所以会有提示(横线),并不重要,上方截图的依赖安装成功之后,Android Studio 基本不会有什么大问题了。

2、插件

在 Android Studio 中安装 Flutter插件(Flutter 插件中自带 Dart 插件),安装之后,才可以在 Android Studio 中创建 Flutter 项目。操作步骤如下:

Android Studio => File => Settings => Plugins => Marketplace => 搜索 flutter => 点击 Install 执行安装

image.png

选择 Flutter 即可,Dart 会在安装时提示你安装

3、安卓模拟器

开发过程中,可以直接使用真机开发,当然最简单的方案是直接使用安卓模拟器,具体看个人习惯,环境配置过程中,安卓模拟器应该也会下载一个,若没有的话,则可以自己配置:

image.png

image.png

image.png

建议不要下载很多,1~2个即可,因为,模拟器非常大,如果你对自己C盘非常自信,那喜欢哪个下哪个。

四、开始检查环境配置

上述步骤走完之后,开始检查自己的环境配置,方法就是:

flutter doctor

image.png

由于我本地环境已配置完成,所以没有什么问题(注意区分平台,比如 Visual Studio - develop for Windows 之类的,如果不打算开发桌面端,就无需处理和配置),至于黄色警告,看心情是否解决(不影响开发的前提下,我截图问题是因为本地存在 android studio 旧版本,你可能也会遇到,但是新版本是正确的的就不会影响开发)

列举一些常见的问题:

  • Android license status unknown.

image.png

解决方案:根据提示,运行

flutter doctor --android-licenses
  • No devices available(没有可用设备)

安装模拟器或连接真机即可

  • Unable to find bundled Java version

java 配置问题,自行检查,11 往上即可,无需最新版本,怕兼容问题

  • Windows Version (Unable to confirm if installed Windows version is 10 or greater)

检查不到是否是 win10 系统,若自己确定,不处理了也没啥所谓(可以降低 flutter 的版本解决)

五、环境变量 PUB_CACHE

这个变量决定了 pub get 下载的那些包资源缓存放到何处。默认情况下,PUB_CACHE 存储在你的用户目录(Mac 和 Linux)或 %APPDATA%\Pub\Cache 目录(Windows,不同版本的 Windows 操作系统可能会不一样)下的子目录中。如果你想更改地址,可以配置该环境变量设置为新的地址。如我将其配置在开发环境目录下(windows),以方便查找:

建议修改此项,保证 pub get 下载的那些包依赖缓存资源和 flutter 项目处于同一根目录下(比如 flutter 项目创建于 D 盘,那依赖目录也修改至 D 盘),这对于你需要修改安卓原生代码的时候会非常的有用。当你构建 flutter 安卓目录项目依赖报错的时候,很有可能是因为这个原因(如果你的电脑只有一个磁盘的话,请忽略)。

image.png

注:

flutter doctor 的报错因人而异,大事大差不差,大部分主要是配置安装问题,错误提示都会有错误解决,即使搞不太懂,百度解决方案即可

本文不涉及安卓SDK环境变量的配置问题,因为新版本仿佛已经不太需要,如果你需要的话:

image.png

image.png

%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\emulator
%ANDROID_HOME%\tools
%ANDROID_HOME%\tools\bin

开发工具看个人喜好,基本也就分为三大类:

  • VS Code
  • IntelliJ
  • Android Studio

若有需要或漏写或错误的内容,后续补充或者修改(大概不会因为懒)。。。

1688973876825.png