跳到主内容

设置 Android 开发环境

配置您的开发环境，以便运行、构建和部署 Flutter 应用到 Android 设备。

了解如何设置开发环境，以便运行、构建和部署 Flutter 应用到 Android 设备。

选择你的开发平台

#

本页面上的说明是针对在 Windows 设备上设置 Android 开发环境而配置的。

如果你想遵循其他操作系统的说明，请选择以下之一。

设置 Android 工具

#

通过 Android Studio，您可以在真实的 Android 设备或 Android 模拟器上运行 Flutter 应用。

如果尚未安装，请下载并设置最新稳定版本的 Android Studio。

  1. 安装必要库

    如果您是在 Linux 上进行开发，请先安装 Android Studio 所需的 32 位库集合。

  2. 安装 Android Studio

    如果尚未安装，请下载并设置最新稳定版本的 Android Studio。

    如果您已经安装了 Android Studio，请确保它是最新版本。

  3. 安装 Android SDK 和工具

    1. 启动 Android Studio。

    2. 打开 SDK Manager 设置对话框。

      1. 如果 Welcome to Android Studio 对话框处于打开状态，请点击 New Project 和 Open 按钮后面的 More Actions 按钮，然后从下拉菜单中点击 SDK Manager。

      2. 如果您已打开项目，请转到工具 > SDK 管理器。

    3. 如果 SDK Platforms 选项卡未打开，请切换至该选项卡。

    4. 确认已选中 API Level 为 36 的第一个条目。

      如果“状态”列显示“有可用更新”或“未安装”

      1. 勾选该条目或行的复选框。

      2. 点击“应用”。

      3. 当“确认更改”对话框显示时，点击“确定”。

        SDK Component Installer 对话框会显示安装进度。

      4. 安装完成后，点击 Finish。

    5. 切换至 SDK Tools 选项卡。

    6. 验证是否已选择以下 SDK 工具

      • Android SDK 构建工具
      • Android SDK 命令行工具
      • Android 模拟器
      • Android SDK 平台工具
      • CMake
      • NDK (Side by side)

    7. 如果上述任何工具的“状态”列显示“有可用更新”或“未安装”

      1. 勾选所需工具的复选框。

      2. 点击“应用”。

      3. 当“确认更改”对话框显示时，点击“确定”。

        SDK Component Installer 对话框会显示安装进度。

      4. 安装完成后，点击 Finish。

  4. 同意 Android 许可协议

    在使用 Flutter 之前以及安装所有先决条件之后，请同意 Android SDK 平台的许可。

    1. 打开您偏好的终端。

    2. 运行以下命令以查看并签署 SDK 许可协议。

      flutter doctor --android-licenses

    3. 阅读并接受所有必要的许可协议。

      如果您之前未接受过每个 SDK 许可协议，则需要在进行 Android 开发之前查看并同意它们。

      在同意每项许可协议的条款之前，请仔细阅读。

      成功接受所有必要许可协议后，您应该会看到类似以下的输出

      All SDK package licenses accepted.

设置 Android 设备

#

您可以在物理 Android 设备上调试 Flutter 应用，也可以通过在 Android 模拟器上运行来调试。

要设置开发环境以在 Android 模拟器上运行 Flutter 应用，请按照以下步骤操作

  1. 设置您的开发设备

    在您的开发计算机上启用 VM 加速。

  2. 设置新模拟器

    1. 启动 Android Studio。

    2. 打开 Device Manager 设置对话框。

      1. 如果 Welcome to Android Studio 对话框处于打开状态，请点击 New Project 和 Open 按钮后面的 More Actions 按钮，然后从下拉菜单中选择 Virtual Device Manager。

      2. 如果您已打开项目，请转到工具 > 设备管理器。

    3. 点击显示为 + 图标的 Create Virtual Device 按钮。

      将显示“虚拟设备配置”对话框。

    4. 在 Form Factor 下选择 Phone 或 Tablet。

    5. 选择一个设备定义。您可以浏览或搜索设备。

    6. 点击“下一步”。

    7. 如果提供了该选项，请根据您的开发电脑是 x64 还是 Arm64 设备，选择 x86 Images 或 ARM Images。

    8. 为您想要模拟的 Android 版本选择一个系统镜像。

      1. 如果所需的镜像名称左侧有 Download 图标，请点击它。

        SDK Component Installer 对话框会显示安装进度。

      2. 下载完成后，点击“完成”。

    9. 点击顶部选项卡栏中的 Additional settings，然后滚动到 Emulated Performance。

    10. 从 Graphics acceleration 下拉菜单中，选择提及 Hardware 的选项。

      这将启用硬件加速，从而提高渲染性能。

    11. 验证您的虚拟设备配置。如果配置正确，点击 Finish。

      要了解有关虚拟设备的更多信息，请查看创建和管理虚拟设备。

  3. 尝试运行模拟器

    在 Device Manager 对话框中，点击所需虚拟设备右侧的 Run 图标。

    模拟器应该会启动并显示您所选 Android OS 版本和设备的默认界面。

要设置开发环境以在物理 Android 设备上运行 Flutter 应用，请按照以下步骤操作

  1. 配置您的设备

    按照在设备上配置开发者选项中的说明，在您的设备上启用 Developer options 和 USB debugging。

  2. 启用无线调试

    要使用无线调试，请按照使用 Wi-Fi 连接到您的设备中的说明，在您的设备上启用 Wireless debugging。

  3. 安装平台必要组件

    如果您是在 Windows 上进行开发，请先安装您特定设备所需的 USB 驱动程序，具体请参考安装 OEM USB 驱动程序。

  4. 连接您的设备

    将设备插入电脑。如果设备出现提示，请授权您的电脑访问您的 Android 设备。

  5. 验证设备连接

    要验证 Flutter 是否识别出您连接的 Android 设备，请在您的终端中运行 flutter devices

    flutter devices

    您的设备应该会被找到并显示为已连接设备。

验证您的设置

#

  1. 检查工具链问题

    要检查 Android 开发设置是否存在任何问题，请在您的终端中运行 flutter doctor 命令

    flutter doctor

    如果您在 Android toolchain 或 Android Studio 部分看到任何错误或待完成的任务，

    请完成提到的任何任务，然后再次运行 flutter doctor 以验证更改。

  2. 检查 Android 设备

    为确保您已正确设置模拟器和/或物理 Android 设备，请在您的终端中运行 flutter emulators 和 flutter devices

    flutter emulators && flutter devices

    根据您设置的是模拟器还是物理设备，至少应该有一个输出显示平台标记为 android 的条目。

  3. 排查设置问题

    如果您在解决设置问题时需要帮助，请查看安装和设置故障排除。

    如果您仍然有问题或疑问，请通过 Flutter 的任一社区渠道联系我们。

开始 Android 开发

#

恭喜！现在您已经完成了 Flutter 的 Android 开发环境设置，您可以继续您的 Flutter 学习之旅，同时在 Android 上进行测试，或者开始改进与 Android 的集成。

继续学习 Flutter
构建 Android 应用

除非另有说明，本网站的文档反映的是 Flutter 3.41.5 版本。页面最后更新于 2026-05-05。 查看源码 或 报告问题。