SwiftUI + TCA를 활용한 iOS 여행 기록 및 공유 애플리케이션입니다.
Boleto는 여행의 모든 순간을 기록하고, 나만의 방식으로 꾸밀 수 있는 여행 기록 및 공유 앱입니다.
- 1.1 버전: 크리스마스 티켓, 인스타그램 스토리 공유 기능 추가
- 1.2 버전: 설날 티켓 및 사진 편집 기능 추가
- 1.3 버전: 이미지 편집 기능 추가
- iOS: 17.0+
- Xcode: 15.0+
- Swift: 5.9+
- CLMonitor 및 CLServiceSession을 활용하여 특정 명소 도착 시 스티커와 사용자 맞춤 프레임 획득
- 백그라운드에서도 이벤트 트리거 및 로컬 알림 지원
- 획득한 스티커와 프레임을 이용해 네컷 또는 폴라로이드 티켓 꾸미기
- 제스처를 통해 스티커 확대, 축소, 회전 등 자유로운 편집
- 다양한 필터를 통해 사진을 커스텀화하기
- 여행 일정, 장소, 동행자를 기록한 디지털 티켓 생성
- 실시간 티켓 공동 편집 및 충돌 방지를 위한 Lock/Unlock 관리
- 유니버설 링크를 통해 친구 초대 및 여행 기록 공유
- 인스타그램 스토리 공유 기능 지원
- Metal Shading Language(MSL)를 활용한 커스텀 이미지 필터 구현
- GPU 가속을 통한 실시간 이미지 프로세싱으로 부드러운 사용자 경험 제공
- 다양한 스타일의 필터 제공
- SwiftUI: 전체 UI 구성 및 애니메이션 구현
- UIKit: ShareLink 관련 기능 UIViewRepresentable로 보완
- CoreLocation: 위치 이벤트 모니터링 및 스티커 제공
- SwiftData: 스티커 및 프레임 로컬 캐싱
- Alamofire: RequestInterceptor를 통한 인증 토큰 자동 갱신 및 API 통신
- Metal Framework: GPU 가속 이미지 처리 및 커스텀 필터 구현
- Composable Architecture (TCA):
- 이 프로젝트는 Composable Architecture (TCA) 를 중심으로 설계되었으며, 주요 목표는 단방향 데이터 흐름, 명확한 상태 관리, 모듈화 통해 코드의 유지보수성, 재사용성을 극대화하는 것입니다.
모든 상태 변화는 Action → Reducer → State의 흐름을 따릅니다. 이를 통해 상태 변경을 명확하게 추적할 수 있으며, 디버깅이 용이합니다.
각 화면이나 주요 기능은 Reducer로 구현되었으며, 비즈니스 로직과 상태 관리를 담당합니다. 이를 통해 기능별로 독립적인 모듈화를 이루었습니다.
AppFeature: 앱 전체의 상태 관리NavigationFeature: 화면전환 관리MonitoringFeature: 위치 추적 로직 작업 관리LoginFeature: 카카오 및 애플 로그인 플로우 처리AuthFeature: 로그인 시 해야하는 작업들 관리. ex) 최초 로그인 경우 스티커, 프레임 정보 SwiftData저장 및 기기 토큰 저장
네트워크 요청, 데이터베이스 연동, 로컬 저장소 등 외부 의존성을 Dependency를 통해 주입했습니다. 이를 통해 테스트 용이성을 높이고, 외부 의존성을 쉽게 교체할 수 있도록 설계했습니다.
@Dependency(\.userClient) var userClient를 통해 사용자 관련 API 호출을 관리.
의존성 주입 사용 사례:
userClient: 사용자 정보 및 프로필 변경.
travelClient: 여행 티켓 추가, 수정, 삭제.
locationClient: 위치 기반 모니터링.
databaseClient: 스티커 및 프레임 데이터베이스 관리.TCA의 모듈화된 구조를 활용하여 재사용 가능한 기능을 구현했습니다.
- 스티커 관리, 사진 편집, 알람 기능 등은 여러 화면에서 활용 가능
- 공통 기능으로 분리된 Feature:
StickerManagementFeaturePhotoGridFeature
이러한 구조를 통해 코드의 유지보수성과 확장성을 극대화하였습니다.
TCA는 테스트 작성에 용이한 구조를 제공합니다.
각 Reducer와 의존성을 분리하여 단위 테스트를 쉽게 작성할 수 있도록 설계되었습니다.
- 각 Reducer의 비즈니스 로직을 독립적으로 테스트 가능
- Mock Dependency 주입을 통해 다양한 시나리오 검증 가능
이러한 설계를 통해 안정적인 애플리케이션 유지보수가 가능합니다.
-
사일런트 푸쉬나 AllticketOverViewFeature에서 티켓들을 get요청 후 해당날짜의 티켓이 있으면 Appfeature에서 .startMonitoring(Spot)발생.
-
LocationClient 내부의 LocationActor에서 CLMonitor생성 후 AsyncStream반환
-
특정 지역 진입 등 이벤트 발생시 CLMonitor.events -> LocationAcotr -> LocationClient -> LocationMonitoringFeature로 전달
-
LocationMonitoringFeature에서 해당 이벤트에 따른 알림, 서버 푸쉬, SwiftData에 저장 등 추가 액션.
Boleto는 Metal Framework를 활용하여 고성능 이미지 필터 시스템을 구현했습니다. 이를 통해 사용자는 여행 사진에 다양한 예술적 효과를 실시간으로 적용할 수 있습니다.
GPU 가속 처리: Metal 쉐이더를 통해 CPU 대신 GPU에서 이미지 처리를 수행하여 빠른 성능 제공
실시간 렌더링: 필터 인텐시티를 조절하며 실시간으로 결과 확인 가능
메모리 효율성: 최적화된 그래픽 파이프라인으로 메모리 사용량 최소화
속도 최적화: 한 이미지에 대해 여러 썸네일을 생성해야하기에 병렬처리와 이미지 리사이징을 통해 빠르게 생성
필터 구현 기술:
소벨 엣지 감지(Sobel Edge Detection): 이미지의 엣지를 감지하여 스케치, 만화 효과 구현
가우시안 블러(Gaussian Blur): 부드러운 블러 효과 제공
미디언 필터(Median Filter): 노이즈 제거 및 이미지 스무딩
컬러 양자화(Color Quantization): 색상 팔레트 단순화를 통한 스타일리시한 효과
노이즈 생성기(Noise Generator): 필름 그레인, 빈티지 효과 등을 위한 다양한 노이즈 알고리즘
비네팅(Vignetting): 사진 가장자리를 어둡게 하여 중앙에 초점을 맞추는 효과
- 이미지 최적화: https://codeisfuture.tistory.com/111, https://codeisfuture.tistory.com/121
- 메모리 릭 해결: https://codeisfuture.tistory.com/103, https://codeisfuture.tistory.com/102
- 위치기반 서비스(CLMonitor): https://codeisfuture.tistory.com/88
- ShareLink: https://codeisfuture.tistory.com/92
- Metal: https://codeisfuture.tistory.com/118, https://codeisfuture.tistory.com/119, https://codeisfuture.tistory.com/122,