모듈(Module)은 프로젝트를 개별 단위로 나눌 수 있도록 도와주는 실행·빌드 설정과 소스 파일의 집합입니다. '모듈이 지정되지 않음(Module Not Specified)' 오류는 주로 빌드 과정에서 Android Studio가 지정된 모듈을 찾지 못할 때 발생합니다.
Android Studio가 어떤 모듈을 사용해야 할지 파악하지 못하면 이 오류가 화면에 표시됩니다. 가장 확실하게 확인된 원인은 누락되거나 잘못 작성된 Gradle 파일, 잘못된 프로젝트 구조, 그리고 빌드/실행 구성의 문제입니다. 원인을 이해했다면, 지금부터 해결 방법을 하나씩 살펴보겠습니다.
1. Gradle 파일에 모듈 지정하기
Android Studio 프로젝트는 여러 개의 모듈을 포함할 수 있으며, 이 모듈들을 모두 settings.gradle 파일에 선언하는 것이 중요합니다. 프로젝트의 각 부분이 정상적으로 작동하려면 서로 다른 모듈에 의존할 수 있기 때문입니다.
Gradle 파일에 모든 모듈을 포함하면 IDE와 빌드 시스템이 필요한 모듈을 정확히 식별하고 사용할 수 있습니다. 특히 멀티 모듈 프로젝트에서는 이 과정이 필수적입니다.
- Android Studio에서 프로젝트를 엽니다.
- 파일 탐색기에서 app 모듈 외에 다른 모듈이 존재하는지 확인합니다.
- settings.gradle 파일을 찾아 엽니다.
- 다음 줄을 추가합니다.
include 'Application', 'app'(모듈 이름은 쉼표로 구분) - 필요한 모든 모듈을 추가한 후 Sync Now를 클릭합니다.
- 동기화가 완료되면 "Edit Run/Debug Configuration"(실행/디버그 구성 편집) 대화상자로 이동합니다.
- 적절한 모듈을 선택한 뒤 프로젝트를 실행(Run)합니다.
2. 백신 프로그램 비활성화 후 Gradle 파일 수동 동기화
일부 백신 프로그램은 파일 접근을 차단하거나 Gradle의 네트워크 활동을 제한하여 빌드 프로세스를 방해할 수 있습니다. Gradle은 빌드 시스템을 업데이트하거나 의존성을 다운로드할 때 네트워크 접근이 반드시 필요하기 때문입니다. 백신 프로그램을 일시적으로 비활성화하면 Android Studio가 원활하게 동기화를 수행하는 데 도움이 됩니다.
백신 프로그램 비활성화하기
먼저 백신 프로그램(일반적으로 Windows Defender)을 일시적으로 비활성화합니다.
- 작업 표시줄에서 Windows 보안 아이콘을 두 번 클릭합니다.
- Windows 보안에서 바이러스 및 위협 방지 메뉴로 이동합니다.
- 아래로 스크롤하여 바이러스 및 위협 방지 설정에서 설정 관리를 클릭합니다.
- 실시간 보호를 끕니다.
Gradle 파일 수동 동기화하기
백신 프로그램을 비활성화한 후, Gradle 파일을 수동으로 동기화하여 Android Studio가 빌드 프로세스를 다시 구성하도록 합니다.
- Android Studio에서 프로젝트를 엽니다.
- 상단 메뉴 표시줄에서 File을 클릭합니다.
- Sync Project with Gradle Files를 선택합니다.
- 동기화가 완료되면 프로젝트를 다시 실행합니다.
3. .idea 폴더 삭제하기
.idea 폴더에는 프로젝트 구조와 Gradle 구성 등 Android Studio의 핵심 설정이 저장됩니다. 이 폴더가 손상되었거나 프로젝트와 동기화되지 않은 상태라면 해당 오류가 발생할 수 있습니다.
.idea 폴더를 삭제하고 프로젝트를 다시 열면 Android Studio가 최신 설정으로 폴더를 새로 생성합니다. 이를 통해 잘못된 구성 문제를 해결하고 모듈을 올바르게 식별할 수 있습니다.
- 프로젝트 디렉터리에서 .idea 폴더를 마우스 오른쪽 버튼으로 클릭하여 삭제합니다.
- Android Studio를 닫은 후 다시 실행합니다.
- 하단에 "Load Gradle Project" 알림이 나타납니다.
- 알림을 클릭하고 동기화가 완료될 때까지 기다립니다.
- 동기화가 끝나면 프로젝트를 다시 실행합니다.
마무리
위 세 가지 방법만으로도 대부분의 '모듈이 지정되지 않음' 오류를 해결할 수 있습니다. 먼저 settings.gradle 파일에 모듈이 올바르게 선언되어 있는지 확인하고, 문제가 지속되면 백신 프로그램을 비활성화한 상태에서 Gradle을 수동 동기화하거나 .idea 폴더를 삭제해 초기화해 보세요.
저자 소개
Hamza Mohammad Anwar
Hamza Mohammad Anwar는 MERN 기술 스택을 활용한 고성능 애플리케이션 개발을 전문으로 하는 JavaScript 웹 개발자입니다. ReactJS, MongoDB, Express, NodeJS 등 관련 기술에 대한 전문성을 갖추고 있으며, Google IT 인증 전문가 자격도 보유하고 있습니다. 문제 해결에 대한 열정이 뛰어난 그는 다양한 기술적 문제를 해결하기 위해 직접 오류를 재현하고 분석하며 솔루션을 찾습니다.