Android Studio中Capacitor升级后InternalUtils类依赖问题排查

问题背景 #

升级Capacitor到5.0.5后，InternalUtils.java中TIRAMISU和PackageInfoFlags标红报错，但项目能正常构建，且compileSdkVersion和targetSdkVersion已设置为33。

解决方案 #

以下是针对性的排查和修复步骤：

• 检查Android SDK API 33组件完整性
  打开Android Studio的File > Settings（或快捷键Ctrl+Alt+S），进入Appearance & Behavior > System Settings > Android SDK：

  1. 在SDK Platforms标签下，确认Android 13 (Tiramisu)的SDK Platform和Sources for Android 13已勾选并完成安装
  2. 在SDK Tools标签下，确保Android SDK Build-Tools 33.x.x版本已安装

• 清理IDE缓存并重启
  点击File > Invalidate Caches...，勾选Invalidate and Restart，重启后等待IDE重新完成项目索引

• 强制同步Gradle项目
  点击工具栏的「Sync Project with Gradle Files」按钮（大象图标），或右键项目根目录选择Gradle > Sync Gradle Project

• 直接指定compileSdkVersion（排除变量覆盖问题）
  把模块级build.gradle中的compileSdkVersion硬编码为33，避免根项目变量可能的覆盖：

  android {
      namespace "com.getcapacitor.android"
      compileSdkVersion 33
      defaultConfig {
          minSdkVersion 22
          targetSdkVersion 33
          // ... 其他配置
      }
      // ... 其他配置
  }
  

  同步后查看报错是否消失

• 确认Java版本兼容性配置
  确保模块级build.gradle中指定了正确的Java版本：

  android {
      // ... 其他配置
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_17
          targetCompatibility JavaVersion.VERSION_17
      }
  }
  

原因说明 #

项目能构建说明Gradle配置是正确的，它会根据compileSdkVersion拉取对应SDK依赖完成编译；而Android Studio的代码索引是独立的流程，当SDK组件缺失、缓存过期或索引未同步时，就会出现符号标红的假报错，不影响实际构建。

内容的提问来源于stack exchange，提问作者Jimy Weiss