アプリ アーキテクチャ ガイドの理解を深めていく

    // DiceRoller/app/src/main/java/com/example/diceroller/DiceViewModel.kt
    package com.example.diceroller

    import androidx.lifecycle.ViewModel
    import androidx.lifecycle.viewModelScope
    import kotlinx.coroutines.flow.MutableStateFlow
    import kotlinx.coroutines.flow.StateFlow
    import kotlinx.coroutines.launch

    /**
    * DiceViewModel: サイコロのロール結果を管理するビューモデル。
    * UIとビジネスロジックの間の橋渡しを行い、UIの状態を保持します。
    */
    class DiceViewModel : ViewModel() {
        private val _diceResult = MutableStateFlow(1) // Default value is 1
        val diceResult: StateFlow<Int> = _diceResult

        /**
        * rollDice: サイコロを振り、1から6までのランダムな整数を生成して結果を更新します。
        */
        fun rollDice() {
            viewModelScope.launch {
                _diceResult.value = (1..6).random()
            }
        }
    }

    // DiceRoller/app/src/main/java/com/example/diceroller/MainActivity.kt
    package com.example.diceroller

    import android.os.Bundle
    import androidx.activity.ComponentActivity
    import androidx.activity.compose.setContent
    import androidx.activity.viewModels
    import androidx.compose.foundation.Image
    import androidx.compose.foundation.layout.*
    import androidx.compose.material3.Button
    import androidx.compose.material3.MaterialTheme
    import androidx.compose.material3.Text
    import androidx.compose.runtime.Composable
    import androidx.compose.runtime.collectAsState
    import androidx.compose.runtime.getValue
    import androidx.compose.ui.Alignment
    import androidx.compose.ui.Modifier
    import androidx.compose.ui.res.painterResource
    import androidx.compose.ui.res.stringResource
    import androidx.compose.ui.tooling.preview.Preview
    import androidx.compose.ui.unit.dp
    import androidx.compose.ui.unit.sp

    /**
    * MainActivity: アプリケーションのエントリポイント。
    * このアクティビティは、UI を設定し、DiceViewModel を初期化します。
    */
    class MainActivity : ComponentActivity() {
        private val diceViewModel by viewModels<DiceViewModel>()

        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContent {
                MaterialTheme {
                    DiceRollerApp(diceViewModel)
                }
            }
        }
    }

    /**
    * DiceRollerApp: サイコロアプリのUIを構築するコンポーザブル関数。
    * @param diceViewModel DiceViewModelのインスタンスを受け取り、UIにデータを提供します。
    */
    @Composable
    fun DiceRollerApp(diceViewModel: DiceViewModel) {
        val result by diceViewModel.diceResult.collectAsState()
        DiceWithButtonAndImage(result = result, onRollDice = { diceViewModel.rollDice() })
    }

    /**
    * DiceWithButtonAndImage: サイコロの結果を表示し、サイコロを振るボタンを提供するUIコンポーネント。
    * @param result サイコロの結果を表す整数。
    * @param onRollDice サイコロを振る動作を実行するコールバック関数。
    */
    @Composable
    fun DiceWithButtonAndImage(result: Int, onRollDice: () -> Unit) {
        val imageResource = when(result) {
            1 -> R.drawable.dice_1
            2 -> R.drawable.dice_2
            3 -> R.drawable.dice_3
            4 -> R.drawable.dice_4
            5 -> R.drawable.dice_5
            else -> R.drawable.dice_6
        }

        Column(modifier = Modifier
            .fillMaxSize()
            .wrapContentSize(Alignment.Center), horizontalAlignment = Alignment.CenterHorizontally) {
            Image(painter = painterResource(id = imageResource), contentDescription = "Dice rolled result $result")
            Spacer(modifier = Modifier.height(16.dp)) // Add some space between the image and button
            Button(onClick = onRollDice) {
                Text(text = stringResource(id = R.string.roll), fontSize = 24.sp)
            }
        }
    }

    /**
    * PreviewDiceWithButtonAndImage: プレビュー機能を提供するコンポーザブル関数。
    * デザインタイムにUIの見た目を確認するために使用します。
    */
    @Preview(showBackground = true)
    @Composable
    fun PreviewDiceWithButtonAndImage() {
        MaterialTheme {
            DiceWithButtonAndImage(result = 1, onRollDice = {})
        }
    }

flowchart TB

    datalayer["データレイヤ"]
    viewModel["ViewModel(UI State)"]
    ui_elements["UI elements"]


    datalayer-. "`Application Data`" .->viewModel

    subgraph UI レイヤ
        viewModel-->ui_elements
        ui_elements-. "events" .->viewModel
    end

flowchart TD
    UIレイヤ:::GreenClass --> データレイヤ
    データレイヤ:::BlueClass  --> ドメインレイヤ:::BlackClass
    classDef GreenClass fill:#00FF00
    classDef BlueClass fill:#0000FF
    classDef BlackClass fill:#000000

// 依存関係を提供するクラス
@Module
@InstallIn(SingletonComponent::class)
object NetworkModule {
    @Singleton
    @Provides
    fun provideRetrofitService(): RetrofitService {
        return Retrofit.Builder()
            .baseUrl("https://example.com")
            .build()
            .create(RetrofitService::class.java)
    }
}

// 依存関係を注入するクラス
@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
    @Inject lateinit var retrofitService: RetrofitService

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // retrofitService を使用
    }
}

関連記事

• Android開発学習のための推奨リンク
  
• ValidationExceptionに関する考察: エラーハンドリングと例外処理の設計
  
• Ranges and progressions（翻訳）
  
• Android Studioのエラー対応集