네이티브 앱 안에 웹뷰를 띄워 화면 일부를 웹으로 만들다 보면, 웹과 앱이 주고받는 브릿지 메시지가 문제일 때가 많은데, 확인하려면 핸들러마다 로그를 넣고 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