Skip to content

Most visited

Recently visited


Troubleshoot Android Studio

This page contains guidance for troubleshooting common issues and configuration problems in Android Studio.

High density displays

As of version 1.5, Android Studio provides support for high density displays (like HiDPI and Retina monitors) on all platforms.

Scaling factor settings

Android Studio determines the scaling factor for your display as follows:

For Retina displays, UI elements are scaled by a factor of 200% and images are rendered in high resolution. There should be no blurriness due to scaling, even in multi-monitor configurations. Note that there is no support for scaling factors other than 100% (for non-Retina displays) and 200% (for Retina displays).
Android Studio uses the primary display's DPI settings to determine the scaling factor of UI elements. For images, if the scaling factor is less than 150%, normal resolution images are scaled up. If the scaling factor is greater than 150%, high resolution images are scaled appropriately.
Android Studio determines the scaling factor by looking at the "Text Scaling Factor," then at the XWindow system DPI Setting.

A DPI setting of 96 corresponds to a scaling factor of 100% (no scaling), and a DPI setting of 192 corresponds to a scaling factor of 200% (the size of UI elements is doubled). Android Studio currently supports DPI settings between 96 (100% scaling) and 288 (300% scaling).

If Android Studio does not detect the correct system DPI on your Linux or Windows machine, you can set it manually by setting the hidpi property in the file as described in Customize your IDE properties. Note that this property has no effect on Mac machines. This property functions as follows:

Sets the DPI to 192 (200% scaling), ignoring the system settings.
Sets the DPI to 96 (100% scaling), ignoring the system settings.

Blurry or pixelated elements on high density displays

If one or more elements of Android Studio's UI appear blurry or pixelated on your high density display, you may be experiencing one of the following issues:

Incorrectly-sized elements on high density displays

If the entire Android Studio UI is the wrong size on your high density display, see Scaling factor settings. If some elements of the Android Studio UI are the wrong size on your high density display, but others are correctly-sized, you may be experiencing one of the following issues:

Linux libraries

If you are running Android Studio on a 64-bit Linux machine, you may need to install some specific libraries, as follows.

If you are running a 64-bit version of Ubuntu, you need to install some 32-bit libraries with the following command:

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

If you are running 64-bit Fedora, the command is:

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

Project sync issues

When attempting to sync your project, you may receive the following error message: "Connection to the Internet denied. ('Permission denied: connect')". You can resolve this error message by adding the system property to your file in Android Studio as follows:

  1. Open your file in Android Studio.
  2. Add the following line to the file:
    Note that if you have already added other Gradle JVM arguments to your file, you can add this property to the same line as shown in the following example:
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m
  3. Restart Android Studio for your changes to take effect.
  4. Click Sync Project with Gradle Files to sync your project.

Problems updating the IDE on Windows

On Windows, files that are in use by a process cannot be deleted. When you attempt to use the built-in update mechanism in the IDE, it sometimes refuses to install the update, usually providing an error message like "Can't delete C:\some\path\file".

To work around this, open the task manager and attempt to kill processes that may be using the file, such as any Gradle daemons.

minSdkVersion issues

If you are using an obsolete version of the Android Support Libraries, you may receive an error message like the following:

: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/
Suggestion: use tools:overrideLibrary="" to force usage

To resolve this issue, use the SDK manager to update to the latest (non-preview) versions of the Android Support Libraries. For more information about setting up the Support Libraries, see Support Library Setup.

This site uses cookies to store your preferences for site-specific language and display options.


This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.