无法在外部设备安装Flutter应用：MainActivity类找不到异常

问题描述 #

将Flutter应用安装到外部设备时失败，应用持续卡在“正在安装”状态，系统抛出ClassNotFoundException，提示找不到com.appazon.appazon.MainActivity类，具体错误日志如下：

E/AndroidRuntime(29040): java.lang.RuntimeException: Unable to instantiate activity ComponentInfo{com.appazon.appazon/com.appazon.appazon.MainActivity}: java.lang.ClassNotFoundException: Didn't find class "com.appazon.appazon.MainActivity" on path: DexPathList[[zip file "/data/app/~~OM2AzhFMd9XUFVOiiYzuPQ==/com.appazon.appazon-gzQHt98phAih6HHo86Rtng==/base.apk"],nativeLibraryDirectories=[/data/app/~~OM2AzhFMd9XUFVOiiYzuPQ==/com.appazon.appazon-gzQHt98phAih6HHo86Rtng==/lib/arm64, /data/app/~~OM2AzhFMd9XUFVOiiYzuPQ==/com.appazon.appazon-gzQHt98phAih6HHo86Rtng==/base.apk!/lib/arm64-v8a, /system/lib64, /system/system_ext/lib64]]

解决方案 #

• 检查AndroidManifest.xml配置
  确认android/app/src/main/AndroidManifest.xml中MainActivity的全类名完全匹配com.appazon.appazon.MainActivity，注意大小写、包名路径是否正确，避免android:name属性写成.MainActivity但包名不匹配的情况。

• 清理重建项目
  执行以下命令彻底清理缓存并重新构建：

  flutter clean
  flutter build apk
  

  也可进入android/目录清理Android端缓存：

  cd android
  ./gradlew clean
  

• 启用多Dex支持
  若应用方法数超过65536，需开启多Dex：
  在android/app/build.gradle中添加配置：

  android {
      defaultConfig {
          multiDexEnabled true
      }
  }
  
  dependencies {
      implementation 'com.android.support:multidex:1.0.3'
  }
  

  同时确保自定义Application类继承MultiDexApplication，或在attachBaseContext方法中调用MultiDex.install(this)。

• 验证Android目录结构
  确认MainActivity文件路径与类名一致：

  • Kotlin项目：android/app/src/main/kotlin/com/appazon/appazon/MainActivity.kt
  • Java项目：android/app/src/main/java/com/appazon/appazon/MainActivity.java
    包名对应的目录层级必须准确，不能出现目录名拼写错误。

• 设备端操作
  卸载设备上已存在的该应用，清理残留数据后重新尝试安装；同时检查设备是否开启了“未知来源应用安装”权限，避免安全软件拦截安装流程。

内容的提问来源于stack exchange，提问作者Suresh Yadav