1. 프레임워크앱 골격
실제 앱 실행 구조와 화면을 만드는 기술. Capacitor, React Native, Flutter, Tauri.
Next.js 사이트를 Expo 버튼 한 번에 앱으로 바꾸는 관계는 아니다. Windows에서 iPhone 최종 빌드는 Mac(로컬 또는 클라우드)이 필요하고, 웹을 껍데기로 감싼 것만으로는 Apple App Store 4.2 심사를 통과한다고 단정할 수 없다.
Android Studio의 Gradle JDK와 JAVA_HOME이 다르면 데몬이 둘 뜨거나 싱크가 실패한다.
Expo Free는 저우선 대기열이다. 공식 문서는 피크 때 90분 이상 기다릴 수 있다고 적는다.
2023-11-13 이후 Google Play 개인 계정은 12명이 연속 14일 참여한 뒤 프로덕션 신청 검토가 있다.
이미 웹이나 웹앱을 만든 사람(다수는 AI로 화면을 붙인 사람)이 막히는 지점은 프레임워크 이름이 아니라 서명, 빌드 기계, 스토어 심사다.
실제 앱 실행 구조와 화면을 만드는 기술. Capacitor, React Native, Flutter, Tauri.
카메라, 푸시, 로그인, 결제를 OS와 연결. Capacitor Plugins, Expo SDK, 앱인토스 SDK.
코드를 APK, AAB, iOS 배포용 빌드로 컴파일하고 인증서로 서명. Expo Build/EAS, Codemagic, Bitrise.
코드를 커밋하면 테스트·빌드·업로드를 자동 실행. GitHub Actions. 코드 저장만으로 저절로 빌드되지는 않는다.
사용자가 검색해 설치하는 마켓. Google Play, Apple App Store, 원스토어, Galaxy Store.
토스, LINE, WeChat 앱 안에서 즉시 실행. 일반 스토어용 APK나 IPA를 올리는 곳이 아니다.
용어 구분 iPhone·iPad 앱은 Apple App Store, Mac 컴퓨터 앱은 Mac App Store, Android는 Google Play · 원스토어 · Galaxy Store다. 이번 지도는 휴대폰 앱이 중심이다.
Capacitor와 Tauri는 이미 만든 웹 화면을 살리기 좋다. React Native(Expo)와 Flutter는 모바일 전용 화면을 새로 그린다. Next.js로 짰다고 Expo 변환 버튼이 생기는 관계가 아니다.
div 대신 모바일 컴포넌트로 화면을 다시 짠다.Next.js 주의 화면을 앱에 넣어도 Node 서버, Route Handler API, DB는 휴대폰 안에 들어가지 않는다. 앱에 포함할 화면은 정적 출력(output: 'export')·클라이언트 실행으로 분리하고 서버 API는 외부 호스팅과 통신하도록 설계한다(Tauri의 Next.js 공식 안내도 정적 내보내기 기준).
빌드한 정적 웹 파일을 앱 내부에 탑재하고 데이터만 서버 API와 주고받는다. 모바일 친화적인 React·Vue·Svelte 웹앱에 카메라·푸시·딥링크가 일부 필요할 때 정석이다.
스윙투앱, Median, WebViewGold 등. 초기 제작은 가장 빠르다. 단, 제작 범위, 원본 소스 제공 여부, 월 유지비, 거절 시 심사 책임을 먼저 확인해야 하며 승인이 보장되지 않는다.
PWABuilder와 Bubblewrap으로 Trusted Web Activity 패키지를 만들고 assetlinks.json(Digital Asset Links)으로 도메인 소유를 증명한다. iOS에는 TWA 경로가 없다.
기존 서버·DB·API는 그대로 재사용하고 휴대폰 화면만 새로 짠다. 네이티브 탭 탐색, 제스처, 오프라인 동기화, 깊은 기기 기능이 핵심이면 단순 포장 비용만 비교하지 않는다.
심사 기준 확인 Apple App Store Review Guidelines 4.2(Minimum Functionality)는 단순 재포장한 웹사이트를 넘어서는 기능, 콘텐츠, 앱다운 UI를 요구한다(가이드라인 페이지 Last Updated: 2026-10-16).
원문 추천 골격을 유지한다. 깊은 조사가 바꾼 것은 “누가 1등인가”가 아니라 각 선택지의 실제 함정이다. 이 셋을 먼저 가른 뒤 Flutter, 네이티브, Tauri를 요구 기능에 맞춰 검토한다.
이미 작동하는 반응형 웹앱을 살리는가? Android는 내 PC 로컬 빌드, iOS는 클라우드 Mac 빌드를 먼저 비교한다(Appflow는 장기 기본값 제외).
모바일 앱 화면을 새로 만드는가? React·TS 생태계와 Expo Build(EAS) 클라우드 서명·제출 파이프라인을 기준점으로 삼는다.
토스 사용자에게 스토어 설치 장벽 없이 바로 서비스를 여는가? 일반 스토어 앱과 전혀 다른 .ait 번들 체계다.
| 작업 / 명령어 | Windows 로컬 | 클라우드 · macOS |
|---|---|---|
| 앱 코드 작성 | 웹, JS/TS, Dart, Rust 모두 가능 | 선택 사항 |
| Android 개발 · APK · AAB | 가능 (Android SDK · JDK · 드라이버 설정) | 가능 (Linux/macOS 러너) |
| iOS 최종 빌드 · 서명 (IPA) | 일반적인 Xcode 로컬 빌드 불가 | macOS 빌드 서비스 필수 (또는 실물 Mac) |
| iOS 시뮬레이터 실행 | Xcode 로컬 시뮬레이터 불가 | 실물 Mac 로컬 실행 (원격 Mac·실기기 테스트 별도) |
eas build | 내 PC가 컴파일하지 않고 소스를 전송 | 클라우드 워커에서 Android·iOS 컴파일·서명 |
eas build --local | 공식 미지원 (WSL 우회는 비공식) | 공식 지원은 macOS · Linux (GitHub 러너 활용) |
npx expo run:android | 내 PC에서 직접 네이티브 Android 컴파일 | 클라우드 빌드(eas build)와 완전히 다른 로컬 명령 |
Capacitor 환경 공식 문서 그대로 iOS 앱을 빌드하려면 macOS와 Xcode가 필요하다. Windows에서는 코드 작성과 Android 실기기 디버깅까지만 로컬로 처리하고, iOS 배포 빌드는 클라우드 Mac 서비스를 붙이는 것이 정석이다.
주의: Tauri(Rust)를 골라도 Android SDK·NDK와 iOS용 Xcode 요구사항을 없애 주지 않는다.
현실적인 절충 평소에는 Android 실기기 로컬 테스트 + 출시 때 클라우드 빌드 조합이 가장 경제적이다. 단, 깊은 네이티브 충돌을 잡을 때는 Android Studio와 Xcode가 여전히 도움이 된다.
| 서비스 | 잘 맞는 상황 | 핵심 확인 포인트 |
|---|---|---|
| Expo Build / EAS | Expo · React Native 우선 | 클라우드 컴파일, 서명 관리, 내부 배포, 스토어 자동 제출 연결. CLI 명령은 eas. |
| Codemagic | Flutter · RN · 네이티브 | macOS 빌드 머신 대여부터 테스트·스토어 배포까지 하나로 묶는 모바일 특화 CI. |
| Bitrise | 다중 플랫폼 운영 팀 | 모바일 빌드·테스트·서명·배포 스텝 라이브러리가 풍부한 워크플로 서비스. |
| GitHub Actions | 빌드 환경을 직접 통제할 때 | Linux·Windows·macOS 러너 제공. YAML 워크플로와 버전 고정을 직접 작성해야 한다. |
| Appcircle | Ionic · Capacitor 포함 | 엔터프라이즈·내부 배포와 함께 Capacitor를 포함한 Ionic 빌드 공식 안내 보유. |
| Capgo Cloud Build | Capacitor 전용 경량화 | 물리적 Mac 없이 iOS·Android 클라우드 네이티브 빌드와 서명을 처리하는 경로. |
Android 키스토어(.jks), Apple 배포 인증서(.p12)·프로비저닝, 스토어 API 키는 절대 Git 코드 저장소에 커밋하지 않고 CI의 암호화된 Secret 금고에 넣는다.
Expo(eas submit) 등도 성공한 빌드의 스토어 업로드를 자동화할 뿐, 앱 심사를 면제해 주지는 않는다.
핵심 구분 “업로드 자동화 완료” 메시지는 App Store Connect나 Play Console 대기실에 파일이 도착했다는 뜻이지, 출시 승인이 났다는 뜻이 아니다.
Ionic의 상용 클라우드 빌드 제품(Appflow) 신규 판매는 멈췄다. 단, Capacitor 오픈소스 프레임워크 자체가 끝난다는 뜻이 아니다.
Just spent over 3 hours on an Expo EAS build that sat in the free-tier queue forever.게시글 @saadbuilds_ · 2026-03-19 KST (공식 SLA가 아닌 체감 사례) · 원문
2026-09-17 스냅샷에서 Android 대기 작업 1,400건이라는 글이 있으나 그 순간의 큐다. 실시간 현황은 expo.dev/eas-build-status에서 본다.
크레딧을 아끼려 GitHub Actions와 eas build --local을 쓰는 글이 있다. 그 전제는 Windows 로컬이 아니라 Linux나 macOS 러너다.
기존 웹 프로젝트를 토스 내부용으로 넓힐 때 쓴다. 패키지 설치·초기화·설정 뒤 번들 빌드 → 콘솔 업로드 → 토스 앱 테스트 → 출시 요청 순서다.
Granite와 @apps-in-toss/framework 조합. 공식 가이드는 Granite 1.x만 호환되며 네이티브 모듈은 지원 범위만 허용된다고 적는다. npm run build 결과는 서비스명.ait.
| 컨테이너 / SDK | 동작 방식 | 혼동하면 안 되는 핵심 차이 |
|---|---|---|
| LINE MINI App / LIFF | LINE 내부 브라우저 기반 웹앱 | 단순 웹 URL 링크 공유와 공식 검증된 미니앱 입점 심사는 절차가 다르다. |
| WeChat Mini Program | WeChat 전용 프레임워크(WXML)와 API | 일반 HTML 웹사이트를 그대로 집어넣는 범용 WebView 껍데기가 아니다. |
| Alipay Mini Program | Alipay 전용 개발 도구와 런타임 | 사업자 입점 자격과 서비스 지역 조건을 먼저 확인해야 한다. |
| 카카오 · 네이버 로그인 | 외부 인증 OAuth SDK | 소셜 로그인 버튼을 붙인 것은 해당 슈퍼앱 안의 미니앱 입점이 아니다. |
| 배포처 | 대상 OS | 패키지 형식 · 운영 특징 |
|---|---|---|
| Google Play | Android | AAB(Android App Bundle)가 게시 표준. Play가 기기 사양에 맞는 APK를 쪼개 만든다. |
| Apple App Store | iPhone · iPad | Xcode/클라우드 Mac에서 서명한 빌드를 App Store Connect에서 테스트·심사·배포. |
| 원스토어 (ONE store) | Android | 국내 독립 앱마켓. 원스토어 개발자센터에서 바이너리 등록, 검수, 인앱 결제를 별도 관리. |
| Galaxy Store | 삼성 기기 대상 | Samsung Seller Portal에서 설치 파일, 인앱 상품, 배포 국가를 관리. |
| APK 직접 배포 | Android | 사용자에게 설치 파일을 직접 전달 가능. 단, 마켓 노출과 자동 업데이트는 직접 설계해야 한다. |
| PWA | 지원 브라우저 | 스토어 심사 없이 홈 화면에 추가. 푸시·백그라운드 등 기기 기능 한계는 OS별로 확인한다. |
APK는 폰에 바로 깔리는 설치 파일이고, AAB는 스토어 제출용 묶음이다. 또한 Google Play App Signing에서는 개발자가 쥐는 업로드 키와 최종 배포용 앱 서명 키가 별도다.
기억할 점 디버그용 assembleDebug APK는 테스트용 임시 키로 묶인 파일이라 어느 앱스토어에도 정식 출시용으로 올라가지 않는다.
프레임워크 이름보다 먼저, 결제·로그인·블루투스 SDK가 해당 런타임 버전에서 지원되는지 카드를 눌러 점검해 보자.
Capacitor 참고 앱 생명주기·딥링크를 다루는 App API와 푸시 알림 API 등이 개별 플러그인으로 나뉘어 있다. 기능을 붙인 뒤 반드시 실기기에서 권한 거절 시나리오까지 확인한다.
| 관문 | 확인된 공식 기준 (날짜·수치) | 절대 단정하지 말아야 할 통념 |
|---|---|---|
| Apple 4.2 | 재포장한 웹사이트를 넘어서는 고유 기능, 콘텐츠, 앱다운 UI 요구 (페이지 Last Updated 2026-10-16). | “WebView를 쓰면 무조건 자동 거절된다” 또는 “감싸기만 해도 무조건 통과된다.” |
| Apple 4.2.6 | 상용 템플릿·앱 생성 서비스로 찍어낸 앱은 콘텐츠 제공자 본인 계정이 직접 제출하지 않으면 거절될 수 있다. | “외주 대행사나 AI 빌더 서비스 계정으로 고객 앱을 대신 올려주면 끝난다.” |
| Play 12 × 14 | 2023-11-13 이후 생성된 개인 계정 대상. 12명이 연속 14일 비공개 테스트에 참여한 뒤 프로덕션 접근 신청·검토(초기 20명 → 2024-12-11부터 12명). | “12명 등록만 채우면 당일 바로 출시된다.” (중간에 인원이 빠져 미달되면 연속 14일이 다시 계산된다.) |
| TestFlight | 업로드한 빌드당 최대 90일 유효. 90일이 지나면 테스터 기기에서 해당 빌드는 만료되어 실행되지 않는다. | “정식 심사 없이 TestFlight 링크만으로 영구적인 서비스 유통 채널을 운영할 수 있다.” |
| Android 개발자 검증 | 2026-09-30부터 브라질, 인도네시아, 싱가포르, 태국의 참여 스토어·인증 기기에 우선 적용, 2027 글로벌 확대 예고. 참여 스토어: Play, HONOR, OPPO, Galaxy Store, Palm Store, vivo, Xiaomi GetApps. | “APK 사이드로드가 이미 전 세계에서 완전히 금지됐다.” (미등록 앱도 ADB나 고급 사이드로드로 설치 경로가 남아 있으며, 취미용 제한 배포 계정은 신분증 없이 최대 20대까지 가능.) |
“invalid gradle JDK config.” — 다시 싱크하니 해결됐고, Studio가 잘못된 JDK를 잡는 경우가 많아 Gradle JDK를 직접 지정.@ipla03 · 2025-10-28 KST · 게시글
“The root cause is the Gradle JDK being incorrectly configured.”@birch_js · 2025-07-10 KST · 게시글
→ 번역: 근본 원인은 Gradle JDK가 잘못 설정된 것이다.
“Android Studio was using 73 GB on my Mac.”당사자 제보 @md_kadiwal · 2026-10-22 KST · 게시글
→ 번역: Mac에서 73GB 점유 (NDK 6버전 17GB, 에뮬레이터 이미지 4개 20GB, Pixel 에뮬레이터 14GB, Gradle 16GB).
“No mac made it even harder.”@eliana_jordan · 2026-02-21 KST · 게시글
→ 번역: Mac이 없어서 더 어려웠다. App Store와 Google Play 설정이 코딩보다 어려웠다.
“Minimum functionality (4.2) — feels like a wrapped website, not a real app.”@attilabuild · 2026-08-03 KST (흔한 거절 사유 2위) · 게시글
→ 번역: 최소 기능성(4.2) — 진짜 앱이 아니라 웹사이트를 감싼 것처럼 느껴짐.
Flutter doctor로 Pixel 에뮬레이터를 3일째 못 띄웠고, 오류는 대부분 Gradle이었다.@rob3rtb3ll · 2025-06-17 KST · 게시글
Play 12×14의 실증 불만은 ACM 논문, r/googleplayconsole, r/androiddev 참고. React Native 업그레이드는 한 버전씩 올리는 것이 원칙이며, 0.73→0.82 한 번에 넘긴 생존기는 개인 기록이다.
이미 React나 TypeScript를 다루면 Expo가 기본 출발점이라는 글이 반복된다. LLM이 React/TS 코드를 더 잘 짠다는 이유로 5년 쓰던 Flutter에서 옮긴다는 사례도 있다(개인 게시글이지 전체 설문 통계는 아님).
완성된 웹 화면이 이미 있을 때 가장 먼저 비교한다. 단, Apple 4.2는 단순 웹 껍데기처럼 보이면 되묻기 때문에 오프라인 동작이나 햅틱·푸시 같은 네이티브 가치를 먼저 넣으라는 조언이 따른다.
OS에 구애받지 않는 일관된 픽셀 UI를 처음부터 새로 그릴 때의 강력한 후보다. 모두가 떠난다는 흐름만 있는 것은 아니며, 단지 “기존 HTML 웹을 포장하는 도구”와 목적이 다를 뿐이다.
Android·iOS·Web으로 확장 중이며 Lynx 4.0 글이 나와 있다. 다만 이번 조사에서 Expo나 Flutter만큼 커뮤니티 합의가 모이지 않았다(언급량이 적다고 점유율이 작다고 단정하지 않으며, 초보 기본 추천에만 아직 올리지 않는다).
Rork 현재 문서는 새 Expo 프로젝트를 만들지 않고 신규는 Swift·Kotlin·웹으로 안내한다(기존 Expo 프로젝트 빌드·게시는 유지). Apple 개발자 계정 $99/년은 본인 부담이며, Bolt는 생성 후 보통 본인이 EAS를 돌린다. Replit의 Play 자동 제출 공식 문구는 확인되지 않았다.
| 현재 출발 상황 | 가장 먼저 검토할 조합 | 반드시 챙길 주의점 |
|---|---|---|
| 웹앱을 양대 스토어에 | Capacitor + Android 로컬 + iOS 클라우드 (Appflow는 장기 기본값 제외) | Apple 4.2 대비 네이티브 가치 보강. Next.js 서버·DB는 폰 안에 넣지 않는다. |
| URL만 빨리 시험 포장 | 스윙투앱, Median, WebViewGold | 월 비용, 원본 소스 제공 여부, 거절 시 심사 책임 확인. 스토어 승인 보장 아님. |
| 처음부터 AI로 모바일 앱 | React Native + Expo + Expo Build(EAS) | 무료 큐(90분+), 크레딧, Apple 4.2·4.2.6, Play 12×14. Rork 신규는 현재 문서를 다시 확인. |
| 모바일 UI를 새로 설계 | Flutter + Codemagic 등, 또는 KMP / Compose Stable | 기존 HTML/CSS 웹 소스 재사용률은 낮다. |
| Android만, 완성된 PWA | PWABuilder / Bubblewrap + TWA | Digital Asset Links 도메인 검증 필수. iOS에는 TWA가 없다. |
| 토스 안에서 설치 없이 | 앱인토스 WebView (필요하면 Granite 1.x에서 .ait) | 일반 Expo·Capacitor 결과물을 그대로 올리는 곳이 아니다. |
| Rust 백엔드 + 기존 웹 UI | Tauri 2 (모바일 플러그인 지원 범위부터 검증) | Android SDK, NDK, macOS Xcode 요구사항은 그대로 남는다. |
| UI까지 전부 Rust로 | Dioxus (작은 시제품·실험 중심) | 상용 결제·광고 등 모바일 플러그인 성숙도를 먼저 확인한다. |
| 복잡한 OS 저수준 연동 | Kotlin · Swift 네이티브, 또는 검증된 크로스플랫폼 | 두 플랫폼 코드베이스를 따로 유지·운영하는 인력 부담. |
| 빌드 파이프라인 장기 통제 | GitHub Actions + 도구 버전 고정 + 서명 키 분리 | Windows 로컬에서 eas build --local은 공식 지원 불가(Linux/macOS 러너 사용). |
Android 프로젝트 생성과 capacitor.config의 webDir 경로가 맞다는 전제다.
결과물은 테스트용 디버그 APK다. 정식 출시 키스토어 서명과 스토어 등록은 별개 단계다.
Expo 계정, 프로젝트 연결, eas.json 설정, 양대 플랫폼 서명 자격 증명이 끝났다는 전제다.
내 PC가 두 플랫폼을 컴파일하지 않는다. 압축된 소스를 EAS 클라우드 Linux/macOS 워커로 보낸다.
package-lock.json 등)과 네이티브 도구 버전을 고정한다.재현성 원칙 매번 latest 최신 버전을 자동으로 끌어오기보다, 한 번 성공해 검증한 JDK · AGP · Gradle · Xcode 버전 조합을 고정해 다시 쓰는 쪽이 훨씬 안정적이다.
GitHub 저장소에 코드를 푸시하거나 버전 태그(v1.0.0)를 찍어 파이프라인을 깨운다.
잠금 파일 기준으로 패키지를 설치하고 타입 체크와 기본 테스트를 통과시킨다.
정적 웹 번들을 추출하거나 React Native · Flutter 모바일 번들을 생성한다.
Android(Gradle)와 iOS(Xcode 클라우드) 바이너리를 각각 기계어로 빌드한다.
서명 키는 CI Secret 금고에만 둔다. 외부 PR 기여가 서명 키에 닿지 않게 워크플로를 분리한다.
Play 개인 계정은 12명×연속 14일이 걸릴 수 있고, TestFlight 빌드는 90일 한도다.
콘솔 대기실까지 파일 제출을 자동화할 수 있다. 여기까지가 빌드 도구의 역할 끝이다.
Apple 4.2 · 4.2.6과 개발자 계정 조건은 그대로 남는다. 어떤 도구도 대신 통과시켜 주지 않는다.
팩 refs의 research.md, x-trends.md, MEMO.md, source.md만 사용했다. 스윙투앱·Median·WebViewGold·원스토어·Galaxy Store는 원문 지도의 이름이고, 확인되지 않은 요금 숫자는 적지 않았다.