Android Studio 疑难解答

本页面包含有关解决 Android Studio 中的常见问题和配置问题的指导。

高密度显示屏

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

缩放比例设置

Android Studio 按如下方式确定显示屏的缩放比例

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

DPI 设置为 96 对应于 100% 的缩放比例（不缩放），DPI 设置为 192 对应于 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。请通过点击帮助 > 提交反馈提交错误报告。请包含屏幕截图以及有关系统配置的尽可能多的信息。

项目同步问题

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

在 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 支持库版本，您可能会收到类似以下的错误消息

: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 支持库。有关设置支持库的更多信息，请参阅支持库设置。

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。