xfy
50a42be9bc
为各模块和子目录添加 AGENTS.md，便于 AI 助手理解项目结构。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.8 KiB
1.8 KiB
shared
Purpose
Kotlin Multiplatform 共享模块，包含所有 Compose UI、ViewModel 和业务逻辑。通过 expect/actual 机制为 Android 和 iOS 提供平台特定实现。这是项目的核心模块。
Key Files
| File | Description |
|---|---|
build.gradle.kts |
共享模块构建配置（KMP 插件设置、source sets、依赖） |
Subdirectories
| Directory | Purpose |
|---|---|
src/androidMain/ |
Android 平台特定实现（见 src/androidMain/AGENTS.md） |
src/commonMain/ |
所有 Compose UI、ViewModel 和业务逻辑（见 src/commonMain/AGENTS.md） |
src/commonTest/ |
共享测试套件（见 src/commonTest/AGENTS.md） |
src/iosMain/ |
iOS 平台特定实现（见 src/iosMain/AGENTS.md） |
For AI Agents
Working In This Directory
- 所有功能代码应放在
commonMain中以跨平台复用 - 仅在
androidMain/iosMain中放置平台特有实现 - 修改
commonMain后需运行:shared:allTests验证
Testing Requirements
- 全部测试：
./gradlew :shared:allTests - Android 主机测试：
./gradlew :shared:testAndroidHostTest - 单类测试：
./gradlew :shared:testAndroidHostTest --tests "ClassName"
Common Patterns
expect声明在commonMain，actual实现在平台 source set- Compose 资源放在
commonMain/composeResources/下 - 包名：
plus.rua.project（逻辑层）、plus.rua.project.ui（UI 层）
Dependencies
External
- Compose Multiplatform 1.11.0, Material 3 1.10.0-alpha05
kotlinx-datetime0.8.0,kotlinx-coroutinestyme4kt（农历/节气）,sketch4.4.0（GIF 显示）molecule（测试用）