解决Ionic Capacitor在Android Studio中Gradle Daemon启动失败问题

一、处理“Unable to start the daemon process”错误 #

• 优化Gradle内存配置：打开项目根目录下的gradle.properties，调整org.gradle.jvmargs参数，确保内存分配在系统承受范围内，示例：

  org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
  

  若系统内存小于8G，不建议设置超过2048m的Xmx值。
• 清理Gradle缓存：删除本地Gradle缓存目录，彻底清除旧缓存：
  • Windows：删除C:\Users\<你的用户名>\.gradle\caches
  • macOS/Linux：删除~/.gradle/caches
• 释放系统资源：关闭后台占用大量内存的程序，给Gradle daemon足够的运行空间。
• 匹配Java版本：确认使用的JDK版本与Android Studio兼容，推荐JDK 11或17（对应Android Studio Flamingo及以上版本）。

二、解决“无法将字符串'UNIFIED_TEST_PLATFORM'转换为BooleanFlag枚举值”错误 #

该问题源于Gradle插件与Capacitor版本不兼容，按以下步骤修复：

• 更新Capacitor Android插件：执行命令升级到最新兼容版本：

  npm install @capacitor/android@latest
  npx cap sync android
  

• 调整Android Gradle插件版本：打开android/build.gradle文件，修改com.android.tools.build:gradle的版本为7.4.2及以上（适配Angular 16和Ionic 7）：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2'
      // 其他依赖项
  }
  

• 同步Gradle项目：在Android Studio中点击File > Sync Project with Gradle Files，完成后重新构建项目。

三、终极排查方案 #

1. 运行ionic doctor check扫描项目依赖冲突，根据提示修复不兼容项。
2. 重建Android平台：若上述方法无效，移除并重新添加Android平台：

   ionic capacitor remove android
   ionic capacitor add android
   npx cap sync android
   

3. 确认Gradle设置：在Android Studio中进入File > Settings > Build, Execution, Deployment > Gradle，选择Use Gradle from:为项目内的gradle-wrapper路径，避免使用全局Gradle版本不匹配。

内容的提问来源于stack exchange，提问作者Souhail AIT SAID