KO/EN
← 글 목록으로

두 달 안에 웹이랑 앱 둘 다? — WebView 래퍼를 고른 이유

읽는 시간 11분

처음 받은 조건

커리어 관리 + 전문가 노하우를 파는 이커머스 플랫폼 외주였다. 클라이언트가 원한 건 딱 두 가지였다.

  • 웹이랑 앱 둘 다
  • 두 달 안에

팀은 프론트(나) 1명, 백엔드 1명. 그런데 막상 시작하고 보니 작업량이 초기 와이어프레임의 3~4배로 불어나 있었다.

  • 관리자 페이지가 통째로 추가됐다. 상품·아티클·회원 관리는 물론이고, 필터 목록 수정 같은 자잘한 기능까지 전부 들어갔다.
  • 기존 기능도 하나하나 커졌다. 회원가입만 해도 그냥 가입이 아니라 프로필 작성, 관심사 선택 같은 단계가 줄줄이 붙어서 가입 관련 라우트만 4개가 됐다. 내 커리어(이력 관리)는 더했다. 학력, 경력, 프로젝트, 자격증, 어학 같은 이력서 항목마다 입력 화면이 따로 있고, 항목별 공개 설정에 이력서 레이아웃까지 붙었다.

여기에 PC 버전과 모바일 버전을 둘 다 만들어야 했으니, 화면 작업은 사실상 또 2배. 그때는 Figma MCP 같은 것도 없어서 디자인을 보고 화면을 하나하나 손으로 옮겨야 했다. 열심히 하면 어떻게든 된다는 계산이 안 나오는 상황이었다.

먼저 범위부터 자르기

그래서 코드를 짜기 전에 와이어프레임을 기준으로 기능 리스트부터 만들었다. 페이지 단위가 아니라 기능 단위로 쪼개고, 각각에 우선순위를 매겼다.

기준은 단순했다.

  • 이게 없으면 서비스가 안 돌아가는가? (로그인, 상품 조회, 결제 같은 것)
  • 출시 후에 붙여도 사용자가 크게 불편하지 않은가?

이렇게 나눠 보니 두 달 안에 전체의 70% 정도를 완성하고, 나머지는 유지보수 기간에 이어서 진행하는 게 현실적인 선이었다. 클라이언트와 이 기준으로 합의했다. 일정이 빠듯할 때는 "다 할게요"보다 "이건 언제, 저건 언제"를 먼저 정해두는 게 서로 덜 괴롭다.

웹 하나, 앱 하나 = 프로젝트 두 개

범위를 잘라도 남는 문제가 있었다. 클라이언트는 웹과 앱을 둘 다 원했는데, 이걸 곧이곧대로 하면 두 달 안에 프로젝트 두 개를 만들라는 말이 된다.

그래서 우리 쪽에서 WebView를 제안했다. 웹을 하나 잘 만들고, 앱은 그 웹을 감싸는 껍데기로 가는 방식이다. 설득할 때는 인스타그램이나 네이버 같은 큰 서비스도 앱 안의 상당 부분을 웹뷰로 띄운다는 점을 예로 들었다.

구조

구조는 단순하다.

  1. React(Vite)로 웹을 만든다. 사실상 작업의 대부분이 여기다. 모바일 화면을 기준으로 반응형으로 만든다.
  2. React Native 앱에서 이 웹을 WebView로 감싼다. 앱은 거의 껍데기 역할만 한다.
  3. Android Studio 에뮬레이터로 앱에서 어떻게 보이는지 수시로 확인하면서 작업한다.

실제로 앱 쪽 코드는 이게 거의 전부였다.

function App() {
  return (
    <SafeAreaView style={{ flex: 1 }}>
      <WebView source={{ uri: "http://10.0.2.2:5173" }} style={{ flex: 1 }} />
    </SafeAreaView>
  );
}

10.0.2.2는 안드로이드 에뮬레이터 안에서 내 PC의 localhost를 가리키는 주소다. 그래서 Vite 개발 서버를 켜 두면 에뮬레이터 앱에서도 웹과 똑같이 핫 리로드가 된다. 웹 개발하던 흐름 그대로 앱 화면을 같이 볼 수 있어서 편했다. 실제 배포할 때는 이 주소만 운영 도메인으로 바꾸면 된다.

웹에서 고치면 앱에도 바로 반영되니까, 화면 작업은 한 번만 하면 된다. 앱을 따로 빌드하고 배포할 일도 껍데기를 바꿀 때만 생긴다. 앱 심사를 다시 받지 않고 웹 배포만으로 기획 변경에 대응할 수 있다는 것도 장점이었다. 기획이 계속 바뀌는 초기 서비스에는 이게 생각보다 크다.

앱에서만 필요한 것들은 병행하기로

WebView라고 앱 작업이 0이 되는 건 아니다. 당시에는 "스토어에 올리려면 웹 코드에 앱만의 기능을 좀 더 붙여야 한다" 정도로만 알고 있었는데, 나중에 찾아보니 챙길 게 꽤 있었다.

1. 웹사이트를 감싸기만 한 앱은 심사에서 떨어질 수 있다

애플은 심사 가이드라인 4.2(최소 기능)에서 웹사이트를 그대로 감싼 앱을 반려 사유로 꼽고, 구글 플레이에도 비슷한 정책이 있다. 그래서 푸시 알림처럼 앱이라서 의미가 있는 기능을 붙여야 한다. 내가 들었던 "앱만의 기능"이 이 얘기였다.

2. 결제 흐름이 웹과 다르다

국내 PG 결제창은 결제 도중에 카드사 앱이나 간편결제 앱을 호출한다. 브라우저에서는 알아서 넘어가지만, WebView는 intent://나 카드사 앱 스킴 같은 http가 아닌 주소를 기본으로 처리하지 못한다. 그래서 네이티브 쪽에서 이런 요청을 가로채 외부 앱을 열어주고, 결제가 끝나면 다시 앱으로 돌아오는 처리를 따로 해야 한다.

3. 디지털 상품이면 스토어 결제 정책도 봐야 한다

이 서비스는 전문가 노하우(PDF 같은 디지털 콘텐츠)를 팔았다. 앱 안에서 디지털 상품을 팔면 스토어 인앱결제 정책의 적용을 받는다. 한국은 법 개정으로 외부 결제를 허용하지만 그래도 수수료가 붙는다. 웹에서는 신경 쓸 필요 없던 비용이 앱에서는 생기는 셈이다.

이런 앱 전용 작업은 웹 개발이 끝나는 시점에 맞춰 같이 진행하는 걸로 계획을 잡았다. 화면과 핵심 기능을 먼저 웹으로 끝내 두면, 앱에서 할 일은 이런 네이티브 연동과 정책 대응만 남기 때문이다.

그래서 출시는?

결론부터 말하면 앱 출시까지는 못 갔다. 개발을 마무리하던 즈음 클라이언트 쪽에서 사업을 빠르게 접기로 하면서, 알림·결제·스토어 출시 단계는 진행하지 않고 프로젝트가 끝났다.

아쉽긴 하지만, 돌아보면 이 구조를 고른 덕분에 손해도 적었다. 웹과 앱을 따로 만들고 있었다면 두 프로젝트 모두 반쯤 만든 상태로 끝났을 거다. WebView로 간 덕분에 최소한 웹은 완성된 상태로 남았다.

돌아보면

WebView가 늘 정답은 아니다. 애니메이션이나 제스처가 많은 앱, 카메라·블루투스처럼 네이티브 기능을 깊게 쓰는 앱이라면 처음부터 네이티브나 RN으로 가는 게 맞다. 웹뷰는 아무리 다듬어도 네이티브 앱과 미묘하게 다른 손맛이 남는다.

그래도 이런 조건이라면 지금도 같은 선택을 할 것 같다.

  • 기간이 짧고 인력이 적다
  • 화면 대부분이 콘텐츠 조회, 목록, 폼 같은 웹스러운 화면이다
  • 기획이 자주 바뀔 가능성이 높다

다만 다시 한다면 앱 전용 작업을 "나중에 병행"으로 미루지 않고 초반에 조사부터 해둘 것 같다. 심사 정책이나 인앱결제 수수료는 코드 문제가 아니라 기획과 비용 문제라서, 늦게 알수록 클라이언트와 다시 협의해야 할 게 커진다.

결국 이 프로젝트에서 한 일은 두 가지였다. 하는 일의 양을 줄이고(70% 범위), 같은 일을 두 번 하지 않게 만든 것(WebView). 기술 선택보다 이 판단이 더 중요했다.