← 목록으로

Show GN: Dari - 앱과 웹뷰가 주고받는 브릿지 메시지를 요청·응답 짝으로 보여 주는 디버그 도구 (Android/iOS)

요약
  • 앱과 웹뷰 간의 브릿지 메시지를 요청과 응답 짝으로 묶어 한눈에 확인할 수 있는 오픈소스 디버그 도구 'Dari'가 안드로이드와 iOS 지원으로 공개되었습니다.
  • 이 도구를 통해 개발자와 QA는 핸들러별 응답 시간, JSON 데이터, 상태 등을 손쉽게 모니터링할 수 있습니다.

네이티브 앱 안에 웹뷰를 띄워 화면 일부를 웹으로 만들다 보면, 웹과 앱이 주고받는 브릿지 메시지가 문제일 때가 많은데, 확인하려면 핸들러마다 로그를 넣고 Logcat이나 Xcode 콘솔을 스크롤하며 요청과 응답을 손으로 맞춰 봐야 했습니다. 이 메시지들을 한 목록에서 보려고 만들었습니다.

핵심

  • 웹에서 앱으로, 앱에서 웹으로 오가는 호출을 requestId로 짝지어 한 줄에 보여 줍니다
  • 상태(진행 중, 성공, 에러), 소요 시간, 정리된 JSON, 핸들러별 평균·최대 응답 시간을 볼 수 있습니다
  • 데스크톱 앱(macOS, Windows, Linux)에서 Android는 adb로, iOS는 Mac에서 Simulator나 USB 기기로 연결합니다. 프록시나 인증서 설정은 없습니다
  • 기기 안에서도 봅니다. Android는 알림과 흔들기로 열고, iOS는 앱의 디버그 메뉴에서 엽니다

그 밖의 기능

  • 브릿지 코드를 고치지 않고 기록: Android는 Gradle 플러그인, iOS는 autoCapture나 @DariBridge 매크로
  • 토큰, 비밀번호 같은 값 가리기, 직접 정한 규칙 추가
  • Protocol Buffers payload 디코딩
  • 텍스트, JSON 내보내기
  • 앱을 다시 켜도 기록 유지

알아 둘 점

  • 디버그용입니다. 릴리스 빌드에는 들어가지 않게 Android는 dari-noop, iOS는 #if DEBUG를 씁니다
  • iOS를 데스크톱 앱으로 보려면 Mac이 필요하고, Wi-Fi 연결은 아직 Android만 됩니다
  • requestId로 요청과 응답을 맞추는 구조라, 콜백 방식이 많이 다른 브릿지에서는 짝이 안 맞을 수 있습니다

Android 쪽은 Android Weekly #748에 소개됐고, 이번에 iOS도 기기 안 인스펙터까지 지원하게 되어 올려 봅니다. 오픈소스(Apache-2.0)입니다.

특히 이런 피드백이 궁금합니다.

  • 쓰고 계신 브릿지 구조(콜백 이름, 메시지 형식)에서 요청과 응답이 제대로 짝지어지는지
  • iOS 앱 내 인스펙터를 실제 QA에서 쓸 때 빠진 기능이 무엇인지

댓글 남겨 주시면 하나씩 답하겠습니다.

문서: https://easyhooon.github.io/dari
데스크톱 앱: https://easyhooon.github.io/dari/download

그냥 목록으로
원문 보기 ↗