Flutter项目Kotlin MainActivity报错、AndroidManifest.xml异常且权限不生效
Flutter项目Kotlin侧报错 & AndroidManifest配置异常排查方案

问题1:AndroidManifest提示"MainActivity must extend android.app.Activity"排查方案
- 核对类路径匹配关系:检查AndroidManifest中
<activity>标签声明的android:name值,必须和MainActivity.kt文件的全限定包名+类名完全一致。如果手动移动过MainActivity的存放路径、修改过包名却没有同步更新Manifest的声明,AS会因为找不到对应类,错误触发“必须继承Activity”的校验报错。 - 检查MainActivity的继承关系正确性:确保Kotlin编写的MainActivity没有缺失继承逻辑,正确导入
io.flutter.embedding.android.FlutterActivity,类定义要写成class MainActivity: FlutterActivity(),不能写成无继承的空类class MainActivity {},否则会直接触发校验规则。 - 同步Flutter嵌入配置:如果项目使用较老的Flutter版本,检查Manifest中
<application>节点下的flutterEmbeddingmeta-data配置是否完整,缺失配置会导致AS的类校验逻辑无法识别FlutterActivity的继承链。 - 清理AS缓存:如果路径和继承关系都检查无误,依然报错的话,执行
File > Invalidate Caches > Invalidate and Restart清理AS索引缓存,多数索引错乱导致的假报错会在重启后消失。
问题2:Manifest中添加的权限配置不生效排查方案
- 确认修改的Manifest文件层级:不要修改build目录下自动生成的合并后Manifest、或是androidTest/test测试目录下的Manifest文件,所有正式权限必须写在
android/app/src/main/AndroidManifest.xml路径下的主配置文件中,错误路径下的声明不会被打进最终安装包。 - 检查标签嵌套位置:所有
<uses-permission>标签必须直接作为<manifest>根节点的子元素存在,绝对不能嵌套放在<application>标签内部,嵌套位置错误的声明会被系统直接忽略。 - 排查Manifest合并冲突:打开Build面板输出的Manifest合并报告,确认是否存在第三方依赖的Manifest配置覆盖、移除了你声明的权限,遇到冲突时需要在对应权限标签上添加
tools:node="merge"规则,强制保留项目自定义的权限声明。 - 区分权限生效逻辑:如果是Android 6.0以上的运行时权限,仅在Manifest声明不会自动获得授权,需要在代码侧补充运行时权限申请逻辑,不要把“未拿到权限授权”等同于“Manifest配置不生效”。
内容的提问来源于stack exchange,提问作者vishal bhardwaj
相关产品推荐
相关产品推荐

