Android Studio 疑难解答

此页面包含有关对 Android Studio 中的常见问题和配置问题进行疑难解答的指南。

高密度显示屏

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

缩放比例设置

Android Studio 确定显示器的缩放比例如下：

Mac: 对于视网膜显示屏，UI 元素会按 200% 的比例缩放，图像以高分辨率渲染。即使在多显示器配置中，也不应该出现由于缩放造成的模糊。请注意，除了 100%（非视网膜显示屏）和 200%（视网膜显示屏）之外，不支持其他缩放比例。
Windows: Android Studio 使用主显示器的 DPI 设置来确定 UI 元素的缩放比例。对于图像，如果缩放比例小于 150%，则普通分辨率图像会被放大；如果缩放比例大于 150%，则高分辨率图像会按比例缩放。
Linux: Android Studio 通过查看“文本缩放比例”，然后查看 X Window 系统的 DPI 设置来确定缩放比例。

96 的 DPI 设置对应于 100% 的缩放比例（无缩放），而 192 的 DPI 设置对应于 200% 的缩放比例（UI 元素的大小加倍）。Android Studio 目前支持 96（100% 缩放）到 288（300% 缩放）之间的 DPI 设置。如果 Android Studio 未能在您的 Linux 或 Windows 机器上检测到正确的系统 DPI，您可以通过设置 idea.properties 文件中的 hidpi 属性来手动设置它，如自定义您的 IDE 属性中所述。请注意，此属性对 Mac 机器无效。此属性的功能如下：

hidpi=true: 将 DPI 设置为 192（200% 缩放），忽略系统设置。
hidpi=false: 将 DPI 设置为 96（100% 缩放），忽略系统设置。

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

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

如果大部分 Android Studio UI 看起来正常，但某个特定图标模糊或像素化，或者某个特定 UI 元素使用错误的字体大小，则该特定元素可能尚未完全更新以支持 HiDPI。请单击帮助 > 提交反馈提交错误报告。请附上屏幕截图，并尽可能提供有关您的系统配置的更多信息。
如果您使用的是 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 或更高版本，然后单击文件 > 项目结构 > SDK 位置并选中使用嵌入式 JDK复选框来切换到使用捆绑的 JDK。

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

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

如果您使用的是自定义编辑器方案，则与高密度显示屏上的其他 UI 元素相比，编辑器字体可能显得太小或太大。要解决此问题，请单击文件 > 设置，然后单击编辑器 > 颜色和字体 > 字体并更改编辑器字体的尺寸。请注意，当默认方案处于活动状态时，编辑器字体大小会自动缩放（请参见错误186920）。
如果 Android Studio 的某些 UI 元素大小正确，但其他元素太小或太大，则您可能遇到问题186923。请单击帮助 > 提交反馈提交错误报告。请附上屏幕截图，并尽可能提供有关您的系统配置的更多信息。

项目同步问题

尝试同步项目时，您可能会收到以下错误消息：“拒绝连接到互联网。（'权限被拒绝：连接'）”。您可以通过将系统属性-Djava.net.preferIPv4Stack=true添加到 Android Studio 中的gradle.properties文件来解决此错误消息，方法如下：

在 Android Studio 中打开您的gradle.properties文件。
将以下行添加到文件中：
```
org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
```
请注意，如果您已将其他 Gradle JVM 参数添加到您的gradle.properties文件中，您可以将此属性添加到同一行，如下例所示：
```
org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
```
重新启动 Android Studio 以使更改生效。
单击使用 Gradle 文件同步项目以同步您的项目。

在 Windows 上更新 IDE 时遇到的问题

在 Windows 上，进程正在使用的文件无法删除。当您尝试使用 IDE 中的内置更新机制时，它有时会拒绝安装更新，通常会提供类似“无法删除 C:\some\path\file”的错误消息。

要解决此问题，请打开任务管理器并尝试终止可能正在使用该文件的进程，例如任何 Gradle 守护程序。

minSdkVersion 问题

如果您使用的是过时的 Android Support Libraries 版本，您可能会收到如下错误消息：

: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 Support Libraries 版本。有关设置 Support Libraries 的更多信息，请参见Support Library 设置。

Android 模拟器问题

请参见Android 模拟器故障排除。

配置 (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
插件 (idea.plugins.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
系统 (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
日志 (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

配置 (idea.config.path): ~/.config/Google/AndroidStudioVERSION
插件 (idea.plugins.path): ~/.local/share/Google/AndroidStudioVERSION
系统 (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
日志 (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

每个目录都以以下格式列出：

<非正式目录名称> (<IDE 属性>): <默认路径>。

替换

AndroidStudio 为产品名称，稳定版为 AndroidStudio，Beta 版和 Canary 版为 AndroidStudioPreview。
VERSION 为版本号。例如：2023.1 或 2023.3。