새 기기를 위한 모듈 추가

모듈은 앱의 소스 코드, 리소스 파일, 그리고 모듈 수준 빌드 파일과 Android 매니페스트 파일 같은 앱 수준 설정을 위한 컨테이너를 제공합니다. 각 모듈은 개별적으로 빌드, 테스트 및 디버그할 수 있습니다.

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

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

또한 Android 스튜디오를 사용하면 프로젝트에 라이브러리나 Google Cloud 모듈을 쉽게 추가할 수 있습니다. 라이브러리 모듈을 만드는 자세한 방법은 라이브러리 모듈 만들기를 참고하세요.

새 모듈 만들기

새 기기를 위해 프로젝트에 새 모듈을 추가하려면 다음 단계를 진행하세요.

  1. File > New > New Module을 클릭합니다.
  2. 표시된 Create New Module 창에서 Android 스튜디오가 제공하는 기기 모듈은 다음과 같습니다.
    • 스마트폰 및 태블릿 모듈
    • 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 Activity와 Finish를 차례로 클릭하여 완료합니다.
  5. 활동 템플릿을 선택했다면 Customize the Activity 페이지에 활동을 위한 설정을 입력합니다. Activity Name, Layout Name, Title 및 Source Language는 대부분의 템플릿에서 요구하며 각각의 템플릿에 활동별 설정이 있습니다. Finish를 클릭합니다. 활동 템플릿으로 앱 모듈을 만들면 기기에서 즉시 모듈을 실행하고 테스트할 수 있습니다.

Android 스튜디오는 새 모듈에 필요한 모든 파일을 만들고 새 모듈의 gradle 파일과 프로젝트를 동기화합니다. 새 기기를 위해 모듈을 추가하면 대상 기기에 필요한 모든 종속 항목도 모듈의 빌드 파일에 추가됩니다.

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

모듈 가져오기

기존 모듈을 프로젝트로 가져오려면 다음 단계를 진행하세요.

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

모듈을 가져오면 왼쪽 Project 창에 표시됩니다.

다음 단계

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

또한, 새 기기를 제대로 지원하기 위해 코드와 리소스를 추가할 수도 있습니다. 여러 기기 유형에 맞는 앱 모듈을 개발하는 방법에 관한 자세한 내용은 아래의 문서를 참고하세요.

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