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 시스템 DPI 설정을 차례로 확인하여 배율을 결정합니다.
DPI 설정 96은 100% 배율(배율 조정 없음)에 해당하며, DPI 설정 192는 200% 배율(UI 요소의 크기가 두 배)에 해당합니다. 현재 Android Studio는 96(100% 배율) ~ 288(300% 배율) 사이의 DPI 설정을 지원합니다. Linux 또는 Windows 시스템에서 Android Studio가 정확한 시스템 DPI를 감지하지 못하는 경우, hidpi 속성을 ide.properties 파일에서 설정하여 DPI를 수동으로 설정할 수 있습니다(IDE 속성 사용자설정 참조). 참고로, 이 속성은 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 이상으로 업데이트하고 번들 JDK를 사용하도록 전환합니다. 이렇게 하려면 File > Project Structure > SDK Location을 클릭하고 Use embedded JDK 확인란을 선택합니다.

고밀도 디스플레이에서 크기가 잘못된 요소

고밀도 디스플레이에서 모든 Android Studio UI의 크기가 잘못된 경우, 배율 설정을 참조하세요. 고밀도 디스플레이에서 일부 Android Studio UI의 크기가 틀리지만 다른 것은 괜찮은 경우, 다음과 같은 문제 중 하나일 수도 있습니다.

  • 사용자설정 편집기 구성을 사용 중인 경우, 편집기 글꼴이 고밀도 디스플레이의 나머지 UI 요소에 비해 너무 작거나 커질 수 있습니다. 이 문제를 해결하려면 File > Settings를 클릭하고 Editor > Colors and Fonts > Font를 클릭한 다음, 편집기 글꼴의 크기를 변경합니다. 참고로, 기본 구성표가 활성인 경우에는 편집기 글꼴의 크기가 자동으로 조정됩니다(버그 186920 참조).
  • Android Studio에서 일부 UI 요소의 크기는 올바르지만 다른 요소의 크기가 너무 작거나 큰 경우, 186923 문제가 있을 수도 있습니다. Help > Submit Feedback을 클릭하여 버그를 제출하세요. 시스템 구성에 대한 스크린샷과 최대한 많은 정보를 포함하세요.

Linux 라이브러리

Android Studio를 64비트 Linux 시스템에서 실행 중인 경우, 다음과 같이 특정 라이브러리를 설치할 필요가 있습니다.

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')". 이 오류 메시지를 해결하려면 다음과 같이 시스템 속성 -Djava.net.preferIPv4Stack=true를 Android Studio의 gradle.properties 파일에 추가합니다.

  1. gradle.properties 파일을 Android Studio에서 엽니다.
  2. 다음 줄을 파일에 추가합니다.
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    참고로, 다음 예시에 나오는 것처럼 다른 Gradle JVM 인수를 gradle.properties 파일에 이미 추가한 경우에는 이 속성을 동일한 줄에 추가할 수 있습니다.
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. 변경사항을 적용하려면 Android Studio를 다시 시작합니다.
  4. Sync Project with Gradle Files를 클릭하여 프로젝트를 동기화합니다.

Windows에서 IDE 업데이트 시의 문제

Windows에서는 프로세스에 의해 사용 중인 파일을 삭제할 수 없습니다. 기본 제공되는 업데이트 메커니즘을 IDE에서 사용하려고 시도할 때, 가끔 업데이트 설치가 거부되는 경우가 있으며 "Can't delete 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 Manager를 사용하여 최신 버전(Preview 버전이 아님)의 Android 지원 라이브러리로 업데이트하세요. 지원 라이브러리 설정에 대한 자세한 내용은 지원 라이브러리 설정을 참조하세요.