本文最后更新于 2023-11-09,文章内容可能已经过时,请注意文章发布时间.

Flutter 框架安装笔记(Android Studio)

下载SDK

下载地址:FlutterSDK

开始安装

将压缩包解压到一个想要的且不会丢失的位置即可完成安装。 例如我的文件位置:C:\Static\flutter.

为了避免出现不必要的麻烦问题,请不要使用C:\Proggrame Files及其子文件夹。

配置环境变量

  1. Windows下依次打开设置->系统 ->关于->高级系统设置->环境变量->高级->环境变量

  2. 双击系统环境变量中的Path选项,新建一条记录:C:\Static\flutter\bin(注意,此处请写自己的Flutter解压路径下的bin目录)

  3. 打开命令行终端,输入命令:where.exe flutter dart查询环境变量是否配置成功。示例:

    ┌─Jack───────> │~ └─> where.exe flutter dart C:\Static\flutter\bin\flutter C:\Static\flutter\bin\flutter.bat C:\Static\flutter\bin\dart C:\Static\flutter\bin\dart.bat

检验安装

配置环境变量后,使用Flutter自带的检测工具检验安装,并根据提示完成配置。

检验安装

打开PowerSHell,执行下面的语句:

 flutter doctor

一般会提示类似信息:

[-] Android toolchain - develop for Android devices • Android SDK at D:\Android\sdk ✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ • Try re-installing or updating your Android SDK, visit https://flutter.cn/docs/setup/#android-setup for detailed instructions.

此时我们需要安装Android Studio来解决这个问题。

安装Android Studio

下载链接:Android Studio

执行安装。(此处略)

一般情况下,Android Studio会自动配置环境变量。此时需要使用Flutter doctor检验。

flutter doctor

安装Flutter插件

在空项目页面,依次点击文件(files)->设置(settings)->插件(Plugins),搜索并安装Flutter。并根据提示,点击确定安装Dart插件。

安装完成后,根据提示,重启IDE

在这里,相信已经解决了安卓SDK的问题。此时Flutter doctor提示了cmdline-tools component is missing问题。

添加Command-line Tools

问题的原因应该是Android Studio 没有自动配置Android SDK Command-line Tools。这里通过手动启用该工具来解决。

  1. 打开Android Studio。

  2. 新建一个空项目,等待IDE自动下载文件(打断下载会报错,小心行事)

  3. 依次点击文件(files)->设置(settings)->搜索框,在搜索框中输入Android SDK,并点选Android SDK设置项,勾选Android SDK Command-line Tools8611dc21f5884341bc432389e83ac739.png

  4. 依次点击Apply->OK

  5. 退出Android Studio,再次终端执行:

    flutter doctor
    

示例:

95f5732b1d887aafd5084c7b8a50027 33a64af2d77c02bfa6a13cc9a9e8325

同意Android协议

重启Powershell,再次运行

flutter doctor

可见Network resources问题已经[√],接下来我们需要同意协议

注意,请确保Android Studio 正确识别了 flutter路径。

安装Chrome浏览器

再次执行flutter doctor,可以看到之前的Android toolchain问题已经消失了。接下来我们着手处理Chrome的问题

直接去官网安装 Chrome浏览器:[Chrome下载](Google Chrome 网络浏览器)

6f81265ddfab152845fd6c0b85024c3

安装即可。

安装Visual Studio

重新运行

flutter doctor

可见Chrome问题已经解决了。下面我们着手解决Visual Studio问题。

下载Visual Studio安装程序:Visua lStudio

Visual Studio 安装完成后,需要继续安装需要的开发环境。例如:image-20230917113906936.png 安装程序会从云端下载开发环境,此过程持续时间较长。

添加环境变量

再次运行

flutter doctor

可见Visual Studio问题已经[√],此时我们着手解决Network resources问题。

Windows中依次打开:设置->系统 ->关于->高级系统设置->环境变量->高级->环境变量

选择编辑系统环境变量,并在 系统环境变量中添加如下变量名:

变量名:PUB_HOSTED_URL

变量值:https://pub.flutter-io.cn

变量名:FLUTTER_STORAGE_BASE_URL

变量值:https://storage.flutter-io.cn

打开命令行或PowerShell,执行:

flutter doctor --android-licenses

先后yEnter同意协议,重复操作直到同意所有协议。

完成后,再次执行flutter doctor,不出意外的话,你已经安装成功了。

最后一次运行flutter doctor,若所有检查项均为[√],即安装成功,如下图所示: 安装成功

体验开发

  1. 新建一个Flutter项目,切记是Flutter项目,在FlutterSDK中填入你的Flutter文件夹。

  2. 创建完成后,在右上角的Target Selector中选择一个设备用于运行安卓应用。

    工具栏若设备列表为空,则需要手动安装一个安卓模拟器(转3)。反之若设备列表不为空,则无需安装(转7)。

  3. 依次点击Tools ->AVD Manager ,点击Create Device,选择一个符合自己需求的安卓镜像,点击Next

  4. 选择一个安卓镜像(ABI是x86或x86_64),点击Next

  5. 输入名称后点击FInish

  6. 此时会开始下载镜像,完成后可在Device Manager中找到对应虚拟机。

  7. 安装完成后,再次右上角的Target Selector中选择刚刚下载的设备用于运行安卓应用,如果设备没有开机,请在DeviceManager中点击三角形启动符号启动。

  8. 点击Config Selector 旁边的Run按钮,运行自动生成的测试代码,运行框弹出如下提示:该过程会持续大约几分钟

    Launching lib\main.dart on sdk gphone64 x86 64 in debug mode... Running Gradle task 'assembleDebug'... Checking the license for package Android SDK Tools in C:\Users\Jack\AppData\Local\Android\sdk\licenses License for package Android SDK Tools accepted. Preparing "Install Android SDK Tools (revision: 26.1.1)". "Install Android SDK Tools (revision: 26.1.1)" ready. Installing Android SDK Tools in C:\Users\Jack\AppData\Local\Android\sdk\tools "Install Android SDK Tools (revision: 26.1.1)" complete. "Install Android SDK Tools (revision: 26.1.1)" finished. Checking the license for package Android SDK Build-Tools 30.0.3 in C:\Users\Jack\AppData\Local\Android\sdk\licenses License for package Android SDK Build-Tools 30.0.3 accepted. Preparing "Install Android SDK Build-Tools 30.0.3 (revision: 30.0.3)". "Install Android SDK Build-Tools 30.0.3 (revision: 30.0.3)" ready. Installing Android SDK Build-Tools 30.0.3 in C:\Users\Jack\AppData\Local\Android\sdk\build-tools\30.0.3 "Install Android SDK Build-Tools 30.0.3 (revision: 30.0.3)" complete. "Install Android SDK Build-Tools 30.0.3 (revision: 30.0.3)" finished. √ Built build\app\outputs\flutter-apk\app-debug.apk. Installing build\app\outputs\flutter-apk\app-debug.apk... Debug service listening on ws://127.0.0.1:55700/_HuPkg7gdVM=/ws Syncing files to device sdk gphone64 x86 64...

  9. 打开RunningDevice,查看正在运行安卓模拟器。

注意事项

  • 官方安装文档有Mac、Linux等其他操作系统以及Visual Studio Code 的配置流程。点击直达)
  • 该文档是由学生总结编辑,如有错误恳请指正。

中北大学 软件工程 移动互联网软件开发与应用方向 21130408班 郝杰