Skip to content

Most visited

Recently visited

navigation

명령줄에서 앱 빌드

Gradle 래퍼 명령줄 도구를 사용해 Android 프로젝트에 대해 지원되는 빌드 작업을 전부 실행할 수 있습니다. Windows에는 배치 파일(gradlew.bat)로, Linux와 Mac에는 셸 스크립트(gradlew.sh)로 사용할 수 있고, Android Studio로 생성하는 각 프로젝트의 루트에서 액세스 가능합니다.

래퍼에서 작업을 실행하려면, 다음 명령 중 하나를 사용합니다.

프로젝트에 사용 가능한 모든 빌드 작업의 목록을 보려면 tasks를 실행하세요.

gradlew tasks

이 페이지의 나머지 부분에서는 Gradle 래퍼로 앱을 빌드하고 실행하기 위한 기본 사항에 대해 설명합니다. Android 빌드의 설정 방법에 대한 자세한 정보는 빌드 구성을 참조하세요.

명령줄 도구 대신 Android Studio 도구를 사용할 생각이라면 앱 빌드 및 실행을 참조하세요.

빌드 유형 정보

기본적으로, 어떤 Android 앱에 대해서든 두 가지 빌드 유형을 사용할 수 있습니다. 하나는 앱을 디버그하기 위한 빌드이고(디버그 빌드), 다른 하나는 앱을 사용자에게 릴리스하기 위한 빌드입니다(릴리스 빌드). 각 빌드에서 최종적으로 얻은 결과 APK는 먼저 인증서로 서명해야 에뮬레이터나 기기에 설치할 수 있습니다. 디버그 빌드는 SDK 도구에서 제공되는 디버그 키로 자동으로 서명되고(안전하지 않으므로 이 APK를 Google Play Store에 게시할 수 없음), 릴리스 빌드는 자신의 개인 키로 서명해야 합니다.

릴리스할 APK를 빌드하려는 경우에는 먼저 앱 서명을 읽어보세요. 개인 키를 생성한 후 이 키로 APK 파일을 서명하는 절차에 대한 설명을 볼 수 있습니다. 하지만 이제 막 시작한 초보자라면 디버그 APK를 빌드하여 에뮬레이터나 연결된 기기에서 앱을 빠르게 실행할 수 있습니다.

build.gradle 파일에서 사용자설정 빌드 유형을 정의하고 debuggable true를 포함시켜 이 유형이 디버그 빌드로 서명되도록 구성할 수도 있습니다. 자세한 내용은 빌드 변형 구성을 참조하세요.

디버그 APK 빌드

즉각적인 앱 테스트와 디버깅을 위해 디버그 APK를 빌드할 수 있습니다. 디버그 APK는 SDK 도구에서 제공되는 디버그 키로 서명되며 adb를 통한 디버깅을 허용합니다.

디버그 APK를 빌드하려면 명령줄을 열고 프로젝트 디렉토리의 루트로 이동합니다. Android Studio에서 View > Tool Windows > Terminal을 선택하세요. 디버그 빌드를 시작하려면 다음과 같이 assembleDebug 작업을 호출하세요.

gradlew assembleDebug

그러면 project_name/module_name/build/outputs/apk/module_name-debug.apk라는 이름의 APK가 생성됩니다. 이 파일은 이미 디버그 키로 서명되고 zipalign으로 맞춰져 있으므로 기기에 바로 설치할 수 있습니다.

또는 APK를 빌드하고 실행 중인 에뮬레이터나 연결된 기기에 즉시 설치하려면 아래와 같이 installDebug를 대신 호출하세요.

gradlew installDebug

위 작업 이름에서 "Debug" 부분은 빌드 변형 이름을 카멜 표기법으로 나타낸 것일 뿐이므로, 어셈블하거나 설치하려는 빌드 변형으로 자유롭게 바꿀 수 있습니다. 예를 들어, "데모" 제품 버전이 있을 경우에는 assembleDemoDebug 작업으로 디버그 버전을 빌드할 수 있습니다.

(제거 작업을 포함하여) 각 변형에 사용 가능한 모든 빌드 및 설치 작업을 보려면 tasks 작업을 실행하세요.

에뮬레이터에서 앱 실행기기에서 앱 실행 방법에 대한 섹션도 참조하세요.

릴리스 APK 빌드

앱을 릴리스하고 배포할 준비가 되면 개인 키로 서명된 릴리스 APK를 빌드해야 합니다.

자세한 정보는 앱 서명을 참조하세요.

에뮬레이터에서 앱 실행

Android Emulator를 사용하려면 Android Studio로 AVD(Android Virtual Device)를 생성해야 합니다.

AVD가 생성되면 Android Emulator를 시작하고 다음과 같이 앱을 설치하세요.

  1. 명령줄에서 android_sdk/tools/를 탐색하고 AVD를 지정하여 에뮬레이터를 시작하세요.

    emulator -avd avd_name

    AVD 이름을 확실히 모르면 emulator -list-avds를 실행하세요.

  2. 위에서 언급한 Gradle 설치 작업이나 adb 도구를 사용하여 앱을 설치할 수 있습니다.
    adb install path/to/your_app.apk
    

    빌드된 APK는 전부 project_name/module_name/build/outputs/apk/에 저장됩니다.

자세한 정보는 Android Emulator에서 앱 실행을 참조하세요.

기기에서 앱 실행

기기에서 앱을 실행할 수 있으려면 먼저 기기에서 USB 디버깅을 활성화해야 합니다. 이 옵션은 Settings > Developer options에서 찾을 수 있습니다.

참고: Android 4.2 이상의 버전에서는 Developer options가 기본적으로 숨겨져 있습니다. 이 옵션을 활성화하려면 Settings > About phone으로 이동하여 Build number를 일곱 번 누릅니다. 이전 화면으로 돌아가서 Developer options를 찾습니다.

기기를 설정하고 USB를 통해 연결하고 나면, 위에서 언급한 Gradle 설치 작업이나 adb 도구를 사용하여 앱을 설치할 수 있습니다.

adb -d install path/to/your_app.apk

빌드된 APK는 전부 project_name/module_name/build/outputs/apk/에 저장됩니다.

자세한 내용은 하드웨어 기기에서 앱 실행을 참조하세요.

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!

Follow Google Developers on WeChat

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)