React Native 버전 업그레이드

 

새 프로젝트를 생성해서 이전 코드를 이관하지 않고, 기존 프로젝트 내에서 React Native 버전을 올리면서 버전 업그레이드를 진행하는 방법 입니다.

 

 

React Native Upgrade Helper

 

React Native 이전 버전과 최신 버전 사이의 코드 변경사항을 알려주는 온라인 툴을 사용한다.

먼저 프로젝트의 package.json 에서 RN 버전을 확인 후 아래 링크로 접속한다.

Upgrade React Native applications

 

페이지 상단 각 필드에 프로젝트에 대한 정보를 입력한다.

  • •

    App name, Package name(=Bundle ID), 기존 RN 버전, 업그레이드 할 RN 버전

 

입력 후 [Show me How to upgrade!] 버튼을 클릭하면 하단에 코드 변경사항을 알려주는데

이 변경사항을 참고하여 기존 프로젝트에 한땀한땀 적용 시키면 된다.

 

 

변경사항 적용시 주의할 점 -1

언어가 변경되어 파일을 새로 추가하는 경우 기존에 라이브러리 관련 네이티브 코드가 있는지 주의 확인이 필요하다.

  • •

    예로는 MainActivity.java → MainActivity.kt

    • ◦

      react-navigation, react-native-splash-screen 라이브러리

 

변경사항 적용시 주의할 점 -2

RN 0.76+ 부터 New architecture가 기본으로 활성화되도록 하지만,

microsoft/react-native-code-push 를 사용중이라면 New Archtecture는 사용할 수 없다.

 

관련 Docs:

https://github.com/Microsoft/react-native-code-push?tab=readme-ov-file#react-native-module-for-codepush

 

안드로이드 New Architecture 옵트아웃

Java
newArchEnabled=false
android/gradle.properties

iOS New Architecture 옵트아웃

Swift
ENV['RCT_NEW_ARCH_ENABLED'] = '0'
ios/Podfile

 

변경사항 적용시 주의할 점 -3

RN 버전에 따라 지원하는 라이브러리의 버전이 세분화되어있는 경우가 많아서,

버전 업그레이드 후 빌드 시 라이브러리에서 충돌이 있다면 해당 케이스일 확률이 높으니 Docs의 가이드라인에 맞춰서 버전을 업데이트 해주어야한다.