문제: React Native 0.87을 윈도우에서 작성할 수는 있지만, 아이오에스 시뮬레이터와 Xcode 빌드 단계에서 막힙니다.
가장 빠른 해결: 평소에는 Windows 11에서 JavaScript 또는 TypeScript를 작성하고, 아이오에스 확인이 필요할 때 원격 맥으로 프로젝트를 실행합니다.
이 방법은 맥을 아직 구매하지 않은 학생에게 적합합니다. Android 학습과 공통 화면 개발은 윈도우에서 계속하고, 아이오에스 네이티브 오류와 첫 빌드만 맥에서 확인하면 됩니다.
마지막 업데이트: 2026년 8월 26일. React Native 공식 문서와 Apple 공식 문서를 기준으로 버전과 환경 조건을 다시 확인했습니다.
윈도우와 맥의 역할을 먼저 나누기
React Native 0.87은 윈도우에서 코드 작성과 Android 테스트를 진행할 수 있습니다. 그러나 아이오에스 앱을 로컬로 빌드하려면 Xcode가 필요하며, React Native 공식 환경 문서도 아이오에스 개발 도구로 Xcode를 요구합니다. 공식 환경 설정 문서를 먼저 확인해야 하는 이유입니다.
따라서 “React Native 0.87을 맥 없이 아이오에스용으로 개발할 수 있는가”에 대한 답은 조건부입니다.
- 공통 화면, 상태 관리, API 연결: 윈도우에서 가능
- JavaScript와 TypeScript 작성: 윈도우에서 가능
- Android 실행과 디버깅: 윈도우에서 가능
- 아이오에스 시뮬레이터 실행: macOS와 Xcode 필요
- 아이오에스 네이티브 의존성 확인과 Xcode 빌드: macOS 필요
- 실제 기기 테스트와 배포 서명: 맥과 Apple 개발 환경 필요
React Native 0.87은 2026년 8월 11일 공개됐고, Strict TypeScript API가 기본으로 활성화됐습니다. Swift Package Manager를 이용한 아이오에스 지원은 공식 문서에서 아직 실험적 경로로 안내됩니다. React Native 0.87 공개 내용과 Strict TypeScript API 안내를 함께 확인하십시오.
첫 단계: 윈도우에서 공통 코드를 완성하기
처음부터 개발 컴퓨터 전체를 바꿀 필요는 없습니다. 윈도우에서 프로젝트를 만들고 화면을 작성한 뒤, Git 저장소에 올리는 흐름을 먼저 익히면 됩니다.
이 단계에서 집중할 내용은 다음과 같습니다.
- 프로젝트 생성과 폴더 구조 이해
- 화면 이동과 입력창 같은 공통 UI 작성
- 서버 요청과 오류 표시 구현
- Android 에뮬레이터 또는 실제 Android 기기 확인
- 변경 사항을 Git 커밋으로 저장
다만 브라우저나 Android에서 화면이 보였다고 해서 아이오에스 검증이 끝난 것은 아닙니다. 아이오에스에서는 권한 설정, 네이티브 라이브러리, 프로젝트 파일, 빌드 설정이 추가로 작동합니다.
프로젝트를 맥으로 옮기기 전에는 반드시 커밋하십시오. Node.js 버전, 패키지 관리자, React Native 0.87 의존성 버전도 메모해 두면 환경을 다시 설치할 때 시간을 줄일 수 있습니다.
React Native를 배우다가 맥이 필요한 시점
가장 분명한 기준은 아이오에스 전용 도구를 직접 실행해야 하는 순간입니다. 단순히 Expo 화면을 미리 보는 것과 Xcode를 사용해 아이오에스 앱을 빌드하는 것은 같은 결과가 아닙니다.
Expo Go는 빠른 화면 확인에는 유용하지만, 모든 네이티브 모듈과 프로젝트 설정을 대신 검증하지는 않습니다. 개발 빌드와 Expo Go의 차이는 Expo 공식 개발 빌드 설명에서 확인할 수 있습니다.
다음 상황이면 맥으로 전환하십시오.
- 아이오에스 시뮬레이터에서 화면을 확인해야 할 때
- 아이오에스 전용 라이브러리를 추가했을 때
- 권한, 알림, 카메라 같은 네이티브 기능을 확인할 때
- Xcode에서 컴파일 오류를 읽어야 할 때
- 실제 아이폰 테스트나 배포용 서명이 필요할 때
즉, Expo 미리보기는 Xcode 빌드를 대체하지 않습니다. 공통 UI의 빠른 확인은 Expo로 할 수 있지만, 아이오에스 네이티브 동작을 보장하려면 맥에서 별도 검증이 필요합니다.
두 가지 학습 방식 중 당신에게 맞는 선택
윈도우만 사용하는 방식
추천도는 낮습니다. JavaScript 학습과 Android 개발에는 충분하지만, 아이오에스 시뮬레이터를 실행할 수 없습니다. 네이티브 오류가 발생하면 문제를 재현하지 못한 채 추측하게 됩니다.
윈도우와 원격 맥을 함께 사용하는 방식
초보자에게 가장 현실적인 선택입니다. 일상적인 코딩은 익숙한 윈도우에서 하고, 아이오에스 확인이 필요한 날에만 원격 맥에 접속합니다. 원격 맥에서도 React Native 아이오에스 시뮬레이터를 실행할 수 있으며, 다만 네트워크 상태와 원격 화면 반응은 별도로 확인해야 합니다.
SSHMac의 도움말 센터에서 접속 방식과 사용 환경을 먼저 확인한 뒤, 과제 기간에 맞춰 이용 기간을 정하는 편이 안전합니다.
첫 전환 전 준비할 항목
맥에 접속하기 전에 아래 내용을 준비하십시오.
- Git 저장소 주소와 로그인 권한
- 프로젝트의 Node.js 및 패키지 관리자 버전
- React Native 0.87에 맞는 의존성 파일
- 강의에서 지정한 Xcode와 macOS 조건
- Apple 계정이 필요한 작업인지 여부
- 프로젝트의 환경 변수와 테스트용 API 주소
- 아이오에스 플랫폼 폴더의 변경 사항
Xcode 26.6을 검색해 이 버전을 그대로 설치하려는 경우에는 먼저 공식 지원 상태를 확인해야 합니다. Xcode의 macOS 요구 조건은 버전마다 달라질 수 있으므로 Apple의 Xcode 시스템 요구 사항을 기준으로 판단하십시오. 테스트 버전 정보를 안정적인 학습 환경의 기본값으로 삼지 않는 것이 좋습니다.
Swift Package Manager도 마찬가지입니다. React Native 0.87의 실험적 지원을 시험하려는 목적이 아니라면, 강의와 프로젝트가 사용하는 기존 의존성 설치 방식을 먼저 유지하십시오. 새 설치 방식을 동시에 바꾸면 오류 원인을 구분하기 어려워집니다.
주의: 아이오에스 시뮬레이터가 열렸다는 사실만으로 배포 가능한 앱이 완성된 것은 아닙니다. 시뮬레이터 실행, 실제 기기 테스트, 배포용 서명은 서로 다른 확인 단계입니다.
두 번째 단계: 원격 맥에서 첫 실행하기
처음에는 많은 명령을 외울 필요가 없습니다. 목표는 저장소를 내려받고, 의존성을 설치하고, 시뮬레이터에서 기본 화면을 보는 것입니다.
1. 프로젝트 가져오기
원격 맥의 터미널에서 저장소를 내려받습니다.
git clone 저장소주소
cd 프로젝트폴더
이미 프로젝트가 있다면 새로 복제하지 말고 최신 커밋을 가져옵니다.
git pull
2. 의존성 설치하기
프로젝트가 사용하는 방식에 맞춰 설치합니다.
npm install
저장소에 yarn.lock 또는 다른 잠금 파일이 있다면 강의에서 지정한 패키지 관리자를 우선하십시오. 서로 다른 설치 방식을 번갈아 사용하면 잠금 파일이 바뀌어 재현성이 떨어질 수 있습니다.
3. Metro 시작하기
npx react-native start
Metro는 작성한 JavaScript와 TypeScript 코드를 앱이 읽을 수 있도록 전달하는 중계 장치입니다. 식당의 주문 전달대처럼, 코드 변경 내용을 실행 중인 앱으로 보내는 역할을 합니다.
4. 아이오에스 시뮬레이터 실행하기
새 터미널 창에서 다음 명령을 실행합니다.
npx react-native run-ios
React Native 공식 실행 안내에도 이 명령을 통한 시뮬레이터 실행 흐름이 제시되어 있습니다. 아이오에스 시뮬레이터 실행 문서를 참고하십시오.
5. 오류를 한 번에 하나씩 확인하기
처음부터 모든 오류를 해결하려 하지 마십시오.
- 명령을 찾을 수 없음: Node.js 또는 Xcode 명령 도구 확인
- 패키지 오류: 잠금 파일과 설치 명령 확인
- 네이티브 모듈 오류: 해당 라이브러리의 아이오에스 설치 안내 확인
- 빌드 오류: Xcode에서 첫 번째 오류부터 확인
- 화면 연결 오류: Metro가 실행 중인지 확인
성공 여부를 판단하는 기준
첫 실행이 성공했다고 기록하려면 다음 결과를 각각 확인하십시오.
- 시뮬레이터가 열리고 앱이 표시됩니다.
- 기본 화면과 이미지가 정상적으로 나타납니다.
- JavaScript 또는 TypeScript를 수정한 뒤 변경 내용이 반영됩니다.
- 앱을 종료한 뒤 같은 명령으로 다시 실행됩니다.
- 오류가 발생했을 때 터미널 로그와 Xcode 로그를 저장할 수 있습니다.
Apple의 앱 빌드와 실행 안내는 Xcode에서 빌드 결과를 확인하는 기본 절차를 설명합니다.
여기서 시뮬레이터 실행 성공과 배포용 앱 완성은 구분해야 합니다. 실제 기기에서 테스트하려면 서명 설정이 필요할 수 있고, 배포에는 provisioning profile과 같은 별도 항목이 관여합니다. Apple의 provisioning profile 안내를 확인하되, 단순한 수업용 시뮬레이터 실행이라면 처음부터 배포 절차까지 진행할 필요는 없습니다.
첫 주에 사용할 이중 작업 흐름
다음 순서를 반복하면 코드가 사라지는 일을 줄일 수 있습니다.
- [ ] Windows 11에서 화면과 공통 로직을 작성합니다.
- [ ] Android에서 기본 동작을 확인합니다.
- [ ] 변경 사항을 작은 단위로 커밋합니다.
- [ ] 원격 맥에서 최신 커밋을 가져옵니다.
- [ ] Metro와 아이오에스 시뮬레이터를 실행합니다.
- [ ] 화면, 권한, 네이티브 라이브러리를 확인합니다.
- [ ] 문제가 있으면 로그와 재현 절차를 저장합니다.
- [ ] 수정한 내용을 다시 커밋하고 다음 작업으로 넘어갑니다.
새로운 네이티브 라이브러리를 추가했거나 권한을 바꿨거나 아이오에스 프로젝트 파일을 수정했다면, 다음 원격 맥 작업일까지 기다리지 말고 바로 아이오에스 검증을 예약하십시오. 이 세 가지 변경은 Android에서 정상이어도 아이오에스 빌드에 영향을 줄 수 있습니다.
SSHMac을 이용할지 직접 장비를 마련할지 비교할 때는 결제와 이용 기간 안내도 함께 확인할 수 있습니다. 단기 과제인지, 여러 주 동안 반복 검증할 프로젝트인지에 따라 적합한 선택이 달라집니다.
윈도우만 계속 사용하는 방식은 비용 부담은 적지만 아이오에스 시뮬레이터를 직접 열 수 없고, 네이티브 오류를 재현하기 어렵고, 서명 단계도 맥으로 다시 옮겨야 한다는 단점이 있습니다. 반대로 맥을 바로 구매하면 환경은 안정적이지만 학습 초기에 사용하지 않는 비용까지 부담할 수 있습니다. 현재 목표가 수업 과제의 아이오에스 확인이나 첫 빌드라면, SSHMac의 원격 맥을 필요한 기간만 이용해 윈도우 코딩과 맥 검증을 나누는 편이 더 합리적일 수 있습니다..final