Skip to content

Most visited

Recently visited

navigation

프로젝트 개요

Android Studio의 프로젝트에는 소스 코드 및 자산에서 테스트 코드 및 빌드 구성에 이르기까지 앱에 대한 작업 영역을 정의하는 모든 항목이 포함됩니다. 새 프로젝트를 시작하면 Android Studio에서 모든 파일에 필요한 구조를 생성하고 이를 IDE 왼쪽에 있는 Project 창(View > Tool Windows > Project 클릭)에 표시합니다. 이 페이지에서는 프로젝트에 포함된 주요 구성 요소에 대한 개요를 제공합니다.

모듈

모듈은 소스 파일 및 빌드 설정으로 구성된 모음이며, 이를 통해 프로젝트를 별개의 기능 단위로 분할할 수 있습니다. 프로젝트에는 하나 이상의 모듈이 포함될 수 있으며, 하나의 모듈이 다른 모듈을 종속성으로 사용할 수 있습니다. 각 모듈은 개별적으로 빌드, 테스트 및 디버그할 수 있습니다.

자체 프로젝트 내에서 코드 라이브러리를 생성하거나 기기 유형(예: 휴대폰 및 웨어러블 기기)별로 각각 다른 코드 및 리소스 집합을 생성하되, 모든 파일의 범위를 동일한 프로젝트 내로 유지하고 일부 코드를 공유하려는 경우 모듈을 추가하는 것이 유용한 때가 많습니다.

File > New > New Module을 클릭하여 프로젝트에 새 모듈을 추가할 수 있습니다.

Android Studio에서는 몇 가지 서로 다른 모듈 유형을 제공합니다.

Android 앱 모듈
앱 소스 코드, 리소스 파일, 앱 수준 설정(예: 모듈 수준의 빌드 파일 및 Android 매니페스트 파일)을 포함할 수 있는 컨테이너를 제공합니다. 새 프로젝트를 생성할 때 기본 모듈 이름은 "app"으로 지정됩니다.

Android Studio는 Create New Module 창에서 다음과 같은 앱 모듈을 제공합니다.

  • Phone & Tablet 모듈
  • Android Wear 모듈
  • Android TV 모듈
  • Glass 모듈

이러한 모듈은 각각 해당 앱 또는 기기 유형에 적합한 일부 코드 템플릿과 필수 파일을 제공합니다.

모듈을 추가하는 방법에 대한 자세한 내용은 새 기기를 위한 모듈 추가를 참조하세요.

라이브러리 모듈
다른 앱 모듈에서 종속성으로 사용하거나 다른 프로젝트로 가져올 수 있는 재사용 가능한 코드를 포함할 수 있는 컨테이너를 제공합니다. 라이브러리 모듈은 구조적으로 앱 모듈과 같습니다. 단, 빌드될 때 APK가 아니라 코드 아카이브 파일이 생성되므로 기기에 설치할 수 없습니다.

Android Studio는 Create New Module 창에서 다음과 같은 라이브러리 모듈을 제공합니다.

  • Android 라이브러리: 이 유형의 라이브러리는 소스 코드, 리소스 및 매니페스트 파일을 비롯하여 Android 프로젝트에서 지원되는 모든 파일 형식을 포함할 수 있습니다. 빌드 결과로 AAR(Android Archive) 파일이 생성되며, 이 파일은 Android 앱 모듈에 대한 종속성으로 추가할 수 있습니다.
  • Java 라이브러리: 이 유형의 라이브러리는 Java 소스 파일을 포함할 수 있습니다. 빌드 결과로 JAR(Java Archive) 파일이 생성되며, 이 파일은 Andriod 앱 모듈 또는 기타 Java 프로젝트에 대한 종속성으로 추가할 수 있습니다.
Google 클라우드 모듈
Google 클라우드 백엔드 코드를 포함할 수 있는 컨테이너를 제공합니다. 이 모듈은 단순한 HTTP, Cloud Endpoints 및 Cloud Messaging을 사용하여 앱에 연결하는 Java App Engine 백엔드에 대한 종속성 및 필수 코드를 추가합니다. 백엔드를 개발하여 앱에 필요한 클라우드 서비스를 제공할 수 있습니다.

Android Studio를 사용하여 Google 클라우드 모듈을 생성하고 개발하면 같은 프로젝트에서 앱 코드 및 백엔드 코드를 관리할 수 있습니다. 또한, 백엔드 코드를 로컬로 실행하고 테스트한 후 Android Studio를 사용하여 Google 클라우드 모듈을 배포할 수 있습니다.

Google 클라우드 모듈을 추가하는 방법에 대한 자세한 내용은 App Engine Java 서블릿 모듈 추가를 참조하세요. Google 클라우드 모듈을 실행하고 배포하는 방법에 대한 자세한 내용은 백엔드 실행, 테스트 및 배포를 참조하세요.

몇몇 사람들은 모듈을 하위 프로젝트라고 지칭하기도 하는데 괜찮습니다. Gradle도 모듈을 프로젝트로 나타내기 때문입니다. 예를 들어, 라이브러리 모듈을 생성하고 이를 종속성으로 Android 앱 모듈에 추가하려는 경우 다음과 같이 이 모듈을 선언해야 합니다.

dependencies {
  compile project(':my-library-module')
}

프로젝트 파일

Android Studio는 기본적으로 Android 뷰에 프로젝트 파일을 표시합니다. 이 뷰는 디스크에 있는 실제 파일 계층 구조를 반영하지는 않지만, 모듈 및 파일 형식별로 구성되어 있으며 자주 사용되지 않는 파일이나 디렉토리는 숨기므로 프로젝트의 주요 소스 파일들을 간단하게 탐색할 수 있습니다. 디스크 상의 구조와 비교하여 몇 가지 구조적으로 변경된 사항은 다음과 같습니다.

각 Android 앱 모듈 내에서 파일은 다음 그룹에 표시됩니다.

manifests
AndroidManifest.xml 파일을 포함합니다.
java
JUnit 테스트 코드를 비롯한 Java 소스 코드 파일을 포함합니다. 이들 파일은 패키지 이름별로 구분됩니다.
res
코드가 아닌 모든 리소스(예: XML 레이아웃, UI 문자열, 비트맵 이미지 등)를 포함합니다. 이들 리소스는 해당 하위 디렉토리로 나뉩니다. 가능한 모든 리소스 유형에 대한 자세한 내용은 리소스 제공을 참조하세요.

Android 프로젝트 뷰

Android 뷰에서 숨겨진 모든 파일을 포함하여 프로젝트의 실제 파일 구조를 보려면 Project 창의 맨 위에 있는 드롭다운에서 Project를 선택합니다.

Project 뷰를 선택하면 훨씬 더 많은 파일과 디렉토리를 볼 수 있습니다. 그 중 가장 중요한 디렉토리는 다음과 같습니다.

module-name/
build/
빌드 출력을 포함합니다.
libs/
비공개 라이브러리를 포함합니다.
src/
다음 하위 디렉토리에 모듈에 대한 모든 코드 및 리소스 파일을 포함합니다.
androidTest/
Android 기기에서 실행되는 계측 테스트에 대한 코드를 포함합니다. 자세한 내용은 Android 테스트 문서를 참조하세요.
main/
"기본" 소스 세트 파일, 즉 모든 빌드 변형이 공유하는 Android 코드 및 리소스(디버그 빌드 유형의 경우 src/debug/와 같이 형제 디렉토리에 있는 다른 빌드 변형의 파일)를 포함합니다.
AndroidManifest.xml
애플리케이션의 특성 및 각 구성 요소를 설명합니다. 자세한 내용은 AndroidManifest.xml 문서를 참조하세요.
java/
Java 코드 소스를 포함합니다.
jni/
JNI(Java Native Interface)를 사용하는 네이티브 코드를 포함합니다. 자세한 내용은 Android NDK 문서를 참조하세요.
gen/
Android Studio에서 생성하는 Java 파일(예: R.java 파일) 및 AIDL 파일에서 생성되는 인터페이스를 포함합니다.
res/
애플리케이션 리소스(예: 드로어블 파일, 레이아웃 파일 및 UI 문자열)를 포함합니다. 자세한 내용은 애플리케이션 리소스를 참조하세요.
assets/
.apk 파일로 있는 그대로 컴파일되어야 하는 파일을 포함합니다. URI를 사용하여 일반적인 파일 시스템과 같은 방식으로 이 디렉토리를 탐색하고 AssetManager 를 사용하여 바이트 스트림으로 파일을 읽어 올 수 있습니다. 예를 들어, 이는 텍스처 및 게임 데이터에 사용할 수 있는 훌륭한 위치입니다.
test/
호스트 JVM에서 실행되는 로컬 테스트의 코드를 포함합니다.
build.gradle(모듈)
이는 모듈별 빌드 구성을 정의합니다.
build.gradle(프로젝트)
이는 모든 모듈에 적용되는 빌드 구성을 정의합니다. 이 파일은 프로젝트에 반드시 필요하므로, 기타 모든 소스 코드와 함께 수정 버전 제어에서 유지해야 합니다.

기타 빌드 파일에 대한 자세한 내용은 빌드 구성을 참조하세요.

프로젝트 구조 설정

Android Studio 프로젝트에 대한 다양한 설정을 변경하려면 File > Project Structure를 클릭하여 Project Structure 대화상자를 엽니다. 여기에는 다음 섹션이 포함되어 있습니다.

Developer Services

Project Structure 대화상자의 Developer Services 섹션에는 앱에 사용할 수 있는 여러 서비스에 대한 구성 페이지가 포함되어 있습니다. 이 섹션에는 다음과 같은 페이지가 들어 있습니다.

이러한 서비스를 활성화하면 Android Studio가 필요한 종속성 및 권한을 앱에 추가할 수 있습니다. 각 구성 페이지에는 이들 항목과 함께, 관련 서비스를 활성화하는 경우 Android Studio에서 수행하는 기타 작업이 나열됩니다.

Modules

Modules 설정 섹션에서는 각 프로젝트 모듈에 대한 구성 옵션을 변경할 수 있습니다. 각 모듈의 설정 페이지는 다음 탭으로 나뉘어 있습니다.

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

Hooray!

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.