Instruction file imported from hyjfine/VeloTrack-android (.cursor/rules/kotlin-compose.mdc). Copyright stays with the author.

Kotlin & Compose

Name: kotlin-compose
Author: hyjfine

分层

Activity（MainActivity）：权限、LocationTracker 生命周期、保屏、注入 MapProvider
ViewModel（TrackViewModel）：录制状态机、计时、点过滤、历史/删除/AI；不直接持有 MapView
Composable：只读 TrackUiState，通过 lambda 回调；主题用 VeloTheme / VeloColors

状态

// ✅ 收集状态
val state by viewModel.uiState.collectAsStateWithLifecycle()

// ✅ ViewModel 内更新
_uiState.update { it.copy(isRecording = true) }

单位与格式

内部速度 m/s；展示 km/h：mps * 3.6
格式化复用 TrackViewModel.kt 底部：formatDistanceMeters、formatSpeedKmh、formatDurationMs

Compose UI

颜色/圆角来自 VeloColors、VeloDimens，勿硬编码偏离 docs/design-tokens.json
点击反馈：Modifier.tapFeedbackClickable + rememberTapFeedback()
停止录制：长按 1.5s，配合 HoldProgressOverlay 与 holdVersion

Room

改 Entity/Database version 时更新 app/schemas/ 导出
GpsPoint 运行时字段（如 GpsSource）不持久化，见 GpsPointEntity

{ "ocm": "1", "id": "hyjfine-velotrack-android-kotlin-compose-rule", "kind": "skill", "name": "kotlin-compose", "description": "Kotlin / Compose 编码约定", "publisher": "hyjfine", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-cursor-rules" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Kotlin / Compose 编码约定" ], "primary": false, "metadata": { "source": { "provider": "github-cursor-rules", "repository": "https://github.com/hyjfine/VeloTrack-android", "path": ".cursor/rules/kotlin-compose.mdc", "ref": "f321f6551b85c9b3a13d2294669150084423e84a", "url": "https://github.com/hyjfine/VeloTrack-android/blob/f321f6551b85c9b3a13d2294669150084423e84a/.cursor/rules/kotlin-compose.mdc", "key": "hyjfine/VeloTrack-android/.cursor/rules/kotlin-compose.mdc" }, "applies_to": "app/**/*.kt" }, "instructions": "# Kotlin & Compose\n\n## 分层\n\n- **Activity**（`MainActivity`）：权限、`LocationTracker` 生命周期、保屏、注入 `MapProvider`\n- **ViewModel**（`TrackViewModel`）：录制状态机、计时、点过滤、历史/删除/AI；不直接持有 `MapView`\n- **Composable**：只读 `TrackUiState`，通过 lambda 回调；主题用 `VeloTheme` / `VeloColors`\n\n## 状态\n\n```kotlin\n// ✅ 收集状态\nval state by viewModel.uiState.collectAsStateWithLifecycle()\n\n// ✅ ViewModel 内更新\n_uiState.update { it.copy(isRecording = true) }\n```\n\n## 单位与格式\n\n- 内部速度 **m/s**；展示 km/h：`mps * 3.6`\n- 格式化复用 `TrackViewModel.kt` 底部：`formatDistanceMeters`、`formatSpeedKmh`、`formatDurationMs`\n\n## Compose UI\n\n- 颜色/圆角来自 `VeloColors`、`VeloDime", "cost": { "context_tokens": 218 } }

kotlin-compose

About

Kotlin & Compose

分层

状态

单位与格式

Compose UI

Room

Use it

Manifest

Reviews