用户可通过该项目获取多城市实时天气信息,它提供动态天气数据展示、多城市管理及现代化界面,支持温度等数据自动切换、城市搜索与本地存储,采用 MVVM 架构和 Material Design 3 设计。【此简介由AI生成】
| Files | Last commit | Last update |
|---|---|---|
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago |
🌤️ CityWeather - 现代城市天气应用
CityWeather 是一个使用现代 Android 开发技术构建的天气应用,提供多城市天气管理、实时气象数据和优雅的用户界面体验。
✨ 主要功能
🌡️ 动态天气展示
- 自动切换显示:温度、湿度、气压每2秒自动平滑切换
- 实时气象数据:温度、风速、风向、天气状况、体感温度、降水、气压
- 动态背景:根据当前温度自动变化的渐变背景
- 平滑动画:使用 Jetpack Compose 动画实现流畅的切换效果
🏙️ 多城市管理
- 左右滑动切换:HorizontalPager 实现城市间流畅切换
- 城市搜索:支持搜索全球任意城市并添加到收藏
- 本地存储:使用 Room 数据库持久化保存城市列表
- 删除功能:可删除不需要的城市
🎨 现代化界面
- Material Design 3:遵循最新的 Material Design 设计规范
- 响应式布局:适配不同屏幕尺寸和设备
- 优雅交互:流畅的过渡动画和用户反馈
🛠️ 技术栈
核心框架
- Kotlin - 现代 Android 开发语言
- Jetpack Compose - 声明式 UI 框架
- MVVM 架构 - 清晰的架构分离
数据层
- Retrofit - REST API 网络请求
- Room - 本地数据库存储
- Coroutines - 异步编程和流处理
依赖库
// Jetpack Compose
implementation(platform("androidx.compose:compose-bom:2024.09.00"))
implementation("androidx.compose.ui:ui")
implementation("androidx.compose.material3:material3")
// 网络
implementation("com.squareup.retrofit2:retrofit:2.9.0")
implementation("com.squareup.retrofit2:converter-gson:2.9.0")
// 数据库
implementation("androidx.room:room-runtime:2.6.1")
implementation("androidx.room:room-ktx:2.6.1")
// 协程
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
📱 界面概览
主天气界面 (WeatherScreen.kt)
- 顶部应用栏:显示当前城市名称、刷新按钮、城市管理入口
- 天气图标:根据天气代码显示对应表情符号
- 数据展示区:220dp 固定高度的动画容器,显示温度/湿度/气压
- 详细信息卡片:包含风速、降水、体感温度等详细信息
- 背景渐变:根据温度动态变化的颜色渐变
城市管理界面 (CityListScreen.kt)
- 搜索栏:实时搜索全球城市
- 城市列表:LazyColumn 显示已保存的城市
- 卡片布局:ElevatedCard 展示城市信息
- 删除功能:每个城市卡片支持删除操作
🌐 API 集成
Open-Meteo 天气 API
interface WeatherApiService {
@GET("forecast")
suspend fun getWeather(
@Query("latitude") lat: Double,
@Query("longitude") long: Double,
@Query("current") current: String = "temperature_2m,wind_speed_10m,wind_direction_10m,weather_code,is_day,relative_humidity_2m,apparent_temperature,precipitation,surface_pressure"
): WeatherResponse
}
地理编码 API
interface GeocodingApiService {
@GET("search")
suspend fun searchCity(
@Query("name") name: String,
@Query("count") count: Int = 10,
@Query("language") language: String = "zh",
@Query("format") format: String = "json"
): GeocodingResponse
}
📊 数据模型
天气响应数据
data class CurrentWeather(
val temperature: Double, // 温度 (°C)
val windspeed: Double, // 风速 (km/h)
val winddirection: Double, // 风向 (°)
val weathercode: Int, // 天气代码
val is_day: Int, // 是否白天
val time: String, // 时间
val humidity: Int, // 湿度 (%)
val apparentTemperature: Double, // 体感温度 (°C)
val precipitation: Double, // 降水量 (mm)
val pressure: Double // 气压 (hPa)
)
城市数据
@Entity
data class City(
@PrimaryKey val id: Int,
val name: String,
val latitude: Double,
val longitude: Double,
val country: String?
)
🚀 运行指南
环境要求
- Android Studio Flamingo 或更高版本
- JDK 11+
- Android SDK 34+
构建步骤
- 克隆项目到本地
- 使用 Android Studio 打开项目
- 等待 Gradle 同步完成
- 连接 Android 设备或启动模拟器
- 点击运行按钮构建并安装应用
配置说明
项目使用 Open-Meteo 免费天气 API,无需 API 密钥即可使用。
📁 项目结构
app/src/main/java/com/example/cityweather/
├── data/
│ ├── local/ # 本地数据存储
│ │ ├── AppDatabase.kt # Room 数据库
│ │ ├── City.kt # 城市实体
│ │ └── CityDao.kt # 城市数据访问对象
│ ├── remote/ # 远程数据源
│ │ ├── WeatherApiService.kt # 天气 API 服务
│ │ ├── WeatherModels.kt # 天气数据模型
│ │ └── GeocodingModels.kt # 地理编码模型
│ └── repository/ # 数据仓库
│ └── WeatherRepository.kt # 天气数据仓库
├── ui/
│ ├── screens/ # 界面屏幕
│ │ ├── WeatherScreen.kt # 主天气界面
│ │ └── CityListScreen.kt # 城市管理界面
│ ├── viewmodel/ # ViewModel 层
│ │ └── WeatherViewModel.kt # 天气 ViewModel
│ └── theme/ # 主题和样式
│ ├── Color.kt # 颜色定义
│ ├── Theme.kt # 应用主题
│ └── Type.kt # 字体样式
├── CityWeatherApplication.kt # 应用入口
└── MainActivity.kt # 主活动
🎯 核心特性实现
自动数据切换
enum class WeatherDisplayMode { Temperature, Humidity, Pressure }
var displayMode by remember { mutableStateOf(WeatherDisplayMode.Temperature) }
LaunchedEffect(Unit) {
while (true) {
delay(2000) // 每2秒切换一次
displayMode = when (displayMode) {
WeatherDisplayMode.Temperature -> WeatherDisplayMode.Humidity
WeatherDisplayMode.Humidity -> WeatherDisplayMode.Pressure
WeatherDisplayMode.Pressure -> WeatherDisplayMode.Temperature
}
}
}
平滑动画效果
AnimatedContent(
targetState = displayMode,
transitionSpec = {
slideInVertically { height -> height } + fadeIn() togetherWith
slideOutVertically { height -> -height } + fadeOut()
}
) { mode ->
// 根据模式显示不同数据
}
城市分页切换
val pagerState = rememberPagerState(pageCount = { cities.size })
HorizontalPager(state = pagerState) { page ->
val city = cities[page]
WeatherPage(city, weatherUiStateMap[city.id])
}
🔮 未来计划
📄 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
🤝 贡献
欢迎提交 Issue 和 Pull Request 来改进这个项目!
开发技术: Kotlin, Jetpack Compose, MVVM, Retrofit, Room, Coroutines
API 服务: Open-Meteo (免费天气API)
最低版本: Android 8.0 (API 24)
目标版本: Android 14 (API 34)
Introduction
用户可通过该项目获取多城市实时天气信息,它提供动态天气数据展示、多城市管理及现代化界面,支持温度等数据自动切换、城市搜索与本地存储,采用 MVVM 架构和 Material Design 3 设计。【此简介由AI生成】
Customize your domain