☁️ LittleBean (Bean Cloud)

专为儿童音频资源管理设计的云端应用

功能特性 • 技术栈 • 项目结构 • 快速开始 • 许可证

---

介绍

LittleBean (Bean Cloud) 是一款专为儿童音频资源管理设计的 Android 应用。它提供了便捷的云端播单管理功能，支持音频的上传、下载、云端同步等操作，让家长轻松管理孩子的音频资源。

功能特性

🎵 播单管理

• 云端播单的创建、编辑、删除
• 播单内音频资源的浏览和搜索
• 支持批量操作（多选删除等）

⬇️ 传输管理

• 音频文件的下载和上传
• 后台下载支持（前台服务）
• 下载进度实时显示
• 支持网络类型限制（仅 WiFi / 全部网络）

🔐 账户系统

• 密码登录
• 短信验证码登录
• Token 自动刷新

⚙️ 设置与偏好

• 深色/浅色主题支持
• 网络传输设置
• 关于页面与版本检查

🎨 用户体验

• Material Design 3 风格
• 流畅的页面过渡动画
• 响应式布局

技术栈

类别	技术
语言	Kotlin
UI 框架	Jetpack Compose
架构模式	MVI (Model-View-Intent)
依赖注入	Hilt
网络请求	Retrofit + OkHttp
本地数据库	Room
数据存储	DataStore
后台任务	WorkManager
图片加载	Coil
导航	Navigation3
序列化	Kotlinx Serialization

项目结构

app/src/main/java/app/idaima/littlebean/
├── data/                    # 数据层
│   ├── local/               # 本地数据源 (Room)
│   ├── AuthEventManager.kt  # 认证事件管理
│   ├── SettingsPreferences.kt # 设置偏好
│   ├── TokenManager.kt      # Token 管理
│   └── UserManager.kt       # 用户信息管理
├── di/                      # 依赖注入模块
├── model/                   # 数据模型
├── mvi/                     # MVI 基础类
├── navigation/              # 导航配置
├── network/                 # 网络层
│   ├── dto/                 # 数据传输对象
│   ├── ApiService.kt        # API 接口定义
│   └── interceptors/        # 网络拦截器
├── transfer/                # 传输模块
│   ├── model/               # 传输任务模型
│   ├── notification/        # 下载通知管理
│   ├── worker/              # WorkManager Workers
│   └── TransferTaskManager.kt
├── ui/                      # UI 层
│   ├── cloudplaylist/       # 云端播单页面
│   ├── component/           # 公共组件
│   ├── login/               # 登录页面
│   ├── main/                # 主页面
│   ├── playlistdetail/      # 播单详情页面
│   ├── selectaudio/         # 音频选择页面
│   ├── settings/            # 设置页面
│   ├── splash/              # 启动页面
│   ├── theme/               # 主题配置
│   ├── transfer/            # 传输页面
│   └── webview/             # WebView 页面
├── util/                    # 工具类
├── LittleBeanApplication.kt # Application 类
└── MainActivity.kt          # 主 Activity

快速开始

环境要求

• Android Studio Koala | 2024.1.1 或更高版本
• JDK 21
• Android SDK 36 (compileSdk)
• Android 12+ (minSdk 31)

构建运行

1. 克隆项目

   git clone https://github.com/idaima/LittleBean.git
   cd LittleBean

2. 打开项目

   使用 Android Studio 打开项目根目录

3. 同步依赖

   等待 Gradle 自动同步项目依赖

4. 运行应用

   选择目标设备或模拟器，点击运行按钮

配置说明

项目使用 local.properties 存储本地配置。如需自定义 SDK 路径，请确保文件中包含：

sdk.dir=/path/to/your/android/sdk

贡献

欢迎提交 Issues 和 Pull Requests！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 提交 Pull Request

许可证

本项目采用 MIT 许可证

---

Made with ❤️ by idaima