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. 使用適當的後台處理
   `;