App Template

一个基于 Jetpack Compose 的 Android 应用模板项目，采用 MVVM + 单向数据流架构，开箱即用。

功能特性

• 自适应布局 — 根据设备屏幕尺寸自动切换紧凑/展开布局
• 多语言支持 — 支持简体中文与英文，应用内实时切换
• 主题切换 — 浅色 / 深色 / 跟随系统，运行时切换
• 隐私政策 — 内置隐私政策页面，首次启动引导用户确认
• 边缘到边缘 — 支持 Edge-to-Edge 显示，横屏自动隐藏系统栏

技术栈

类别	技术
语言	Kotlin 2.3
UI	Jetpack Compose + Material 3
架构	MVVM + UDF（单向数据流）
依赖注入	Koin 4.2
导航	Navigation 2.9
状态管理	DataStore 1.2 + StateFlow
异步处理	Kotlin Coroutines + Flow
序列化	Kotlin Serialization
自适应	Material 3 Adaptive

环境要求

• Android SDK：minSdk 32 / targetSdk 36
• JDK 21
• Kotlin 2.3.21
• AGP 9.2.1

项目结构

app/src/main/kotlin/com/template/jh/
├── MainActivity.kt
├── MyApplication.kt
├── core/
│   └── utils/
│       └── localization/
│           └── LanguageManager.kt
├── data/
│   └── repository/
│       └── UserPreferencesRepository.kt
├── di/
│   └── AppModule.kt
├── home/
│   ├── HomeScreen.kt
│   ├── HomeViewModel.kt
│   ├── HomeUiState.kt
│   └── ui/
│       ├── CompactHomeContent.kt
│       ├── ExpandedHomeContent.kt
│       ├── FeatureCard.kt
│       └── WelcomeCard.kt
├── privacy/
│   ├── PrivacyScreen.kt
│   ├── PrivacyViewModel.kt
│   ├── PrivacyUiState.kt
│   └── ui/
│       ├── DataCollectionCard.kt
│       ├── NetworkCard.kt
│       ├── PermissionCard.kt
│       └── PrivacyButtons.kt
├── settings/
│   ├── SettingsScreen.kt
│   ├── SettingsViewModel.kt
│   ├── SettingsUiState.kt
│   └── ui/
│       ├── LanguageSettingsCard.kt
│       └── ThemeSettingsCard.kt
└── ui/
    ├── adaptive/
    │   └── WindowSizeClass.kt
    ├── navigation/
    │   ├── AppNavHost.kt
    │   └── Screen.kt
    └── theme/
        ├── Color.kt
        ├── Theme.kt
        └── Type.kt

发布版构建配置

项目配置了完整的发布版构建流程，包括签名和代码混淆：

签名配置

发布版使用 local.properties 管理密钥信息：

KEYSTORE_PASSWORD=your_keystore_password
KEY_ALIAS=your_key_alias
KEY_PASSWORD=your_key_password

签名文件 your_key.keystore 应放置于项目根目录。

构建类型

类型	特性
Release	启用代码混淆、资源压缩、PNG 优化、签名打包
Debug	关闭调试标志，启用 ProGuard 规则

构建命令

# 构建发布版 APK
./gradlew assembleRelease

# 构建发布版 AAB
./gradlew bundleRelease

构建与运行

1. 克隆仓库

git clone https://github.com/Evilgodxu/kotlin-android-template.git

2. 使用 Android Studio 打开项目

3. 配置签名（可选，用于发布版构建）

   • 在项目根目录创建 local.properties 文件
   • 添加密钥配置信息

4. 同步 Gradle 后直接运行

许可证

MIT License