소개

webview-bridge-kit은 WebView 안의 웹 앱과 그것을 감싸는 React Native, Swift 또는 Kotlin 호스트 사이에서 타입 안전하게 메시지를 주고받기 위한 브릿지입니다.

웹과 네이티브가 하나의 contract를 함께 사용해서, 메시지 이름·페이로드·응답 타입을 컴파일 타임에 맞추고, 스키마를 붙이면 런타임에서도 검증합니다. WebView의 postMessage / injectJavaScript 위에 얇은 RPC + pub/sub 레이어를 올린 형태입니다.

메시지 세 종류

브릿지가 다루는 메시지는 다음 세 가지뿐입니다.

종류	방향	응답	용도
request	web → native	O	응답이 필요한 호출 (로그인, 토큰 조회 등)
command	web → native	X	응답이 필요 없는 명령 (화면 열기, 로그 전송 등)
event	native → web	X	네이티브에서 웹으로 보내는 알림 (딥링크, 앱 상태 등)

• request 는 Promise를 반환하고, 네이티브 handler의 반환값으로 resolve됩니다.
• command 는 fire-and-forget. 보내고 끝납니다.
• event 는 네이티브가 웹으로 push합니다. 웹은 구독(subscribe)해서 받습니다.

다음 단계에서 이 세 종류를 Contract로 정의하고 React, React Native, Swift, Kotlin에서 어떻게 쓰는지 살펴봅니다.