android studio refactor를 이용해서 패키지명을 바꾸었을 때 R 인식을 못하는 이유는? 해결 방법은?

Android Studio에서 패키지 이름을 바꿀 때 R 클래스를 인식하지 못하는 이유는 주로 두 가지입니다.

 

1. 빌드 오류: 패키지 이름을 변경하면 기존에 생성된 R 클래스의 경로가 변경되어 빌드 시 R 클래스를 찾을 수 없는 오류가 발생할 수 있습니다.
2. Import 문제: 패키지 이름을 변경하면 기존에 사용되던 import 문이 잘못된 패키지 경로를 가리키게 되어 R 클래스를 찾을 수 없는 문제가 발생할 수 있습니다.

 

이 문제를 해결하기 위해 다음 단계를 따라서 진행할 수 있습니다.

 

1. Build → Clean Project를 실행하여 빌드 캐시를 제거합니다. 이렇게 하면 이전에 생성된 R 클래스가 제거됩니다.
2. Refactor 기능을 사용하여 패키지 이름을 변경합니다. 이를 통해 모든 클래스 파일과 패키지 경로가 변경됩니다.
3. 변경된 패키지 이름이 반영된 import 문을 확인합니다. 필요한 경우 import 문을 수정하여 올바른 패키지 경로를 가리키도록 합니다.
4. Build → Rebuild Project를 실행하여 프로젝트를 다시 빌드합니다. 이렇게 하면 새로운 패키지 이름에 맞는 R 클래스가 생성됩니다.

 

이 단계를 따르면 R 클래스가 패키지 이름 변경을 올바르게 반영하고 인식할 수 있게 됩니다.

 

그림 1.

위 방법으로도 R 인식이 안되어서 android studio File 메뉴에서 Invalidate Caches를 선택해서 안드로이드 스튜디오를 재시작했습니다.

그래도 인식이 안되었습니다.

 

 

그림 2.

결론은 그림 2.처럼 AndroidManifest.xml 파일 최상단 package 정보에 전체 패키지 정보가 없이 변경된 이름만 있어서 발생된 문제였습니다.

 

예를 들어 기존 "com.example.old"에서 new로 refactor를 했을 때 "com.example.new"로 변경이 되어야 하는데 "new"로만 변경되어 R 인식을 못했던 경우입니다. 전체 패키지로 변경하니 R 인식이 잘 되었습니다.