Flutter 安装和环境配置之windows

Updated on in Flutter相关文档 with 929 views

在 Windows 操作系统上安装和配置 Flutter 开发环境

系统配置要求

要想安装和运行 Flutter,你的开发环境至少应该满足如下的需求:

  • 操作系统 :Windows 7 SP1 或更高的版本(基于 x86-64 的 64 位操作系统)。
  • 磁盘空间 :除安装 IDE 和一些工具之外还应有至少 1.64 GB 的空间。
  • 工具 :要让 Flutter 在你的开发环境中正常使用,依赖于以下的工具:
    • Windows PowerShell 5.0 或者更高的版本(Windows 10 中已经预装了)
    • Git for Windows 2.x,并且勾选从 Windows 命令提示符使用 Git 选项。
      如果 Windows 版的 Git 已经安装过了,那么请确保能从命令提示符或者 PowerShell 中直接执行 git 命令。

获取 Flutter SDK

  1. 点击下方的安装包,获取 stable 发行通道的 Flutter SDK 最新版本:
    flutter_windows_2.8.1-stable.zip
    要查看其他发行通道和以往的版本,请参阅 SDK 版本列表 页面。
  2. 将压缩包解压,然后把其中的 flutter 目录整个放在你想放置 Flutter SDK 的路径中(例如 C:\src\flutter)。

请注意

请勿将 Flutter 安装在需要高权限的文件夹内,例如 C:\Program Files\

如果你不想安装指定版本的安装包。可以忽略步骤 1 和 2。从 GitHub 上的 Flutter repo 获取源代码,并根据需要,切换到指定的分支或标签。例如:

content_copy

C:\src>git clone https://github.com/flutter/flutter.git -b stable

现在你可以在控制台当中使用 Flutter 的命令了。

更新 path 环境变量

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

  • 在开始菜单的搜索功能键入「env」,然后选择 编辑系统环境变量
  • 用户变量 一栏中,检查是否有 Path 这个条目:
    • 如果存在这个条目,以 ; 分隔已有的内容,加入 flutter\bin 目录的完整路径。
    • 如果不存在的话,在用户环境变量中创建一个新的 Path 变量,然后将 flutter\bin 所在的完整路径作为新变量的值。

你需要重新打开已经打开的命令行提示符窗口,这样下次启动命令提示符时,才能访问到刚才修改的变量。

提示

自 Flutter 1.19.0 dev 版本开始,Flutter SDK 在 flutter 命令脚本的同级目录下增加了 dart 命令,你可以更方便地运行 Dart 命令行程序。下载 Flutter SDK 时也会下载对应版本的 Dart SDK,但如果你单独下载了 Dart SDK,请确保 Flutter SDK 内的 dart 在你的环境变量中排在首位,因为单独的 SDK 可能并不兼容 Flutter SDK。下面的命令展示了 flutterdart 是否来自相同的 bin 目录,并且是否可以兼容使用。

content_copy

C:\>where flutter dart
  C:\path-to-flutter-sdk\bin\flutter
  C:\path-to-flutter-sdk\bin\flutter.bat
  C:\path-to-dart-sdk\bin\dart.exe        :: this should go after `C:\path-to-flutter-sdk\bin\` commands
  C:\path-to-flutter-sdk\bin\dart
  C:\path-to-flutter-sdk\bin\dart.bat

如上所示,Flutter SDK 内的 dart 命令不在首位。你需要更新 PATH,将 C:\path-to-flutter-sdk\bin\ 放在 C:\path-to-dart-sdk\bin\ 前面(当前场景)。接着重启命令行使修改生效,再次运行 where,此时来自相同目录的 flutterdart 已经排在前面。

content_copy

C:\>where flutter dart
  C:\dev\src\flutter\bin\flutter
  C:\dev\src\flutter\bin\flutter.bat
  C:\dev\src\flutter\bin\dart
  C:\dev\src\flutter\bin\dart.bat
  C:\dev\src\dart-sdk\bin\dart.exe

然而,如果你在使用 PowerShellwhere 其实是 Where-Object 命令的别名,所以实际上你需要运行 where.exe

content_copy

PS C:\> where.exe flutter dart

了解更多 dart 命令的用法,可以在命令行中运行 dart -h 查看,也可以访问 DartVM 运行环境

运行 flutter doctor

在将 Path 变量更新后,打开一个新的控制台窗口,然后执行下面的命令。如果它提示有任何的平台相关依赖,那么你就需要按照指示完成这些配置:

content_copy

C:\src\flutter>flutter doctor

上述命令会检查你的现有环境,并将检测结果以报告形式呈现出来。仔细阅读它显示的内容,检查是否有尚未安装的软件或是有其他的步骤需要完成(通常会以粗体 呈现)。

例如:

content_copy

[-] 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.

下面的章节介绍了对缺失的内容进行配置的方法。每当您安装了任何一个的依赖项,就可以随时执行 flutter doctor 来检查是否正确配置了所有内容。

提示

如果 flutter doctor 提示 Android Studio 的 Flutter 或者 Dart 插件尚未安装,请移步文档 编辑器设定 查阅如何解决这个问题。

请注意 The Flutter tool may occasionally download resources from Google servers. By downloading or using the Flutter SDK you agree to the Google Terms of Service.

Flutter 工具可能会偶尔从 Google 的服务器上下载资源,下载了或使用 Flutter SDK 代表您同意了 Google 服务条款

举个例子,当开发者们从 GitHub 安装(而不是从预打包的归档文件中安装),为了要执行 flutter 命令,Flutter 工具将会在首次运行时从谷歌服务器下载 Dart SDK。升级 Flutter 时亦会发生 (比如运行 flutter upgrade 命令) 。

flutter 工具使用了 Google Analytics 来对基本使用情况和 崩溃报告 进行匿名的统计。这些数据用来帮助改善 Flutter 工具。

在第一次运行或者任何涉及到 flutter config 的信息都不会进行发送,所以你可以在发送分析数据之前选择禁止分析数据的统计。要禁用这一功能,只需要输入 flutter config --no-analytics 即可,想要查看当前设置使用命令 flutter config。如果你禁用了统计信息发送,这次的禁用行为会被记录发送,其他任何信息,以及未来都不会再有任何数据会被记录。

Dart 工具同样可能会发送使用指标数据和崩溃报告给 Google。控制这些发送的数据,请参考下面的 [dart 命令行][dart tool 参数:

  • --enable-analytics: 启用匿名分析;
  • --disable-analytics: 禁用匿名分析。

Google 的隐私权政策 里详细描述了这些服务会如何控制这些数据。

设置 Android 开发环境

提示

Flutter 依赖 Android Studio 的全量安装来为其提供 Android 平台的支持。但你也可以使用其他的编辑器来写 Flutter 应用,接下来的步骤会提到这个问题。

安装 Android Studio

  1. 下载并安装 Android Studio
  2. 运行 Android Studio,并进入 ‘Android Studio Setup Wizard’,这会安装最新的 Android SDK, Android SDK Platform-Tools 以及 Android SDK Build-Tools,这些都是在开发 Android Flutter 应用时所需要的。
  3. 运行 flutter doctor 确保 Flutter 已经定位到了你的 Android Studio 的安装位置。如果 Flutter 并未定位到,运行 flutter config --android-studio-dir <directory> 设置你的 Android Studio 的安装目录。

配置 Android 设备

在 Android 设备上运行或测试 Flutter 应用之前,你需要一个运行 Android 4.1(API 版本 16)或者更高的设备。

  1. 在设备上打开 Developer optionsUSB debugging 选项,你可以在 Android documentation 上查看更详细的方法介绍。
  2. 如果是在 Windows 平台上使用,需要安装 Google USB Driver
  3. 通过 USB 接口连接手机和电脑,如果在设备上弹出需要授权弹窗,允许授权以便让电脑能够访问你的开发设备。
  4. 在命令行中,使用 flutter devices 命令来确保 Flutter 能够识别出你所连接的 Android 设备。

配置 Android 模拟器

根据以下步骤来将 Flutter 应用运行或测试于你的 Android 模拟器上:

  1. 激活机器上的 VM acceleration 选项。
  2. 打开 Android Studio ,点击 AVD Manager 按钮,选择 Create Virtual Device…
    • 在一些旧的 Android Studio 版本里,需要通过 Android Studio > Tools > Android > AVD Manager ,然后选择 Create Virtual Device… 选项。(只有在 Android 项目中才会显示 Android 子选项。)
    • 如果你以及还没打开某个项目,你可以选择 Configure > AVD Manager 然后选择 Create Virtual Device 选项
  3. 选择相应的设备并选择 Next 选项。
  4. 选择一个或多个你想要模拟的 Android 版本的系统镜像,然后选择 Next 选项。推荐选择 x86 或者 x86_64 镜像。
  5. 在 Emulated Performance 下选择 Hardware - GLES 2.0 选项来开启 硬件加速
  6. 确保 AVD 选项配置正确,并选择 Finish 选项。
    想要查看上述步骤的更多详细信息,请查看 Managing AVDs 页面。
  7. 在 Android Virtual Device Manager 中,点击工具栏中的 Run 选项,模拟器会启动并为你所选择的系统版本和设备显示出相应的界面。

同意 Android 协议

在使用 Flutter 前,你必须同意 Android SDK 平台的协议。你可以在安装完上述工具后执行这一步。

  1. 确保你安装了 Java 8,并且正确设置了 JAVA_HOME 环境变量到 JDK 目录。
    高于 2.2 版本的 Android Studio 自带了 JDK,所以应无需手动操作。
  2. 打开一个已经提升管理员权限的终端窗口,运行以下命令进行协议的确认。
    content_copy
    $ flutter doctor --android-licenses
    
  3. 仔细阅读每条协议后同意。
  4. 当你同意所有协议后,再次运行 flutter doctor 以确认是否已经可以正常使用 Flutter。

Windows 设置

请注意

Win32 的 Beta 支持和 UWP 的 Alpha 版支持 本页涵盖的桌面支持,描述的是对 Windows (Win32) 的 Beta 支持,以及对 UWP 的 Alpha 支持。Windows UWP 是由社区 (非官方) 提供支持的。

你可以在 stable 渠道尝试这个 Beta 版的桌面支持,或者可以切换到使用 beta 渠道,使用最新的桌面版支持。如果要跟进 Windows UWP 最新版,需要使用 master 渠道。

更多有关 桌面版 的详细信息,请查看文章: Flutter 2.2 带来了哪些更新

其他 Windows 需要的内容

对于 Windows 桌面开发来说,除了 Flutter SDK 以外你还需要以下内容:

  • Flutter 2.9 Beta 和更新的版本使用 Visual Studio 2022, 2.8.1 和之前的版本使用 Visual Studio 2019 (请别把它与 Visual Studio Code 搞混了)做 Win32 开发的话,你需要安装 “Desktop development with C++” 工作负载,包括其所有默认组件。如果是 UWP 开发的话,你需要安装 “Universal Windows Platform development” 工作负载,包括可选的 UWP C++ 工具。

启用桌面版支持

在命令行中执行以下命令以开启 Win32 桌面端支持:

content_copy

$ flutter config --enable-windows-desktop

Windows UWP 桌面支持需要先升级到 master 发布渠道,然后启用 UWP。

content_copy

$ flutter channel master
$ flutter upgrade
$ flutter config --enable-windows-uwp-desktop

更多详情请查看 Flutter 的桌面端支持



标题:Flutter 安装和环境配置之windows
作者:yanjing
地址:https://yanjingtp.cn/articles/2022/02/18/1645167536098.html