WSL에서 React Native 개발하기

안녕하세요! 여러분은 지금 WSL (Ubuntu on Windows) 환경에서 React Native 개발 환경을 구축하고 계신가요? 몇 가지 중요한 포인트를 짚고 넘어가면 더 효율적인 개발 환경을 만들 수 있습니다.

전제 조건

React Native는 iOS 개발은 macOS에서만 가능하지만, Android 개발은 WSL에서도 충분히 가능합니다. 다만 WSL 자체는 GUI가 없고, Android Emulator도 기본적으로 실행하기 어렵습니다. 따라서 아래 방식이 가장 실용적입니다:

• 코드는 WSL에서 작성하고
• 실행은 Windows의 Android Studio를 통해 진행하는 방식

✅ npm 설치 – 어떤 방법이 최선일까?

🔹 1. apt install npm

• 가장 간단한 방법이지만, 매우 구버전의 npm/node가 설치됩니다
• Node.js 버전이 10.x대일 가능성이 높아 → React Native CLI 설치 시 호환성 문제가 발생할 수 있습니다

🔹 2. brew install node

• brew는 WSL2에서 설치 가능하지만, 공식적으로는 macOS용이라 완전히 추천드리지 않습니다
• brew 사용 시 패키지 위치가 꼬이는 문제가 발생할 수 있습니다

🔥 가장 깔끔하고 추천하는 방법: nvm (Node Version Manager)

# 1. nvm 설치 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash 
source ~/.bashrc # 또는 ~/.zshrc 

# 2. 설치 확인 
nvm --version 

# 3. 최신 LTS 버전 설치 
nvm install --lts

# 4. Node, npm 확인 
node -v 
npm -v

이 방법의 장점:

• Node.js 버전을 자유롭게 변경할 수 있습니다
• 다양한 프로젝트 간 버전 충돌을 방지합니다
• React Native에서 권장하는 환경과 맞춤 설정이 가능합니다

📦 React Native CLI 설치 및 프로젝트 생성

npm install -g react-native-cli

이후 WSL에서 프로젝트를 생성할 수 있습니다:

npx react-native init GrindUp --template react-native-template-typescript

중요: Android Emulator는 Windows 측 Android Studio에서 실행하고, 디바이스 연결은 adb.exe를 Windows에서 실행하거나 adb connect 명령으로 연결해야 합니다.

🧠 부가 팁: WSL에서 GUI 확인 방법

WSL2 + Ubuntu 22.04 + Windows 11 환경이라면 GUI 앱도 실행 가능합니다. 하지만 현재로서는 React Native 개발은 VS Code (WSL Remote) + Android Studio (Windows) 조합이 가장 현실적이고 안정적입니다.

✅ 정리

설치 방법추천 여부이유

apt install npm	❌	구버전, 비권장
brew install node	❌	WSL에서 비호환 가능성
nvm	✅	최신 환경, 안정성, 유연성

이 가이드를 통해 WSL에서 React Native 개발 환경을 효과적으로 구축하고, 윈도우에서도 원활하게 안드로이드 앱을 개발하실 수 있기를 바랍니다!