주요기능

검색하기

• 키워드를 검색하면 해당 키워드를 포함한 기사를 검색할 수 있습니다.
• Paging3 라이브러리를 이용하여 page단위로 뉴스들을 불러옵니다.
• 검색내용이 없는 경우, 안내문구를 통해 없음을 나타냅니다.
• 에러가 발생한 경우, 안내문구를 통해 에러문구를 나타냅니다.
• 기사내용을 클릭할 수 있으며, 세부 기사내용을 볼 수 있으며 북마크를 통해 저장이 가능합니다.

검색	검색없음	검색에러(네트워크 연결x)

탑뉴스

• 미국의 탑뉴스를 기본적으로 표시합니다.
• Paging3 라이브러리를 이용하여 page단위로 뉴스들을 불러옵니다.
• 에러가 발생한 경우, 안내 문구와 "다시시도" 기능을 통해 다시 page를 불러 올 수 있습니다.
• 클릭하여 세부 기사내용을 볼 수 있습니다.

탑뉴스	재시도

카테고리

• 기사 카테고리를 보여줍니다.
• 카테고리를 클릭하면 관련 뉴스를 볼 수 있습니다.
• 관련된 기사는 paging3를 적용했기 때문에 page단위로 불러옵니다.
• 기사를 클릭하여 세부 내용을 볼 수 있습니다.
• 에러가 발생한 경우, 안내 문구와 "다시시도" 기능을 통해 다시 page를 불러 올 수 있습니다.

카테고리	재시도

북마크

• 북마크가 표시된 기사를 모아놓은 화면입니다.
• Room 라이브러리를 이용하여 로컬 캐싱처리했습니다.
• Room 라이블리에서 제공하는 Flow를 활용하여 비동기 스트림으로 추가 및 삭제 시, UI를 업데이트 시키도록 만들었습니다.
• 저장한 북마크 뉴스가 없다면 기본 문구가 표시됩니다.

프로젝트 구조(Multi Module)

App Module

• App 모듈은 프로젝트에 필요한 모든 모듈의 의존성을 갖는 모듈입니다.
• Fragment Navigation을 관리합니다.

Feature Module

• Feature Module은 크게 Search/TopNews/Category/Bookmark Module로 구성되어 있습니다.
• 각 모듈은 서로 참조하지 않으며, Shared_Module과 의존성을 갖습니다.

Shared_Feature Module

• Feature 모듈에서 공통적으로 사용되는 모듈로 구성되어져 있습니다.
• 각 Shared_Feature 모듈은 참조할 수 있지만, 순환참조는 불가능합니다.

아키텍처 구조

각 feature 모듈은 Clean Architecture 구조로 구성되어 있습니다.

Presentation

• UI와 관련된 파일들이 저장되는 패키지로 Activity/Fragment/ViewModel 등으로 구성됩니다.

Domain

• 비지니스 영역과 데이터 영역에서 사용되는 로직을 제공하는 패키지로 interface 및 entity로 구성됩니다.
• uaseCase
  • 사용자 Action에 의해 수행될 로직을 인터페이스로 정의한 패키지입니다.
• Repository
  • Model과 상호작용하여 Data를 처리하기 위한 인터페이스를 정의한 패키지입니다.
• Entity
  • 비지니스 모델로 실제 UI에 적용되는 Model 패키지입니다. 프로젝트에서는 entity부분을 Shared_Feature로 구성하였기 때문에 Domain에는 포함되어 있지 않습니다.

Data

• Domain에서 정의한 UseCase 및 Repository 인터페이스를 구현한 클래스들로 이뤄진 패키지입니다.

• uaseCase

  • Domain에서 정의된 UseCase interface를 구현한 패키지입니다.

• Repository

  • Domain에서 정의된 Repository interface를 구현한 패키지입니다.

• Model

  • API에서 제공하는 Model을 정의한 패키지입니다.
  • Mapper를 통해 UseCase의 Entity로 변환합니다.

• Network

  • Network처리를 위한 API Interface를 정의하며, 사용법을 제공합니다.

• DI

  • DI는 의존성을 주입하기 위한 Module로 구성된 패키지이며, Hilt 라이브러리를 이용하여 구성했습니다.
  • UseCaseModule을 제공하여 Presentation에서 UsecCaseImpl를 주입받을 수 있는 방법을 제공합니다.
  • RepositoryModule을 제공하여 UseCase에서 RepositoryImpl를 주입받을 수 있는 방법을 제공합니다.
  • NetworkModule을 통해 Retrofit에서 사용할 ApiService를 구성하고 이 ApiService를 통해 Network통신을 위한 방법을 제공합니다.

라이브러리

JetPack

• Paging3
• Fragment Navigation

Network

• Retrofit
• Kotlinx.Serailization

Asynchronous

• Coroutine
• Flow

DI

• Hilt

DataBase

• Room

Image

• Glide