Android에서 패키지 이름을 변경하는 방법
Android 프로젝트를 개발하다 보면 패키지 이름(package name)을 변경해야 하는 경우가 종종 있습니다. Android Studio에서는 리팩터링(Refactor) 기능을 사용하면 몇 번의 클릭만으로 패키지 이름을 안전하게 변경할 수 있습니다. 아래 단계를 따라 해보세요.
1단계: 패키지 선택 후 Rename 실행
프로젝트 소스 트리(Source Tree)에서 변경하려는 패키지 이름을 클릭한 뒤, 마우스 오른쪽 버튼을 누르고 Refactor → Rename을 선택합니다.
2단계: Rename 팝업 확인
Rename을 클릭하면 아래와 같은 팝업 창이 나타납니다.
3단계: Rename Package 선택
팝업에서 Rename Package를 클릭합니다. 이 옵션은 디렉터리 이름만 변경하는 것이 아니라 실제 패키지 전체를 대상으로 합니다.
4단계: 새 패키지 이름 입력
새로운 팝업 창이 나타나면 원하는 새 패키지 이름을 입력하고 Refactor 버튼을 클릭합니다.
5단계: 리팩터링 미리보기 검토
Android Studio가 프로젝트 내 모든 파일을 자동으로 검사하고, 변경이 필요한 코드 목록을 미리보기 형태로 보여줍니다.
6단계: Do Refactor 버튼 클릭
Android Studio 하단에 있는 Do Refactor 버튼을 클릭하여 리팩터링을 최종 적용합니다. 그다음 build.gradle 파일을 열어 확인합니다.
7단계: build.gradle의 applicationId 수정
리팩터링 후에도 build.gradle 파일에는 여전히 이전 패키지 이름이 남아 있을 수 있습니다. applicationId와 namespace 값을 새 패키지 이름으로 직접 수정해 주세요.
8단계: 클린 및 재빌드
마지막으로 메뉴에서 Build → Clean Project를 실행한 뒤 Build → Rebuild Project를 클릭하면 모든 과정이 완료됩니다.
마무리
이렇게 하면 Android Studio에서 패키지 이름을 손쉽게 변경할 수 있습니다. 리팩터링 기능을 사용하면 코드 전체에서 참조되는 패키지 경로가 일괄 업데이트되므로 수동으로 파일을 하나씩 수정할 필요가 없습니다. 다만 build.gradle의 applicationId는 별도로 확인하고 수정해야 한다는 점을 꼭 기억하세요.