[React-Native CLI] react-native-vector-icons 설치에러 해결 과정

문제 발생

❗️react-native-vector-icons 설치 중 발생한 문제

1. Ionicons 아이콘을 사용하려고 했으나 설치 과정에서 문제가 발생
2. 문제를 해결하기 위해 여러 시도를 했으나, 제대로 작동하지 않음

---

문제 원인 파악

처음에 react-native-vector-icons GitHub 링크에 안내된 설치 방법으로 진행

npm install --save @react-native-vector-icons/common

첫 번째 문제

위 명령어로 설치를 진행했으나, 참고 글에는 npm 패키지 버전의 설치방법으로 글이 작성되어 있어서 GitHub의 설치방법과는 달라 문제가 발생

두 번째 문제

이후에 npm 버전으로 다시 설치하여 진행

• npm에 공개된 버전: 10.2.0
• GitHub에 공개된 최신 버전: 11.0.0

npm install --save react-native-vector-icons

두 버전 간 차이로 인해 설치 과정에서 충돌이 발생

세 번째 문제

두 버전을 혼합하여 설치한 상태에서 pod install 명령어를 실행하여, 두 버전이 서로 충돌하며 iOS 빌드에서 디버깅 오류가 발생.

Xcode에서 react-native-vector-icons 관련 부분에 문제가 있다고 표기됨

---

해결 방법

1. 안정적인 버전 선택으로 문제 해결
   • (2025.1.13 일 기준) 최신 버전(11.0.0) 대신, 비교적 안정성이 높은 10.2.0 버전을 사용
   • npm install --save react-native-vector-icons
2. 충돌 해결
   • Xcode에서 충돌한 react-native-vector-icons 파일을 삭제.
   • 이후, 하나의 버전만 남긴 상태에서 pod install을 실행.
3. 정상 작동 확인
   • 위 과정을 통해 iOS 빌드와 디버깅 오류가 모두 해결