跳到主内容

了解如何设置开发环境，以便在 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 管理器。

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

    4. 如果“欢迎使用 Android Studio”对话框已打开，请点击“打开”按钮旁边的“更多选项”图标，然后从下拉菜单中点击“SDK 管理器”。

    5. 如果“SDK 平台”选项卡未打开，请切换到该选项卡。

    6. 验证是否已选择 API Level 为 35 的第一个条目。

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

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

      2. 点击“应用”。

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

        “SDK 组件安装程序”对话框会显示一个进度指示器。

      4. 安装完成后，点击“完成”。

    7. 切换到“SDK 工具”选项卡。

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

      • Android SDK 构建工具
      • Android SDK 命令行工具
      • Android 模拟器
      • Android SDK 平台工具

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

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

      2. 点击“应用”。

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

        “SDK 组件安装程序”对话框会显示一个进度指示器。

      4. 安装完成后，点击“完成”。

  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. 转到设置对话框以查看 SDK 管理器。

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

      2. 如果“欢迎使用 Android Studio”对话框已打开，请点击“打开”按钮旁边的“更多选项”图标，然后从下拉菜单中选择“设备管理器”。

    3. 点击“虚拟”。

    4. 点击“创建设备”。

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

    5. 在“类别”下选择“手机”或“平板电脑”。

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

    7. 点击“下一步”。

    8. 根据您的开发计算机是 x64 还是 Arm64 设备，点击“x86 镜像”或“ARM 镜像”。

    9. 点击您要模拟的 Android 版本的系统镜像。

      1. 如果所需的镜像在“发布名称”右侧有一个“下载”图标，请点击它。

        将显示“SDK 快速修复安装”对话框，并附带进度指示器。

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

    10. 点击“下一步”。

      “虚拟设备配置”显示其“验证配置”步骤。

    11. 要重命名 Android 虚拟设备 (AVD)，请更改“AVD 名称”框中的值。

    12. 点击“显示高级设置”并滚动到“模拟性能”。

    13. 从“图形”下拉菜单中，选择“硬件 - GLES 2.0”。

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

    14. 验证您的 AVD 配置。如果正确，点击“完成”。

      要了解有关 AVD 的更多信息，请查阅管理 AVD。

  3. 尝试运行模拟器

    在“设备管理器”对话框中，点击所需 AVD 右侧的“运行”图标。

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

  4. 验证模拟器设置

    要验证 Flutter 是否可以连接到您设置的模拟器，请在您首选的终端中运行 flutter emulators

    flutter emulators

    您设置的模拟器应该会被找到并显示为可用的模拟器之一。

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

  1. 配置您的设备

    按照配置设备上的开发者选项中的说明，在您的设备上启用“开发者选项”和“USB 调试”。

  2. 启用无线调试

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

  3. 安装平台先决条件

    如果您正在 Windows 上进行开发，请首先按照安装 OEM USB 驱动程序中的说明，为您特定设备安装必要的 USB 驱动程序。

  4. 连接您的设备

    将您的设备插入计算机。如果您的设备提示您，请授权您的计算机访问您的 Android 设备。

  5. 验证设备连接

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

    flutter devices

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

验证您的设置

#

  1. 检查工具链问题

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

    flutter doctor

    如果您在“Android 工具链”或“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 的最新稳定版本。页面最后更新于 2025-05-20。 查看源代码 或 报告问题。