1、下载 SDK
选择自行下载安装 Flutter SDK,下载完成后解压,将解压后的 bin 目录添加到系统环境变量中。打开终端运行 flutter doctor 命令来检查环境,这一步可能会很慢,运行时间取决于你的网络质量。
根据 flutter doctor 的提示解决环境问题,例如开发安卓应用需要安装 Android Studio 及相关工具,开发 Windows 桌面程序则需要安装 Visual Studio 并确保所需的 Windows 开发库已就绪。
2、配置环境变量
由于国内访问 Flutter 相关资源可能较慢,建议添加环境变量来指定国内镜像网站。Flutter 官网推荐了多个镜像源,你可以根据网络情况自行选择并设置 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 等变量以加速依赖下载。
3、创建工程并运行
这里以 VS Code 为例进行演示,使用 IntelliJ IDEA 或 Android Studio 也是可以的。首先在 VS Code 中安装 Flutter 插件,安装完成后通常会连带安装 Dart 插件。
使用 Ctrl+Shift+P(或 Cmd+Shift+P 在 macOS 上)打开命令面板,输入 "Flutter: New Project" 并运行,根据提示选择项目存放的文件夹和设置项目名称即可创建一个新的 Flutter 工程。
运行 Windows 程序
在 VS Code 中打开左侧的“运行与调试”窗口,选择 Flutter 配置,然后将设备目标设置为 Windows。点击运行按钮,等待几秒钟,应用程序窗口便会弹出。
运行安卓程序
安卓应用的首次运行可能较为麻烦,因为需要下载许多依赖库。国内网络环境下,下载过程可能非常缓慢甚至卡住,因此建议配置 Gradle 镜像以加速。
首次运行安卓程序时,不要直接使用 UI 按钮运行,而是通过终端执行命令 flutter run -v 以便查看详细日志。如果卡在 Gradle 下载阶段,需要修改项目中的 gradle-wrapper.properties 文件,将 distributionUrl 替换为国内镜像源,例如:
https://mirrors.cloud.tencent.com/gradle/gradle-7.6.3-all.zip
请根据实际项目中的 Gradle 版本调整上述 URL。此外,还需在项目的 settings.gradle 和 build.gradle 文件中添加 Maven 镜像仓库来加速依赖库下载:
maven { url 'https://maven.aliyun.com/repository/releases' }
maven { url 'https://maven.aliyun.com/repository/jcenter' }
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
maven { url 'https://maven.aliyun.com/repository/public' }
同时确保系统环境变量中的 Java 版本至少为 JDK 11。如果终端中仍出现警告,可以根据提示在项目配置文件中指定 JDK 的安装位置。
完成上述配置后,再次运行 flutter run -v,大约 5 分钟左右即可完成首次编译。后续运行就可以直接使用“运行与调试”窗口中的按钮了。
4、打包
Flutter 打包过程十分快捷。在项目根目录打开终端,运行相应的构建命令即可。
-
打包 Windows 桌面程序(默认输出免安装版本,生成的文件夹打包后即可在其他设备上使用):
flutter build windows -
打包安卓 APK(默认包含多种 CPU 架构的库):
flutter build apk -
打包安卓 APK 并指定目标平台架构,或为每个架构单独生成 APK 以减小包体积:
flutter build apk --target-platform android-arm,android-arm64,android-x64 --split-per-abi
默认配置下,生成的安卓 APK(仅保留一种 CPU 架构)大小约为 6MB,Windows 桌面程序约为 23MB,相较于基于浏览器内核的跨平台方案,Flutter 应用在体积上更为轻便。