Skip to main content
Version: Next

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

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}}

3. 프로젝트 파일 업그레이드​

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

문제 해결​

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

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