在安装和运行 Flutter 前,你的 Windows 环境必须满足以下要求:
硬件要求#你的 Windows Flutter 开发环境必须满足以下最低硬件要求。
要求最低推荐x86_64 CPU 核心数48内存 (GB)816显示器分辨率(像素)WXGA (1366 x 768)FHD (1920 x 1080)可用磁盘空间 (GB)11.060.0 软件要求#要为 Android 编写和编译 Flutter 代码,你必须安装以下版本的 Windows 以及所列出的软件包。
lightbulb小提示你无需单独安装 Dart,因为 Flutter SDK 包含了完整的 Dart SDK。
操作系统#Flutter 支持 64-bit version of Microsoft Windows 10 或更高版本。这些版本的 Windows 必须包含Windows PowerShell 5或更高版本。
开发工具#下载并安装以下软件包的 Windows 版本:
Git for Windows 2.27 或更高的版本来管理源代码。
Android Studio 2023.3.1 (Jellyfish) 或更高版本来调试和编译 Android 的 Java 或 Kotlin 代码。Flutter 需要完整版本的 Android Studio。
上述软件的开发商为这些产品提供支持。如果需要排查安装的问题,请查阅该产品的文档。
当你在当前版本运行 flutter doctor 的时候,它可能会列出这些软件包的其他不同版本。如果出现这种情况,请安装它推荐的版本。
配置文本编辑器或 IDE#你可以使用任意文本编辑器或集成开发环境 (IDE),并结合 Flutter 的命令行工具,来使用 Flutter 构建应用程序。
使用带有 Flutter 扩展或插件的 IDE 会提供代码自动补全、语法高亮、widget 编写辅助、调试以及其他功能。
以下是热门的扩展插件:
Visual Studio Code 1.77 或更高版本使用 Flutter extension for VS Code。
Android Studio 2023.3.1 (Jellyfish) 或更高版本使用 Flutter plugin for IntelliJ.
IntelliJ IDEA 2023.3 或更高版本使用 Flutter plugin for IntelliJ.
bolt推荐Flutter 团队推荐安装 Visual Studio Code 1.77或更高版本并搭配 Flutter extension for VS Code。这样搭配可以简化 Flutter SDK 的安装。
安装 Flutter SDK#你可以使用 VS Code Flutter 扩展或自行下载安装 Flutter 压缩包,来安装 Flutter SDK。
使用 VS Code 安装 自行下载安装 使用 VS Code 安装 Flutter#在使用以下流程来安装 Flutter 前,请确保你已经安装 Visual Studio Code 1.77或更高版本,以及 Flutter extension for VS Code。
根据 VS Code 的提示,安装 Flutter#启动 VS Code。
打开 命令面板 (Command Palette),按下快捷键 Control + Shift + P。
在 命令面板 (Command Palette) 中输入 flutter。
选择 Flutter: New Project。
VS Code 会提示你在计算机上找到 Flutter SDK。
如果你已经安装 Flutter SDK,请单击 Locate SDK。
如果你没有安装 Flutter SDK, 请单击 Download SDK。
如果你没有按照 开发工具的必要条件安装 Git for Windows ,单击该按钮后会导航至 Flutter 安装页面。
当提示 Which Flutter template? 的时候,请忽略它。可以按下 Esc。你可以在检查完开发配置后创建初始测试项目。
下载 Flutter SDK#当对话框 Select Folder for Flutter SDK 显示时,选择你想要安装 Flutter 的位置。
VS Code 会打开你默认的位置。你可以选择其他位置。
请考虑 %USERPROFILE% 或 C:\dev 这样的位置。
warning请注意不要将 Flutter 安装到以下情况的目录或路径中:
路径包含特殊字符或空格。
路径需要较高的权限。
例如,C:\Program Files 路径就是以上情况。
单击 Clone Flutter。
在下载 Flutter 时,VS Code 会弹出该通知:
Downloading the Flutter SDK. This may take a few minutes.下载需要一些时间。如果你怀疑下载被挂起,请单击 Cancel 取消下载后,再重新尝试安装。
Flutter 一旦完成下载,输出 (Output) 面板就会显示。
Checking Dart SDK version...Downloading Dart SDK from the Flutter engine ...Expanding downloaded archive...成功后,VS Code 会弹出该通知:
Initializing the Flutter SDK. This may take a few minutes.初始化时,输出 (Output) 面板会显示下面的内容:
Building flutter tool...Running pub upgrade...Resolving dependencies...Got dependencies.Downloading Material fonts...Downloading Gradle Wrapper...Downloading package sky_engine...Downloading flutter_patched_sdk tools...Downloading flutter_patched_sdk_product tools...Downloading windows-x64 tools...Downloading windows-x64/font-subset tools...该进程还会运行 flutter doctor -v。此时,请忽略该输出。因为 Flutter Doctor 可能会显示与本次快速启动无关的错误。
Flutter 安装成功后,VS Code 会弹出该通知:
Do you want to add the Flutter SDK to PATH so it's accessiblein external terminals?单击 Add SDK to PATH。
成功后会显示通知:
The Flutter SDK was added to your PATHVS Code 可能会显示一则 Google Analytics 的通知。
如果你同意,请单击 OK。
在所有 PowerShell 窗口中启用 flutter:
关闭,然后重新打开所有 PowerShell 窗口。
重新启动 VS Code。
下载并安装 Flutter#从归档列表中下载 Flutter SDK 压缩包,将压缩包移动到你想要的位置,然后解压 SDK,以此来安装 Flutter。
下载以下 Flutter SDK 最新 stable 版本的压缩包。
(loading...)
关于其他发布渠道和旧版本,请查阅 Flutter SDK 归档列表。
Flutter SDK 应该会下载至 Windows 默认下载目录:%USERPROFILE%\Downloads。
如果你自行更改了下载目录的位置,那么请将之后步骤中解压指令 (Expand-Archive) 的路径 (-Path) 改为你更改后的路径。如果你需要查找当前计算机下载目录的位置,请查阅 Microsoft Community post
创建一个文件夹,用于安装 Flutter。
Consider creating a directory at %USERPROFILE% (C:\Users\{username}) 或者 %LOCALAPPDATA% (C:\Users\{username}\AppData\Local).
可以考虑在 %USERPROFILE% (C:\Users\{username}) 或者 %LOCALAPPDATA% (C:\Users\{username}\AppData\Local) 中创建一个目录。
warning请注意不要将 Flutter 安装到以下情况的目录或路径中:
路径包含特殊字符或空格。
路径需要较高的权限。
例如,C:\Program Files 路径就是以上情况。
将 Flutter SDK 压缩文件 (zip) 解压到你想要存储的目录中。可以使用以下指令进行解压。
PS C:\> Expand-Archive ` –Path $env:USERPROFILE\Downloads\flutter_sdk_v1.0.0.zip ` -Destination $env:USERPROFILE\dev\完成后,Flutter SDK 应该会位于 C:\user\{username}\dev\flutter 目录中。
更新 Windows PATH 环境变量#help帮助
将 Flutter 添加到 PATH 环境变量后,才能在 PowerShell 中运行 Flutter 指令。本节假定你在 %USERPROFILE%\dev\flutter 中安装了 Flutter SDK。
按下快捷键 Windows + Pause。
如果你的键盘上没有 Pause 键,请尝试 Windows + Fn + B。
这将会显示 系统 > 系统信息 的窗口。
单击 高级系统设置> 高级> 环境变量…
这将会显示 环境变量 的窗口。
在 username 用户变量 的部分中,找到 Path 条目。
如果存在该条目,请双击它。
这将会显示 编辑环境变量 的窗口。
双击空白行。
输入 %USERPROFILE%\dev\flutter\bin。
单击选中 %USERPROFILE%\dev\flutter\bin 条目。
单击 上移,直到 Flutter 条目位于列表顶部。
顺着打开的窗口依次点击 确认(三次)。
如果条目不存在,请单击 新建…。
这将会显示 新建用户变量 的窗口。
在 变量名 框中,输入 Path。
在 变量值 框中,输入 %USERPROFILE%\dev\flutter\bin。
顺着打开的窗口依次点击 确认(三次)。
为了启用这些更改,请关闭并重新打开所有现有命令提示符和 PowerShell 实例。
配置 Android 开发#在 Android Studio 中配置 Android toolchain#help帮助
To create Android apps with Flutter, verify that the following Androidcomponents have been installed.
Android SDK Platform, API 35.0.1Android SDK Command-line ToolsAndroid SDK Build-ToolsAndroid SDK Platform-ToolsAndroid EmulatorIf you haven't installed these, or you don't know, continue with the following procedure.
Otherwise, you can skip to the next section.
首次使用 Android Studio 正在使用 Android Studio启动 Android Studio。
显示 Welcome to Android Studio 的对话框。
按照 Android Studio Setup Wizard 操作。
安装以下组件:
Android SDK Platform, API 35.0.1Android SDK Command-line ToolsAndroid SDK Build-ToolsAndroid SDK Platform-ToolsAndroid Emulator启动 Android Studio。
打开 Settings 对话框,查看 SDK Manager。
如果你已经打开了一个项目,请打开 Tools > SDK Manager。
如果显示 Welcome to Android Studio 的对话框,请单击 Open 按钮后面的 More Options 图标,然后从下拉菜单中单击 SDK Manager。
单击 SDK Platforms。
检查 Android API 35.0.1 是否已经选中。
如果 Status 栏显示 Update available 或 Not installed:
选择 Android API 35.0.1
单击 Apply。
当显示 Confirm Change 对话框时,单击 OK。
显示 SDK Quickfix Installation 完成进度的对话框。
安装完成后,单击 Finish。
安装最新的 SDK 后,Status 栏可能会显示 Update available。这意味着某些额外的系统镜像可能尚未安装。你可以忽略它然后继续。
单击 SDK Tools。
检查以下 SDK 工具是否已经选择:
Android SDK Command-line ToolsAndroid SDK Build-ToolsAndroid SDK Platform-ToolsAndroid Emulator如果上述任何工具的 Status 栏显示Update available 或 Not installed:
选择所需的工具。
单击 Apply。
当显示 Confirm Change 的对话框时,单击 OK。
显示 SDK Quickfix Installation 完成进度的对话框。
安装完成后,单击 Finish。
配置目标 Android 设备#虚拟设备 真机设备 配置安卓模拟器#help帮助
要配置 Flutter 应用在 Android 模拟器中运行,请按照以下步骤创建并选择模拟器:
在你的开发电脑上启用 VM acceleration。
启动 Android Studio。
打开 Settings 对话框,查看 SDK Manager。
如果你已经打开了一个项目,请打开 Tools >Device Manager。
如果显示 Welcome to Android Studio 的对话框,请单击 Open 按钮后面的 More Options 图标,然后在下拉菜单中单击 Device Manager。
单击 Virtual。
单击 Create Device。
显示 Virtual Device Configuration 的对话框。
在 Category 下选择 Phone 或 Tablet。
选择设备,你可以浏览或搜索设备。
单击 Next。
单击 x86 Images。
单击需要模拟的 Android 版本系统镜像。
如果所需镜像的 Release Name 右侧有一个 Download 图标,请单击该图标。
显示 SDK Quickfix Installation 完成进度的对话框
下载完成后,单击 Finish。
单击 Next。
Virtual Device Configuration 会显示它的Verify Configuation 步骤。
如果要重命名 Android 虚拟设备 (AVD),请更改 AVD Name 框中的值。
单击 Show Advanced Settings 并滚动至 Emulated Performance。
从 Graphics 下拉菜单中,选择 Hardware - GLES 2.0。
这样就会开启 硬件加速 (hardware acceleration)并提高渲染性能。
检查你的 AVD 配置。如果已经完备,请单击 Finish。
想要了解