안드로이드 앱 개발 포트폴리오 | 스포츠 매칭 플랫폼

내일배움캠프 7기 앱 개발 과정 안드로이드 트랙 수료생 최종 프로젝트 '매칭매니저'를 소개합니다.

Mar 07, 2024

Contents

🎲 MVVM - ARCHITECTURE ⚙️ Main Stacks 🏟️ Features 🛠️ Technical Decision 🛠 Trouble Shoot 👩🏻‍💻🧑🏻‍💻 Team members 🏟️ Project Github & Service URL

"Matching-Manager" 는 스포츠 경기 매칭, 경기장 추천, 용병 모집을 도와주는 스포츠 매칭 플랫폼입니다.

💡

이런 사람들에게 추천합니다

🏟️ 경기장 추천- 경기장을 예약할때 근처에 있는 경기장 정보를 알고싶은 사람!

지역별, 종목별 필터를 통해 경기장 정보를 제공해 줍니다.

👥 용병 모집- 경기는 하고싶지만 함께 할 인원이 부족한 사람들!

인원이 부족한 사람들은 용병 모집/신청 이 가능해 팀에 가입하거나 인원을 보충 할수 있습니다.

🫱🏻‍🫲🏼경기 매칭 - 운동을 하고싶지만, 함께 경기 할 상대팀이 없을때!

지역, 운동 종목을 나눠 함께 경기를 진행할 상대와 매칭을 도와줍니다.

🎲 MVVM - ARCHITECTURE

⚙️ Main Stacks

분류	이름
Architecture	DI,MVVM
Jetpack	ViewModel,LiveData,LifeCycle,ViewBinding,DataBinding,AAC,Reposittory
비동기 처리	Coroutine
데이터 처리	Json Deserializer,SharedPreferences
Firebase	Realtime DB,Storage,Authentication,Cloud Messaging
API 통신	Retrofit,Kakao Search API
이미지 로더	Coil
UI Frameworks	Fragment,RecyclerViewAdapter,ListAdapter,XML,BottomsheetFragment,MaterialDesign

🏟️ Features

1) Sign In + Sign Up

쉽고 빠른 로그인!

Google Signln + FireBase Auth를 사용한 쉽고 간편한 로그인 기능 제공!

앱 내에서 사용할 User, 이름, 번호를 입력해 회원가입 진행

2) home

추천매치, 공지사항 제공

앱의 메인 페이지로 공지사항 및 추천 경기 매칭을 제공하며상단의 버튼 클릭 시 각각 Arena/Alarm 페이지로 연결

3) Announcement

공지사항

앱 소개 및 안내사항을 보여주는 공지사항 페이지

4) Arena

경기장 검색 & 공유 & 전화 기능

KaKao 장소검색 API를 사용하여 종목별 경기장 정보를 지역별로 보여주고 Url공유, 전화기능을 제공합니다.

5) Match

쉽고 빠른 경기 매칭

함께 경기할 상태팀을 구하기 위한 경기매칭 페이지 종목별, 지역별 필터 사용 가능

6) Team

용병 모집/신청

인원이 부족한 사람들을 위한 용병 모집/신청 기능 제공 모집/신청, 지역별 필터 사용 가능

7) Detail/Add (MATCH/TEAM)

게시글의 상세정보를 확인할 수 있는 디테일 페이지

게시글을 추가할 수 있는 Add Page 구현

관심 목록 기능 & 매치/팀 신청기능 제공

8) Calendar

간편한 일정 관리

경기 날짜, 장소, 가벼운 메모 등 사용자가 손쉽게 이용할 수 있는 일정관리 기능 제공

9) My

USER PROFILE PAGE

USER의 프로필 정보를 확인할 수 있는 페이지

작성글/관심목록을 한 눈에 확인할 수 있고버튼을 눌러 수정/삭제 가능

추가적으로 로그아웃 기능을 제공

- SEND MSG

Send Cloud Messaging 을 사용

각각 디테일 페이지에서 용병/경기 매칭 신청을 지원하는 페이지신청 후 CloudMessage를 통해 데이터 전송

- ALARM

빠르고 정확한 알림

용병 모집/신청, 경기 매칭 등 알림 서비스 제공 우측상단 Call 버튼으로 전화기능 제공

🛠️ Technical Decision

DI(Dependency Injection)

문제상황

기존의 코드 : 하드코딩된 의존성으로 인한 객체간의 결합도 증가 ➡ 변경이 발생할 때 마다 수많은 코드를 수정 ➡ 어플리케이션의 유지보수성을 크게 저해

DI 도입

문제를 해결하기 위해 DI(Dependency Injection)도입 ➡ DI를 사용하여 의존성을 외부에서 주입 ➡ 객체간의 결합도 낮아짐 ➡ 코드의 유지보수성, 확장성을 향상 시키는 결과를 가져옴

ViewType

문제상황

기존의 코드 : 서로 다른 타입의 두가지 데이터를 각각의 ListAdapter로 한 화면에 출력 ➡ 유지보수의 측면에서 복잡성 증가 ➡ 재사용성 및 이해도 감소

ViewType 적용

문제를 해결하기 위해 ViewType을 나눠 한 ListAdapter로 관리 ➡ 특성에 따라 EnumClass로 타입을 분리 ➡ 별도의 ViewHolder로 데이터 구분 ➡ 재사용성, 가독성 ,유지보수성이 크게 향상

ListAdapter

기존의 상황

기존의 코드 : RecyclerView Adapter 사용 ➡ 추가, 삭제, 수정 등의 데이터 관리 로직 모두 구현 ➡ 갱신 코드의 빈번한 사용 ➡ 데이터의 유지보수 측면에서의 아쉬움

ListAdapter 도입

문제를 해결하기 위해 ListAdapter로 변경 ➡ 변경된 부분만을 업데이트 해주는 DiffUtil을 활용 ➡ 복잡한 데이터 관리 로직을 작성할 필요가 없어짐 ➡ 코드 간소화, 가독성, 성능 등의 다양한 이점 ➡ LiveData와 함께 사용하면서 데이터의 관찰이 용이해짐

Sealed Class

기존의 상황

중복된 데이터가 많은 모집/신청두가지 모델을 함께 묶어서 구현할 때 Enum/Sealed중 어떤 Class를 사용할지에 대해 고민

Sealed Class를 선택한 이유

제한적인 Enum과는 달리 상속, 다양성 등 다양한 이점이 있는 Sealed Class를 선택 이로 인해 코드안정성, 가독성등의장점 또한 가져감

Cloud Messaging

기존의 상황

짧은 시간내에 기기간 알림 서비스구현을 위해 완벽하게 구축된 서버 없이 기기간 전송을 구현해야 하는 문제가 있었음

Cloud Messaging 선택 이유

크로스플랫폼 지원, 시간&비용 단축, 안정성 등 다양한 장점이 있는 CloudMessaging 선택

Realtime DB, Storage

기존의 상황

유저, 게시글, 이미지 정보 등을실시간으로 데이터를 저장하고상태를 동기화 하기 위한 데이터베이스가 필요한 상황

도입 이유

효율적이고 지연시간이 짧은Firebase의 Realtime DB를 선택하였고 성능에 영향을 주지않고이미지를 저장하기 위해FireBase Storage를 선택

Fragment Result Listener

기존의 상황

Fragment간 데이터 전달을 위해여러가지 방법을 찾아봤는데Shared VeiwModel, ResultLisner 등 여러가지 중에어떤 방법을 사용할지에 대한 고민

도입 이유

Fragment, DialogFragment간데이터 전달이 목적이였기 때문에가볍게 사용할 수 있는FragmentResultListener를 선택

🛠 Trouble Shoot

최신 AGP 에서의 오류

문제 상황

DI(Dagger2)를 적용시키기 위하여 의존성을 추가해주던 중 JVM버전과 타겟이 전부 오류 메시지에서 요구하는 버전과 일치하는데 빌드되지 않고 오류 메시지를 따라가며 수정해도 처음 상태로 돌아오는 상황

해결 방법

스택오버플로우, 블로그 등 많은 글을 찾아보며 비슷한 문제를 겪고있는 글을 찾았고 결론적으로 최신 AGP버전에서의 오류임을 인지하고 AGP버전을 다운그레이드 한 후 jvmTarget 버전을 17로 명시해주어 해결

RecyclerView 아이템이 중간부터 생성되는 문제

문제 상황

리사이클러뷰에 아이템을 뿌려줄 때 scrollToPosition을 적용해주어도 처음이 아닌 중간 부분부터 보이는 문제 발생 ➡ 검색 이후 스크롤이 되도록 순서 변경 ➡ RecyclerView에 딜레이 넣기 등 다양한 시도를 했음에도 그대로인 상황

해결 방법

listAdapter가 아이템을 다 그리고 난 이후 콜백 할 수 있도록{}를 사용해 순서를 지정하여 해결

Cloud Messaging 송수신

문제 상황

앱의 Foreground/Background 따라 메시지 수신 여부가 달라짐 ➡ Fcm 전송 로직 구현에 대한 어려움 ➡ 알림 데이터가 갱신되지 않고 재사용 되는 오류

해결 방법

➡ Foreground/Background의 처리를 동시에 처리하기 위해 수신용 투명Activity를 구현 ➡ 기존에 사용해봤던 Retrofit을 사용한 전송 로직 구현 ➡ 인텐트 재사용 문제임을 인지 → 펜딩 인텐트의 Flag를 변경하여 해결

두 타입의 데이터 화면에 출력

문제 상황

Sealed Class를 사용해 묶어놓은 두가지 타입의 데이터를 화면에 출력할 때의 어려움

해결 방법

데이터를 ViewType으로 구분한 후 하나의 RecyclerView안에서 여러 데이터를 필터 동작에 따라 ViewType을 구분해 데이터를 출력해줄 수 있도록 함

DB기능의 비정상적 수행

문제 상황

DB관련 기능 수행 후 Activity에서 finish()하면 데이터베이스 기능이 정상적으로 작동하지 않는 현상

해결 방법

비동기인 DB기능이 완료되지 않았는데 Activity를 Finish 하던 문제를 인지 → ViewModel안의 Live Data를 관찰해 변동 시 Finish를 수행하도록 구현

👩🏻‍💻🧑🏻‍💻 Team members

역할	이름	Github	Blog
리더	추민수	https://github.com/SoftyChoo	https://softychoo.github.io/
부리더	김영현	https://github.com/AgileCatch	https://agilecatch.github.io/
팀원	손현준	https://github.com/hjdevelop	https://velog.io/@hyunjun6133
팀원	김민우	https://github.com/mwkimm	https://devdiary5076.tistory.com/