关于Android Studio的AndroidManifest.xml的详解

心之所向，自强不息

已于 2025-05-17 22:40:02 修改

阅读量858

点赞数 23

分类专栏： Unity Android 文章标签： android studio xml AndroidManifest

于 2025-04-27 05:42:58 首次发布

本文链接：https://blog.csdn.net/qq1342753906/article/details/147546107

版权

Unity Android 专栏收录该内容

10 篇文章

订阅专栏

AndroidManifest.xml 是 Android 项目的核心配置文件，它定义了应用的基本信息、所需权限、组件、功能等。它为 Android 系统提供了关于应用如何运行的重要信息。每个 Android 应用程序必须包含这个文件，而且这个文件的配置直接影响到应用的行为和安装要求。
下面是一个具体的 AndroidManifest.xml 配置文件的完整代码示例，并结合注释解释每一部分的作用。最后，我还会对这个配置文件做一个总结。

完整的 `AndroidManifest.xml` 示例

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp"  <!-- 应用包名，唯一标识应用 -->
    android:versionCode="1"      <!-- 应用的内部版本号，每次更新时需要增加 -->
    android:versionName="1.0"    <!-- 应用的外部版本号，给用户展示的版本信息 -->

    android:installLocation="auto"  <!-- 安装位置，auto表示系统决定安装位置 -->

    <!-- 定义应用所需的权限 -->
    <uses-permission android:name="android.permission.INTERNET" />  <!-- 允许访问网络 -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  <!-- 允许写入外部存储 -->

    <!-- 声明支持的硬件特性 -->
    <uses-feature android:name="android.hardware.camera" android:required="true" />  <!-- 应用需要相机硬件 -->
    <uses-feature android:name="android.hardware.screen.portrait" android:required="false" />  <!-- 应用支持竖屏，非必需 -->

    <!-- 支持的屏幕配置 -->
    <supports-screens 
        android:smallScreens="true"      <!-- 支持小屏幕 -->
        android:normalScreens="true"     <!-- 支持普通屏幕 -->
        android:largeScreens="true"      <!-- 支持大屏幕 -->
        android:xlargeScreens="true"     <!-- 支持超大屏幕 -->
        android:resizeable="true"        <!-- 支持窗口调整 -->
        android:anyDensity="true" />     <!-- 支持所有屏幕密度 -->

    <!-- 应用组件声明 -->
    <application
        android:icon="@mipmap/ic_launcher"  <!-- 应用图标 -->
        android:label="@string/app_name"    <!-- 应用名称 -->
        android:theme="@style/AppTheme"     <!-- 应用的全局主题 -->
        android:allowBackup="true"          <!-- 是否允许备份应用数据 -->
        android:hardwareAccelerated="true"  <!-- 是否启用硬件加速 -->
        android:debuggable="false">         <!-- 发布版本设置为false，避免调试漏洞 -->

        <!-- Main Activity，应用启动时打开的第一个屏幕 -->
        <activity
            android:name=".MainActivity"  <!-- Activity 类名 -->
            android:label="@string/app_name"
            android:icon="@mipmap/ic_launcher"
            android:theme="@style/AppTheme"
            android:configChanges="orientation|keyboardHidden" <!-- 配置变化时，Activity的响应方式 -->
            android:launchMode="singleTop"> <!-- 启动模式，当栈顶已经存在该Activity时，不重新创建实例 -->
            
            <!-- Intent Filter，表示该Activity响应的Intent -->
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />   <!-- 启动应用时的主动作 -->
                <category android:name="android.intent.category.LAUNCHER" />  <!-- 标记为Launcher -->
            </intent-filter>
        </activity>

        <!-- 第二个 Activity -->
        <activity
            android:name=".SecondActivity"
            android:label="Second Activity"
            android:theme="@style/AppTheme" />

        <!-- 需要在后台运行的服务 -->
        <service android:name=".MyService" 
                 android:enabled="true"  <!-- 是否启用服务 -->
                 android:permission="android.permission.BIND_JOB_SERVICE"> <!-- 启动服务需要的权限 -->
        </service>

        <!-- 广播接收器 -->
        <receiver android:name=".MyBroadcastReceiver" 
                  android:enabled="true">
            <intent-filter>
                <action android:name="com.example.myapp.ACTION_RECEIVE" />  <!-- 监听特定的广播 -->
            </intent-filter>
        </receiver>

        <!-- 内容提供者 -->
        <provider 
            android:name=".MyContentProvider"
            android:authorities="com.example.myapp.provider" 
            android:exported="false"  <!-- 是否允许其他应用访问 -->
            android:readPermission="android.permission.READ_EXTERNAL_STORAGE" 
            android:writePermission="android.permission.WRITE_EXTERNAL_STORAGE">
        </provider>
        
    </application>
</manifest>

注释解释：

根元素 <manifest>:
- package：这是应用的包名，必须是唯一的，系统根据它来标识和管理应用。
- 这边新版抛弃了这个，所以包名放到了build.gradle里面定义，build.gradle详情定义查看https://blog.csdn.net/qq1342753906/article/details/147523439?spm=1001.2014.3001.5502
  namespace ‘com.example.myapplication’ //定义Androidmainfest.xml里面的activity类的空间，如果没有这个定义那么Androidmainfest.xml里面的定义只能是

        <activity
            android:name="com.UnityPlayer.UnityPlayerActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

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

如果定义了，可以直接

        <activity
            android:name=".UnityPlayerActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

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

android:versionCode：整数值，每次更新应用时必须增加，表示内部版本号。
android:versionName：用户可见的版本号，一般是字符串类型。

权限声明 (<uses-permission>):
- android.permission.INTERNET：应用需要访问互联网。
- android.permission.WRITE_EXTERNAL_STORAGE：应用需要访问外部存储。
硬件特性声明 (<uses-feature>)：
- android.hardware.camera：表示应用需要相机硬件。
- android.hardware.screen.portrait：表示应用支持竖屏显示，但不是必需的（android:required="false"）。
屏幕支持声明 (<supports-screens>):
- 配置应用支持的屏幕尺寸、密度等，以确保在不同设备上适配。
<application> 元素：
- android:icon：应用的图标。
- android:label：应用名称。
- android:theme：应用的主题，可以统一应用的界面样式。
- android:allowBackup：是否允许系统备份应用数据。
- android:hardwareAccelerated：是否启用硬件加速。
Activity 配置：
- android:name：Activity 的类名。
- android:launchMode：启动模式。singleTop 表示如果该 Activity 已经在栈顶，则重用栈顶实例而不是创建新实例。
- android:configChanges：指定当设备的配置（如方向变化）发生时，Activity 的响应方式。
Intent Filter：
- 定义 Activity 或组件响应的 Intent。MAIN 和 LAUNCHER 使得该 Activity 成为应用的入口。
Service 配置：
- 声明一个后台服务 MyService，它可以在后台执行长时间的任务。
BroadcastReceiver 配置：
- 用于监听广播消息。这里的 MyBroadcastReceiver 接收 com.example.myapp.ACTION_RECEIVE 广播。
Content Provider 配置：
- 用于数据共享，MyContentProvider 提供访问应用数据的接口。

总结：

权限声明：通过 <uses-permission> 声明应用需要的系统权限。
硬件特性声明：通过 <uses-feature> 声明应用所需的硬件特性，如相机、屏幕方向等。
屏幕支持：使用 <supports-screens> 声明应用支持的屏幕尺寸和密度，以适配不同设备。
应用组件：
- Activity：声明应用的 UI 组件，通常是每个屏幕的入口。
- Service：用于处理后台任务。
- BroadcastReceiver：接收广播消息，处理系统或其他应用发出的广播。
- ContentProvider：用于提供跨应用的数据访问。
Intent Filter：允许应用响应特定的 Intent，例如启动应用时的主入口。
合并：如果应用有多个 AndroidManifest.xml 文件（如库模块和主应用模块），Gradle 会自动将它们合并，冲突时会提示错误并需要手动解决。

通过这些配置，AndroidManifest.xml 定义了应用的各个组件、权限要求以及如何与 Android 系统及其他应用交互。

打包时会对AndroidManifest.xml进行合并
Manifest 合并（Manifest Merging）
当 Android Studio 构建应用时，如果有多个 AndroidManifest.xml 文件（例如，主应用的 AndroidManifest.xml 和库模块的 AndroidManifest.xml），Gradle 会自动将它们合并。

如果多个 AndroidManifest.xml 文件包含相同的元素，Gradle 会尝试合并它们。如果冲突（如两个模块中都有相同的配置），Gradle 会抛出错误。

常见冲突类型：

包名冲突：库模块不能定义 package，只能在主应用的 AndroidManifest.xml 中定义。

权限冲突：如果多个模块都请求相同的权限，会被合并，导致权限冗余。

组件冲突：如果多个模块都声明相同的组件（如 activity 或 service），可能会导致冲突。

如何解决冲突：

使用 tools:node=“remove” 来删除不需要的元素。

使用 tools:overrideLibrary 来覆盖库中的配置。
好的，理解了！你想要一个从头到尾非常详细的关于 Manifest 合并 的例子，包括如何引发冲突、如何解决冲突，以及如何查看合并后的结果。让我给你一个完整的代码例子，解释冲突的产生、如何合并 Manifest 文件，以及如何调试和解决问题。

场景设定：

假设我们有一个包含两个模块的 Android 项目：

应用模块 (app)：这是我们的主应用模块。
库模块 (library)：这是一个包含第三方功能的库模块。

我们将会遇到以下几种常见的 Manifest 合并冲突，并且如何通过 Gradle 合并这些文件来调试和解决这些冲突。

1. 模块 `app` 中的 `AndroidManifest.xml`

这是应用模块中的 AndroidManifest.xml 文件，它定义了应用程序的包名、权限和 Activity。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">

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

    <application
        android:label="My App"
        android:icon="@mipmap/ic_launcher"
        android:theme="@style/Theme.AppCompat.Light">
        
        <activity android:name=".MainActivity"
            android:label="MainActivity"
            android:theme="@style/Theme.AppCompat.DayNight.NoActionBar">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
</manifest>

2. 模块 `library` 中的 `AndroidManifest.xml`

这是库模块中的 AndroidManifest.xml 文件，定义了一个提供共享功能的 Activity，并且声明了与应用模块相同的权限（这将导致冲突）。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.library">

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

    <application
        android:label="Library Module"
        android:icon="@mipmap/ic_launcher">
        
        <activity android:name="com.example.library.LibraryActivity"
            android:label="Library Activity"
            android:theme="@style/Theme.AppCompat.Light">
            <intent-filter>
                <action android:name="com.example.library.OPEN_LIBRARY" />
            </intent-filter>
        </activity>

    </application>
</manifest>

3. `settings.gradle` 文件

在 settings.gradle 文件中，我们声明了项目的结构。

include ':app', ':library'

4. 合并后的 Manifest 文件

在构建时，Gradle 会将 app 模块和 library 模块的 AndroidManifest.xml 合并为一个最终的 AndroidManifest.xml 文件。合并过程会进行如下操作：

权限合并：如果多个模块声明了相同的权限，它们将被合并。
组件合并：如果多个模块声明了相同的组件（如 Activity），Gradle 会尝试合并这些组件。

合并后的 AndroidManifest.xml 可能看起来像这样：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">

    <!-- 合并的权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

    <application
        android:label="My App"
        android:icon="@mipmap/ic_launcher"
        android:theme="@style/Theme.AppCompat.Light">
        
        <!-- MainActivity -->
        <activity android:name=".MainActivity"
            android:label="MainActivity"
            android:theme="@style/Theme.AppCompat.DayNight.NoActionBar">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <!-- LibraryActivity -->
        <activity android:name="com.example.library.LibraryActivity"
            android:label="Library Activity"
            android:theme="@style/Theme.AppCompat.Light">
            <intent-filter>
                <action android:name="com.example.library.OPEN_LIBRARY" />
            </intent-filter>
        </activity>

    </application>
</manifest>

5. 可能的 Manifest 合并冲突

冲突 1：`package` 属性冲突

app 和 library 模块中的 package 属性值不同。package 属性已经不允许在合并时重复声明，因此 Gradle 会报错：

Multiple declarations of the same package name detected.

解决方法：

应用模块：在 app 的 AndroidManifest.xml 中保留 package="com.example.myapp"。
库模块：移除 library 的 AndroidManifest.xml 中的 package 属性。

冲突 2：权限冲突

如果两个模块声明了相同的权限（例如 android.permission.INTERNET），Gradle 会自动合并它们。

应用模块：声明了 android.permission.INTERNET 和 android.permission.ACCESS_NETWORK_STATE。
库模块：声明了 android.permission.INTERNET 和 android.permission.ACCESS_WIFI_STATE。

在合并后，权限不会重复声明，它们会被合并成一个声明。

冲突 3：组件冲突

如果 app 模块和 library 模块中都声明了 Activity，Gradle 会合并它们。例如，如果 app 中有 MainActivity，而 library 中有 LibraryActivity，合并后就会有两个 Activity 声明。

这种合并是 自动的，并且不会报错。

但是，如果组件的配置（如 theme、intent-filter 等）不兼容，则需要手动调整。

解决方法：

你可以使用 tools:node="remove" 来移除某个组件，或者使用 tools:node="replace" 来替换冲突的配置。
如果你不希望某个库中的 Activity 被合并，可以在 app 的 AndroidManifest.xml 中使用以下代码：

<activity
    android:name="com.example.library.LibraryActivity"
    tools:node="remove" />

6. 进一步调试 Manifest 合并

如果遇到 Manifest 合并问题，你可以通过 Gradle 构建来查看合并的具体结果。运行以下命令：

./gradlew :app:processDebugManifest

或者，在 Android Studio 中查看 Manifest 合并报告：

Build > Analyze APK > 打开合并后的 AndroidManifest.xml。

7. 总结

在多个模块之间，AndroidManifest.xml 的合并是常见的操作，特别是当你有多个库和应用模块时。可能会遇到以下冲突：

package 属性冲突：只允许在应用模块中设置 package，库模块中不设置 package 属性。
权限冲突：如果多个模块声明了相同的权限，Gradle 会合并这些权限。
组件冲突：如果多个模块声明了相同的组件（如 Activity、Service 等），Gradle 会合并它们，但如果配置冲突（如主题或 intent-filter），你需要手动解决。

使用 tools 属性来精细控制 Manifest 合并行为，查看 Gradle 输出和 Manifest 合并报告可以帮助你解决问题。

这是一个从头到尾的完整示例和解决方案，希望它能帮助你理解如何处理 Manifest 合并冲突。如果你有任何问题，或者需要进一步的帮助，请告诉我！💡