跳转至正文

设置 Android 开发环境

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

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

选择你的开发平台

#

本页说明默认面向在 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. 若已打开项目，前往 Tools > SDK Manager。

    3. 若 SDK Platforms 标签页未打开，请切换到该标签页。

    4. 确认已选中 API Level 为 36 的第一项。

      若 Status 列显示 Update available 或 Not installed：

      1. 选中该项或该行的复选框。

      2. 点击 Apply。

      3. 当 Confirm Change 对话框出现时，点击 OK。

        SDK Component Installer 对话框会显示进度指示器。

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

    5. 切换到 SDK Tools 标签页。

    6. 确认已选中以下 SDK Tools：

      • Android SDK Build-Tools
      • Android SDK Command-line Tools
      • Android Emulator
      • Android SDK Platform-Tools
      • CMake
      • NDK (Side by side)

    7. 若上述任一工具的 Status 列显示 Update available 或 Not installed：

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

      2. 点击 Apply。

      3. 当 Confirm Change 对话框出现时，点击 OK。

        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. 若已打开项目，前往 Tools > Device Manager。

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

      Virtual Device Configuration 对话框会出现。

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

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

    6. 点击 Next。

    7. 若提供该选项，根据开发计算机是 x64 还是 Arm64 设备，选择 x86 Images 或 ARM Images。

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

      1. 若所需镜像在系统镜像名称左侧有 Download 图标，请点击它。

        SDK Component Installer 对话框会显示进度指示器。

      2. 下载完成后，点击 Finish。

    9. 点击顶部标签栏中的 Additional settings，滚动到 Emulated Performance。

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

      这将启用 硬件加速，提升渲染性能。

    11. 验证虚拟设备配置。若正确，点击 Finish。

      要了解更多虚拟设备信息，请参阅 创建和管理虚拟设备。

  3. 尝试运行模拟器

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

    模拟器应启动并显示所选 Android 操作系统版本和设备的默认画布。

要配置开发环境以在实体 Android 设备上运行 Flutter 应用，请按以下步骤操作：

  1. 配置你的设备

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

  2. 启用无线调试

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

  3. 安装平台必备项

    若在 Windows 上开发，请先按 安装 OEM USB 驱动 中的说明，为特定设备安装必要的 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 开发，你可以在 Android 上测试的同时继续 Flutter 学习之旅，或开始改进与 Android 的集成。

继续学习 Flutter
为 Android 构建

除非另有说明，本文档之所提及适用于 Flutter 3.44.0 版本。本页面最后更新时间：2026-06-15。查看文档源码 或者 为本页面内容提出建议。