React Native 프로젝트 생성시 발생한 에러

오랜만에 설레는 마음으로 터미널을 켜고 React Native 프로젝트를 생성하는 순간


Installing Bundler단계에서 펑!하고 터져버렸다. 머선129

1
2
3
4
Ignoring digest-crc-0.6.3 because its extensions are not built. Try: gem pristine digest-crc --version 0.6.3
Ignoring unf_ext-crc-0.0.7.7 because its extensions are not built. Try: gem pristine unf_ext --version 0.0.7.7

Error: Looks like your iOS environment is not properly set. ~~

Try해보라는 커맨드를 입력해봤지만 같은 에러가 뜨기는 마찬가지였다. 약간의 구글링과 삽질을 통해 ruby 버전의 문제임을 알았다. 내 mac에 설치된 Ruby의 버전이 낮아서, 업데이트하니 말끔히 해결되었다.

Ruby 버전 업데이트

현재 작업중인 폴더에 설치된 Ruby의 버전은 아래 커맨드로 확인할 수 있다.

1
$ ruby --version

Ruby의 버전을 선택해서 설치하거나 업그레이드하려면, Ruby 버전 관리 툴인 rbenv를 설치해야한다.

1
2
3
$ brew update

$ brew install rbenv

이후 React Native에서 요구하는 버전으로 Ruby를 새로 설치하자. 필요한 Ruby의 버전은 여기에서 확인할 수 있다. 글을 작성하는 시점에는 2.7.6으로 되어있었다. 참고로 상위 버전의 Ruby를 설치했을 때에도 오류가 나서, 정확히 일치하는 버전을 설치해야 하는 것 같다.

1
$ rbenv install 2.7.6

이후 아래 커맨드를 통해 rbenv에 설치된 Ruby를 사용하도록 설정해준다.

1
2
3
4
$ rbenv global 2.7.6

$ ruby --version
* 2.7.6

만약 rbenv global 커맨드 이후에도 ruby --version이 바뀌지 않는다면, 환경변수 설정이 필요하다. eval "$(rbenv init - zsh)"를 ~/.zshrc파일에 추가해주면, Ruby 버전이 정상적으로 반영된 것을 확인할 수 있다.

1
2
3
4
5
6
7
8
$ vim ~/.zshrc

# 마지막줄에 eval "$(rbenv init - zsh)" 추가

$ source ~/.zshrc

$ ruby --version
* 2.7.6

이제 다시 설레는 마음으로 새로운 프로젝트를 시작해보자!

1
$ npx react-native init myProject --template react-native-template-typescript