Repolode
igorwojda

igorwojda/android-showcase

Clean Architecture, 모듈형 기능 설계, Jetpack Compose, Gradle convention plugin을 보여주는 Kotlin 기반 Android 참고 앱입니다.

스타
6,810
포크
902
열린 이슈
7
마지막 커밋
3일 전

어떤 프로젝트인가요?

Android Showcase는 Jetpack Compose로 만든 샘플 Android 앱으로, Last.fm API에서 앨범 정보를 불러와 검색과 앨범 상세 정보 확인을 지원하고 Room을 통해 로컬에 캐시합니다. 완성된 소비자용 제품이라기보다 프로덕션 수준의 Android 코드베이스를 어떻게 구성할 수 있는지 보여주는 것이 주된 목적입니다. 즐겨찾기와 프로필 화면은 아직 개발 중입니다.

앱은 기능 모듈(album, profile, favourite)과 공용 base 및 library 모듈로 나뉩니다. 각 기능은 presentation, domain, data로 구성된 3계층 Clean Architecture를 따르며, MVVM과 Kotlin Flow로 단일 UI 상태를 전달하는 MVI 스타일을 결합합니다. 빌드 로직은 convention plugin에 두고, 의존성 버전은 Gradle version catalog로 관리합니다.

품질 관리 도구도 프로젝트에 포함되어 있습니다. Konsist 아키텍처 테스트, Detekt, Ktlint, Spotless, Android Lint와 GitHub Actions CI 파이프라인을 사용합니다. 의존성 주입에는 Koin을, 네트워킹과 이미지 처리에는 Retrofit과 Coil을 사용하며, 테스트는 Mockk 및 Kluent와 함께 JUnit으로 작성합니다.

핵심 기능

  • 01Last.fm API를 기반으로 한 검색 기능이 포함된 앨범 목록 및 앨범 상세 화면
  • 023계층 Clean Architecture를 적용한 기능 모듈과 MVVM 및 MVI 스타일 상태 관리
  • 03Gradle convention plugin과 중앙 집중식 version catalog
  • 04CI에 연결된 Konsist, Detekt, Ktlint, Spotless 및 Android Lint 검사
  • 05Room 로컬 캐싱, Koin 의존성 주입, Compose 기반 UI

활용 사례

  • Clean Architecture를 적용한 다중 모듈 Android 앱 구성 방법 살펴보기
  • 새 프로젝트의 템플릿으로 Gradle convention plugin과 version catalog 활용하기
  • Konsist 아키텍처 테스트와 정적 분석 설정 사례 살펴보기
  • 실제 프로덕션 스타일 앱에서 Jetpack Compose, Flow, Koin을 함께 사용하는 방법 익히기

사용 전 알아둘 점

  • Favorites 및 Profile 기능은 아직 개발 중입니다.
  • Espresso UI 테스트는 아직 개발 중입니다.

포함된 컬렉션

토픽

자주 묻는 질문

android-showcase은(는) 무엇인가요?
Clean Architecture, 모듈형 기능 설계, Jetpack Compose, Gradle convention plugin을 보여주는 Kotlin 기반 Android 참고 앱입니다. Android Showcase는 Jetpack Compose로 만든 샘플 Android 앱으로, Last.fm API에서 앨범 정보를 불러와 검색과 앨범 상세 정보 확인을 지원하고 Room을 통해 로컬에 캐시합니다. 완성된 소비자용 제품이라기보다 프로덕션 수준의 Android 코드베이스를 어떻게 구성할 수 있는지 보여주는 것이 주된 목적입니다. 즐겨찾기와 프로필 화면은 아직 개발 중입니다.
android-showcase은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
android-showcase은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
android-showcase은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. android-showcase의 마지막 커밋은 2026년 11월 3일입니다.
android-showcase은(는) 어디에 사용할 수 있나요?
Clean Architecture를 적용한 다중 모듈 Android 앱 구성 방법 살펴보기 새 프로젝트의 템플릿으로 Gradle convention plugin과 version catalog 활용하기 Konsist 아키텍처 테스트와 정적 분석 설정 사례 살펴보기 실제 프로덕션 스타일 앱에서 Jetpack Compose, Flow, Koin을 함께 사용하는 방법 익히기
android-showcase은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/igorwojda/android-showcase

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트