실시간 혼잡도 데이터를 기반으로 관광지·맛집·문화시설·축제 정보를 제공하는 부산 지역 특화 관광서비스

이 프로젝트는 @react-native-community/cli를 통해 생성된 React Native 기반 프로젝트입니다.

• React Native 환경 구성 가이드를 참고해 Node, JDK, Android Studio, Xcode 등을 사전에 설치해 주세요.

• 🎉 Start: Start New Project
• ✨ Feat: 새로운 기능을 추가
• 🐛 Fix: 버그 수정
• 🎨 Design: CSS 등 사용자 UI 디자인 변경
• ♻️ Refactor: 코드 리팩토링
• 🔧 Settings: 설정 파일 수정
• 🗃️ Comment: 필요한 주석 추가 및 변경
• ➕ Dependency/Plugin: 의존성·플러그인 추가
• 📝 Docs: 문서 수정
• 🔀 Merge: 브랜치 병합
• 🚀 Deploy: 배포 관련 커밋
• 🚚 Rename: 파일·폴더명 수정 또는 이동
• 🔥 Remove: 파일 삭제
• ⏪️ Revert: 이전 버전으로 롤백

npx react-native start

프로젝트 루트에서 실행하며, JS 번들러 역할을 합니다. 항상 백그라운드에서 켜두세요.

npx react-native run-android

연결된 Android 기기 또는 에뮬레이터에서 앱을 실행합니다.

npx react-native run-ios

macOS 환경에서만 실행 가능하며, Xcode 설정 필요

emulator -list-avds          # AVD 리스트 출력
emulator -avd [에뮬레이터 이름]  # 에뮬레이터 실행

xcrun simctl list devices  # 모든 iOS 기기 리스트 확인
npx react-native run-ios --device "iPhone 14"

• Xcode → Devices and Simulators → 본인 iPhone 연결 및 신뢰 설정
• Xcode에서 해당 기기 선택 후 실행 또는

npx react-native run-ios --device "사용자 아이폰 이름"

npm install

package.json 기반으로 모든 의존성을 설치합니다.

• --legacy-peer-deps: 의존성 충돌이 날 경우 무시하고 강제 설치 (주의 필요)
• --force: 강제 설치 (더 위험함, 추천하지 않음)

rm -rf node_modules package-lock.json
npm cache clean --force
npm install

• 개발자 메뉴: Ctrl + M (Windows/Linux), Cmd ⌘ + M (macOS)
• 또는 R 키 두 번 눌러 새로고침

• 시뮬레이터 내에서 Cmd ⌘ + R

src/
├── screens/           # 전체 화면 단위 (ex. HomeScreen.tsx)
├── components/        # 공통 UI 컴포넌트 (ex. CustomButton.tsx)
├── navigation/        # 네비게이션 스택/탭 정의
├── hooks/             # 사용자 정의 훅
├── store/             # Redux/Context 등 상태관리
├── api/               # REST API 호출, axios 정의 등
├── utils/             # 날짜/문자열/포맷 함수들
├── types/             # 공통 타입 정의
├── assets/            # 이미지, 폰트, 아이콘 등
└── App.tsx            # 루트 앱 진입점

• React Native 공식문서
• 환경설정 가이드
• 디버깅 방법
• iOS 디바이스 설정

다음 값은 현재 프로젝트의 안드로이드 설정에서 확인된 배포/서명 정보입니다.

• 패키지명(applicationId): com.busanvibe
• 버전 정보
  • versionCode: 1 (재업로드 시 반드시 증가 필요)
  • versionName: 1.0
• SDK 타겟
  • minSdkVersion: 21
  • targetSdkVersion: 34
  • compileSdkVersion: 34
• 릴리즈 서명 키
  • keystore 경로: android/app/busanvibe-release.keystore
  • key alias: BusanVibe_release
  • storePassword: busanvibern2025A9x3
  • keyPassword: busanvibern2025A9x3
  • 설정 위치:
    • android/app/build.gradle → signingConfigs.release 가 Gradle 속성 참조
    • android/gradle.properties → MYAPP_UPLOAD_* 값 지정
• 디버그 키(참고)
  • keystore: android/app/debug.keystore
  • alias: androiddebugkey / password: android

keytool -list -v -keystore android\app\busanvibe-release.keystore -alias BusanVibe_release

cd android
./gradlew clean
./gradlew assembleRelease
# 산출물: app/build/outputs/apk/release/app-release.apk