Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.

排查 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 位库:

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

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

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 来解决此错误消息:

  1. 在 Android Studio 中打开您的打开 gradle.properties 文件。
  2. 在此文件中添加下列代码行:
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    请注意,如果您已向 gradle.properties 文件添加其他 Gradle JVM 参数,则可像下例所示那样在该行中添加此属性:
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. 重新启动 Android Studio,以使您的更改生效。
  4. 点击 Sync Project with Gradle Files 以同步您的项目。

Windows 上更新 IDE 期间出现问题

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

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

minSdkVersion 问题

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

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
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
Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

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