[안드로이드] 안드로이드 아키텍처 권장사항

안드로이드 애플리케이션을 개발할 때, 코드의 유지보수성과 확장성을 높이는 것이 매우 중요하다. 구글은 이를 위해 안드로이드 아키텍처에 대한 다양한 권장사항을 제공하고 있으며, 이를 따르면 앱의 품질과 견고성을 향상시킬 수 있다. 

 

1. 아키텍처 권장사항의 개요

안드로이드 아키텍처 권장사항은 엄격한 규칙이 아니라 앱의 품질을 높이는 데 도움이 되는 가이드라인이기 때문에 앱의 요구사항과 팀의 개발 환경을 고려하여 이를 적절히 조정할 수 있다.

권장사항은 우선순위에 따라 다음과 같이 구분된다.

• 적극 권장됨: 기본적인 원칙과 충돌하지 않는 한 반드시 따라야 하는 권장사항.
• 권장됨: 앱의 품질을 향상시키는 데 큰 도움이 되는 권장사항.
• 선택사항: 특정 상황에서 유용할 수 있는 권장사항.

 

2. 계층화된 아키텍처 적용하기

안드로이드 애플리케이션에서는 관심사 분리(Separation of Concerns) 를 적용하여 명확한 아키텍처 계층을 설계하는 것이 중요하다. 구글은 데이터 모델에서 UI를 구동하며, 단일 정보 소스 원칙(Single Source of Truth)과 단방향 데이터 흐름(Unidirectional Data Flow)을 따르는 아키텍처를 권장한다.

1. 데이터 레이어 구축

데이터 레이어는 애플리케이션 데이터를 관리하고 비즈니스 로직을 포함하는 계층이다.

• 저장소(Repository)를 사용하여 데이터를 노출 (적극 권장됨)
• 데이터 소스(DB, API, Sensor 등)와 UI 레이어가 직접 상호작용하지 않도록 함
• 작은 앱에서는 data 패키지에 데이터 관련 클래스를 배치 가능

2. UI 레이어 구축

UI 레이어는 데이터를 화면에 표시하고 사용자 입력을 처리하는 역할을 한다.

• ViewModel을 활용하여 UI 상태 관리 (적극 권장됨)
• 단방향 데이터 흐름(UDF) 원칙을 따름 (적극 권장됨)
• UI에서 직접 데이터 소스를 호출하지 않고, ViewModel을 통해 데이터와 상호작용

 

3. ViewModel 활용 및 UI 상태 관리

ViewModel은 UI 상태를 관리하고, 데이터를 노출하는 역할을 한다. ViewModel을 활용할 때 다음 권장사항을 따르는 것이 좋다.

• Lifecycle에 구애받지 않도록 설계 (적극 권장됨)
• 코루틴 및 Flow 사용하여 비동기 작업 처리 (적극 권장됨)
• UI 상태를 StateFlow로 관리 (권장됨)
• ViewModel에서 UI로 이벤트를 직접 전송하지 않음 (적극 권장됨)

@HiltViewModel
class BookmarksViewModel @Inject constructor(
    newsRepository: NewsRepository
) : ViewModel() {

    val feedState: StateFlow<NewsFeedUiState> =
        newsRepository
            .getNewsResourcesStream()
            .mapToFeedState()
            .stateIn(
                scope = viewModelScope,
                started = SharingStarted.WhileSubscribed(5_000),
                initialValue = NewsFeedUiState.Loading
            )
}

 

4. 단일 액티비티 & Jetpack Compose 활용

앱이 여러 화면을 포함하는 경우 단일 액티비티 구조(Single Activity Architecture) 를 따르는 것이 권장된다. 또한, 최신 UI 프레임워크인 Jetpack Compose 를 활용하면 보다 유연하고 선언적인 UI 개발이 가능하다.

• Navigation Component 활용하여 화면 간 이동 관리 (권장됨)
• Compose UI 상태를 collectAsStateWithLifecycle으로 수집 (적극 권장됨)

@Composable
fun MyScreen(viewModel: MyViewModel) {
    val uiState by viewModel.uiState.collectAsStateWithLifecycle()
    // UI 구성
}

 

5. 종속성 관리 및 DI 활용

안드로이드 앱 개발에서는 의존성 주입(Dependency Injection, DI) 을 통해 객체 생성을 효율적으로 관리하는 것이 중요하다.

• Hilt를 사용하여 의존성 관리 (권장됨)
• 생성자 주입(Constructor Injection) 사용 (적극 권장됨)
• 필요한 경우 컴포넌트 범위 지정 (적극 권장됨)

@Module
@InstallIn(SingletonComponent::class)
object AppModule {
    @Provides
    fun provideRepository(): NewsRepository {
        return DefaultNewsRepository()
    }
}

 

6. 테스트 전략

앱의 품질을 보장하기 위해서는 적절한 테스트 전략이 필요하다.

• ViewModel 단위 테스트 수행 (적극 권장됨)
• Flow 및 LiveData 테스트 (적극 권장됨)
• UI 탐색 테스트 실행 (적극 권장됨)
• Mock보다는 Fake 객체 활용 (적극 권장됨)

@Test
fun testViewModelEmitsCorrectState() = runTest {
    val viewModel = MyViewModel(FakeRepository())
    assertEquals(expectedState, viewModel.uiState.value)
}

 

결론

• 안드로이드 아키텍처 권장사항을 따르면 앱의 품질과 유지보수성을 대폭 향상시킬 수 있다.
• 특히 단방향 데이터 흐름을 유지하고, 관심사 분리를 명확히 하며, ViewModel을 활용한 UI 상태 관리를 철저히 적용 하는 것이 중요하다.
• 또한, DI 및 테스트 전략을 적극 활용 하여 확장성과 안정성을 확보하는 것이 좋다.