[React-Native] 리액트 네이티브 버전 업그레이드시 참고할 사이트

 

최근에 리액트 네이티브로 개발할 일이 있어서 난생 처음으로 리액트 네이티브 개발환경을 구축해보았다.

 

해당 프로젝트에서 내 임무는, Android SDK31 (안드로이드11) 기준으로 targetSdk 된 소스를, 플레이스토어에 다시 올리기 위해 SDK34 이상으로 올려야하는 것이였다.

 

말로는 간단해보이지만, 사실 이런 크로스플랫폼 언어로는 굉장히 까다로운 작업이다.

 

1. android 의존성 폴더 내 gradle과 모든 config를 SDK34 기준으로 업데이트 (gradle, agp 버전 업 등이 있겠다)

2. 안드로이드 버전 업데이트에 따른 react-native 라이브러리 업데이트 (내 기준 0.71.5에서 0.74.0으로 업데이트 해야 빌드가 되는 상황이였다.)

3. react-native 라이브러리 업데이트에 따른 모든 의존성 라이브러리 버전 compatibility 체크 -> 이게 가장 골치아팠다. react-native-reanimated와 같은 네이티브 모듈들이 의존성 오류를 한꺼번에 뿜어서 하나하나 맞추는게 어려웠다.

4. 빌드시에 체크가 안되는 모든 런타임 에러들 해결

 

위 작업에서 막혀 거의 하룻밤을 새다시피 했다.
사실상 리액트 네이티브를 처음 다뤄보는 사람으로서, 아무리 안드로이드에 조예가 깊다해도 하룻밤만에 해결하긴 어려운 난제였다.

 

하루를 버리고, 다시 처음부터 소스를 클론받아 시작해보았다.
그러던 중 선녀같은 사이트를 하나 찾았다.

https://react-native-community.github.io/upgrade-helper/?from=0.71.5&to=0.74.0

Upgrade React Native applications

 

 내 상황처럼 react native 버전을 업그레이드 해야할 때, 어떤 부분에 변경점을 줘야하는지 Diff로 하나하나 알려주는 사이트였다.

물론 리액트 네이티브 개발자분들은 잘 아실만한 사이트이지만, 나처럼 사전배경없이 구버전 소스를 받아서 당장 살려내야하는 개발자들에게는 매우 필요한 사이트인 것 같다.

 

 첫날 헤매었던것과 달리, 위 Diff 변경점을 모두 수정해주고 나니 제대로 빌드 및 동작이 되었다. 되돌아보니 처음에 했던 것 처럼 구글링과 챗지피티에 의존해서는 절대 못 해결할 문제였다;;

 

 어쨌든 나와 같은 상황에 처해있는 사람이 같은 실수를 하지 않길 바라며 포스팅을 마무리한다.