쏘카프레임 - 블루투스 모듈
Summary
차 문 여는 블루투스 로직, 쏘카는 왜 아키텍처부터 새로 짰을까?
iOS와 Android의 파편화된 블루투스 API를 하나로 묶어 비즈니스 유연성을 극대화한 쏘카프레임 설계기
쏘카, 일레클, 따릉이 등 다양한 모빌리티를 하나의 앱으로 제어하기 위해 쏘카가 구축한 커스텀 블루투스 모듈의 핵심 설계를 소개합니다. 로우 레벨 API의 한계를 극복하고 기기의 정체성을 클래스 단위로 응집시킨 '쏘카프레임'의 아키텍처와 그 가치를 다룹니다.
- 01플랫폼 API의 파편화를 극복하고 기기 중심의 객체지향적 추상화 계층 구축
- 02가상 스캔 매니저를 통한 iOS와 Android의 블루투스 동작 방식 차이 완벽 해소
- 03BluetoothSpec과 Handle의 분리로 실시간 비즈니스 로직 교체 유연성 확보
- 04비즈니스 계층을 하드웨어 복잡성으로부터 분리하여 개발 생산성 획기적 개선
- 05하드웨어 의존성을 끊어낸 Mocking 전략으로 물리적 기기 없는 테스트 환경 구현
RECOMMENDATION
다양한 하드웨어 기기와 통신해야 하는 모바일 서비스를 개발하거나, 플랫폼 간 API 동작 차이로 인해 코드 중복에 시달리는 엔지니어에게 이 아키텍처를 추천합니다. 특히 확장성 있는 블루투스 라이브러리를 직접 설계하려는 팀에게 매우 유용한 가이드가 될 것입니다.
The Problem
iOS의 CoreBluetooth와 Android의 bluetooth API는 하드웨어 추상화 계층에 대응하는 Low-Level 인터페이스로 제공되어 기기의 정체성이나 하위 비즈니스 맥락을 응집력 있게 담아내지 못하는 한계가 있었습니다. 또한, 두 플랫폼 간의 스캔 정책 및 콜백 구조의 차이로 인해 코드 파편화가 발생하고, 새로운 기기 도입 시마다 중복된 통신 로직을 작성해야 하는 유지보수의 어려움이 존재했습니다.
The Solution
플랫폼 API 위에 '쏘카프레임 블루투스 모듈'이라는 새로운 추상화 계층을 구축하여 기기의 정적인 정체성(Spec)과 동적인 행동(Handle)을 분리하고, 이를 관리하는 BluetoothHost와 BluetoothRemote 개념을 도입했습니다. 특히 iOS의 단일 스캔 제한과 같은 플랫폼별 동작 차이를 해결하기 위해 여러 스캔 요청을 논리적으로 병합하는 '가상 스캔 매니저'를 구현하여 아키텍처를 통일했습니다.
The Result
하드웨어 제어와 비즈니스 로직의 완전한 분리를 통해 개발자가 스캔, 연결, 세션 유지 등의 복잡한 절차 대신 비즈니스 의도 구현에만 집중할 수 있는 환경을 조성했습니다. 새로운 기기 도입 시 기존 코드를 수정하지 않고 확장할 수 있는 구조를 확보했으며, 하드웨어 의존성을 제거한 Mock 객체 활용이 가능해져 물리적 기기 없이도 테스트 코드로 시스템 안정성을 검증할 수 있게 되었습니다.
Trade-off
본문에 명시적인 한계점은 기술되지 않았으나, 플랫폼 고유 API 위에 추가적인 추상화 레이어를 도입함에 따라 개발자의 초기 학습 곡선이 발생하고 모듈 자체의 유지보수 비용이 추가될 수 있습니다. 또한, 극도로 정밀한 하드웨어 직접 제어가 필요한 특수 케이스에서는 추상화 계층이 제공하는 인터페이스 외에 추가적인 우회 경로 설계가 필요할 가능성이 일반적으로 예상됩니다.
Key Concepts
More from 쏘카
View all posts from 쏘카
S3 + CloudFront 기반 SPA 배포에서 캐시와 fallback 전략 설계하기
CloudFrontS3SPA2주 전쏘카 디자인 시스템 2.0 개발기 2편: 기술로 굴리기(웹)
Design SystemReactComponent Architecture4개월 전쏘카 디자인 시스템 2.0 개발기 1편: 시스템으로 굴리기(웹)
Design SystemFigmaFigma Plugin4개월 전Node.js 컨테이너, 왜 깔끔하게 안 죽을까? (feat. Graceful shutdown)
Node.jsKubernetesDocker5개월 전쏘카프레임 - 앱 프레임워크와 개발자 경험
Socar Frame개발자 경험Android6개월 전