---
title: Android 故障排除
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/platform-specific/android/developing/testing-and-debugging/troubleshooting
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/platform-specific/android/developing/testing-and-debugging/troubleshooting.md
last_updated: 2026-10-30
generated_at: 2026-11-16T07:53:15.184Z
locale: zh-cn
---

# Android 故障排除

> 解决使用 Unity 进行 Android 开发When的常见问题。

了解如何解决使用 Unity 开发 Android Applications程序When的常见问题。

## Android 清单文件包含意外权限##android-manifest-file-contains-unexpected-permissions

构建 Unity Android 应用程序程序When，最终应用程序程序清单可能包含未显式添加到Project的权限。When希望通过DistributionServices（例如 播放 存储）分发应用程序程序时，此类意外权限可能会导致问题。

### 症状##symptom

应用程序程序清单包含不属于Project清单文件的意外权限条目。

### 原因##cause

构建 Unity Android 应用程序程序When，Gradle 会合并各种来源（包括插件和包）的清单文件，从而生成最终的应用程序程序清单。此过程可能会根据 ON 依赖关系和目标 SDK 版本自动在清单中包含某些意外权限。

### 解决方案##resolution

要识别和解决此类意外权限，请使用 Gradle 在[ Android 应用程序](/engine/6000.0/manual/platform-specific/android/building-and-delivering/build-process.md)版本时生成的清单合并日志文件。此日志文件提供ON Gradle 如何以及为什么添加每个清单元件的信息。请执行以下步骤：

1. 以 `.apk` 或 `.aab` Format 生成应用程序。

2. 转到 `<your_project>/Library/Bee/Android/Prj/IL2CPP/Gradle/launcher/build/outputs` 下的 `logs` 目录。

3. ON 版本类型打开相应的日志文件。

   * **发布版本**：`manifest-merger-release-report.txt`
   * Development build

4. 查找以 `IMPLIED` 开头的日志条目以识别意外权限。日志文件显示的信息如下：

   ```
   D:\MyProject\库\蜜蜂\Android\Prj\IL2CPP\Gradle\启动器\src\主要\AndroidManifest。XML:2:1-5:12 原因：COM.test.包具有 targetSdkVersion < 4
   uses-permission#android.permission.READ_PHONE_STATE
   ```

5. Check the `reason` Field to identify the cause of the unexpected rights.在此示例中，日志条目表示 Gradle 添加了`uses-permission#android.permission.READ_PHONE_STATE`权限，因为`com.test.package`的`targetSdkVersion`低于 `4`。

6. 请与包的所有者者联系，请求更新Target SDK 版本本以MatchProject的Target SDK 版本。

## 其他资源##additional-resources

* [ON Android Devices调试](/engine/6000.0/manual/platform-specific/android/developing/testing-and-debugging/debugging-on-an-android-device.md)
* [Android 应用程序清单](/engine/6000.0/manual/platform-specific/android/introducing/manifest.md)
* [Android Gradle 版本故障排除](/engine/6000.0/manual/platform-specific/android/introducing/gradle-overview/troubleshooting.md)
