Android 应用清单

Android 应用清单包含有关 Android 应用程序的信息。每个应用程序在其源集根目录中都有一个 Android 应用清单 XML 文件，名为 AndroidManifest.xml。Android 操作系统和数字分发服务（例如 Google Play）使用 Android 应用清单查找信息，例如应用程序的名称、应用程序的 入口点、Android 版本支持、硬件功能支持和应用程序权限。有关 Android 应用清单文件的更多信息，以及它配置的设置列表，请参阅 Android 开发人员文档中的 Android 应用清单。

要生成一个表示应用程序的 Android 应用清单，Gradle 会合并来自各种来源的清单文件。这包括

• Unity 库清单：Unity 生成的清单文件，用于配置 Unity 播放器活动。有关更多信息，请参阅 Unity 库清单。
• Unity 启动器清单：Unity 生成的清单文件，用于配置包装 Unity 库的应用程序。有关更多信息，请参阅 Unity 启动器清单。
• 插件在 Unity 之外创建的一组代码，用于在 Unity 中创建功能。您可以在 Unity 中使用两种类型的插件：托管插件（使用 Visual Studio 等工具创建的托管 .NET 程序集）和原生插件（平台特定的原生代码库）。 更多信息
  请参阅 术语表 清单：表示插件（例如 Android 归档 (AAR) 或 Android 库项目）的清单文件。

有关 Unity 如何使用这些清单文件生成 Android 应用清单的信息，请参阅 生成 Android 应用清单。

生成 Android 应用清单

Android 应用程序构建过程 为应用程序生成一个 Android 应用清单文件。为此

1. Unity 使用 Unity 库清单作为 Android 应用清单的模板。如果您 覆盖 Unity 库清单，Unity 会使用您指定的作为模板的文件。
2. Unity 会使用诸如 权限、配置选项和应用程序使用的功能等信息更新 Unity 库清单和 Unity 启动器清单文件。
3. Gradle一个 Android 构建系统，可自动执行多个构建过程。这种自动化意味着许多常见的构建错误不太可能发生。 更多信息
   请参阅 术语表 将 Unity 库清单、Unity 启动器清单和插件清单合并到一个 Android 应用清单文件中。

您可以使用 Android Studio APK 分析器 或其他第三方工具（例如 Apktool）在输出的 Android 应用包 (AAB) 或 Android 包 (APK) 中查看 Android 应用清单文件。

重要：您无法编辑 APKUnity 输出的 Android 包格式。当您选择“文件”>“构建并运行”时，APK 会自动部署到您的设备。 更多信息
请参阅 术语表 或 AAB 中的 Android 应用清单文件。有关如何覆盖 Android 应用清单内容的信息，请参阅 修改 Gradle 项目文件。

权限

Unity 会根据 Android 播放器设置 和应用程序从 C# 脚本一段代码，允许您创建自己的组件、触发游戏事件、随时间推移修改组件属性并以任何您喜欢的方式响应用户输入。 更多信息
请参阅 术语表 调用的 Unity API 自动将必要的权限添加到清单中。例如

• 以下类、包和播放器设置会添加 INTERNET 权限。
  • 在 Android 播放器设置 中将 互联网访问 设置为 需要，用于 开发版本开发版本包括调试符号并启用探查器。 更多信息
    请参阅 术语表。
  • UnityWebRequest 和 Ping 类
  • System.Net.Sockets API
  • Unity Analytics一个数据平台，提供 Unity 游戏的分析数据。 更多信息
    请参阅 术语表 包和 云诊断包 中的 崩溃和异常报告。
• 使用振动（例如 Handheld.Vibrate）会添加 VIBRATE。
• InternetReachability 属性会添加 ACCESS_NETWORK_STATE。
• 位置 API（例如 LocationService）会添加 ACCESS_FINE_LOCATION
• WebCamTexture API 会添加 CAMERA。
• Microphone 类会添加 RECORD_AUDIO。

如果插件需要在其清单中声明的权限，则 Unity 会在 Gradle 合并阶段自动将该权限添加到最终的 Android 应用清单中。请注意，Unity 会在权限列表中包含插件使用的所有 Unity API。

您可以使用 Android 运行时权限系统 来 在运行时请求权限，而不是在 Android 应用清单中指定权限。

有关权限的更多信息，请参阅 Android 开发人员文档中的 Android 应用清单权限。