Flutter - 安装

Flutter - 安装

本章将指导你如何在 Windows、macOS 和 Linux 上安装 Flutter SDK 并设置开发环境。

重要提示： 系统要求和具体步骤可能会发生变化。请务必参考官方 Flutter 安装文档以获取最新说明：https://docs.flutter.dev/get-started/install

通用要求

• 操作系统： Windows 10 或更高版本（64位）、macOS（64位）、Linux（64位）。
• 磁盘空间： 至少 1.64 GB（不包括 IDE/工具）。
• 工具： Flutter 依赖于你的环境中安装了 git。

在 Windows 上安装

1. 获取 Flutter SDK

• 访问 Flutter SDK 发布页面：https://docs.flutter.dev/get-started/install/windows
• 下载最新的稳定版安装包（一个 .zip 文件）。
• 将 zip 文件解压到你希望永久存放 Flutter 的位置（例如，C:\src\flutter）。不要将 Flutter 安装到需要提升权限的目录，例如 C:\Program Files\。

2. 更新你的 Path 环境变量

• 在 Windows 搜索栏中输入 ‘env’ 并选择 编辑系统环境变量。
• 点击 环境变量(Environment Variables)... 按钮。
• 在 用户变量(User variables) 下找到 Path 条目，选中它并点击 编辑(Edit)...。
• 点击 新建(New) 并添加 Flutter 安装目录内 bin 目录的完整路径（例如，C:\src\flutter\bin）。
• 点击所有对话框中的 确定(OK) 保存更改。
• 重要提示： 关闭并重新打开任何现有的命令提示符或 PowerShell 窗口，以使路径更改生效。

3. 运行 Flutter Doctor

• 打开新的命令提示符或 PowerShell 窗口。
• 运行命令：flutter doctor
• flutter doctor 会检查你的环境并显示 Flutter 安装状态的报告。它会识别缺失的依赖或需要进一步设置的项目。
• 示例输出（可能有所不同）：

4. 安装 Android Studio（用于 Android 开发）

• 从官方 Android 开发者网站下载并安装 Android Studio。
• 在安装过程中，确保安装了 Android SDK、Android SDK Command-line Tools 和 Android SDK Build-Tools。
• 如果缺少组件，flutter doctor 会给你指导。

5. 设置 Android 设备 / 模拟器

• 模拟器： 使用 Android Studio AVD Manager（Tools > AVD Manager）创建并启动一个 Android Virtual Device。
• 物理设备： 在你的 Android 手机上启用开发者选项和 USB 调试，然后通过 USB 连接。按照设备和计算机上的提示授权。
• 再次运行 flutter doctor 验证设备连接。

6. 安装 Flutter 和 Dart 插件

• 打开 Android Studio。
• 转到 File > Settings > Plugins（或在旧版本上是 Android Studio > Preferences... > Plugins）。
• 在 Marketplace 标签页中搜索 Flutter 并点击 Install。
• 接受提示同时安装所需的 Dart 插件。
• 收到提示时重启 Android Studio。

在 macOS 上安装

1. 获取 Flutter SDK

• 访问 Flutter SDK 发布页面：https://docs.flutter.dev/get-started/install/macos
• 下载适用于你的 Mac 架构（Intel 或 Apple Silicon）的最新稳定版安装包。
• 将 zip 文件解压到永久存放位置（例如，$HOME/development/flutter）。
• 或者，你可以克隆仓库：git clone https://github.com/flutter/flutter.git -b stable

2. 更新你的 Path 环境变量

• 打开或创建你 shell 的配置文件（例如，对于 Zsh (较新 macOS 的默认 shell) 是 $HOME/.zshrc，对于 Bash 是 $HOME/.bash_profile）。
• 添加以下行，将 [PATH_TO_FLUTTER_GIT_DIRECTORY] 替换为你实际的 Flutter 目录路径：
• export PATH="$PATH:[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin"
• 保存文件。
• 运行 source $HOME/.<你的配置文件>（例如，source $HOME/.zshrc）或打开一个新的终端窗口以使更改生效。
• 验证路径：echo $PATH（应包含 flutter/bin 路径）和 which flutter。

3. 运行 Flutter Doctor

• 打开一个新的终端窗口。
• 运行命令：flutter doctor
• 检查输出中是否有缺失的依赖。
• 示例输出（可能有所不同）：

4. 安装 Xcode（用于 iOS/macOS 开发）

• 从 Mac App Store 安装 Xcode。
• 安装后首次打开 Xcode 并接受许可协议。
• 安装 Xcode 命令行工具：sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 和 sudo xcodebuild -runFirstLaunch。
• 再次运行 flutter doctor 确保 Xcode 设置完成。

5. 设置 iOS 模拟器 / 设备

• 模拟器： 通过 Xcode (Xcode > Open Developer Tool > Simulator) 或使用命令 open -a Simulator 打开模拟器。
• 物理设备： 通过 USB 连接你的 iOS 设备。你可能需要在 Xcode 中配置代码签名才能部署到物理设备（需要 Apple Developer 账户）。

6. 安装 Android Studio 和插件（可选，用于 Android 开发）

• 如果你也计划开发 Android 应用，请遵循 Windows 安装部分的步骤 4 和 6。

后续步骤

一旦 flutter doctor 没有报告主要问题（或只报告了你不打算支持的平台的问题），你的环境就准备好了。你可以继续创建你的第一个 Flutter 应用！