Android Modern Architecture & Modularization

Instructions

Android アプリケーションを設計またはリファクタリングする際は、Guide to App Architecture と Clean Architecture の原則を厳守します。

1. High-Level Layers

アプリケーションを 3 つの主要層に構成します。依存関係は厳密に内側へ（またはコア論理へ）流れる必要があります。

• UI Layer (Presentation):
  • 責務: データの表示とユーザーインタラクションの処理。
  • コンポーネント: Activities、Fragments、Composables、ViewModels。
  • 依存関係: Domain Layer（またはシンプルな場合は Data Layer）に依存します。Data Layer の実装詳細に直接依存することは絶対禁止です。
• Domain Layer (Business Logic) [オプション、推奨]:
  • 責務: 複雑なビジネスロジックのカプセル化と再利用。
  • コンポーネント: Use Cases（例：GetLatestNewsUseCase）、Domain Models（pure Kotlin のデータクラス）。
  • Pure Kotlin: Android フレームワーク依存（android.* imports）を含めてはいけません。
  • 依存関係: Repository インターフェイスに依存します。
• Data Layer:
  • 責務: アプリケーションデータの管理（取得、キャッシング、保存）。
  • コンポーネント: Repositories（実装）、Data Sources（Retrofit APIs、Room DAOs）。
  • 依存関係: 外部ソースとライブラリにのみ依存します。

2. Hilt による依存性注入

すべての依存性注入に Hilt を使用します。

• @HiltAndroidApp: Application クラスに注釈を付与します。
• @AndroidEntryPoint: Activities と Fragments に注釈を付与します。
• @HiltViewModel: ViewModels に注釈を付与します。標準的な constructor インジェクションを使用してください。
• Modules:
  • アプリ全体のシングルトン（ネットワーク、データベースなど）には @Module と @InstallIn(SingletonComponent::class) を使用します。
  • インターフェイスの実装をバインドするには、abstract class で @Binds を使用します（@Provides より簡潔）。

3. モジュール化戦略

本番アプリでは、マルチモジュール戦略を使用してビルド時間を短縮し、関心事の分離を実現します。

• :app: メインのエントリーポイント。機能を接続します。
• :core:model: 共有される domain モデル（Pure Kotlin）。
• :core:data: Repositories、Data Sources、Database、Network。
• :core:domain: Use Cases と Repository インターフェイス。
• :core:ui: 共有 Composables、Theme、Resources。
• :feature:[name]: 独立した機能モジュール。独自の UI と ViewModels を含みます。:core:domain と :core:ui に依存します。

4. 実装チェックリスト

• Domain layer に Android 依存がないことを確認する。
• Repositories はデフォルトで main-safe な suspend 関数を使用する（必要に応じて内部で Dispatchers.IO を使用）。
• ViewModels は StateFlow を経由して UI layer と通信する（android-viewmodel skill を参照）。