React 16 – 잘못된 피어 디펜던시
React 16로 마이그레이션한 후에는, “잘못된 피어 디펜던시”라는 경고 메시지를 만날 수 있습니다. 이 경고는 프로젝트 내의 특정 패키지들이 React나 다른 디펜던시들의 다른 버전을 요구하면서 자주 발생합니다. 이 블로그 포스트에서는 Yarn 패키지 매니저를 사용하여 이러한 경고를 어떻게 피할 수 있는지에 대해 설명하겠습니다.
잘못된 피어 디펜던시 경고 이해하기
“잘못된 피어 디펜던시”와 같은 경고 메시지를 보면, 사용한 패키지가 React나 다른 관련 디펜던시들의 특정 버전 범위를 요구하고 있다는 것을 의미합니다. 설치된 버전이 그 범위에 속하지 않으면 이러한 경고를 볼 수 있습니다.
해결 방법: Yarn을 이용한 업그레이드
잘못된 피어 디펜던시 경고를 해결하기 위한 첫 번째 단계는 다음 명령어를 실행하는 것입니다:
yarn upgrade이 명령어는 프로젝트의 패키지를 최신 호환 버전으로 업데이트하려고 시도하며, 이를 통해 많은 잘못된 디펜던시 문제가 해결될 수 있습니다.
개별 패키지 업데이트
하지만, 일부 패키지는 업그레이드 명령어를 실행한 후에도 여전히 오래된 버전이나 호환되지 않는 버전을 가지고 있을 수 있습니다. 이를 해결하기 위해 이러한 패키지들의 버전을 직접 수정하여 React 16과 호환되는 적절한 버전으로 바꿔주어야 합니다.
예를 들어, 다음과 같은 경고 메시지가 있다면:
warning "react-modal@2.4.1" has incorrect peer dependency "react@^0.14.0 || ^15.0.0".React 16과 호환되는 “react-modal”의 최신 버전을 검색하여 찾은 후, 패키지를 프로젝트의 package.json 파일에서 업데이트하여 잘못된 디펜던시를 수정할 수 있습니다.
오래된 패키지 다루기
프로젝트에서 사용하는 패키지에 따라서는, 일부 패키지가 저자에 의해 더 이상 유지되지 않거나 오래되었을 수도 있습니다. 이 경우에는 React 16과 호환되는 업데이트된 버전을 찾는 것이 어려울 수 있습니다.
이 문제를 만나면, React 16과 호환되는 유사한 목적을 가진 대체 패키지를 찾아볼 수 있습니다. 추가적인 시간과 코드 리팩토링을 필요로 할 수 있지만, 이를 통해 잘못된 디펜던시 경고를 피할 수 있습니다.
패키지를 업그레이드한 후에는 항상 프로젝트를 철저히 테스트하여 모든 기능이 예상대로 작동하는지 확인하는 것을 기억하세요.
결론
React 16로 마이그레이션할 때 “잘못된 피어 디펜던시” 경고를 종종 만날 수 있습니다. Yarn 패키지 매니저를 사용하여 프로젝트의 패키지를 업그레이드하고 호환되지 않는 버전을 수동으로 수정할 수 있습니다. 오래된 패키지를 추적하고 필요한 경우 대체 옵션을 고려하는 것을 기억하세요. 이러한 단계를 따르면 React 16 프로젝트에서 잘못된 피어 디펜던시 경고를 피하고 해결할 수 있습니다.
