xfy/yayacal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
yayacal/AGENTS.md
xfy 2028897ce3 docs: 同步 AGENTS.md 文档，反映纯 Android 项目结构 
- 更新所有层级 AGENTS.md 中的模块描述（:app / :core）
- 移除 KMP/iOS 相关引用，统一为纯 Android + Jetpack Compose
- 同步构建命令和测试路径

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 16:46:17 +08:00

1.9 KiB
Raw Blame History

YaYa

Purpose

YaYa 是一款基于纯 Android + Jetpack Compose 构建的日历应用。应用功能包括农历显示、节气标注、节假日信息、个人班次排期（WORK/OFF 循环）以及月/周/年三种视图切换。

Key Files

File Description
build.gradle.kts 根项目 Gradle 构建设置
settings.gradle.kts Gradle 项目包含模块声明（:app, :core）
gradle.properties Gradle 构建设置与缓存配置
gradle/libs.versions.toml 版本目录（依赖版本统一管理）
CLAUDE.md 项目开发指南与架构文档
CHANGELOG.md 版本变更历史
DEVELOPMENT.md 性能追踪与开发工具说明
COMMENTS.md KDoc 注释规范

Subdirectories

Directory Purpose
app/ Android 应用壳层模块（见 app/AGENTS.md）
core/ Android Library 核心模块：所有 Compose UI、ViewModel 和业务逻辑（见 core/AGENTS.md）
gradle/ Gradle Wrapper 文件

For AI Agents

Working In This Directory

  • 所有依赖版本在 gradle/libs.versions.toml 中声明
  • 修改依赖后需同步 Gradle
  • 构建配置在根 build.gradle.kts 和各模块 build.gradle.kts 中

Testing Requirements

  • 核心模块测试：./gradlew :core:test
  • Android 构建：./gradlew :app:assembleDebug
  • 安装验证：./gradlew :app:installDebug

Common Patterns

  • Kotlin 包名统一为 plus.rua.project
  • UI 组件在 plus.rua.project.ui 包下
  • :app 模块仅包含入口 Activity，所有 UI 和逻辑在 :core 模块

Dependencies

External

  • Kotlin 2.3.21, Jetpack Compose BOM, Material 3
  • kotlinx-datetime 0.8.0, tyme4kt（农历/节气）, sketch 4.4.0（GIF）
  • AGP 9.2.1, compileSdk/targetSdk 37, minSdk 24