Exp:基于 Jetpack Compose 的安卓天气应用项目

城市天气展示:以卡片形式展示多个城市的天气信息。 动态 UI:根据不同的天气状况(晴、多云、雨等)自动调整背景和文字颜色。 信息切换:自动切换,温度和天气状况每 3 秒自动切换显示。 手动切换:用户可以通过按钮手动切换显示温度或天气状况。 添加城市:用户可以通过对话框添加新的城市及其天气数据。

Branch1Tags0
FilesLast commitLast update
10 months ago
10 months ago
10 months ago

Exp

城市天气查询与管理应用

项目名称

Android 城市天气展示与管理系统(基于 Jetpack Compose)

项目介绍

本项目是移动应用开发基础

课程设计的实战项目,采用 Kotlin 语言 + Jetpack Compose 构建的安卓原生天气类应用,实现了多城市天气信息展示、城市切换、天气信息动态展示、新增城市天气数据及表单校验等核心功能。

项目遵循 MVVM 架构设计模式,做到数据层、业务逻辑层、UI 层完全解耦,使用 StateFlow 实现数据驱动 UI 更新,结合 Compose 声明式 UI 的特性,完成了高性能、高可读性的安卓应用开发,是学习现代安卓开发的经典实战案例。

项目特点

  1. 采用声明式 UI 框架 Jetpack Compose 开发,代码简洁,布局与逻辑一体化
  2. 遵循 MVVM 架构,数据与 UI 彻底分离,具备优秀的可维护性和扩展性
  3. 实现数据驱动 UI,通过 StateFlow 监听状态变化自动触发 UI 重组
  4. 完善的用户交互:动画切换展示内容、选中高亮、表单校验、错误提示
  5. 视觉化适配:根据不同天气状况自动切换页面背景色与文字色,贴合视觉认知

开发环境 & 技术栈

✅ 开发环境

  • 开发工具: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 的一致性。

运行步骤

  1. 下载本项目源码,使用 Android Studio 打开项目
  2. 等待项目完成 Gradle 同步、依赖下载和编译(首次打开耗时稍长)
  3. 配置安卓模拟器(推荐 Pixel 5,API 26+)或连接真机(开启开发者模式 + USB 调试)
  4. 点击 Android Studio 顶部的「Run」按钮,选择对应的设备运行项目
  5. 项目启动后即可体验所有功能

功能操作演示

  1. 应用启动后,默认展示北京的天气信息,顶部为水平滚动的城市列表
  2. 点击任意城市名称,即可切换至对应城市的天气信息,选中城市高亮显示
  3. 页面中部的温度 / 天气状况会每 3 秒自动切换,也可点击下方按钮手动切换
  4. 点击「添加城市」按钮,弹出新增表单,输入城市名称、温度、天气状况
  5. 若输入内容不合法(如温度非数字、内容为空),会在表单下方显示红色错误提示
  6. 输入合法内容后点击「添加」,弹窗关闭,顶部城市列表自动刷新,新增城市出现在列表中
  7. 点击新增的城市名称,即可查看该城市的天气信息

注意事项

  1. 本项目的数据为内存级存储,应用重启后新增的城市数据会丢失,如需持久化可对接 Room 数据库(扩展方向)
  2. 温度输入框仅支持数字(整数 / 小数均可),输入非数字内容会触发校验提示,无法添加
  3. 城市 ID 为系统自动生成,无需手动输入,规则为「现有最大 ID + 1」
  4. 项目中使用的是 Material3 控件库,界面风格为安卓官方最新的 Material Design 3 设计规范
  5. 最低兼容 Android 8.0,低于该版本的设备无法运行本应用

总结

本项目是一个功能完整、架构规范、代码简洁的安卓入门实战项目,完美融合了 Jetpack Compose + MVVM + StateFlow 等现代安卓开发核心技术栈,实现了天气应用的核心业务逻辑。项目的代码结构清晰、注释规范,非常适合作为移动应用开发基础的课程设计作品,同时也能帮助开发者快速掌握现代安卓开发的核心思想和开发流程。

Introduction

城市天气展示:以卡片形式展示多个城市的天气信息。 动态 UI:根据不同的天气状况(晴、多云、雨等)自动调整背景和文字颜色。 信息切换:自动切换,温度和天气状况每 3 秒自动切换显示。 手动切换:用户可以通过按钮手动切换显示温度或天气状况。 添加城市:用户可以通过对话框添加新的城市及其天气数据。

Customize your domain