네이티브 모바일 앱

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로 iOS 및 Android 앱을 빌드하고, 전화기에서 미리보기하고, 안내된 흐름을 통해 빌드를 준비하세요.

​

시작하기

몇 단계만으로 작동하는 모바일 앱을 만들 수 있습니다:

​

시뮬레이터 또는 에뮬레이터에서 미리보기

Replit은 Expo를 사용하여 전화기에서 모바일 앱을 실행하고 테스트할 수 있게 해줍니다. 또는 Replit이 실제 iOS 시뮬레이터 또는 Android 에뮬레이터를 미리보기 패널로 직접 스트리밍합니다. Agent로 변경 사항을 만들면 실제 기기에서처럼 시뮬레이터에서 핫 리로드됩니다.

​

시뮬레이터 열기

​

브라우저 지원

• Chrome, Safari, Chromium 기반 브라우저가 완전히 지원됩니다.
• Firefox는 지원되지 않습니다. Firefox에서 Replit을 열면 iOS 및 Android 옵션이 비활성화되고 “Firefox는 지원되지 않음” 메모가 표시됩니다. 이는 시뮬레이터를 구동하는 스트리밍 기술의 제한입니다.

​

대신 Expo Go를 사용해야 하는 경우

실제 하드웨어에 의존하는 기능을 테스트해야 하거나 컴퓨터 앞에 없는 사람과 미리보기를 공유하고 싶을 때 실제 전화기에서 Expo Go를 사용하세요:

• 카메라, 마이크, 햅틱, 기타 네이티브 센서
• 푸시 알림
• 실제 GPS 위치
• 팀원, 테스터, 또는 투자자와 개발 미리보기 공유

Expo Go에서 앱을 열려면 replit.com에서 프로젝트를 열고, 프로젝트 편집기의 미리보기 패널에서 Expo Go로 열기를 선택한 다음 전화기의 Expo Go 앱으로 QR 코드를 스캔하세요.

​

전체 화면 시뮬레이터

모바일 아티팩트 카드에서 추가 액션 → iOS 시뮬레이터에서 열기 또는 Android 에뮬레이터에서 열기를 선택하면 더 큰 뷰포트로 자체 탭에서 시뮬레이터를 열 수 있습니다.

​

모바일 앱을 빌드해야 하는 이유

다음이 필요할 때 모바일 앱을 빌드하세요:

• 네이티브 경험: 빠른 성능, 부드러운 상호작용, 플랫폼 네이티브 UI.
• 기기 기능: 카메라, 푸시 알림, 위치 등.
• App Store 배포: Apple의 App Review 프로세스 후 사람들이 발견하고 설치할 수 있는 공유 가능한 리스팅.

​

주요 기능

• AI 우선 생성: 앱을 설명하면 Agent가 작동하는 모바일 앱을 스캐폴딩합니다.
• 프로젝트 편집기 미리보기: Replit을 벗어나지 않고 iOS 시뮬레이터나 Android 에뮬레이터에서 테스트하거나, Expo Go로 전화기에서 미리보기하세요.
• 기본적으로 풀스택: 앱이 성장함에 따라 서버 경로, 데이터베이스, 앱 스토리지, 커넥터, AI 연동을 추가하세요.
• 안내된 제출: 로컬 iOS 툴체인을 관리하지 않고 TestFlight 및 App Store 제출을 위한 빌드를 준비하세요.

​

개발 워크플로우

앱에 접근하는 세 가지 단계가 있으며, 각각 다른 대상과 기능을 가집니다: 개발: 앱을 시작하면 프로젝트 편집기의 iOS 시뮬레이터 또는 Android 에뮬레이터에서 미리보기하거나, 미리보기 패널의 QR 코드를 스캔하여 전화기의 Expo Go에서 열 수 있습니다. 배포: 게시를 클릭하면 Replit이 Expo Go용 QR 코드가 있는 공개 URL을 만듭니다. 이는 개발 미리보기와 프로토타이핑에 이상적입니다. App Store 프로세스를 시작하기 전에 투자자에게 보여주거나, 피드백을 받거나, 친구들과 테스트하세요. App Store: App Store에 제출하면 Apple이 앱을 검토합니다. 승인 후 사람들이 App Store에서 다운로드하고 설치할 수 있습니다. Apple 개발자 계정이 필요합니다.

​

게시 개요

iOS 릴리스를 준비할 때 일반적인 흐름은 다음과 같습니다:

• 프로젝트 편집기에서 게시
• TestFlight에 빌드 제출
• App Store Connect에서 TestFlight 빌드를 App Store로 승격

전체 안내는 모바일 앱 빌드 및 출시 튜토리얼을 참조하세요.

​

네이티브 모바일 앱을 빌드하는 위치

Replit 환경은 로컬 머신이 아닌 클라우드에서 실행됩니다. 네이티브 모바일 앱을 빌드하려면 replit.com의 프로젝트 편집기를 사용하세요. 모바일 앱 워크플로우(Agent 스캐폴딩, Expo Go 미리보기, 시뮬레이터 및 에뮬레이터 테스트, TestFlight 빌드, App Store 제출)는 프로젝트 편집기에서 실행됩니다. 네이티브 모바일 앱 작업은 지원되는 경우 Replit Android 앱에서도 가능합니다. Replit iOS 앱을 사용 중이라면 replit.com에서 프로젝트를 열어 네이티브 모바일 앱을 만들고, 미리보기하고, 빌드하거나 제출하세요.

​

기술 작동 방식

모바일 앱은 함께 작동하는 기술 스택으로 빌드됩니다. 이 섹션에서는 앱을 구동하는 것과 각 요소가 어떻게 맞물리는지 설명합니다.

​

기술 스택

• React Native는 하나의 코드베이스를 작성하여 iOS, Android, 웹에 컴파일할 수 있는 오픈 소스 프레임워크입니다. 웹뷰가 아닌 플랫폼 네이티브 UI 컴포넌트를 렌더링합니다.
• Expo는 빌드를 처리하고, 네이티브 모듈을 관리하고, 미리보기를 위한 Expo Go 같은 도구를 제공하여 React Native 개발을 단순화합니다.
• Expo Go는 전화기에 설치하는 무료 앱입니다. 전체 네이티브 바이너리를 빌드하지 않고 실제 기기에서 테스트할 수 있도록 개발 미리보기를 실행합니다.

앱을 실행하면 Metro 번들러가 코드를 컴파일하여 기기로 푸시합니다. 첫 번째 빌드는 캐시가 없기 때문에 시간이 더 걸립니다. 이후 빌드는 더 빠릅니다.

​

아키텍처: 서버와 클라이언트

모바일 앱을 미리보기나 배포용으로 준비할 때 두 가지를 다룹니다:

1. 서버: 클라우드의 Replit에서 실행됩니다. 데이터베이스, API 경로, AI 연동, 백엔드 로직을 처리합니다.
2. 클라이언트 앱: 사람의 전화기에서 실행됩니다. 개발 중에는 Expo Go에서 미리보기되거나, 검토 후 앱 스토어를 통해 배포되는 네이티브 앱입니다.

이 분리를 통해 유연성이 제공됩니다. 서버에서 복잡한 로직을 실행하고(Replit의 데이터베이스, 오브젝트 스토리지, 커넥터에 접근 가능) 클라이언트를 가볍게 유지할 수 있습니다. 빌드하면서 전화기에서 일어나야 할 일과 클라우드에서 일어나야 할 일을 생각해보세요.

​

고려 사항

• 게시 요구 사항: Apple이 TestFlight 및 App Store에 대한 요구 사항을 설정하며, Apple이 배포 전에 iOS 앱을 검토합니다.
• Android 게시: iOS 및 Android용 크로스 플랫폼 앱을 빌드할 수 있습니다. 안내된 경험을 통한 Google Play 게시는 아직 지원되지 않지만 수동으로 완료할 수 있습니다.
• 네이티브 변경: 앱 아이콘이나 권한 같은 변경은 일반적으로 새 스토어 빌드가 필요합니다.

​

문제 해결

모바일 앱 개발 중 문제가 발생하면 일반적인 문제와 해결 방법에 대해 모바일 앱 문제 해결을 참조하세요.

​

다음 단계

• Agent 작동 방식 알아보기: Agent
• 연동 탐색: 연동
• 모바일에서 Replit 사용: Replit 모바일 앱
• Expo에 대해 자세히 읽기: Expo
• TestFlight 및 제출 관리: App Store Connect

​

FAQ