android/architecture-samples

어떤 프로젝트인가요?

핵심 기능

• 01단일 액티비티 아키텍처와 Navigation Compose를 사용하는 Jetpack Compose UI
• 02화면마다 ViewModel을 두고, 반응형 상태 처리에 Flow와 코루틴 사용
• 03Room 로컬 저장소와 가짜 원격 데이터 소스를 사용하는 리포지토리 데이터 계층
• 04Hilt를 통한 의존성 주입
• 05`mock` 및 `prod` 제품 플레이버
• 06공유 테스트를 포함한 단위 테스트, 통합 테스트, 엔드 투 엔드 테스트

활용 사례

• Compose, ViewModel, 리포지토리로 Android 앱을 구성하는 방법 학습
• 브랜치별로 같은 앱의 아키텍처 방식 비교
• 단위 테스트와 계측 테스트를 위한 참고 자료로 테스트 설정 활용

빠른 시작

1. 1

   리포지토리를 클론합니다

   git clone git@github.com:android/architecture-samples.git
2. 2

   Android Studio에서 architecture-samples/ 디렉터리를 엽니다

사용 전 알아둘 점

• !앱을 빌드하고 실행하려면 Android Studio가 필요합니다.
• !아키텍처 방식마다 브랜치가 다르므로 원하는 브랜치를 체크아웃해야 합니다.

토픽

자주 묻는 질문

architecture-samples은(는) 무엇인가요?

Google이 만든 TODO 앱 샘플로, 여러 브랜치에서 Android 아키텍처 패턴과 도구, 테스트 방식을 비교할 수 있습니다. 이 저장소에는 같은 TODO 앱을 서로 다른 아키텍처 방식으로 구현한 Android 앱 샘플이 모여 있습니다. 각 브랜치는 서로 다른 도구와 패턴을 보여 주므로, 개발자는 동일한 기능을 각각 어떻게 구성했는지 비교할 수 있습니다.

architecture-samples은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

architecture-samples은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

architecture-samples은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. architecture-samples의 마지막 커밋은 2026년 10월 20일입니다.

architecture-samples은(는) 어디에 사용할 수 있나요?

Compose, ViewModel, 리포지토리로 Android 앱을 구성하는 방법 학습 브랜치별로 같은 앱의 아키텍처 방식 비교 단위 테스트와 계측 테스트를 위한 참고 자료로 테스트 설정 활용

architecture-samples는 어떻게 설치하나요?

리포지토리를 클론합니다: git clone git@github.com:android/architecture-samples.git Android Studio에서 architecture-samples/ 디렉터리를 엽니다

architecture-samples은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/android/architecture-samples