README.md

너굴포털+

📱 앱 설치하러 가기!!!

 

카탈로그 수집 기록의 즐거움 🌱

v1.0.0 2022.05 - 2022.07

 

👩🏻‍💻 개발자 소개

아리(Ari)

기획, 디자인, 개발 모두 다 아리가 했어요. 😵‍💫

 

⭐️ 프로젝트 소개

모여봐요 동물의 숲을 플레이하면서 수많은 아이템들을 내가 수집했는지의 여부를 기록해둘 수 있어요. (가구, 생물, 레시피 등...)

아이템의 상세정보 및 수집하는 방법에 대해서 간단하게 확인해볼 수 있어요.

또한 동물의 숲의 인기 아티스트 K.K.의 음반도 맛보기로 감상할 수 있는 모동숲 가이드앱입니다. 🌳

 

🛠 프로젝트 주요 기능

🌓 다크모드 라이트모드를 지원합니다.

🇰🇷 🇺🇸 지역화 처리를 하여 영어, 한국어를 지원합니다.

🌴 앱 기본 설정을 통해 나의 섬 정보를 편집할 수 있어요.

📝 오늘 할일을 했는지 체크하고, 편집을 통해 할일을 수정하거나 추가할 수 있어요.

🔍 마을 주민을 추가한다면 대시보드에서 마을 주민의 정보를 손쉽게 확인할 수 있어요.

✅ 마을 주민과 대화를 하거나 선물을 주고받았다면 체크해서 표시할 수도 있어요.

📊 수집현황을 통해 수집 진행 상황을 확인하거나, 아직 획득하지 못한 아이템들을 확인할 수 있어요.

(자동으로 미획득 아이템 필터링해줍니다. 생물이라면 당월로 필터링되어 아이템을 보여줍니다.)

📚 카탈로그 탭을 활용하여 수집한 아이템을 기록할 수 있어요.

우측 버튼을 통해 정렬 혹은 필터링을 하여 아이템을 편리하게 볼 수 있어요.

🔎 상세정보를 통해 아이템의 키워드를 통해 관련된 아이템을 탐색하거나, 리폼된 모습을 확인해볼 수 있어요.

제작을 통해 얻을 수 있는 아이템의 경우, 레시피 획득방법, 그리고 필요한 재료도 추가로 보여줍니다.

🕙 생물의 경우 어디서 출현하는지, 몇시에 언제 출현하는지에 대한 정보를 확인해볼 수 있어요.

🐰 마을 주민의 경우 상세한 필터링을 통해 편리하게 주민을 찾아볼 수 있어요.

좋아하는 주민, 내 섬 주민을 나눠서 한 눈에 볼 수도 있습니다.

📦 수집품을 통해 내가 수집한 아이템을 관리할 수 있어요.

수집한 아이템이 없는 경우에는 아무것도 표시하지 않습니다.

 

아키텍처

MVVM

• MVVM을 도입하여 뷰 컨트롤러와 뷰는 화면을 그리는 역할에만 집중하고, 데이터 관리, 로직 실행은 뷰 모델에서 진행되도록 했습니다.

Input/Output Modeling

• 뷰모델을 Input과 Output으로 정의하여 뷰의 이벤트들을 Input에 바인딩하고, 뷰에 보여질 데이터를 Output에 바인딩 했습니다.
• 일관성 있고 직관적인 구조를 유지해 뷰모델의 코드 가독성이 높아졌습니다.

Coordinator

• 화면 전환에 대한 로직을 ViewController로부터 분리하고 의존성 객체에 대한 주입을 외부에서 처리하도록 하기 위해 코디네이터를 적용했습니다.

 

기술적 도전

RxSwift

• 연속된 escaping closure를 피하고, 선언형 프로그래밍을 통한 높은 가독성과 RX 오퍼레이터들을 통한 효율적인 비동기 처리를 위해서 RxSwift를 사용하게 되었습니다.
• 데이터가 발생하는 시점에서부터 뷰에 그려지기 까지 하나의 큰 Stream으로 데이터를 바인딩 하였습니다.

CI/CD 빌드 및 테스트 자동화

• Github Actions를 활용하여 develop 브랜치로 push를 하게 되면 빌드 및 테스트를 실행하도록 자동화를 처리했습니다.

 

Credits/Thanks

🙏🏻 Thanks to Animal Crossing: New Horizons spreadsheet

• 이 앱은 위 스프레드 시트를 활용하여 만든 Norviah의 레파지토리를 활용하여 동물의 숲 아이템을 가져옵니다.

🙏🏻 Thanks to ACNH API

• 동물의 숲의 음악, BGM 등을 이 API를 통해 불러옵니다

아리의 개발기에 대해 더 자세한 내용이 보고싶다면, 너굴포털 Wiki를 방문해주세요.