Skip to content

Most visited

Recently visited

navigation

Android Studio 구성

Android Studio에서 제공하는 마법사와 템플릿을 사용하면 JDK(Java Development Kit) 및 사용 가능한 RAM과 같은 시스템 요구사항을 확인할 수 있으며, 또한 최적화된 기본 AVD(Android Virtual Device) 에뮬레이션 및 업데이트된 시스템 이미지와 같은 기본 설정을 구성할 수 있습니다. 이 문서에서는 Android Studio를 사용자 지정하는 데 사용할 수 있는 추가적인 구성 설정에 대해 설명합니다.

Android Studio는 Help 메뉴에서 두 개의 구성 파일에 액세스할 수 있습니다.

에뮬레이터와 기기의 설정 및 사용에 대한 구체적인 문서는 가상 기기 관리, 하드웨어 기기 사용OEM USB 드라이버를 참조하세요.

구성 파일 찾기

두 개의 구성 파일은 모두 Android Studio의 구성 폴더에 저장됩니다. 폴더 이름은 Studio 버전에 따라 달라집니다. 예를 들어 Android Studio 2.2는 폴더 이름이 AndroidStudio2.2입니다. 이 폴더의 위치는 운영 체제에 따라 달라집니다.

또한 다음 환경 변수를 사용하여 다른 곳의 특정 재정의 파일을 가리킬 수 있습니다.

VM 옵션 사용자설정

studio.vmoptions 파일에서 Android Studio의 VM 옵션을 사용자 지정할 수 있습니다. Studio 성능을 개선하기 위해 가장 일반적으로 수정하는 옵션은 최대 힙 크기이지만 studio.vmoptions 파일을 사용하여 다른 기본 설정(예: 최초 힙 크기, 캐시 크기, 자바 가비지 수집 스위치)을 재정의할 수도 있습니다.

새로운 studio.vmoptions 파일을 생성하거나 기존 파일을 열려면 다음 단계를 수행합니다.

  1. Help > Edit Custom VM Options를 클릭합니다. Android Studio용 VM 옵션을 편집한 적이 없다면 IDE에서 새로운 studio.vmoptions 파일을 생성하라는 메시지를 표시합니다. Yes를 클릭하여 파일을 생성합니다.
  2. studio.vmoptions 파일이 Android Studio의 에디터 창에서 열립니다. 파일을 편집하여 사용자 지정한 VM 옵션을 추가합니다. 사용자설정이 가능한 JVM 옵션의 전체 목록은 Oracle의 Java HotSpot VM Options 페이지를 참조하세요.

생성된 studio.vmoptions 파일은 Android Studio 설치 폴더 안의 bin/ 디렉토리에 있는 기본 studio.vmoptions 파일에 추가됩니다.

Android Studio 프로그램 폴더의 studio.vmoptions 파일을 직접 편집해서는 안 됩니다. 파일에 액세스해서 Studio의 기본 VM 옵션을 확인할 수는 있지만 studio.vmoptions 파일만 편집하면 Android Studio의 중요한 기본 설정을 재정의하지 못합니다. 그러므로 studio.vmoptions 파일에서 원하는 특성만 재정의하면 Android Studio가 변경하지 않은 특성에 대해서는 기본값을 계속 사용하게 됩니다.

최대 힙 크기

기본적으로 Android Studio의 최대 힙 크기는 1280MB입니다. 큰 프로젝트에서 작업 중이거나 시스템에 RAM 용량이 많은 경우에는, AndroidStudio의 VM 옵션에서 최대 힙 크기를 늘려 성능을 개선할 수 있습니다. 시스템 메모리가 제약되어 있다면 최대 힙 크기를 줄이는 것이 좋습니다.

최대 힙 크기를 변경하려면 다음 단계를 수행하세요.

  1. Help > Edit Custom VM Options를 클릭하여 studio.vmoptions 파일을 엽니다.
  2. studio.vmoptions 파일에 줄을 추가하고 -XmxheapSize 구문을 사용하여 최대 힙 크기를 설정합니다. 선택한 크기는 프로젝트 크기와 컴퓨터에서 사용 가능한 RAM을 고려해야 합니다. 기본적으로 RAM이 4GB 이상이고 중간 규모의 프로젝트라면 최대 힙 크기는 2GB 이상으로 설정해야 합니다. 다음 줄은 최대 힙 크기를 2GB로 설정합니다.
    -Xmx2g
  3. 변경 사항을 studio.vmoptions 파일에 공유하고 변경 사항이 적용되도록 Android Studio를 다시 시작합니다.
  4. 새로운 최대 힙 크기를 확인하려면 명령줄을 열고 다음 명령을 입력하세요.
    jps -lvm

    각각의 인수와 전달되는 인수의 전체 패키지 이름을 포함하여 컴퓨터에서 실행되는 계측된 JVM 목록을 확인할 수 있습니다. Android Studio 인스턴스에 해당하는 항목을 찾습니다. -Didea.paths.selector=AndroidStudio[Version]로 끝나야 합니다. 이 JVM의 경우 -Xmx로 시작하는 인수 2개가 보여야 합니다. 그림 1과 같이 하나는 1280mb의 기본값이고 하나는 새로운 값입니다.

    그림 1. Android Studio JVM의 현재 인수를 보여주는 터미널 출력.

    1. 기본 최대 힙 크기를 보여주는 -Xmx 인수로, 이 경우 1280m입니다.
    2. 현재 실행 중인 Android Studio 버전을 보여주는 -Didea.paths.selector.
    3. 새로 설정된 최대 힙 크기를 보여주는 -Xmx 인수. 위에서 생성한 사용자설정 studio.vmoptions 파일이 뒤따라 옵니다.

IDE 설정 내보내기 및 가져오기

프로젝트에서 선호하는 IDE 설정의 하위 집합 한 개 또는 모두를 포함하는 설정 JAR 파일(Settings.jar)을 내보낼 수 있습니다. 그리고 JAR 파일을 다른 프로젝트로 가져오거나 다른 동료가 프로젝트로 가져갈 수 있도록 JAR 파일을 제공할 수 있습니다.

자세한 내용은 IntelliJ IDEA의 내보내기 및 가져오기 설정을 참조하세요.

IDE 속성 사용자설정

idea.properties 파일에서는 Android Studio의 IDE 속성을 사용자 지정할 수 있습니다. 예를 들어, 사용자가 설치한 플러그인 경로나 IDE가 지원하는 최대 파일 크기를 설정합니다. idea.properties 파일은 IDE의 기본 속성과 병합되므로 재정의 속성만 지정하면 됩니다.

새로운 idea.properties 파일을 생성하거나 기존 파일을 열려면 다음 단계를 수행합니다.

  1. Help > Edit Custom Properties를 클릭합니다. IDE 속성을 한 번도 편집한 적이 없다면 Android Studio가 새로운 idea.properties 파일을 생성하라는 메시지를 표시합니다. Yes를 클릭하여 파일을 생성합니다.
  2. idea.properties 파일이 Android Studio의 에디터 창에서 열립니다. 파일을 편집하여 사용자 지정한 IDE 속성을 추가합니다.

다음 idea.properties 파일에는 일반적으로 사용자 지정된 IDE 속성이 포함되어 있습니다. 전체 속성 목록은 IntelliJ IDEA의 idea.properties 파일을 참조하세요.

#---------------------------------------------------------------------
# Uncomment this option if you want to customize path to user installed plugins folder. Make sure
# you're using forward slashes.
#---------------------------------------------------------------------
# idea.plugins.path=${idea.config.path}/plugins
#---------------------------------------------------------------------
# Maximum file size (kilobytes) IDE should provide code assistance for.
# The larger file is the slower its editor works and higher overall system memory requirements are
# if code assistance is enabled. Remove this property or set to very large number if you need
# code assistance for any files available regardless their size.
#---------------------------------------------------------------------
idea.max.intellisense.filesize=2500
#---------------------------------------------------------------------
# This option controls console cyclic buffer: keeps the console output size not higher than the
# specified buffer size (Kb). Older lines are deleted. In order to disable cycle buffer use
# idea.cycle.buffer.size=disabled
#---------------------------------------------------------------------
idea.cycle.buffer.size=1024
#---------------------------------------------------------------------
# Configure if a special launcher should be used when running processes from within IDE.
# Using Launcher enables "soft exit" and "thread dump" features
#---------------------------------------------------------------------
idea.no.launcher=false
#---------------------------------------------------------------------
# To avoid too long classpath
#---------------------------------------------------------------------
idea.dynamic.classpath=false
#---------------------------------------------------------------------
# There are two possible values of idea.popup.weight property: "heavy" and "medium".
# If you have WM configured as "Focus follows mouse with Auto Raise" then you have to
# set this property to "medium". It prevents problems with popup menus on some
# configurations.
#---------------------------------------------------------------------
idea.popup.weight=heavy
#---------------------------------------------------------------------
# Use default anti-aliasing in system, i.e. override value of
# "Settings|Editor|Appearance|Use anti-aliased font" option. May be useful when using Windows
# Remote Desktop Connection for instance.
#---------------------------------------------------------------------
idea.use.default.antialiasing.in.editor=false
#---------------------------------------------------------------------
# Disabling this property may lead to visual glitches like blinking and fail to repaint
# on certain display adapter cards.
#---------------------------------------------------------------------
sun.java2d.noddraw=true
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under Windows.
#---------------------------------------------------------------------
sun.java2d.d3d=false
#---------------------------------------------------------------------
# Workaround for slow scrolling in JDK6
#---------------------------------------------------------------------
swing.bufferPerWindow=false
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under X Window.
#---------------------------------------------------------------------
sun.java2d.pmoffscreen=false
#---------------------------------------------------------------------
# Workaround to avoid long hangs while accessing clipboard under Mac OS X.
#---------------------------------------------------------------------
# ide.mac.useNativeClipboard=True
#---------------------------------------------------------------------
# Maximum size (kilobytes) IDEA will load for showing past file contents -
# in Show Diff or when calculating Digest Diff
#---------------------------------------------------------------------
# idea.max.vcs.loaded.size.kb=20480

메모리 용량이 낮은 기기의 IDE 구성

권장 사양(시스템 요구사항 참조)보다 낮은 컴퓨터에서 Android Studio를 실행하는 경우 IDE를 설정하여 다음과 같이 컴퓨터의 성능을 개선할 수 있습니다.

Instant Run에 맞춰 프로젝트 구성

Instant Run은 Run Debug 명령의 동작으로, 앱 업데이트 시간을 상당히 단축해줍니다. 첫 빌드를 완료하는 데 오랜 시간이 걸릴 수도 있지만, Instant Run은 새 APK를 빌드하지 않고 후속 업데이트를 앱에 푸시하므로, 변경사항을 훨씬 빨리 확인할 수 있습니다.

Android Studio는 Gradle용 Android 플러그인 2.0.0 이상을 사용하여 빌드한 프로젝트에 대해 기본적으로 Instant Run을 활성화합니다. 프로젝트 설정을 몇 가지 바꾸는 것만으로 Instant Run을 사용하여 빌드 성능을 개선할 수 있습니다. Instant Run에 맞춰 프로젝트를 구성하는 방법에 대한 자세한 내용은Instant Run에 맞춰 프로젝트 구성 및 최적화를 참조하세요.

JDK 버전 설정

최신 OpenJDK 사본은 Android Studio 2.2 이상과 번들로 제공되고 Android 프로젝트에는 이 JDK 버전을 사용하는 것이 좋습니다. 번들된 JDK를 사용하려면 다음 단계를 수행합니다.

  1. Android Studio에서 프로젝트를 열고 메뉴 모음에서 File > Project Structure를 선택합니다.
  2. SDK Location 페이지의 JDK location에서 Use embedded JDK 확인란을 선택합니다.
  3. OK를 클릭합니다.

기본적으로 프로젝트를 컴파일하는 데 사용하는 자바 언어 버전은 프로젝트의 compileSdkVersion을 기반으로 합니다(Android 버전이 달라지면 지원하는 자바도 달라지기 때문입니다). 필요한 경우, CompileOptions {} 블록을 build.gradle 파일에 추가하여 기본 자바 버전을 재정의할 수 있습니다.

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_6
        targetCompatibility JavaVersion.VERSION_1_6
    }
}

compileSdkVersion이 정의된 위치에 대한 자세한 내용은 모듈 수준 빌드 파일을 참조하세요.

프록시 설정

프록시는 HTTP 클라이언트와 웹 서버 간에 중간 연결 지점 역할을 하며 인터넷 연결의 보안과 개인정보 보호 기능을 추가합니다.

Android Studio가 방화벽 뒤에서 실행되도록 지원하려면 Android Studio IDE에 대해 프록시 설정을 구성합니다. Android Studio IDE의 HTTP 프록시 설정 페이지를 사용하여 Android Studio의 HTTP 프록시 설정을 구성합니다.

Gradle용 Android 플러그인을 명령줄에서 실행하거나 Android Studio가 설치되지 않은 기기(예: Continuous Integration 서버)에서 실행하는 경우, Gradle 빌드 파일에서 프록시 설정을 구성합니다.

참고: Android Studio 번들을 처음 설치한 후에는 인터넷 액세스 또는 오프라인으로 Android Studio를 실행할 수 있습니다. 그러나 Android Studio는 Setup Wizard 동기화, 타사 라이브러리 액세스, 원격 저장소 액세스, Gradle 초기화 및 동기화, Android Studio 버전 업데이트를 위해 인터넷 연결이 필요합니다.

Android Studio 프록시 설정

Android Studio는 HTTP 프록시 설정을 지원하므로, 방화벽 또는 보안 네트워크 뒤에서 Android Studio를 실행할 수 있습니다. Android Studio에서 HTTP 프록시 설정을 구성하려면:

  1. 메뉴 모음에서 File > Settings(Mac: Android Studio > Preferences)를 클릭합니다.
  2. 왼쪽 창에서 Appearance & Behavior > System Settings > HTTP Proxy를 클릭합니다. HTTP Proxy 페이지가 나타납니다.
  3. Auto-detect proxy settings를 선택하여 프록시 설정의 자동 프록시 구성 URL을 사용하거나 Manual proxy configuration을 선택하여 각 설정을 직접 입력합니다. 이러한 설정에 대한 자세한 내용은 HTTP Proxy를 참조하세요.
  4. Apply 또는 OK를 클릭하여 변경 사항을 적용합니다.

Gradle용 Android 플러그인 HTTP 프록시 설정

Android 플러그인을 명령줄에서 실행하거나 Android Studio가 설치되지 않은 기기에서 실행하는 경우, Gradle 빌드 파일에서 Gradle용 Android 플러그인 프록시 설정을 구성합니다.

애플리케이션 특정 HTTP 프록시 설정의 경우, 각 애플리케이션 모듈의 필요에 따라 build.gradle 파일에서 프록시 설정을 구성합니다.

apply plugin: 'com.android.application'

android {
    ...

    defaultConfig {
        ...
        systemProp.http.proxyHost=proxy.company.com
        systemProp.http.proxyPort=443
        systemProp.http.proxyUser=userid
        systemProp.http.proxyPassword=password
        systemProp.http.auth.ntlm.domain=domain
    }
    ...
}

프로젝트 범위의 HTTP 프록시 설정의 경우, gradle/gradle.properties 파일에서 프록시 설정을 구성합니다.

# Project-wide Gradle settings.
...

systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=username
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain

systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=443
systemProp.https.proxyUser=username
systemProp.https.proxyPassword=password
systemProp.https.auth.ntlm.domain=domain

...

프록시 설정에 Gradle 속성을 사용하는 방법은 Gradle User Guide를 참조하세요.

참고: Android Studio를 사용할 경우, Android Studio IDE HTTP 프록시 설정 페이지의 설정은 gradle.properties 파일의 HTTP 프록시 설정보다 우선합니다.

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

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

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 short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)