Flutter是谷歌开源的一个跨平台开发的框架,方便好用,这里以Windows 上构建 Flutter Android 应用为例,记录下我搭建环境时碰到的一些问题以及解决。
第一步:参考官网:开发 Android 应用 | Flutter 中文文档 - Flutter 中文开发者网站 - Flutter 先安装好必须的开发工具。
第二步: 下载flutter SDK,直接从官网下载压缩包解压:归档列表 | Flutter 中文文档 - Flutter 中文开发者网站 - Flutter ,需要将解压路径添加到环境变量Path内,如:D:\flutter\bin
第三步:打开PowerShell,执行flutter doctor,这一步可能会遇到各种问题
PS D:\flutter> flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 3.24.5, on Microsoft Windows [版本 10.0.19042.1706], locale zh-CN)
[√] Windows Version (Installed version of Windows is version 10 or higher)
[√] Android toolchain - develop for Android devices (Android SDK version 35.0.0)
[√] Chrome - develop for the web
[√] Visual Studio - develop Windows apps (Visual Studio Community 2022 17.12.1)
[√] Android Studio (version 2024.2)
[√] IntelliJ IDEA Community Edition (version 2020.2)
[√] Connected device (4 available)
[!] Network resources
X A network error occurred while checking "https://maven.google.com/": 信号灯超时时间已到
! Doctor found issues in 1 category.
博主主要是在Android toolchain、Visual Studio、Network resources这3个点遇到问题。
Android toolchain主要是sdk版本以及其他一些工具未找到:这里有两个点,1.由于本地已经有安装了Android Studio,所以忽略了版本要求导致的问题,卸载重新安装要求的版本即可;2. 本地sdk的环境变量错误导致,由于之前装过其他的android sdk改过环境变量导致的问题,建议在安装Android Studio之前,先将android sdk相关环境变量先删除,再安装。
Visual Studio问题会有提示需要在安装时添加哪些组件,直接卸载重装将组件勾选上。
Network resources问题其实不影响,如果在意的话,参考官网处理:在中国网络环境下使用 Flutter | Flutter 中文文档 - Flutter 中文开发者网站 - Flutter
第四步:创建项目,参考:构建您的第一个 Flutter 应用 | Google Codelabs. 这里我用的是VS code编辑器,需要先安装Flutter插件。
第五步:调试,在调试这一步,我选择的是安卓设备,会遇到报错:
Emulator: PANIC: Broken AVD system path. Check your ANDROID_SDK_ROOT value
这是由于前边环境变量的问题导致的,只要在前边安装Android Studio之前,先将android sdk相关环境变量先删除,再安装。
这里重装后需要重新添加安卓设备,在Android Studio点击Virtual Device Manager,管理添加设备。启动设备后,在vs code调试,国内的话可能会遇到报错
Gradle threw an error while downloading artifacts from the network
这里打开gradle-wrapper.properties文件
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-all.zip
将distributionUrl的链接文件下载下来,找位置存放到本地,不需要解压,将distributionUrl修改为本地,如
distributionUrl=file\:///D:/gradle-8.3-all.zip
就可以在vscode直接启用安卓模拟设备进行调试了。