城市天气展示:以卡片形式展示多个城市的天气信息。 动态 UI:根据不同的天气状况(晴、多云、雨等)自动调整背景和文字颜色。 信息切换:自动切换,温度和天气状况每 3 秒自动切换显示。 手动切换:用户可以通过按钮手动切换显示温度或天气状况。 添加城市:用户可以通过对话框添加新的城市及其天气数据。
| Files | Last commit | Last update |
|---|---|---|
| 10 months ago | ||
| 10 months ago | ||
| 10 months ago |
Exp
城市天气查询与管理应用
项目名称
Android 城市天气展示与管理系统(基于 Jetpack Compose)
项目介绍
本项目是移动应用开发基础
课程设计的实战项目,采用 Kotlin 语言 + Jetpack Compose 构建的安卓原生天气类应用,实现了多城市天气信息展示、城市切换、天气信息动态展示、新增城市天气数据及表单校验等核心功能。
项目遵循 MVVM 架构设计模式,做到数据层、业务逻辑层、UI 层完全解耦,使用 StateFlow 实现数据驱动 UI 更新,结合 Compose 声明式 UI 的特性,完成了高性能、高可读性的安卓应用开发,是学习现代安卓开发的经典实战案例。
项目特点
- 采用声明式 UI 框架 Jetpack Compose 开发,代码简洁,布局与逻辑一体化
- 遵循 MVVM 架构,数据与 UI 彻底分离,具备优秀的可维护性和扩展性
- 实现数据驱动 UI,通过 StateFlow 监听状态变化自动触发 UI 重组
- 完善的用户交互:动画切换展示内容、选中高亮、表单校验、错误提示
- 视觉化适配:根据不同天气状况自动切换页面背景色与文字色,贴合视觉认知
开发环境 & 技术栈
✅ 开发环境
- 开发工具:Android Studio (推荐 Hedgehog / Iguana 版本)
- JDK 版本:17+
- 最小兼容 Android 版本:Android 8.0 (API 26)
- 目标 Android 版本:Android 14 (API 34)
✅ 核心技术栈
- 开发语言:Kotlin (完全抛弃 Java,纯 Kotlin 开发)
- UI 核心框架:Jetpack Compose 1.5+ (声明式 UI、组合函数、动画、弹窗等)
- 架构组件:ViewModel、StateFlow、MutableStateFlow、Lifecycle
- 布局组件:Scaffold、Column、Box、LazyRow 等 Compose 原生布局
- 动画组件:AnimatedContent (平滑过渡动画)
- 其他:Compose Material3 控件、状态管理、Lambda 表达式、集合操作等
核心功能说明
✅ 预置初始化数据:内置 6 个国内主流城市(北京、上海、广州、深圳、杭州、成都)的天气数据
✅ 城市列表展示:水平滚动的城市列表(LazyRow),点击城市名称即可切换当前展示的天气信息
✅ 选中高亮效果:当前选中的城市名称会以蓝色背景 + 白色文字高亮展示,视觉反馈清晰
✅ 天气信息双模式展示:支持「温度展示」和「天气状况展示」两种模式,内容平滑动画切换
✅ 自动 + 手动切换:① 每 3 秒自动切换展示模式 ② 点击按钮手动切换,两种方式互不冲突
✅ 天气视觉适配:根据天气状况(晴 / 多云 / 雨 / 雷 / 阴 / 雾)自动匹配对应的背景色与文字色
✅ 新增城市功能:点击「添加城市」弹出表单弹窗,支持自定义录入城市名称、温度、天气状况
✅ 完善的表单校验:非空校验(城市名 / 温度 / 天气状况不能为空)、格式校验(温度必须为数字),错误信息实时提示
✅ 防重复添加:根据城市 ID 进行唯一性校验,避免重复添加数据
✅ 自动生成城市 ID:新增城市时自动读取现有最大 ID+1,无需手动输入 ID
项目架构设计(MVVM)
本项目严格遵循 MVVM 架构模式 进行分层开发,共分为四层,职责清晰、解耦彻底,是现代安卓开发的标准架构,四层结构如下:
1. 数据模型层(Model)
- 核心实体类:
data class Weather - 封装天气相关的核心数据:城市 ID、城市名称、温度、天气状况,作为整个项目的数据载体
2. 数据仓库层(Repository)
- 核心类:
WeatherRepository - 职责:统一管理所有天气数据,提供数据的增、查、读方法,是项目的唯一数据来源;
- 内部维护一个内存级的天气列表,对外提供只读的列表访问、根据 ID 查询天气、新增天气(去重)等方法;
- 作用:隔离数据来源,后续如需对接网络接口 / 本地数据库,仅需修改该层代码,不影响上层逻辑。
3. 视图模型层(ViewModel)
- 核心类:
WeatherViewModel(继承自 Android ViewModel) - 职责:业务逻辑的核心处理层,持有 Repository 实例,不持有任何 UI 引用,生命周期与页面一致;
- 通过
MutableStateFlow/StateFlow管理所有 UI 相关的状态(选中的天气、展示模式、弹窗状态、城市列表); - 对外暴露操作方法(切换展示模式、选择城市、弹窗显隐、新增城市),所有 UI 操作都通过调用 ViewModel 的方法完成;
- 作用:承担数据加工、业务逻辑处理,是 UI 层和数据层的桥梁,保证数据状态的统一性和可复用性。
4. 视图层(View / UI)
- 核心载体:
MainActivity+ 组合函数WeatherApp - 职责:纯 UI 展示与用户交互,基于 Jetpack Compose 的声明式 UI 编写,无任何业务逻辑;
- 通过
collectAsStateWithLifecycle监听 ViewModel 中的 StateFlow 状态变化,状态驱动 UI 自动重组更新; - 所有用户点击事件,仅做事件转发,调用 ViewModel 的对应方法即可,做到UI 逻辑与业务逻辑完全分离。
项目核心文件结构(按功能划分)
plaintext
com.example.exp
├── MainActivity.kt # 应用入口,初始化Compose主题和ViewModel
├── Weather.kt # Weather数据模型类
├── WeatherRepository.kt # 数据仓库层,数据管理核心
├── WeatherViewModel.kt # 视图模型层,业务逻辑核心
└── ComposeUI相关组合函数 # WeatherApp及所有UI组件(内联编写)
核心功能核心实现说明
1. 自动切换展示内容
通过 LaunchedEffect(Unit) 开启协程,无限循环中延迟 3 秒调用 ViewModel 的切换方法,实现自动轮播,生命周期与 Compose 组件绑定。
2. 动画切换展示内容
使用 AnimatedContent 组件包裹温度 / 天气状况文本,实现两种展示模式的平滑过渡动画,提升用户体验。
3. 天气色彩适配
提供两个工具方法 getWeatherBackgroundColor()、getWeatherTextColor(),根据天气状况返回对应的颜色值,实现视觉化适配。
4. 新增城市表单校验
在弹窗确认按钮中,通过多条件判断完成表单校验,将错误信息存入状态变量,校验不通过时展示红色错误提示文本,不执行新增逻辑。
5. 数据驱动 UI 更新
所有数据变更均通过修改 ViewModel 中的 StateFlow 值实现,UI 层监听状态变化自动重组,无需手动刷新页面,保证数据与 UI 的一致性。
运行步骤
- 下载本项目源码,使用 Android Studio 打开项目
- 等待项目完成 Gradle 同步、依赖下载和编译(首次打开耗时稍长)
- 配置安卓模拟器(推荐 Pixel 5,API 26+)或连接真机(开启开发者模式 + USB 调试)
- 点击 Android Studio 顶部的「Run」按钮,选择对应的设备运行项目
- 项目启动后即可体验所有功能
功能操作演示
- 应用启动后,默认展示北京的天气信息,顶部为水平滚动的城市列表
- 点击任意城市名称,即可切换至对应城市的天气信息,选中城市高亮显示
- 页面中部的温度 / 天气状况会每 3 秒自动切换,也可点击下方按钮手动切换
- 点击「添加城市」按钮,弹出新增表单,输入城市名称、温度、天气状况
- 若输入内容不合法(如温度非数字、内容为空),会在表单下方显示红色错误提示
- 输入合法内容后点击「添加」,弹窗关闭,顶部城市列表自动刷新,新增城市出现在列表中
- 点击新增的城市名称,即可查看该城市的天气信息
注意事项
- 本项目的数据为内存级存储,应用重启后新增的城市数据会丢失,如需持久化可对接 Room 数据库(扩展方向)
- 温度输入框仅支持数字(整数 / 小数均可),输入非数字内容会触发校验提示,无法添加
- 城市 ID 为系统自动生成,无需手动输入,规则为「现有最大 ID + 1」
- 项目中使用的是 Material3 控件库,界面风格为安卓官方最新的 Material Design 3 设计规范
- 最低兼容 Android 8.0,低于该版本的设备无法运行本应用
总结
本项目是一个功能完整、架构规范、代码简洁的安卓入门实战项目,完美融合了 Jetpack Compose + MVVM + StateFlow 等现代安卓开发核心技术栈,实现了天气应用的核心业务逻辑。项目的代码结构清晰、注释规范,非常适合作为移动应用开发基础的课程设计作品,同时也能帮助开发者快速掌握现代安卓开发的核心思想和开发流程。
Introduction
城市天气展示:以卡片形式展示多个城市的天气信息。 动态 UI:根据不同的天气状况(晴、多云、雨等)自动调整背景和文字颜色。 信息切换:自动切换,温度和天气状况每 3 秒自动切换显示。 手动切换:用户可以通过按钮手动切换显示温度或天气状况。 添加城市:用户可以通过对话框添加新的城市及其天气数据。
Customize your domain