原生移动开发 / 系统课时
AndroidManifest 配置
AndroidManifest 配置
本节解决“Android 系统如何知道你的应用包含什么、能做什么、从哪里启动”的问题。你将用一份最小可用 Manifest 串起应用信息、组件、权限和 Intent Filter,并学会验证最终合并后的启动入口。
学习目标
- 理解
AndroidManifest.xml在构建与安装过程中的职责。 - 会声明应用组件、权限和 Launcher 启动入口。
- 能识别
exported、权限类型与 Manifest 合并带来的常见问题。
Manifest 在构建中的位置
应用模块的主 Manifest 通常位于 app/src/main/AndroidManifest.xml。构建时,Gradle 会把主 Manifest、构建变体 Manifest 以及依赖库中的 Manifest 合并成最终清单,再写入 APK 或 AAB。系统安装应用后,根据这份最终清单注册 Activity、Service、BroadcastReceiver、ContentProvider 等组件。
现代 Android 项目通常在 Gradle 中定义 namespace 和 applicationId。不要把 Manifest 里的包名概念与最终应用 ID 混为一谈;排查安装包身份时应以当前构建变体的 applicationId 为准。
声明应用信息和权限
下面是一份最小但完整的主 Manifest。示例假设项目中已经存在 MainActivity、@string/app_name 和 @style/Theme.AndroidBasics。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.INTERNET" />
<application
android:allowBackup="true"
android:label="@string/app_name"
android:theme="@style/Theme.AndroidBasics">
<activity
android:name=".MainActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>这份配置生效后,应用拥有联网权限声明,并且系统启动器会把 MainActivity 识别为可启动页面。INTERNET 属于普通权限,不需要运行时授权;相机、定位等危险权限即使写进 Manifest,仍可能需要在运行时向用户申请。
配置组件与启动入口
组件声明放在 <application> 内。Activity 使用 <activity>,Service 使用 <service>,广播接收器使用 <receiver>,内容提供者使用 <provider>。是否允许其他应用直接调用组件,要结合 android:exported、Intent Filter 和权限一起判断。
Launcher Activity 需要同时具备 android.intent.action.MAIN 与 android.intent.category.LAUNCHER。当组件包含 Intent Filter 且目标 Android 版本要求显式声明导出状态时,应明确设置 android:exported;作为启动页的 Activity 必须能被系统启动器调用,因此这里设置为 true。
验证 Launcher 是否解析正确
安装 Debug 版本后,可以让系统包管理器直接解析 Launcher Activity。下面示例假设当前 applicationId 为 com.example.androidbasics,实际项目请替换成自己的值。
adb shell cmd package resolve-activity --brief -a android.intent.action.MAIN -c android.intent.category.LAUNCHER com.example.androidbasics预期输出
com.example.androidbasics/.MainActivity如果没有返回组件,优先检查应用是否已安装、applicationId 是否正确、MAIN 与 LAUNCHER 是否同时存在,以及最终合并 Manifest 中的 Activity 名称和 exported 值。
处理 Manifest 合并与常见冲突
Manifest 不是孤立文件。src/debug/AndroidManifest.xml、不同 flavor 和依赖库都可能参与合并,因此只查看 src/main 有时会误判最终结果。出现重复组件、属性冲突或权限来源不明时,应在 Android Studio 的 Merged Manifest 视图或构建产物中确认最终值及来源。
组件类名还要与代码包路径对应。.MainActivity 是相对类名写法,会依据模块命名空间解析;如果移动类或重构包路径后启动崩溃,要同步检查 Manifest 引用。配置完成后的判断标准不是“XML 能保存”,而是最终合并清单能被构建、安装并被系统正确解析。