Development & React Native Setting (3/3)

1. Node & Watchman 설치

Node와 Watchman가 설치되어 있는지 확인합니다.
아래 코드는 각각의 버전을 확인하는 코드입니다.

# 시스템에 설치된 Node 버전 확인하기
node -v
# 시스템에 설치된 Watchman 버전 확인하기
watchman -v

React Native Android 세팅을 진행하셨다면, 이미 Node와 Watchman은 설치가 되어 있습니다. 설치에 도움이 필요하다면 Development & React Native Setting (2/3)을 참고하시면 됩니다.

2. Ruby 설치

React Native를 이용한 프로젝트를 실행하기 위해서는 특정한 버전의 Ruby 설치가 필요합니다. 기본적으로 시스템에는 이미 Ruby가 설치되어 있습니다. 현재(2023.04.08) macOS 13.2 기준으로 Ruby 2.6.10 버전이 설치되어 있습니다. 하지만 React Native는 2.7.6 버전을 사용합니다. 필요에 따라 다른 Ruby 버전을 사용하기도 합니다.

2.1. Ruby version manager 설치

Ruby도 Node와 같이 버전 매니저를 설치하여 관리할 수 있습니다. Ruby version manager는 rbenv, RVM, chruby 등이 있습니다. 그 중에서 제일 가볍고 시스템 파일의 변경이 가장 적다고 하는 rbenv 를 사용하여 Ruby를 설치하려 합니다. 물론 사용법도 그리 어렵지 않습니다.

위 사진 1에 안내되고 있는 3가지 방법들 중에서 첫번째 Homebrew를 이용해서 rbenv를 설치하고, 이어서 위 사진 2에 안내되고 있는 rbenv를 불러오는 명령을 통해 설치를 진행할 것입니다.

이미 Homebrew를 설치하였기 때문에, rbenv 또한 Homebrew를 이용해서 다운로드 합니다.
명령은 아래와 같습니다. 아래 명령을 복사해도 좋습니다.

brew install rbenv ruby-build

설치한 rbenv를 불러오기 위해서 다음 명령을 입력합니다.

rbenv init

추가로 .zshrc 파일에 아래 코드의 입력이 필요합니다. 해당 코드를 입력 후 파일을 저장합니다.

eval "$(rbenv init - zsh)"

2.2. 프로젝트에 맞는 Ruby 설치

Ruby를 설치하는 법은 간단합니다.

# list latest stable versions
rbenv install -l

# list latest local versions
rbenv install -L

# install a Ruby version
rbenv install 2.7.4

프로젝트의 ios 빌드 환경이 Ruby 2.7.4 버전이 필요하기에 해당 버전을 다운로드 받습니다.

rbenv를 이용하여 여러 버전의 Ruby를 다운로드 받을 수 있습니다. 다운로드 받은 버전 목록과 현재 설정된 버전을 확인하는 명령이 있습니다. 그리고 최근에 다운로드 받은 버전은 기기의 기본 버전으로 설정됩니다. 특정 프로젝트에 특정한 버전을 설정하고 싶다면 아래의 명령을 참고할 수 있습니다.

# lists all Ruby versions known to rbenv, and shows currently active version
rbenv versions

# set the default Ruby version for this machine
rbenv global 2.7.6

# set the Ruby version for this directory
rbenv local 2.7.4

3. Xcode 설치

Xcode는 최소 버전이 10 이상이 되어야 합니다.
그리고 반드시 해줘야 하는 설정이 있습니다. Preferences(Settings) > Locations 로 이동해서 Command Line Tools 설정을 해줘야 합니다. 단순히 체크가 되어 있는지만 확인할 것이 아니라, 실제로 드롭다운을 클릭하여 설정이 필요합니다.

4. Cocoapods 설치

빌드를 실행하기 이전에 ios dependencies 설치가 필요합니다. 설치를 위한 pod 명령어를 사용하기 위해서는 Cocoapods을 설치합니다. 설치 명령과 ios dependencies 설치 명령은 다음과 같습니다.

# install Cocoapods
brew install cocoapods

# install iOS dependencies
cd ios
pod install

ios dependencies의 설치는 프로젝트 내 ios 디렉토리에서 설치해야합니다.

5. 프로젝트 빌드

프로젝트 빌드에 앞서 선행되어야 할 것이 2가지 있습니다.

• 프로젝트를 처음 clone 받은 후, yarn install을 진행하여 패키지 설치를 진행합니다.
• 프로젝트의 root 폴더 내에 .env 파일을 생성하여 필요한 내용을 채워 넣습니다.

# metro 서버 시작 명령입니다.
yarn start
# 프로젝트의 아이오에스 빌드 명령입니다.
yarn ios
# 기기를 특정하여 빌드하고자 할 때의 명령입니다. ex) iPhone SE (3rd generation)
yarn ios --simulator="iPhone SE (3rd generation)"

6. 빌드 에러 핸들링

처음 빌드할 당시에 해당 부분에서 계속된 compile 에러가 발생했습니다.
||가 아닌 |로 되어 있어 생긴 문제였는데, 어느 순간에 수정되었는지 추적은 할 수 없었습니다.
해당 언어(C+)에서 or 문법은 ||를 사용합니다.