Android 스튜디오 문제 해결하기

이 페이지에서는 Android 스튜디오에서 발생하는 일반적인 문제와 구성 문제를 해결하는 방법을 설명합니다.

고밀도 디스플레이

버전 1.5부터 Android 스튜디오는 모든 플랫폼에서 고밀도 디스플레이(예: HiDPI 및 Retina 모니터)를 지원합니다.

배율 설정

Android 스튜디오는 다음과 같이 디스플레이의 배율을 결정합니다.

Mac
Retina 디스플레이의 경우 UI 요소는 200% 배율로 조정되며 이미지는 고해상도로 렌더링됩니다. 다중 모니터 구성인 경우라도 배율 조정 때문에 흐려지는 현상이 발생해서는 안 됩니다. 100%(Retina가 아닌 디스플레이)와 200%(Retina 디스플레이)가 아닌 다른 배율은 지원되지 않습니다.
Windows
Android 스튜디오는 기본 디스플레이의 DPI 설정을 사용하여 UI 요소의 배율을 결정합니다. 이미지의 경우 배율이 150%보다 작다면 정상 해상도 이미지의 배율이 확대됩니다. 배율이 150%보다 큰 경우에는 고해상도 이미지의 배율이 적절하게 조정됩니다.
Linux
Android 스튜디오는 'Text Scaling Factor(텍스트 배율)'와 XWindow 시스템 DPI 설정을 차례로 확인하여 배율을 결정합니다.
DPI 설정 96은 100% 배율(배율 조정 없음)에 해당하며, DPI 설정 192는 200% 배율(UI 요소의 크기가 두 배)에 해당합니다. 현재 Android 스튜디오는 96(100% 배율)~288(300% 배율) DPI 설정을 지원합니다. Linux 또는 Windows 시스템에서 Android 스튜디오가 정확한 시스템 DPI를 감지하지 못하는 경우 IDE 속성 맞춤설정에서 설명하는 대로 idea.properties 파일의 hidpi 속성을 수동으로 설정하면 됩니다. 참고로 이 속성은 Mac 시스템에는 영향이 없습니다. 이 속성은 다음과 같이 작동합니다.
hidpi=true
DPI를 192(200% 배율)로 설정하며 시스템 설정이 무시됩니다.
hidpi=false
DPI를 96 (100% 배율)으로 설정하며 시스템 설정이 무시됩니다.

고밀도 디스플레이에서 흐리거나 모자이크 형태로 표시되는 요소

고밀도 디스플레이에서 Android 스튜디오 UI의 요소 중 하나 이상이 흐리거나 모자이크 형태로 표시되는 경우 다음과 같은 문제 중 하나일 수 있습니다.

  • 대부분의 Android 스튜디오 UI가 정상적으로 보이지만 특정 아이콘 하나만 흐리거나 모자이크 형태로 표시되는 경우 또는 특정 UI 요소 하나만 잘못된 글꼴 크기를 사용하는 경우, 이 특정 요소는 아직 완벽하게 업데이트되지 않아서 HiDPI가 지원되지 않는 것입니다. Help > Submit Feedback을 클릭하여 버그를 제출하세요. 스크린샷 및 시스템 구성과 관련하여 최대한 많은 정보를 포함하세요.
  • Windows 또는 Linux 시스템을 사용 중이며 디스플레이의 배율이 100% 또는 200%가 아닌 경우, 배율 조정으로 인해 이미지가 약간 흐리게 나타날 수 있습니다.
  • Windows 시스템을 사용 중이며 Control Panel(제어판)에서 Windows 글꼴 크기를 변경한 경우, 글꼴이 흐려지거나 모자이크 형태로 표시될 수 있습니다. 이 문제를 해결하려면 Windows에서 로그아웃한 다음 다시 로그인하세요.
  • Windows 8.1 이상을 실행 중인 다중 모니터 설정에서 해상도나 DPI가 다른 또 다른 디스플레이로 창을 이동하는 경우, 글꼴이나 이미지 문제가 발생할 수도 있습니다(버그 186007 참조). 이 경우에는 알려진 해결 방법이 없습니다.
  • 이전 버전의 JRE 1.8은 글꼴이 흐려지는 문제가 있습니다(특히 JRE 1.8.0_25-b18 amd64, 버그 192316 참고). Android 스튜디오 버전 2.2부터 최신 지원 JDK의 번들 버전이 포함되며 여기에 JDE가 포함됩니다. 이 문제를 해결하려면 Android 스튜디오를 버전 2.2 이상으로 업데이트하고 번들 JDK를 사용하도록 전환합니다. 이렇게 하려면 File > Project Structure > SDK Location을 클릭하고 Use embedded JDK 체크박스를 선택합니다.

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

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

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

프로젝트 동기화 문제

프로젝트를 동기화하려고 시도하면 다음과 같은 오류 메시지가 나타날 수 있습니다. 'Connection to the Internet denied. ('Permission denied: connect')'. 이 오류 메시지를 해결하려면 다음과 같이 시스템 속성 -Djava.net.preferIPv4Stack=true를 Android 스튜디오의 gradle.properties 파일에 추가합니다.

  1. Android 스튜디오에서 gradle.properties 파일을 엽니다.
  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 지원 라이브러리로 업데이트하세요. 지원 라이브러리 설정을 자세히 알아보려면 지원 라이브러리 설정을 참조하세요.

Android Emulator 문제

Android Emulator 문제 해결을 참고하세요.

디렉터리

다음 디렉터리는 Android 스튜디오에서 설정, 캐시, 플러그인, 로그를 저장하는 데 사용됩니다.

Windows

  • 구성 (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • 플러그인 (idea.plugins.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • 시스템 (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • 로그 (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • %APPDATA% 예: C:\Users\YourUserName\AppData\Roaming
  • %LOCALAPPDATA% 예: C:\Users\YourUserName\AppData\Local

macOS

  • 구성 (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

각 디렉터리는 다음 형식으로 나열됩니다.

다음과 같이 바꿉니다.

  • AndroidStudio을 제품 이름으로 바꿉니다. 안정화 버전은 AndroidStudio, 베타 및 카나리아 출시는 AndroidStudioPreview입니다.
  • VERSION를 버전으로 바꿉니다. 예를 들면 2023.1 또는 2023.3입니다.