yayacal/app/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

2.1 KiB
Raw Blame History

app

Purpose

Android 应用壳层模块,仅包含入口 MainActivityAboutActivityLicensesActivity 和最小化的 Android 平台配置。所有 UI 和业务逻辑均来自 :core 模块。

Key Files

File Description
build.gradle.kts Android 应用模块构建配置
src/main/kotlin/plus/rua/project/MainActivity.kt Android 入口 Activity设置 CalendarMonthView() Composable
src/main/kotlin/plus/rua/project/AboutActivity.kt 关于页面 Activity
src/main/kotlin/plus/rua/project/LicensesActivity.kt 许可证列表 Activity
src/main/AndroidManifest.xml Android 清单,声明 Activities 和主题
src/main/res/values/themes.xml 应用主题配置Material 3
src/main/res/values-night/themes.xml 夜间模式主题
src/main/res/values/strings.xml 应用名称字符串
src/main/res/anim/ Activity 转场动画slide_in/slide_out
src/main/assets/gifs/ GIF 动画资源目录

Subdirectories

Directory Purpose
src/main/ 主源码与资源(见 src/main/AGENTS.md
src/debug/ Debug 构建资源
src/release/ Release 构建资源

For AI Agents

Working In This Directory

  • 不要在此模块添加业务逻辑;所有代码应放在 :core 模块
  • 仅修改 Android 特有的配置Manifest、主题、权限、Activity 声明
  • MainActivity.kt 应保持简洁,仅负责调用 CalendarMonthView()

Testing Requirements

  • 构建验证:./gradlew :app:assembleDebug
  • 安装验证:./gradlew :app:installDebug

Common Patterns

  • 使用 enableEdgeToEdge() 实现全屏边缘到边缘显示
  • Activity 转场使用 overridePendingTransition() 配合 res/anim/ 中的 XML 动画
  • 主题继承自 Theme.AppCompat.DayNight.NoActionBar

Dependencies

Internal

  • :core 模块 — 提供所有 UI 和逻辑

External

  • Android Gradle Plugin 9.2.1
  • Material 3, Compose runtime, Compose UI tooling