Unity打包Android的AndroidManifest.xml

最新推荐文章于 2025-06-05 10:12:22 发布

原创最新推荐文章于 2025-06-05 10:12:22 发布 · 6.9k 阅读

20 ·

CC 4.0 BY-SA版权

Unity与Android交互专栏收录该内容

6 篇文章

订阅专栏

本文深入探讨了AndroidManifest在Unity中的作用与配置，包括其在Android程序中的全局配置功能，Unity打包时的处理方式，以及如何正确设置入口Activity，确保应用正常启动。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一. 什么是AndroidManifest

AndroidMainfest是Android程序的全局配置表，提供了Android程序运行的必要信息，例如活动，服务，广播接收机，内容提供商等功能注册，既是Android程序运行前系统必须拥有的信息。
相关文章链接：
https://blog.csdn.net/aiyan1111111/article/details/52858003
https://www.jianshu.com/p/3b5b89d4e154
官方：https://developer.android.com/guide/topics/manifest/manifest-intro?hl=zh-cn

二. unity中的AndroidManifest

Unity发布Android的APK时

如果在Plugins/Android，不存在AndroidManifest文件，会使用Unity默认的AndroidManifest文件。
默认的AndroidManifest文件目录在：Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Apk
如果存在AndroidManifest文件，那么Unity会使用它代替默认的AndroidManifest文件。并将unity中的配置写入该文件。
默认的AndroidManifest.xml:

    xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.unity3d.player"
    xmlns:tools="http://schemas.android.com/tools"
    android:installLocation="preferExternal">
    <supports-screens
        android:smallScreens="true"
        android:normalScreens="true"
        android:largeScreens="true"
        android:xlargeScreens="true"
        android:anyDensity="true"/>

    <application
        android:theme="@style/UnityThemeSelector"
        android:icon="@mipmap/app_icon"
        android:label="@string/app_name">
        <activity android:name="com.unity3d.player.UnityPlayerActivity"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
        </activity>
    </application> 
    </manifest>

Unity发布Android的APK时，关于AndroidManifest的合并，分为两种情况：

当存在多个jar包时，需要手动合并每个jar包的AndroidManifest
当存在aar包时，在导出APK时，Unity会解析Arr包的资源，并把它们的AndroidManifest文件合并到Plugins/Android目录下的AndroidManifest文件或者Unity默认的AndroidManifest文件中，这样每个Arr包AndroidManifest请求的权限或者服务最后会合并到一个AndroidManifest中

三. AndroidManifest.xml解析

入口Activity

一.什么是Activity
Activity是一个Android四大组件之一，它提供了一个界面，用户可以通过该界面进行交互以执行某些操作，例如拨打电话，拍照，发送电子邮件或查看地图等行为，包含着行为功能的逻辑组织，由各种控件组件拼凑起来的窗口。
相关文章链接：https://www.jianshu.com/p/476087b4c087

AndroidManifest.xml中：

<activity android:name="com.unity3d.player.UnityPlayerActivity"
          android:label="@string/app_name">
	<intent-filter>
		<action android:name="android.intent.action.MAIN" />
		<category android:name="android.intent.category.LAUNCHER" />
	</intent-filter>
	<meta-data android:name="unityplayer.UnityActivity" android:value="true" />
</activity>

android.intent.action.MAIN：决定应用的入口Activity，也就是我们启动应用时首先显示哪一个Activity。
android.intent.category.LAUNCHER：表示activity应该被列入系统的启动器(launcher)(允许用户启动它)。Launcher是安卓系统中的桌面启动器，是桌面UI的统称。

这个标签决定了哪个Activity作为入口Activity。

注意：
这个标签是必须的，否则unity打包的apk会出现闪退

<meta-data android:name="unityplayer.UnityActivity" android:value="true" />

参考：https://www.jianshu.com/p/75e0f4f16471