Android清单文件

清单文件AndroidManifest.xml

AndroidManifest.xml 配置清单文件是 每个 Android 应用的配置中心，系统在安装和运行应用时，首先会读取它。

它是 Android 应用的 "说明书"，主要作用是：

功能	说明
声明应用组件	比如 Activity、Service、BroadcastReceiver 等
请求权限	比如访问网络、读写存储、拍照等
声明应用信息	应用名、图标、版本号、最小兼容 SDK 等
配置 intent-filter	指定某个组件能响应哪些 Intent（尤其是隐式 Intent）
设置应用入口	指定启动时第一个 Activity

---

基本结构

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">

    <!-- 权限声明 -->
    <uses-permission android:name="android.permission.INTERNET" />

    <!-- 应用本体 -->
    <application
        android:label="@string/app_name"
        android:icon="@mipmap/ic_launcher"
        android:theme="@style/AppTheme">

        <!-- 启动 Activity -->
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <!-- 其他 Activity -->
        <activity android:name=".SecondActivity" />
    </application>

</manifest>

主要节点详解

<manifest> 根节点

属性	说明
xmlns:android	声明 XML 命名空间，必须有
package	包名，必须唯一，通常和代码一致

---

<uses-permission> 声明权限

声明你的应用需要什么权限，例如：

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.INTERNET" />

系统会在安装时提示用户。

---

<application> 应用级设置

它包含整个应用的组件和元数据。

属性	说明
android:label	应用名称（需要在strings.xml中定义）
android:icon	应用图标，放在res/mipmap目录
android:theme	主题样式
android:name	（可选）自定义 Application 类

---

<activity> 声明 Activity 页面

这个 Android 项目中的全部 Activity 都必须在清单文件中用声明

<activity android:name=".MainActivity">
    <!-- 设置该页面为启动页面 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

属性	说明
android:name	Activity 的类名（可用 .类名 简写）
intent-filter	定义此 Activity 可响应的 Intent
android:screenOrientation	屏幕方向（portrait/landscape）

---

<intent-filter> 意图过滤器

包括在中

用于指定组件能响应该怎样的 Intent。

最典型用途：指定 App 的主入口 Activity。告诉系统哪些Intent可以触发当前activity

<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
</intent-filter>

含义是：这是一个 主界面（MAIN） + 桌面图标（LAUNCHER）。

属性	说明
<action>	指定Intent的动作（如MAIN代表主入口）
<category>	指定intent的类别（如LAUNCHER代表启动器）

服务（Service）

<service android:name=".MyService" />

广播接收器（BroadcastReceiver）

<receiver android:name=".MyReceiver">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
    </intent-filter>
</receiver>

内容提供者（ContentProvider）

<provider android:name=".MyProvider"
    android:authorities="com.example.myapp.provider"
    android:exported="false" />

---

权限机制注意

从 Android 6.0（API 23）开始，除了在 AndroidManifest.xml 里声明权限外，还必须 在运行时动态申请某些敏感权限（比如摄像头、位置、存储读写）。

下面是一些常用的权限

    <uses-permission android:name="android.permission.INTERNET" /> <!-- 添加网络权限 -->

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!-- 添加写入外部存储权限 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <!-- 添加读取外部存储权限 -->
    <uses-permission android:name="android.permission.CAMERA" /> <!-- 添加相机权限 -->

---

常见错误

问题	原因
页面跳转时报错	没有在 manifest 里声明目标 Activity
权限不生效	没在 manifest 中声明，或没有动态申请
找不到主入口	忘了加 MAIN + LAUNCHER 的 <intent-filter>

---