Android開発

// Android Jetpack Compose .cursorrules

// フレキシビリティ通知

// 注意：これは推奨されるプロジェクト構造ですが、フレキシビリティを保ち、既存のプロジェクト構造に適応してください。
// プロジェクトが異なる組織方式に従っている場合は、これらの構造パターンを強制的に適用しないでください。
// 既存のプロジェクトアーキテクチャと整合性を保ちながら、Jetpack Compose のベストプラクティスを適用することに重点を置いてください。

// プロジェクトアーキテクチャとベストプラクティス

const androidJetpackComposeBestPractices = [
"コードの清潔性原則を保ちながら既存のプロジェクトアーキテクチャに適応",
"Material Design 3 ガイドラインとコンポーネントに従う",
"ドメイン層、データ層、プレゼンテーション層を含むクリーンアーキテクチャを実装",
"Kotlin コルーチンと Flow を使用して非同期操作を実行",
"Hilt を使用して依存性注入を実装",
"ViewModel と UI State の単方向データフローに従う",
"Compose Navigation を使用して画面管理を行う",
"適切な状態昇格と組み合わせを実装",
];

// フォルダ構造

// 注意：これは参考構造です。プロジェクトの既存の組織に適応してください。

const projectStructure = `app/
  src/
    main/
      java/com/package/
        data/
          repository/
          datasource/
          models/
        domain/
          usecases/
          models/
          repository/
        presentation/
          screens/
          components/
          theme/
          viewmodels/
        di/
        utils/
      res/
        values/
        drawable/
        mipmap/
    test/
    androidTest/`;

// Compose UI ガイドライン

const composeGuidelines = `

1. remember と derivedStateOf を適切に使用
2. 適切な再構成最適化を実装
3. 正しい Compose 修飾子の順序を使用
4. コンポーザブル関数の命名規則に従う
5. 適切なプレビュー注釈を実装
6. MutableState を使用して適切な状態管理を行う
7. 適切なエラーハンドリングとロードステートを実装
8. MaterialTheme を使用して適切なテーマ設定を行う
9. アクセシビリティガイドラインに従う
10. 適切なアニメーションパターンを実装
    `;

// テストガイドライン

const testingGuidelines = `

1. ViewModels と UseCases に対してユニットテストを作成
2. Compose テストフレームワークを使用して UI テストを実装
3. テスト用のモックリポジトリを使用
4. 適切なテストカバレッジを実装
5. 適切なテストコルーチンスケジューラを使用
   `;

// パフォーマンスガイドライン

const performanceGuidelines = `

1. 適切なキーを使用して再構成を最小限に抑える
2. LazyColumn と LazyRow を使用して適切な遅延読み込みを実装
3. 効率的な画像ロードを実装
4. 不要な更新を防ぐために適切な状態管理を使用
5. 適切なライフサイクル感知に従う
6. 適切なメモリ管理を実装
7. 適切なバックグラウンド処理を実装
   `;