Architecture recommendations

Recommendations for Android Architecture

Bu sayfada çeşitli Architecture best practiceleri ve önerileri sunulmaktadır. Uygulamanızın kalitesini, sağlamlığını ve ölçeklenebilirliğini artırmak için bunları benimseyin. Ayrıca uygulamanızın bakımını ve test edilmesini de kolaylaştırırlar.

Not: Bu belgedeki önerileri katı gereklilikler olarak değil tavsiyeler olarak ele almalısınız. Gerektiğinde bunları uygulamanıza uyarlayın.

Aşağıdaki best practiceler konuya göre gruplandırılmıştır. Her birinin, ekibin ne kadar güçlü bir şekilde önerdiğini yansıtan bir önceliği vardır. Öncelikler listesi aşağıdaki gibidir:

• Strongly recommended: Yaklaşımınızla temelden çelişmediği sürece bu pratiği uygulamalısınız.
• Recommended: Bu pratiğin uygulamanızı geliştirmesi muhtemeldir.
• Optional: Bu pratik, belirli durumlarda uygulamanızı geliştirebilir.

Not: Bu önerileri anlamak için [Architecture kılavuzu](guide-to-app-architecture)na aşina olmanız gerekir.

Layer Architecture

Önerdiğimiz katmanlı mimari, seperation of concern’i destekler. UI’yi veri modellerinden yönlendirir, single source of truth ilkesine uyar ve undirectional data flow ilkelerini takip eder. İşte katmanlı mimari için bazı best practiceler:

UI Layer

UI katmanının rolü, uygulama verilerini ekranda görüntülemek ve kullanıcı etkileşiminin birincil noktası olarak hizmet etmektir. İşte UI katmanı için bazı best practiceler:

Aşağıdaki kod parçacığı, UI state’inin yaşam döngüsüne duyarlı bir şekilde nasıl collect edileceğini özetlemektedir:

//Views
class MyFragment : Fragment() {

    private val viewModel: MyViewModel by viewModel()

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        viewLifecycleOwner.lifecycleScope.launch {
            viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) {
                viewModel.uiState.collect {
                    // Process item
                }
            }
        }
    }
}

//Compose
@Composable
fun MyScreen(
    viewModel: MyViewModel = viewModel()
) {
    val uiState by viewModel.uiState.collectAsStateWithLifecycle()
}

ViewModel

ViewModeller, UI state’ini sağlamaktan ve data katmanına erişimden sorumludur. ViewModel’ler için bazı best practiceler aşağıda verilmiştir:

Aşağıdaki kod parçacığı, UI state’inin bir ViewModel’den nasıl açığa çıkarılacağını özetlemektedir:

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

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

    // ...
}

Lifecycle

Aşağıda Android yaşam döngüsü ile çalışmaya yönelik best practiceler yer almaktadır:

Aşağıdaki kod parçacığı, belirli bir Yaşam Döngüsü state’i verildiğinde işlemlerin nasıl gerçekleştirileceğini özetlemektedir:

//Views
class MyFragment: Fragment() {
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        viewLifecycleOwner.lifecycle.addObserver(object : DefaultLifecycleObserver {
            override fun onResume(owner: LifecycleOwner) {
                // ...
            }
            override fun onPause(owner: LifecycleOwner) {
                // ...
            }
        }
    }
}

//Compose
@Composable
fun MyApp() {

    val lifecycleOwner = LocalLifecycleOwner.current
    DisposableEffect(lifecycleOwner, ...) {
        val lifecycleObserver = object : DefaultLifecycleObserver {
            override fun onStop(owner: LifecycleOwner) {
                // ...
            }
        }

        lifecycleOwner.lifecycle.addObserver(lifecycleObserver)
        onDispose {
            lifecycleOwner.lifecycle.removeObserver(lifecycleObserver)
        }
    }
}

Handle dependencies

Componentler arasındaki bağımlılıkları yönetirken gözlemlemeniz gereken birkaç best practice vardir:

Testing

Aşağıda test için bazı best practiceler verilmiştir:

Daha fazla bilgi için Android DAC’da neleri test etmeli kılavuzuna bakın.

Models

Uygulamalarınızda model geliştirirken bu best practiceleri uymalısınız:

Naming Conventions

Kod tabanınızı adlandırırken, aşağıdaki best practice’lerden haberdar olmalısınız: