【踩坑三天三夜终于跑起来了】不使用Android Studio的Flutter+VSCode在安卓模拟器跑通记录

糟糕的开端

---

想写个小app试试，结果上了年纪的商务笔记本已经带不动Android Studio了，前几年下载安装还能正常用（存疑），今年下载之后不仅自己过了十几分钟闪退，还带着我浏览器一起闪退，连桌面美化都给我搞退了，真的忍不了，然后走上了配环境一直在报错的三天三夜。

Android Studio为什么这么难用？

不用的话一定要把Android Studio卸载干净

---

除了按照网上的卸载教程（我的参照Android studio 卸载（彻底卸载））之外

一定要删除Android Studio目录下的遗留java

Flutter会默认使用这个，搞个1.8然后验证java版本怎么都通过不了你不炸了吗，真的很黑。

启动VSCode，装Flutter

---

这步没什么大问题，基本按照Set up and test drive Flutter来
我是英语白痴，没汉化使我愤怒旋转

别忘了环境变量（系统，path，新建，3次确定）
用户path我也放了这个，不确定放不放的影响

xxx\flutter\bin

我在这步遇到的问题是vscode的扩展装Flutter SDK时没装上，所以自己手动装的。

不要听开发文档的下载zip就用，一会flutter doctor有你好果子吃
手动安装请用git clone指令，请用git clone指令，请用git clone指令！

git clone -b stable https://github.com/flutter/flutter.git

用这个不要开科学上网否则你会像我一样摸不着头脑

最好先建一个Android文件夹并且在这个文件夹使用git clone，这样方便后续的统一管理。
（这个目录树是按照下面步骤全装完以后的）

xxx/Android
├─ flutter
└─ sdk
   ├─  ...
   ├─  build--tools
   ├─  cmake
   ├─  cmdline-tools
   ├─  emulator
   ├─  ndk
   ├─  platforms
   ├─  platform-tools
   └─  system-images

装好之后命令行运行flutter doctor，还是闪退的话，试试运行flutter doctor闪退

在中国网络环境下使用 Flutter
我忘了这个用来解决哪些问题，但是这篇很重要，一定要看，而且最好只用官方镜像因为据说其他的不怎么更新了。

flutter doctor不闪退了以后哪个红解决哪个

---

如果全解决了就是这样：

最后一条的github是偶尔抽风偶尔正常，不用处理

可以说处理这个是我觉得最麻烦的一部分了，建议先打开百八十个窗口对比解决。
遇事不决就多用flutter doctor -v，会多给一些详细信息，能用来比对问题出在哪。
我的问题集中在Android toolchain，先提一下别的：

1. 运行flutter doctor命令检测环境是否配置成功报错及解决方案
   这篇提到了vs安装、使用Android Studio处理Android toolchain和解决Windows Version。我的win版本验证没问题所以这个不知道好不好用。
2. Flutter开发环境搭建，启动项目，耗时一天 终于成功了
   这篇提到了最后一条的Network resources处理，虽然github不用管也管不了，但是maven该换还是要换。

没有Android Studio如何大战Android toolchain

---

以防你不知道：环境变量改完了要关掉再打开cmd。

想致富先修路，先装cmdline-tools

cmdline-tools

Android Studio的下载界面，拉到最底下

下载之后放在前面所说的xxx/Android/sdk文件夹解压

要在cmdline-tools文件夹下新建latest文件夹，然后把cmdline-tools文件夹的所有东西塞到latest文件夹下面

否则打开cmd启动sdkmanager就会：

Error: Could not determine SDK root. Error: Either specify it explicitly with --sdk_root= or move this package into its expected location: <sdk>\cmdline-tools\latest\

参考文献：命令行工具：无法确定SDK根目录

• 添加环境变量：

系统变量新建
变量名：ANDROID_HOME    值：xxx\Android\sdk（你的对应路径）
系统变量path新建：
xxx\Android\sdk\cmdline-tools\latest
xxx\Android\sdk\cmdline-tools\latest\bin

这样就说明可以用了

sdkmanager安装需要的组件（这节产生了奇怪的问题）

那我们还需要装什么呢，答案依旧能在flutter文档找到。

Verify that the following SDK Tools have been selected:
■ Android SDK Build-Tools
■ Android SDK Command-line Tools
■ Android Emulator
■ Android SDK Platform-Tools
■ CMake
■ NDK (Side by side)

注意API得选36以上要不然重装有你好果子吃。
链接文档也提了但谁让我第一次装的时候不知道。

sdkmanager --install build-tools;36.1.0 platforms;android-36
sdkmanager --install emulator system-images;android-36;google_apis_playstore;x86_64sdkmanager --install emulator system-images;android-36;google_apis_playstore;x86_64
sdkmanager --install ndk;29.0.14206865
sdkmanager --install cmake;4.1.2

再用sdkmanager --list_installed

写到这里发现又被做局了，一个组件2个版本。我早晚把flutter和vscode扒皮抽筋看看谁干的。
但是能跑所以先不动了。

依旧系统path新建环境变量：

%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\ndk\29.0.14206865
%ANDROID_HOME%\emulator

avdmanager安装模拟器

avdmanager create avd --name Test01 --package "system-images;android-36;google_apis_playstore;x86_64"
emulator -avd test01

Test01是我取的模拟器名字，可以替换。

成功运行的话就会出现模拟器了，但是我的模拟器侧边栏按键没反应，还没弄清是怎么回事。

最后回到flutter doctor的认证

flutter doctor --android-licenses

如果有Android toolchain Could not determine java version，或者
java.lang.UnsupportedClassVersionError: com/android/sdklib/tool/sdkmanager/SdkManagerCli has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0

如果报这个错误就是flutter的java版本问题，就是我上面提到的遗留了Android Studio的jdk1.8并且被Flutter自动锁定了。用下面的指令。

Linux:flutter config --jdk-dir /usr/lib/jvm/java-17-openjdk
Windows:flutter config --jdk-dir=xxx\Java\jdk-21.0.10

此处参考：调整Flutter项目Java版本

在完成上述步骤而且确定java版本没问题之后应该能顺利运行了，会弹出一堆协议，按y就完了。
还报错的话我这里就解决不了了。

再次启动VSCode，处理依赖。

---

依旧使用Set up and test drive Flutter的步骤，在vscode使用flutter:new project创建一个项目demo。
默认的application是一个计数器。

这时可能会有在web能正常加载，在模拟器无法正常加载的问题，有其他文章说这个不用魔法的话看运气，目前我运行的2次都还正常，没有用魔法。

需要处理的依赖包括：

• 项目\android\gradle\wrapper\gradle-wrapper.properties的最后一行改成

distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/v8.14.0/gradle-8.14-all.zip

核心就是换源成阿里云。

• 项目\android\settings.gradle.kts的repositories

repositories {
        maven { setUrl("https://maven.aliyun.com/repository/public") }
        gradlePluginPortal()
        google()
        mavenCentral()
    }

• 项目\android\build.gradle.kts的allprojects-repositories

allprojects {
    repositories {
        maven { setUrl("https://maven.aliyun.com/repository/google") }
        maven { setUrl("https://maven.aliyun.com/nexus/content/groups/public/") }
        google()
        mavenCentral()
    }
}

这些改动参考了：

• AndroidStudio运行Flutter时卡在Running ‘gradle assembleDebug…‘问题解决
  以及链接中的参考链接
• 【终于不被绕死了】Gradle 换源 kts

记得要根据自己实际情况修改否则有你好果子吃。

没有使用第二个链接所有的换源url，是因为跑的时候会出现：

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:compileDebugKotlin'.
> Error while evaluating property 'friendPathsSet$kotlin_gradle_plugin_common' of task ':app:compileDebugKotlin'.
   > Could not resolve all files for configuration ':app:debugCompileClasspath'.
      > Failed to transform kotlinx-coroutines-core-jvm-1.7.1.jar (org.jetbrains.kotlinx:kotlinx-coroutines-core-jvm:1.7.1) to match attributes {artifactType=android-classes-jar, org.gradle.category=library, org.gradle.libraryelements=jar, org.gradle.status=release, org.gradle.usage=java-api, org.jetbrains.kotlin.platform.type=jvm}.
         > Could not find kotlinx-coroutines-core-jvm-1.7.1.jar (org.jetbrains.kotlinx:kotlinx-coroutines-core-jvm:1.7.1).
           Searched in the following locations:
7.1.jar

就是说，全换源就会少jar包，有的jar包镜像没有那不炸了吗，所以用核心换源其他不变就好。
此处参考：【maven】解决阿里云 maven仓库找不到依赖的问题

以上问题都解决之后就可以愉快使用模拟器跑项目咯，最后放个胜利结算。
终于可以离开环境的折磨开始写代码的折磨了

翻历史记录写了一下午，有帮助的话还请点个赞。谢谢！