排查 Android Studio 的问题

本页面包含有关排查 Android Studio 中的常见问题和配置问题的指南。

高密度显示屏

从版本 1.5 开始，Android Studio 在所有平台上提供了对高密度显示屏（例如 HiDPI 和 Retina 显示器）的支持。

缩放比例设置

Android Studio 根据如下原则确定显示屏的缩放比例：

  • Mac
  • 对于 Retina 显示屏，UI 元素按 200% 的比例缩放，而图像则以高分辨率呈现。 不能因为缩放而导致模糊，即使在多显示器配置中也不例外。 请注意，暂不支持 100%（对于非 Retina 显示屏）和 200%（对于 Retina 显示屏）之外的其他缩放比例。
  • Windows
  • Android Studio 使用主显示屏的 DPI 设置来确定 UI 元素的缩放比例。 对于图像，如果缩放比例小于 150%，则会放大正常分辨率的图像。 如果缩放比例大于 150%，则会相应缩放高分辨率图像。
  • Linux
  • Android Studio 通过检查 “Text Scaling Factor” 和 “XWindow system DPI Setting” 来确定缩放比例。 DPI 设置为 96 对应于缩放比例为 100%（无缩放），DPI 设置为 192 对应于缩放比例为 200%（UI 元素的尺寸放大一倍）。 Android Studio 当前支持介于 96（100% 缩放）和 288（300% 缩放）之间的 DPI 设置。 如果 Android Studio 在您的 Linux 或 Windows 计算机上未检测到正确的系统 DPI，则可按照 自定义 IDE 属性中的说明在 ide.properties 文件中设置 hidpi 属性来手动设置 DPI。 请注意，此属性在 Mac 计算机上没有作用。 此属性的工作方式如下： hidpi=true
  • 将 DPI 设置为 192（200% 缩放），忽略系统设置。
  • hidpi=false
  • 将 DPI 设置为 96（100% 缩放），忽略系统设置。

在高密度显示屏上元素显示模糊或像素化

如果 Android Studio 的 UI 中有一个或多个元素在您的高密度显示屏上显示模糊或者像素化，您可能遇到以下问题之一：

  • 如果大多数 Android Studio UI 显示正常，但有一个特别的图标显示模糊或像素化，或者某个特别的 UI 元素使用了错误的字体大小，则说明该特定元素很可能尚未完全进行针对 HiDPI 支持的更新。 请点击 Help > Submit Feedback，提交错误报告。 请在报告中包含屏幕截图以及尽可能详尽的系统配置相关信息。
  • 如果您使用的是 Windows 或 Linux 计算机，而您的显示屏使用 100% 或 200% 之外的缩放比例，则图像可能会因缩放而出现轻微模糊。
  • 如果您使用的是 Windows 计算机，并且您已在控制面板中更改 Windows 的字体大小，您可能会遇到字体模糊或像素化的问题。 您可以通过注销 Windows 然后重新登录来解决这个问题。
  • 在运行 Windows 8.1 或更高版本的多显示器配置中，当您将一个窗口从一台显示器移动到另一台分辨率或 DPI 不同的显示器中时，您可能会遇到字体或图像问题（参阅错误 186007）。 此问题尚无已知的解决办法。
  • 旧版本的 JRE 1.8 中存在一个字体模糊的问题（特别是 JRE 1.8.0_25-b18 amd64，请参阅错误 192316。） 从版本 2.2 开始，Android Studio 捆绑了所支持的最新版 JDK，其中包含此 JDE。 要解决此问题，请将 Android Studio 更新至版本 2.2 或更高版本并通过点击 File > Project Structure > SDK Location 并选中 Use embedded JDK 复选框，改为使用所捆绑的 JDK。

高密度显示屏上显示的元素大小不正确

如果在您的高密度显示屏上，整个 Android Studio UI 的大小都不正确，请参阅缩放比例设置。 如果在您的高密度显示屏上，Android Studio UI 的部分元素大小不正确，但其他元素大小正确，则可能是遇到以下问题之一：

  • 如果您使用的是自定义编辑器方案，则在高密度显示屏上，与其他 UI 元素相比，此编辑器的字体可能看上去太小或太大。 要修复此问题，请点击 File > Settings，然后点击 Editor > Colors and Fonts > Font，更改编辑器的字体大小。 请注意，当启用默认方案时，将会自动缩放编辑器的字体大小（请参阅错误 186920）。
  • 如果 Android Studio 的某些 UI 元素的大小合适，但其他元素太小或太大，则可能是遇到 186923 问题。 请点击 Help > Submit Feedback，提交错误报告。 请在报告中包含屏幕截图以及尽可能详尽的系统配置相关信息。

Linux 库

如果您在 64 位 Linux 计算机上运行 Android Studio，则可能需要安装某些特定的库，如下所述。

如果您运行的是 64 位版本 Ubuntu，则您需要使用以下命令安装一些 32 位库：

  1. sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386 lib32z1 lib32bz2-1.0

如果您运行的是 64 位版本的 Fedora，则所用命令为：

  1. sudo yum install zlib.i686 ncurses-libs.i686 bzip2-libs.i686

项目同步问题

尝试同步您的项目时，您可能会收到以下错误消息："Connection to the Internet denied. ('Permission denied: connect')"。您可以通过按照下述步骤，在 Android Studio 中向您的 gradle.properties 文件添加系统属性 -Djava.net.preferIPv4Stack=true 来解决此错误消息：

  • 在 Android Studio 中打开您的打开 gradle.properties 文件。
  • 在此文件中添加下列代码行：
  1. org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true

请注意，如果您已向 gradle.properties 文件添加其他 Gradle JVM 参数，则可像下例所示那样在该行中添加此属性：

  1. org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
  • 重新启动 Android Studio，以使您的更改生效。
  • 点击 Sync Project with Gradle FilesTroubleshoot - 图1 以同步您的项目。

Windows 上更新 IDE 期间出现问题

在 Windows 上，无法删除被某个进程占用的文件。 当您试图使用 IDE 内置的更新机制执行更新时，有时，系统会拒绝安装更新，通常还会提供类似“无法删除 C:\some\path\file” 这样的错误消息。

要解决此问题，请打开任务管理器并尝试结束可能使用该文件的进程，例如 Gradle 后台程序。

minSdkVersion 问题

如果您使用的是过时的 Android 支持库版本，您可能会收到下面这样的错误消息：

  1. :app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
  2. uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
  3. Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

要解决此问题，请使用 SDK 管理器更新至最新版（非预览版）Android 支持库。 如需了解有关设置支持库的详细信息，请参阅支持库设置。