Cityweather:基于 Jetpack Compose 的 Android 天气应用项目

用户可通过该项目获取多城市实时天气信息,它提供动态天气数据展示、多城市管理及现代化界面,支持温度等数据自动切换、城市搜索与本地存储,采用 MVVM 架构和 Material Design 3 设计。【此简介由AI生成】

Branch1Tags0
FilesLast commitLast 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+

构建步骤

  1. 克隆项目到本地
  2. 使用 Android Studio 打开项目
  3. 等待 Gradle 同步完成
  4. 连接 Android 设备或启动模拟器
  5. 点击运行按钮构建并安装应用

配置说明

项目使用 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