ios-widge.md

iOS 위젯 실행 방법 (개발자용)

앱 자체는 Expo로 실행하지만, iOS 위젯은 반드시 Xcode로 빌드/실행해야 합니다. (WidgetKit은 네이티브 Extension이라 Expo만으로는 실행되지 않습니다)

사전 준비

• Xcode 설치 (시뮬레이터 포함)
• CocoaPods 설치
• Node / npm 환경 정상 동작

1️⃣ JS 의존성 설치

프로젝트 루트에서 실행:

npm install

2️⃣ iOS Pods 설치

위젯 및 일부 네이티브 모듈은 CocoaPods에 의존합니다.

cd ios
pod install --repo-update
cd ..

정상 설치 여부 확인:

test -f ios/Podfile.lock && echo "Podfile.lock OK"

3️⃣ Expo 번들러 실행

터미널 하나 열어두고 계속 실행 상태로 유지합니다.

npm run dev
# (expo start -c)

4️⃣ Xcode에서 iOS 워크스페이스 열기

open ios/*.xcworkspace

5️⃣ Xcode에서 앱 1회 실행

Xcode 상단에서:

1. Scheme: RabbitTracker
2. Simulator 기기 선택
3. ▶️ Run

이 단계는 위젯을 시스템에 설치하기 위해 반드시 필요합니다.

6️⃣ iOS 시뮬레이터에서 위젯 추가

1. 시뮬레이터 홈 화면 이동
2. 빈 공간 길게 누르기
3. + 버튼 → 위젯 추가
4. Rabbit Tracker 검색
5. 원하는 사이즈의 위젯 추가