Android 架構建議 (original) (raw)

本頁提供多個架構的最佳做法和建議。採用這些最佳做法和建議，可提升應用程式的品質、穩定性和擴充性，還能更輕鬆地維護及測試應用程式。

以下最佳做法依主題分組。各自的優先順序反映了建議程度。優先順序清單如下：

• 強烈建議：除非此做法與您的方法相衝突，否則應採用此做法。
• 建議：這種做法可改善應用程式。
• 選用：在某些情況下，這種做法可改善應用程式。

分層架構

建議的分層架構採用關注點分離做法，透過資料模型使用 UI，符合單一可靠資料來源的原則，並維持單向資料流。以下是分層架構的一些最佳做法：

UI 層

UI 層的作用是在螢幕上顯示應用程式資料，且為使用者與應用程式互動的主要管道。以下是 UI 層的最佳做法：

下列文字片段說明如何以生命週期感知方式收集 UI 狀態：

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

ViewModel

ViewModel 負責提供 UI 狀態和存取資料層。以下是一些 ViewModel 最佳做法：

以下文字片段概述了如何從 ViewModel 公開 UI 狀態：

@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
            )

    // ...
}

生命週期

遵循使用 Activity 生命週期的最佳做法：

下列文字片段概述了如何根據特定生命週期狀態來執行作業：

  @Composable
  fun LocationChangedEffect(
    locationManager: LocationManager,
    onLocationChanged: (Location) -> Unit
  ) {
    val currentOnLocationChanged by rememberUpdatedState(onLocationChanged)

    LifecycleStartEffect(locationManager) {
        val listener = LocationListener { newLocation ->
            currentOnLocationChanged(newLocation)
        }

        try {
            locationManager.requestLocationUpdates(
                LocationManager.GPS_PROVIDER,
                1000L,
                1f,
                listener,
            )
        } catch (e: SecurityException) {
            // TODO: Handle missing permissions
        }

        onStopOrDispose {
            locationManager.removeUpdates(listener)
        }
    }
  }

處理依附元件

管理元件之間的依附元件時，請遵循下列最佳做法：

測試

以下是測試的一些最佳做法：

詳情請參閱「Android 測試項目」和「測試 Compose 版面配置」。

模型

在應用程式中開發模型時，請遵守下列最佳做法：

命名慣例

為程式碼集命名時，您應瞭解下列最佳做法：

其他資源

如要進一步瞭解 Android 架構，請參閱下列其他資源：

說明文件

• Compose UI 架構
• Jetpack Compose 架構分層

Views content

• Android 架構 (Views) 建議