xfy
2028897ce3
- 更新所有层级 AGENTS.md 中的模块描述（:app / :core） - 移除 KMP/iOS 相关引用，统一为纯 Android + Jetpack Compose - 同步构建命令和测试路径 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
<!-- Parent: ../AGENTS.md -->
|
||
<!-- Generated: 2026-05-20 | Updated: 2026-05-20 -->
|
||
|
||
# app
|
||
|
||
## Purpose
|
||
Android 应用壳层模块，仅包含入口 `MainActivity`、`AboutActivity`、`LicensesActivity` 和最小化的 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
|
||
|
||
<!-- MANUAL: -->
|