Android Studio 和 Android Gradle 插件的已知问题

调试和测试

本节说明与调试和测试应用相关的已知问题。

从 Android Studio 运行时，JUnit 测试在类路径中找不到资源

如果您的 Java 模块使用了特定的资源文件夹，那么从 IDE 运行测试时将找不到这些资源。您可以从命令行使用 Gradle 运行测试。也可以从 IDE 执行 Gradle check 任务。请参阅问题 64887 了解详情。

发生这个问题的原因是，从 IntelliJ 13 起，只能将一个文件夹用作类路径。IntelliJ 的编译工具会将所有资源复制到该编译文件夹中，但 Gradle 不会复制这些资源。

• 解决方法 1：从 IDE 运行 Gradle check 任务，而不是运行单元测试。
• 解决方法 2：更新编译脚本以手动将资源复制到编译文件夹中。如需了解详情，请参见此处的第 13 条评论。

运行 JUnit 测试可能会编译两次代码

创建新项目时，系统可能会在 Make 和 Gradle-aware Make 这两个“发布前”步骤中创建模板 JUnit 配置。然后，系统会将此配置传播到所有已创建的 JUnit 运行配置。

• 要为当前项目解决此问题，请依次点击 Run > Edit Configurations，然后将默认的 JUnit 配置更改为仅包含 Gradle-aware Make 步骤。
• 要为今后的所有项目解决此问题，请依次点击 File > Close Project。您应该会看到欢迎屏幕。然后，依次点击 Configure > Project Defaults > Run Configurations，并将 JUnit 配置更改为仅包含 Gradle-aware Make 步骤。

某些测试运行配置无效

右键点击某个测试方法时，并非所有可用的运行配置都有效。具体而言，以下配置无效：

• Gradle 运行配置（其图标为 Gradle 徽标）无效。
• JUnit 运行配置（其图标不带绿色的 Android）不适用于插桩测试（此类测试无法在本地 JVM 上运行）。

调试原生代码时添加 Java 断点

当您的应用在原生代码中的断点处暂停时，Auto 和 Dual 调试程序可能无法立即识别您设置的新 Java 断点。要避免此问题，请在启动调试会话之前或在 Java 断点处暂停应用时添加 Java 断点。如需了解详情，请参阅问题 229949。

退出原生调试程序

使用 Auto 或 Dual 调试程序调试 Java 和原生代码时，如果您通过 Java 代码逐步执行原生函数（例如，调试程序在调用原生函数的某行 Java 代码处暂停执行，并且您点击 Step Into 图标 ）并且希望返回到 Java 代码，请点击 Resume Program 图标 （而非 Step Out 图标 或 Step Over 图标 ）。您的应用进程仍将处于暂停状态，因此请点击 your-module-java 标签页中的 Resume Program 图标 来将其恢复。如需了解详情，请参阅问题 224385。

分析器

本部分说明分析器的已知问题。

调试或剖析时出现 ADB 异常

使用 Platform Tools 29.0.3 时，原生调试和 Android Studio 分析器可能无法正常工作，当您依次选择 Help > Show Log 时，idea.log 文件中可能会显示“AdbCommandRejectedException”或“Failed to connect port”。将 Platform Tools 升级到 29.0.4 或更高版本可以解决这两个问题。

要升级 Platform Tools，请执行以下操作：

1. 依次点击 Tools > SDK Manager 或点击工具栏中的 SDK Manager 图标 ，从 Android Studio 打开 SDK 管理器。
2. 点击 Android SDK Platform-Tools 旁边的复选框，使其显示复选标记。左侧列中应会显示下载图标 。
3. 点击 Apply 或 OK。

Android Gradle 插件的已知问题

本节介绍了最新的稳定版 Android Gradle 插件中存在的已知问题。

缺少清单类

如果您的应用在其清单中定义自定义权限，Android Gradle 插件通常会生成 Manifest.java 类，此类会将您的自定义权限作为字符串常量添加。该插件会将此类与您的应用打包在一起，这样您可以在运行时更轻松地引用这些权限。

目前，无法在 Android Gradle 插件 3.6.0 及更高版本中生成清单类。如果您使用此版本的插件构建应用，并且该应用引用了清单类，您可能会看到 ClassNotFoundException 异常。如需解决此问题，请执行以下某项操作：

• 通过完全限定名称引用自定义权限。例如："com.example.myapp.permission.DEADLY_ACTIVITY"。

• 定义您自己的常量，如下所示：

  public final class CustomPermissions {
        public static final class permission {
          public static final String DEADLY_ACTIVITY="com.example.myapp.permission.DEADLY_ACTIVITY";
        }
      

对使用回车符 (CR) 命名的文件签名

JAR 签名（v1 方案）不支持包含回车符 (CR) 字符的文件名。（参阅问题 #63885809。）

API 变更

在 Android Gradle 插件 3.0.0 及更高版本引入的 API 变更中，部分功能被移除，因此您现有的编译可能会出现异常。插件的更高版本可能会引入新的公共 API 来替代失效的旧功能。

在编译时可能无法正常修改变体输出

新插件不支持使用 Variant API 来操纵变体输出，但仍然支持使用该 API 处理某些简单任务，例如在编译时更改 APK 名称，具体如下所示：

    // If you use each() to iterate through the variant objects,
    // you need to start using all(). That's because each() iterates
    // through only the objects that already exist during configuration time—
    // but those object don't exist at configuration time with the new model.
    // However, all() adapts to the new model by picking up object as they are
    // added during execution.
    android.applicationVariants.all { variant ->
        variant.outputs.all {
            outputFileName = "${variant.name}-${variant.versionName}.apk"
        }
    }
    

不过，涉及访问 outputFile 对象的复杂任务已不再受支持。这是因为在配置阶段不会再创建专门针对特定变体的任务。这导致插件不能预先了解所有的输出，但也缩短了配置时间。

manifestOutputFile 将不再可用

processManifest.manifestOutputFile() 方法不再可用，如果您调用该方法，会遇到以下错误：

    A problem occurred configuring project ':myapp'.
       Could not get unknown property 'manifestOutputFile' for task ':myapp:processDebugManifest'
       of type com.android.build.gradle.tasks.ProcessManifest.
    

您可以调用 processManifest.manifestOutputDirectory() 来返回包含所有已生成清单的目录的路径，而不是调用 manifestOutputFile() 来获取每个变体的清单文件。然后，您可以找到相应清单，并对该清单运用您的逻辑。以下示例将在清单中动态更改版本代码：

    android.applicationVariants.all { variant ->
        variant.outputs.all { output ->
            output.processManifest.doLast {
                // Stores the path to the maifest.
                String manifestPath = "$manifestOutputDirectory/AndroidManifest.xml"
                // Stores the contents of the manifest.
                def manifestContent = file(manifestPath).getText()
                // Changes the version code in the stored text.
                manifestContent = manifestContent.replace('android:versionCode="1"',
                        String.format('android:versionCode="%s"', generatedCode))
                // Overwrites the manifest with the new text.
                file(manifestPath).write(manifestContent)
            }
        }
    }
    

修复的已知问题

本部分说明最新版本中已经修复的已知问题。如果您遇到所述的任何问题，请将 Android Studio 更新为最新稳定版或预览版。

Android Studio 3.6 中修复的问题

• LineageOS 上的 APK 安装错误：将应用部署到运行某些版本的 LineageOS 或 CyanogenMod 的设备可能会失败，并引发 INSTALL_PARSE_FAILED_NOT_APK 异常。

  在 Android Studio 3.6 Beta 1 及更高版本上，当您将应用部署到 LineageOS 或 CyanogenMod 设备时，IDE 通过执行完整的应用安装来处理此异常，这可能会导致部署时间变长。

Android Studio 3.5.2 中修复的问题

• XML 代码样式损坏：在编辑 XML 代码时，如果从菜单栏中依次选择 Code > Reformat Code，IDE 会应用不正确的代码样式。

Android Studio 3.3.1 中修复的问题

• 扫描基于 C++ 的项目时出现内存不足错误：如果 Gradle 扫描的项目在同一驱动器上的多个位置都有 C++ 代码，则扫描会涵盖这些位置的首个共通目录下的所有目录。扫描大量目录和文件可能会导致出现内存不足错误。

  要详细了解此问题，请参阅与该问题相关的错误。