原生移动开发 / 系统课时

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
<?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,实际项目请替换成自己的值。

bash
adb shell cmd package resolve-activity --brief -a android.intent.action.MAIN -c android.intent.category.LAUNCHER com.example.androidbasics

预期输出

text
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 能保存”,而是最终合并清单能被构建、安装并被系统正确解析。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

AndroidManifest 配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通