在 ChromeOS 上开始构建 Flutter Android 应用
- 验证系统要求
- 配置文本编辑器或 IDE
- 安装 Flutter SDK
- 配置 Android 开发
- 检查您的开发设置
- 开始使用 Flutter 开发 ChromeOS 上的 Android 应用
- 管理您的 Flutter SDK
验证系统要求
#要安装并运行 Flutter,你的 ChromeOS 环境必须满足以下硬件和软件要求。
硬件要求
#你的 ChromeOS Flutter 开发环境必须满足以下最低硬件要求。
要求 | 最低 | 推荐 |
---|---|---|
CPU 内核 | 4 | 8 |
内存(GB) | 8 | 16 |
显示分辨率(像素) | WXGA(1366 x 768) | FHD(1920 x 1080) |
可用磁盘空间(GB) | 11.0 | 60.0 |
要了解 ChromeOS 建议用于 Android 开发的硬件设备,请查阅 ChromeOS 文档。
软件要求
#要为 Android 编写和编译 Flutter 代码,你必须拥有以下版本的 ChromeOS 和列出的软件包。
操作系统
#Flutter 支持 ChromeOS。
开发工具
#要在 ChromeOS 上开发 Flutter
在你的 Chromebook 上启用 Linux。
安装以下软件包:
curl
、git
、unzip
、xz-utils
、zip
、libglu1-mesa
sudo apt-get update -y && sudo apt-get upgrade -y; sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
要开发 Android 应用
安装 Android Studio 的以下先决条件软件包
sudo apt-get install libc6:amd64 libstdc++6:amd64 lib32z1 libbz2-1.0:amd64
安装 Android Studio 2023.3.1(Jellyfish)或更高版本以调试和编译 Android 的 Java 或 Kotlin 代码。Flutter 需要 Android Studio 的完整版本。
当你运行当前版本的 flutter doctor
时,它可能会列出其中一个软件包的不同版本。如果是这样,请安装它推荐的版本。
上述软件的开发者提供对这些产品的支持。要解决安装问题,请查阅该产品的文档。
配置文本编辑器或 IDE
#你可以使用任何文本编辑器或集成开发环境 (IDE) 结合 Flutter 的命令行工具来构建应用。
使用带有 Flutter 扩展或插件的 IDE 可以提供代码补全、语法高亮、窗口小部件编辑辅助、调试和其他功能。
常用的选项包括
- Visual Studio Code 1.77 或更高版本,以及 VS Code 的 Flutter 扩展。
- Android Studio 2023.3.1(Jellyfish)或更高版本,以及 IntelliJ 的 Flutter 插件。
- IntelliJ IDEA 2023.3 或更高版本,以及 IntelliJ 的 Flutter 插件。
安装 Flutter SDK
#要安装 Flutter SDK,你可以使用 VS Code Flutter 扩展或自己下载并安装 Flutter 包。
使用 VS Code 安装 Flutter
#要使用这些说明安装 Flutter,请验证你是否已安装 Visual Studio Code 1.77 或更高版本,以及 VS Code 的 Flutter 扩展。
提示 VS Code 安装 Flutter
#启动 VS Code。
要打开**命令面板**,请按 Control + Shift + P。
在**命令面板**中,输入
flutter
。选择**Flutter: 新建项目**。
VS Code 会提示你找到计算机上的 Flutter SDK。
如果你已安装 Flutter SDK,请点击**定位 SDK**。
如果你未安装 Flutter SDK,请点击**下载 SDK**。
如果你尚未按照 开发工具先决条件 中的说明安装 Git,此选项会将你发送到 Flutter 安装页面。
当出现**选择哪个 Flutter 模板?**提示时,请忽略它。按 Esc。在检查开发设置后,你可以创建一个测试项目。
下载 Flutter SDK
#当显示**选择 Flutter SDK 文件夹**对话框时,选择要安装 Flutter 的位置。
VS Code 会将你放置在你的用户配置文件中以开始。选择其他位置。
考虑
~/development/
点击**克隆 Flutter**。
下载 Flutter 时,VS Code 会显示此弹出通知
Downloading the Flutter SDK. This may take a few minutes.
此下载需要几分钟。如果你怀疑下载已挂起,请点击**取消**,然后重新开始安装。
下载完成后,**输出**面板会显示。
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.
初始化期间,**输出**面板会显示以下内容
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 accessible in external terminals?
VS Code 可能会显示 Google Analytics 通知。
如果你同意,请点击**确定**。
要在所有终端窗口中启用
flutter
- 关闭,然后重新打开所有终端窗口。
- 重新启动 VS Code。
下载然后安装 Flutter
#要安装 Flutter,请从其存档中下载 Flutter SDK 包,将包移动到要存储它的位置,然后解压缩 SDK。
下载以下安装包以获取 Flutter SDK 的最新稳定版本。
对于其他发布渠道和旧版本,请查看 SDK 存档。
Flutter SDK 应下载到 ChromeOS 默认下载目录:
~/Downloads/
。创建一个可以安装 Flutter 的文件夹。
考虑在
~/development/
中创建目录。将文件解压缩到要存储 Flutter SDK 的目录中。
tar -xf ~/Downloads/flutter_sdk_v1.0.0.zip -C ~/development/
完成后,Flutter SDK 应位于
~/development/flutter
目录中。
将 Flutter 添加到你的 PATH
#要在 shell 中运行 Flutter 命令,请将 Flutter 添加到 PATH
环境变量中。
检查打开新控制台窗口时启动哪个 shell。这将是你的*默认 shell*。
echo $SHELL
这与另一个命令不同,另一个命令会告诉你当前控制台中运行哪个 shell。
echo $0
要将 Flutter 添加到你的
PATH
,请展开默认 shell 的条目,然后选择命令。显示bash命令
echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.bash_profile
显示zsh命令
echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.zshenv
显示fish命令
fish_add_path -g -p ~/development/flutter/bin
显示csh命令
echo 'setenv PATH "~/development/flutter/bin:$PATH"' >> ~/.cshrc
显示tcsh命令
echo 'setenv PATH "~/development/flutter/bin:$PATH"' >> ~/.tcshrc
显示ksh命令
echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.profile
显示sh命令
echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.profile
要应用此更改,请重新启动所有打开的终端会话。
配置 Android 开发
#在 Android Studio 中配置 Android 工具链
#要使用 Flutter 创建 Android 应用,请验证以下 Android 组件是否已安装。
- Android SDK 平台,API 35.0.1
- Android SDK 命令行工具
- Android SDK 构建工具
- Android SDK 平台工具
- Android 模拟器
如果你尚未安装这些组件,或者你不知道,请继续执行以下步骤。
否则,你可以跳到 下一节。
启动**Android Studio**。
将显示**欢迎使用 Android Studio** 对话框。
按照**Android Studio 设置向导**进行操作。
安装以下组件
- Android SDK 平台,API 35.0.1
- Android SDK 命令行工具
- Android SDK 构建工具
- Android SDK 平台工具
- Android 模拟器
启动**Android Studio**。
转到**设置**对话框以查看**SDK 管理器**。
如果已打开项目,请转到**工具** > **SDK 管理器**。
如果显示**欢迎使用 Android Studio** 对话框,请点击**打开**按钮后面的**更多选项**图标,然后从下拉菜单中点击**SDK 管理器**。
点击**SDK 平台**。
验证是否已选中**Android API 35.0.1**。
如果**状态**列显示**有更新可用**或**未安装**
选择**Android API 35.0.1**。
点击**应用**。
当显示**确认更改**对话框时,请点击**确定**。
将显示**SDK 快速修复安装**对话框,其中包含一个完成进度条。
安装完成后,点击**完成**。
安装最新 SDK 后,**状态**列可能会显示**有更新可用**。这意味着某些其他系统映像可能尚未安装。你可以忽略此信息并继续。
点击**SDK 工具**。
验证是否已选中以下 SDK 工具
- Android SDK 命令行工具
- Android SDK 构建工具
- Android SDK 平台工具
- Android 模拟器
如果上述任何工具的**状态**列显示**有更新可用**或**未安装**
选择所需的工具。
点击**应用**。
当显示**确认更改**对话框时,请点击**确定**。
将显示**SDK 快速修复安装**对话框,其中包含一个完成进度条。
安装完成后,点击**完成**。
配置您的目标 Android 设备
#设置 Android 模拟器
#要配置 Flutter 应用以在 Android 模拟器中运行,请按照以下步骤创建并选择模拟器。
在你的开发计算机上启用 VM 加速。
启动**Android Studio**。
转到**设置**对话框以查看**SDK 管理器**。
如果已打开项目,请转到**工具** > **设备管理器**。
如果显示**欢迎使用 Android Studio** 对话框,请点击**打开**按钮后面的**更多选项**图标,然后从下拉菜单中点击**设备管理器**。
点击**虚拟**。
点击**创建设备**。
将显示**虚拟设备配置**对话框。
在**类别**下选择**手机**或**平板电脑**。
选择设备定义。你可以浏览或搜索设备。
点击**下一步**。
点击。
点击一个适用于你想要模拟的 Android 版本的系统映像。
如果所需映像在**发行版名称**右侧有一个**下载**图标,请点击它。
将显示**SDK 快速修复安装**对话框,其中包含一个完成进度条。
下载完成后,点击**完成**。
点击**下一步**。
**虚拟设备配置**将显示其**验证配置**步骤。
要重命名 Android 虚拟设备 (AVD),请更改**AVD 名称**框中的值。
点击**显示高级设置**并滚动到**模拟性能**。
从**图形**下拉菜单中,选择**硬件 - GLES 2.0**。
这将启用硬件加速并提高渲染性能。
验证您的 AVD 配置。如果正确,请点击完成。
要了解有关 AVD 的更多信息,请查看管理 AVD。
在设备管理器对话框中,点击所需 AVD 右侧的运行图标。模拟器启动并显示所选 Android 操作系统版本和设备的默认画布。
设置您的目标 Android 设备
#要配置 Flutter 应用以在物理 Android 设备上运行,您需要一台运行 Android API 级别 21 或更高版本的 Android 设备。
在您的设备上启用开发者选项和USB 调试,如Android 文档中所述。
[可选] 要利用无线调试,请在您的设备上启用无线调试,如Android 文档中所述。
将您的设备插入 ChromeOS 计算机。如果您的设备提示您,请授权您的计算机访问您的设备。
验证 Flutter 是否识别您连接的 Android 设备。
默认情况下,Flutter 使用
adb
工具所基于的 Android SDK 版本。要使用不同的 Android SDK 安装路径与 Flutter,请将ANDROID_SDK_ROOT
环境变量设置为该安装目录。
同意 Android 许可证
#在使用 Flutter 之前以及安装所有先决条件后,请同意 Android SDK 平台的许可协议。
打开一个提升权限的控制台窗口。
运行以下命令以启用签名许可证。
flutter doctor --android-licenses
如果您在其他时间接受了 Android Studio 许可证,则此命令将返回
[========================================] 100% Computing updates... All SDK package licenses accepted.
您可以跳过下一步。
在同意每个许可证的条款之前,请仔细阅读每个条款。
排查许可证问题
#如何修复查找 Java 安装错误
您可能在 Android SDK 定位 Java SDK 时遇到问题。
flutter doctor --android-licenses
ERROR: JAVA_HOME is set to an invalid directory: /Applications/Android\ Studio.app/Contents/jre/Contents/Home
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation.
Android sdkmanager tool was found, but failed to run
(/Users/atsansone/Library/Android/sdk/cmdline-tools/latest/bin/sdkmanager): "exited code 1".
Try re-installing or updating your Android SDK,
visit https://fluttercn.cn/to/macos-android-setup for detailed instructions.
由于 JAVA_HOME
变量的设置方式,flutter doctor
命令返回此错误。添加路径到 JAVA_HOME
时,可以在 Android
和 Studio
之间的空格处添加反斜杠,或者将整个路径括在匹配的引号中。您不能同时执行两者。
在您的相应 shell 资源文件中查找您的 JAVA_HOME
路径。
将其从
export JAVA_HOME="/Applications/Android\ Studio.app/Contents/jre/Contents/Home"
更改为
export JAVA_HOME="/Applications/Android Studio.app/Contents/jre/Contents/Home"
不要在 Android
和 Studio
之间包含反斜杠。
要加载此更新的环境变量,请重新加载您的 shell。此示例使用 zsh
资源文件。
source ~/.zshrc
检查您的开发设置
#运行 Flutter doctor
#flutter doctor
命令验证 ChromeOS 上完整 Flutter 开发环境的所有组件。
打开一个 shell。
要验证所有组件的安装,请运行以下命令。
flutter doctor
由于您选择开发 Android,因此您不需要所有组件。如果您按照本指南操作,则命令的结果应类似于
Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.5, on , locale en)
[✓] Android toolchain - develop for Android devices (Android SDK version 35.0.1)
[!] Chrome - develop for the web
[✓] Android Studio (version 2024.2)
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources
! Doctor found issues in 2 categories.
解决 Flutter doctor 问题
#当 flutter doctor
命令返回错误时,可能是 Flutter、VS Code、连接的设备或网络资源导致的。
如果 flutter doctor
命令针对任何这些组件返回错误,请使用详细标志再次运行它。
flutter doctor -v
检查输出以获取可能需要安装的其他软件或需要执行的其他任务。
如果更改 Flutter SDK 或其相关组件的配置,请再次运行 flutter doctor
以验证安装。
开始使用 Flutter 开发 ChromeOS 上的 Android 应用
#恭喜。安装了所有先决条件和 Flutter SDK 后,您就可以开始在 ChromeOS 上为 Android 开发 Flutter 应用了。
要继续您的学习之旅,请参阅以下指南
管理您的 Flutter SDK
#要了解有关管理 Flutter SDK 安装的更多信息,请参阅以下资源。
除非另有说明,否则本网站上的文档反映了 Flutter 的最新稳定版本。页面最后更新于 2024-10-28。 查看源代码 或 报告问题.