WEBVIEW:LAB · FAQ
자주 묻는 질문
실제 운영하면서 자주 받는 질문을 모아 두었습니다. 더 궁금한 점이 있으시면 /contact로 보내 주시면 됩니다.
App Store에서 "Minimum Functionality(4.2)"로 거절되면 어떻게 되나요?+
100% 거절되지는 않지만, 웹뷰 래퍼 앱이 가장 자주 막히는 지점이 바로 이 4.2 조항입니다. 그래서 저희는 빌드를 돌리기 전에 사이트를 한 번 분석해 0~100점으로 거절 위험을 먼저 알려드립니다. 로그인 · 결제 · 멤버십 · 예약처럼 "웹사이트만으로는 불편한 기능"이 있을수록 점수가 올라갑니다. 만약 실제로 거절되면 스토어 등록 키트에 포함된 4.2 응답 템플릿(한국어 · 영어)으로 심사자에게 회신하는 절차를 함께 안내해 드립니다.
출시 전 진단(Apple 4.2 위험 점수)은 무엇을 보고 매기나요?+
사이트를 한 번 가져와 9가지 신호를 확인합니다. viewport meta · web app manifest · service worker(PWA 여부) · 로그인 폼 · 회원가입 흐름 · 장바구니 · 결제 키워드 · 푸시 알림 권한 요청 · 모바일 반응형 여부 등입니다. 신호가 많을수록 "단순 웹사이트가 아니라 앱처럼 동작하는 사이트"로 판정되어 점수가 올라갑니다. 진단은 빌드 횟수를 차감하지 않으니, 사이트를 수정하실 때마다 자유롭게 다시 돌리실 수 있습니다.
4.2 거절 위험을 낮추려면 사이트에 무엇을 더해야 하나요?+
심사자가 "이건 그냥 사파리에서 봐도 되는데?" 라고 느끼지 않게 만드시면 됩니다. 가장 효과가 큰 순서로 회원 로그인, 주문 · 예약 · 멤버십 기능, 푸시 알림 수신 동의, PWA(manifest + service worker) 추가, 카메라 · 위치 · 연락처 같은 네이티브 권한 활용 등입니다. 음식점이라면 "주문 내역 보기"와 "단골 쿠폰", 학원이라면 "내 수업 일정"처럼 로그인이 있어야 의미가 있는 화면 한두 개만 있어도 점수가 크게 달라집니다.
빌드는 얼마나 걸리나요?+
Android · iOS 모두 Codemagic 클라우드 워커에서 처리되며, 큐 대기 시간까지 합쳐서 평균 4~8분 정도 걸립니다. 진행 상황은 대시보드에서 3초 간격으로 갱신됩니다. 직접 macOS 머신을 운영하시지 않아도 iOS IPA가 나온다는 장점이 있고, 대신 빌드 환경 자체는 Codemagic이 관리합니다.
빌드가 실패하면 횟수가 차감되나요?+
차감되지 않습니다. 빌드 실패(타입스크립트 오류, 코드 사인 실패, Apple 인증서 만료 등)는 횟수에서 빠지지 않으니 안심하고 다시 시도하실 수 있습니다. 차감은 APK 또는 IPA 산출물이 정상적으로 생성된 경우에만 발생합니다.
내 사이트가 PWA가 아니어도 되나요?+
됩니다. PWA가 적용되어 있으면 진단 점수가 높게 나오고 오프라인 대응도 더 매끄러워지지만, 일반 반응형 사이트도 빌드는 가능합니다. 다만 이 경우 Apple 4.2 거절 위험은 일반적으로 더 높게 나옵니다.
푸시 알림을 보내려면 처음에 무엇을 준비해야 하나요?+
처음 한 번만 두 가지 키를 등록해 주시면 됩니다. (1) Android — Firebase 콘솔에서 프로젝트를 만들고 "서비스 계정" JSON 파일을 내려받아 업로드합니다. (2) iOS — Apple Developer 계정에서 APNs Auth Key(.p8 파일)와 Key ID, Team ID를 발급받아 업로드합니다. 두 가지 모두 대시보드 안에 단계별 캡처가 포함된 가이드가 있어 처음 하시는 분도 30분 안에 끝내실 수 있습니다. 등록 이후에는 대시보드에서 바로 푸시를 보내실 수 있습니다.
푸시는 누구에게 어떻게 전달되나요?+
앱을 처음 켠 사용자가 푸시 알림 권한에 동의하면, 그 기기의 토큰이 elabhub에 자동으로 저장됩니다. 대시보드에서는 Android만, iOS만, 또는 모두에게 한 번에 보낼 수 있고, 발송 후에는 디바이스별로 전달 성공 · 실패 결과까지 확인하실 수 있습니다. 한 사용자가 여러 기기에서 앱을 켜면 기기마다 따로 카운트됩니다.
FCM · APNs 키는 안전하게 보관되나요?+
elabhub에서 AES-256-GCM(96-bit IV, 128-bit auth tag)으로 즉시 암호화한 뒤 DB에 저장합니다. 빌드 · 푸시를 보낼 때만 워크트리나 요청 안에서 잠깐 복호화한 뒤 바로 폐기되며, 평문 키가 디스크에 남지 않습니다. 저희 운영자도 평문 키 자체는 볼 수 없는 구조입니다.
사이트가 바뀌면 앱을 다시 빌드해야 하나요?+
아니요. 사이트 수정 사항은 앱에 곧바로 반영됩니다(웹뷰가 매번 사이트를 새로 불러오는 구조이기 때문입니다). 다시 빌드가 필요한 경우는 앱 아이콘, 스플래시 화면, 푸시 설정, 권한, 버전 코드처럼 네이티브 셸 자체가 바뀔 때입니다.
스토어 등록 비용은 별도인가요?+
네. Apple Developer Program 연 $99와 Google Play Developer 1회 $25는 직접 부담하셔야 합니다. WEBVIEW:LAB은 셸 빌드, 푸시 발송, 진단, 등록 가이드까지만 제공합니다.
어떤 사이트에 가장 잘 맞나요?+
단골이 반복해서 들어오는 사이트, 그리고 푸시 알림으로 다시 불러올 만한 사이트에 효과가 큽니다. 예시로는 카페 · 식당 멤버십, 학원 · 교습소 알림, 동네 약국 처방 알림, 병원 예약 안내, 쇼핑몰 세일 알림, 콘텐츠 매거진 발행 알림 등이 있습니다. 반대로 처음 한 번만 방문하고 끝나는 정보성 사이트(공지 페이지 등)는 굳이 앱으로 만들 이유가 약합니다.
해지하면 빌드한 앱은 어떻게 되나요?+
이미 빌드해서 받아 두신 APK · IPA는 그대로 쓰실 수 있고, 사이트 자체도 계속 동작하기 때문에 앱이 멈추지는 않습니다. 다만 새 빌드, 푸시 발송, 진단은 결제를 다시 시작하시기 전까지 막힙니다. 스토어에 이미 올라간 앱은 결제 상태와 무관하게 계속 노출됩니다.
Pro와 Studio는 어떤 차이가 있나요?+
Pro는 월 20회 빌드 · 푸시 무제한 · 앱 슬롯 5개입니다. Studio는 월 50회 빌드 · 앱 슬롯 무제한 · 빌드 큐 우선 처리가 더해집니다. 에이전시처럼 여러 고객사의 앱을 한 계정에서 운영하신다면 Studio를 권장합니다. 빌드 한도는 Codemagic 빌드 시간 비용을 안정적으로 관리하기 위한 것이며, 일반적인 운영 패턴(앱 1개당 월 1~3회 업데이트)에서는 한도에 닿지 않습니다.