새 기기를 위한 모듈 추가

모듈은 앱 소스 코드, 리소스 파일, 앱 수준 설정(예: 모듈 수준의 빌드 파일 및 Android 매니페스트 파일)을 포함할 수 있는 컨테이너를 제공합니다. 각 모듈은 개별적으로 빌드, 테스트 및 디버그할 수 있습니다.

Android Studio는 모듈을 사용하여 새 기기에 프로젝트를 쉽게 추가할 수 있습니다. Android Studio에서 간단한 절차를 따라 하면 Wear OS나 Android TV와 같이 기기 유형에 맞는 코드가 포함된 모듈을 생성할 수 있습니다. Android Studio는 모듈 디렉토리(예: source, resource)와 기기 유형에 맞는 기본 build.gradle 파일을 자동으로 생성합니다. 또한, Android Studio는 권장 빌드 구성으로 기기 모듈을 생성합니다. 예를 들어 Android TV 모듈에는 Leanback 라이브러리를 사용합니다.

이 페이지에서는 특정 기기에 새 모듈을 추가하는 방법을 설명합니다.

또한 Android Studio에서는 프로젝트에 라이브러리나 Google 클라우드 모듈을 쉽게 추가할 수 있습니다. 라이브러리 모듈 생성에 대한 자세한 내용은 라이브러리 모듈 생성을 참조하세요.

새 모듈 생성

새 기기에 맞게 프로젝트에 새 모듈을 추가하려면 다음 절차를 따르세요.

  1. File > New > New Module을 클릭합니다.
  2. Create New Module 창이 나타나면 Android Studio에서 다음 기기 모듈을 제공합니다.
    • Phone & Tablet 모듈
    • Wear OS 모듈
    • Android TV 모듈
    • Glass 모듈
    원하는 기기에 맞는 모듈을 선택하고 Next를 클릭합니다.
  3. Configure your new module 양식에 다음 정보를 입력합니다.
    • Application Name: 이 이름은 새 모듈에서 앱 런처 아이콘 제목으로 사용됩니다.
    • Module Name: 이 텍스트는 소스 코드와 리소스 파일이 있는 폴더 이름으로 사용됩니다.
    • Package Name: 모듈 내 코드의 Java 네임스페이스입니다. 모듈의 Android 매니페스트 파일package 속성으로 추가됩니다.
    • Minimum SDK: 이 설정은 앱 모듈이 지원하는 Android 플랫폼의 가장 낮은 버전을 나타냅니다. 이 값은 build.gradle 파일의 minSdkVersion 속성을 설정하며, 나중에 편집할 수 있습니다.

    이어서 Next를 클릭합니다.

  4. 선택한 기기 모듈에 따라 다음 페이지에 선택 가능한 적절한 코드 템플릿이 표시됩니다. 이 코드 템플릿을 선택하여 메인 액티비티로 사용할 수 있습니다. 시작하고 싶은 액티비티 템플릿을 클릭하고 Next를 클릭합니다. 액티비티가 필요 없다면 Add No ActivityFinish를 차례로 클릭합니다. 그러면 작업이 완료됩니다.
  5. 액티비티 템플릿을 선택했다면 Customize the Activity 페이지에 액티비티 설정을 입력합니다. 대부분 템플릿은 Activity Name, Layout Name, Title이 필요하지만 템플릿마다 액티비티별 설정이 있습니다. Finish를 클릭합니다. 액티비티 템플릿으로 앱 모듈을 생성하면 기기에서 바로 모듈을 실행하고 테스트할 수 있습니다.

Android Studio에서 새 기기에 필요한 모든 파일을 생성하고 새 모듈의 Gradle 파일과 프로젝트를 동기화합니다. 새 기기에 모듈을 추가하면 모듈 빌드 파일에 대상 기기에 필요한 종속성도 모두 추가됩니다.

Gradle 프로젝트 동기화가 완료되면 새 모듈이 왼쪽의 Project 창에 표시됩니다. 새 모듈 폴더가 보이지 않을 경우 창에 Android 뷰가 표시되는지 확인합니다.

모듈 가져오기

기존 모듈을 프로젝트로 가져오려면 다음 절차를 따르세요.

  1. File > New > Import Module을 클릭합니다.
  2. Source directory 상자에 가져오고 싶은 모듈 디렉토리를 입력하거나 선택합니다.
    • 하나의 모듈을 가져오려면 그 모듈의 루트 디렉토리를 입력합니다.
    • 하나의 프로젝트에서 여러 모듈을 가져오려면 프로젝트 폴더를 입력합니다. 폴더 안에 있는 모듈마다 상자가 나타나고, 소스 위치모듈 이름이 표시됩니다. 가져오고자 하는 모듈에 전부 Import 상자가 선택되어 있는지 확인합니다.
    모듈에 다른 종속성이 있으면 Additional required modules에 가져올 대상 목록으로 표시됩니다.
  3. Module name 필드에 원하는 모듈 이름을 입력합니다.
  4. Finish를 클릭합니다.

모듈을 가져오면 왼쪽의 Project 에 나타납니다.

다음 단계

새 모듈을 추가하고 나면 모듈 코드와 리소스를 수정하고, 모듈 빌드 설정을 구성하고, 모듈을 빌드할 수 있습니다. 또한 다른 앱과 마찬가지로 모듈을 실행하고 디버그할 수도 있습니다.

새 기기를 적절히 지원하기 위해 코드와 리소스를 추가하고 싶을 수도 있습니다. 여러 가지 기기 유형에 맞는 앱 모듈을 개발하는 방법에 대한 자세한 내용은 각 문서를 참조하세요.

새 모듈을 개발할 때 이미 다른 앱 모듈에 복제된 기기 독립적인 코드를 생성할 수 있습니다. 중복 코드를 유지하는 대신 공통적인 코드를 라이브러리 모듈로 옮기고 라이브러리를 앱 모듈에 종속성으로 추가하는 것이 좋습니다. 라이브러리 모듈 생성과 이를 종속성으로 추가하는 방법에 대한 자세한 내용은 Android 라이브러리 생성을 참조하세요.