⏰ 예상 시간: 15분 모바일 앱은 폰에서 자연스럽게 느껴져야 합니다: 빠르게 열리고, 탭하기 쉽고, 한 손으로 편안하게 사용할 수 있어야 합니다. Replit이란?의 러닝 트래커 예제에서 영감을 받은 폰 우선 러닝 트래커 Pace Mobile을 빌드할 것입니다. 목표는 전체 앱 스토어 경로에 전념하기 전에 집중된 모바일 플로우를 테스트하는 것입니다.Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
달성할 내용
이 가이드를 마치면 다음을 갖게 됩니다:- Agent로 만든 모바일 앱 프로젝트.
- 폰 친화적인 하나의 플로우에 집중한 첫 번째 버전.
- 시뮬레이터 또는 에뮬레이터에서 실행 중인 앱.
- Expo Go로 폰에서 실행 중인 앱.
- 피드백을 위해 누군가에게 보낼 수 있는 공유 가능한 버전.
배울 내용
다음을 배우게 됩니다:- 프롬프트에서 모바일 앱을 시작하는 방법.
- 첫 번째 버전을 폰 제약에 맞게 범위를 정하는 방법.
- 시뮬레이터 또는 에뮬레이터에서 앱을 테스트하는 방법.
- Expo Go로 실제 기기에서 앱을 테스트하는 방법.
- 앱 스토어 또는 TestFlight 작업 전에 계속 반복할 시점을 결정하는 방법.
이 가이드는 누구를 위한 것인가요
아이디어를 폰에서 사용해야 할 때 이 가이드를 사용하세요. 트래커, 예약 플로우, 현장 도구, 이벤트 앱, 학습 도구, 습관 앱, 그리고 사람들이 데스크톱 외부에서 사용해야 하는 모든 것에 유용합니다.TestFlight 및 앱 스토어 게시는 이 가이드와 별개입니다. 해당 경로가 준비되면 모바일 앱 빌드 및 출시하기를 참조하세요.
시작하기 전에
필요한 것: 정확한 시뮬레이터, 에뮬레이터, 기기 미리보기 세부 사항은 네이티브 모바일 앱을 참조하세요.모바일 플로우 정의하기
빌드하기 전에 폰에서 누군가가 무엇을 해야 할지 결정하세요. Pace Mobile의 경우:- 대상: 달리기를 빠르게 기록하고 싶은 러너.
- 주요 플로우: 달리기 유형 선택 → 거리와 시간 입력 → 달리기 저장 → 오늘의 요약 확인.
- 모바일 제약: 기본 동작이 엄지 하나로 쉽게 도달할 수 있어야 합니다.
- 첫 번째 버전: 계정 없음, 소셜 피드 없음, 고급 분석 없음.
첫 번째 버전 빌드하기
Replit을 열고 새 앱을 시작하세요. 만들고 싶은 것을 설명한 다음, 앱 유형으로 Mobile app을 선택하세요.
시뮬레이터 또는 에뮬레이터에서 테스트하기
Agent가 첫 번째 빌드를 마치면 Preview를 여세요. 기기 선택기에서 iOS Simulator 또는 Android Emulator를 선택하세요. 폰에서 사용하는 사람처럼 앱을 탭해 보세요.
- 오류 없이 앱이 시작되는지.
- 달리기 유형을 선택할 수 있는지.
- 거리와 시간을 입력할 수 있는지.
- 달리기를 저장할 수 있는지.
- 오늘의 요약이 업데이트되는지.
- 막히지 않고 탐색할 수 있는지.
- 확대하지 않고 텍스트를 읽을 수 있는지.
폰에서 테스트하기
시뮬레이터 테스트는 유용하지만, 폰은 앱이 제대로 느껴지는지 알려줍니다. 모바일 기기 미리보기 패널을 열고 폰으로 QR 코드를 스캔하세요. 이렇게 하면 Expo Go에서 앱이 열립니다.
- 한 손으로 주요 플로우를 완료할 수 있는지.
- 버튼과 입력창이 탭할 수 있을 만큼 큰지.
- 주요 동작에 쉽게 도달할 수 있는지.
- 키보드가 중요한 필드를 가리지 않는지.
- 작은 화면에서도 앱이 여전히 의미 있는지.
피드백을 위해 공유하기
폰 플로우가 작동하면, 초기 피드백을 위한 공유 가능한 Expo Go 버전을 만들기 위해 앱을 게시하세요. 하나의 집중된 작업과 함께 공유하세요:Pace Mobile을 폰에서 열고, 달리기를 하나 저장하고, 탭하거나 읽거나 이해하기 어색한 것이 있으면 알려주세요.집중된 피드백이 일반적인 의견보다 사용하기 쉽습니다. 피드백이 하나의 명확한 문제를 가리킨다면, Agent에게 가장 작은 수정을 요청하고 폰에서 앱을 다시 테스트하세요.
앱 스토어에 게시하기
Expo Go로 시뮬레이터와 폰에서 Pace Mobile을 테스트한 후, 동일한 앱을 TestFlight 및 앱 스토어로 홍보할 수 있습니다. 이 플로우에는 이중 인증이 포함된 Apple Developer Program 멤버십이 필요합니다. 등록, 개인 vs. 조직 계정, TestFlight vs. 앱 스토어 검토, 외부 테스트에 대한 배경은 모바일 앱 빌드 및 출시하기를 참조하세요.Publishing 탭 열기 및 앱 스토어 게시 시작하기
Expo Go 미리보기가 라이브 상태가 되면 Publishing 탭을 여세요. Production 아래에서 Ready to publish Pace to the App Store? 카드를 볼 수 있습니다. Start publishing to the App Store를 선택하세요.
Expo 프로젝트 선택하기
Replit이 Launch를 엽니다 — Replit에 내장된 Expo 플로우. Expo 프로젝트 이름과 슬러그를 입력하거나 확인한 다음 Continue를 선택하세요. 이미 Expo 프로젝트가 있다면 Use existing을 선택하세요.
Apple로 로그인하기
앱 스토어 목록을 소유할 Apple Developer 계정을 연결하세요. 계정은 Apple Developer Program에 등록되어야 하며, Apple은 이중 인증을 시행합니다 — 신뢰할 수 있는 기기에서 인증 코드를 승인할 준비를 하세요.
Apple 앱 선택 또는 생성하기
앱 스토어에 표시될 App name과 Bundle ID(예: 
app.replit.pace)를 입력하세요. 번들 식별자는 첫 번째 빌드 후 변경할 수 없으므로 신중하게 선택하세요.
버전의 첫 번째 빌드는 일반적으로 테스터가 설치할 수 있기 전에 TestFlight 베타 검토가 필요합니다. 승인 후, 추가 빌드는 보통 테스터에게 더 빠르게 푸시됩니다. 외부 테스터와 공유하거나 앱 스토어 출시를 위해 제출하려면 App Store Connect에서 목록을 완료하세요 — 전체 App Store Connect 체크리스트는 모바일 앱 빌드 및 출시하기를 참조하세요.
완료 기준
- iOS Simulator 또는 Android Emulator에서 앱이 열립니다.
- Expo Go로 폰에서 앱이 열립니다.
- 주요 모바일 플로우를 완료할 수 있습니다.
- 텍스트, 버튼, 내비게이션이 폰에서 편안하게 느껴집니다.
- 테스트 가능한 모바일 버전을 게시하거나 공유했습니다.
- 적어도 한 사람이 사용해보고 피드백을 줄 수 있습니다.
- (선택 사항) 앱 스토어 플로우를 통해 TestFlight에 앱을 제출했습니다.
다음 단계
로그인 추가하기
각 사람이 자신의 진행 상황을 볼 수 있게 하세요.
데이터베이스 추가하기
첫 번째 테스트 세션 이후에도 달리기 기록을 저장하세요.
통합 추가하기
알림, 건강 데이터, 또는 외부 서비스에 앱을 연결하세요.
모바일 앱 빌드 및 출시하기
동작하는 모바일 앱을 TestFlight와 앱 스토어로 이동하세요.
추가 도움이 필요하신가요?
- Agent가 웹 앱을 빌드하는 경우: 다시 시작하고 빌드 전에 앱 유형으로 Mobile app을 선택하세요.
- Expo Go 미리보기가 오래된 경우: 폰을 흔들고 개발자 메뉴를 열어 Refresh를 선택하세요.
- 탭 대상이 너무 작게 느껴지는 경우: Agent에게 터치 대상을 늘리고 기본 동작을 엄지 손가락 범위 내에 유지해달라고 요청하세요.
- 내비게이션이 복잡하게 느껴지는 경우: Agent에게 주요 플로우에 필요한 최소한의 화면으로 앱을 줄여달라고 요청하세요.
- 시뮬레이터는 작동하지만 폰은 작동하지 않는 경우: 실제 기기에서 하드웨어 특화 동작을 테스트하고 네이티브 모바일 앱을 참조하세요.
- 게시가 실패하는 경우: 모바일 앱 문제 해결을 참조하세요.