react-native로 개발하기 :: 클린빌드

React Native에서의 gradle 에러 해결하기

클린빌드란 무엇인가?

React Native에서 gradle에 관련된 오류를 종종 만날 수 있다.

나는 아래 와 같은 경우에서 이 gradle이라는 친구가 속을 썩였었다.

- 디펜던시를 추가하고 작업하다가 다른 PC에서 작업을 시작하려고 할 때
- 협업을 하던 중 팀원의 코드와 병합하고 풀을 땡겨서 작업을 시작하려고 때

그 때 해결한 방법이 "클린빌드"라는 방법인데 오늘은 이 "클린빌드"가 어떤 것인지, 어떻게 하는지 알아보자.

 "클린 빌드"는 프로젝트를 처음부터 다시 빌드하고 이전 빌드의 결과물을 완전히 지우는 작업을 말한다. 클린 빌드는 개발 과정에서 발생하는 일부 문제를 해결하고 빌드 환경을 초기화하여 일관된 빌드 환경을 유지하는 데 도움이 됩니다.
 즉,  개발과정에서 환경설정에 대한 문제들이 발생했다면 이 "클린빌드"가 해결책일 수 있다는 것이다.

그럼, 클린빌드를 하면 어떻게 되는건데?

1. 이전 빌드의 결과물 삭제 :
클린 빌드는 이전에 생성된 빌드 아웃풋 폴더를 삭제함으로써 새로운 빌드를 위한 깨끗한 상태를 만든다.

2. 빌드 캐시 초기화 :
클린 빌드는 이전 빌드에서 생성된 캐시 파일을 제거한다. 빌드 캐시는 변경되지 않은 파일들을 재빌드하지 않고 이전 결과물을 재사용하는 데 사용되는데 클린 빌드를 통해 모든 파일이 다시 빌드되어 일관된 상태로 만들 수 있게 해준다.

3.종속성 재설치 :
클린 빌드는 종속성 패키지를 새로 다운로드하고 설치한다. 이는 프로젝트에 사용되는 패키지가 최신 상태로 유지되며, 종속성 충돌 등의 문제를 방지하는 데 도움이 된다.

정리해보면 기존에 있던 것들과 더해진 것들로 인해 일관되지 않아지는 것들을 일관되도록 만들어주는 작업이다.

 

클린빌드를 하는 방법은 매우 간단하다.

1. 먼저 프로젝트의 아웃풋 폴더들을 지워준다. (android/build, ios/build)
2. package.json 파일을 삭제하고 다시 설치해준다.
3. 플랫폼마다 클린빌드 명령을 실행한다.
- android ::
   루트 폴더에서 cd android 명령어를 통해 android 폴더로 접근해서 ./gradlew clean 명령어를 실행해준다.
- ios ::
    Xcode에서 "Product" 메뉴에서 "Clean Build Folder"를 선택하거나 cmd + shift + k 단축키를 실행한다.

이런 에러를 만나더라도 클린빌드를 통해 해결할 수 있다는 것!