Skip to main content

새로운 버전으로 업그레이드

React Native의 새 버전으로 업그레이드하면 더 많은 API, 뷰, 개발자 도구 및 다양한 기능을 사용할 수 있다. 업그레이드에는 약간의 작업이 필요하지만, 가능한 한 간단하게 진행할 수 있도록 노력했다.

Expo 프로젝트​

Expo 프로젝트를 새로운 React Native 버전으로 업그레이드하려면 package.json 파일에서 react-native, react, expo 패키지 버전을 업데이트해야 한다. Expo는 SDK 버전을 한 번에 하나씩 단계적으로 업그레이드할 것을 권장한다. 이렇게 하면 업그레이드 과정에서 발생하는 문제를 정확히 파악할 수 있다. 프로젝트 업그레이드에 대한 최신 정보는 Expo SDK 업그레이드 가이드를 참고한다.

React Native 프로젝트​

일반적인 React Native 프로젝트는 기본적으로 Android 프로젝트, iOS 프로젝트, 그리고 JavaScript 프로젝트로 구성된다. 이런 구조 때문에 업그레이드가 다소 까다로울 수 있다. Upgrade Helper는 두 버전 사이에 발생하는 모든 변경 사항을 제공하여 앱 업그레이드를 도와주는 웹 도구다. 또한 특정 파일에 대한 주석을 보여주어 해당 변경이 왜 필요한지 이해하는 데 도움을 준다.

1. 버전 선택하기​

먼저 업그레이드할 버전을 선택해야 한다. 기본적으로 최신 메이저 버전이 선택되어 있다. 버전을 선택한 후 "업그레이드 방법 보기" 버튼을 클릭하면 된다.

💡 메이저 업데이트 시 상단에 "유용한 콘텐츠" 섹션이 표시된다. 이 섹션에는 업그레이드 시 도움이 되는 링크가 포함되어 있다.

2. 의존성 업그레이드​

첫 번째로 보이는 파일은 package.json이다. 여기에 표시된 의존성을 업데이트하는 것이 좋다. 예를 들어, react-native와 react가 변경 사항으로 나타난다면, 다음 명령어를 실행해 프로젝트에 설치할 수 있다.

shell
# {{VERSION}}과 {{REACT_VERSION}}은 diff에 표시된 릴리스 버전이다
npm install react-native@{{VERSION}}
npm install react@{{REACT_VERSION}}

새로운 릴리스에는 npx react-native init을 실행할 때 생성되는 다른 파일들에 대한 업데이트가 포함될 수 있다. 이러한 파일들은 Upgrade Helper 페이지에서 package.json 뒤에 나열되어 있다. 다른 변경 사항이 없다면 프로젝트를 다시 빌드하는 것만으로 개발을 계속할 수 있다. 변경 사항이 있는 경우에는 수동으로 프로젝트에 적용해야 한다.

문제 해결​

모든 변경 사항을 적용했는데도 앱이 이전 버전을 사용하고 있다​

이런 종류의 오류는 일반적으로 캐싱과 관련이 있다. 프로젝트의 모든 캐시를 지우기 위해 react-native-clean-project를 설치하는 것을 추천한다. 캐시를 지운 후 다시 실행해 보자.