- Android Studio Arctic Fox 或更高版本
- JDK 11 或更高版本
- Android SDK API 24+ (Android 7.0)
- Gradle 8.0+ （构建本项目时gradle会自动配置与本项目同版本的gradle）
-
克隆项目
git clone https://github.com/Sakurapainting/WeatherReportofYou.git cd WeatherReportofYou -
配置 API Key
- 访问 OpenWeatherMap 注册并获取免费的 API key
- 在项目根目录的
local.properties文件中添加你的 API key：
# local.properties WEATHER_API_KEY=你的API密钥
或者设置环境变量：
# Windows set WEATHER_API_KEY=你的API密钥 # Linux/macOS export WEATHER_API_KEY=你的API密钥
-
编译运行项目
./gradlew assembleDebug
或在 Android Studio 中直接运行
- 支持全球城市搜索
- 实时天气数据获取
- 添加/删除收藏城市
- 收藏列表快速访问
- 本地数据库存储
使用 MPAndroidChart 库实现：
- 温度变化趋势图
- 湿度变化柱状图
- 风速变化曲线
项目使用 Gradle BuildConfig 在编译时自动注入 API 密钥，确保：
- 源码中不包含敏感信息
- 支持环境变量和配置文件两种方式
- 自动验证 API 密钥有效性
- 使用 Retrofit + OkHttp 进行网络请求
- 支持请求日志记录
- 自动重试机制
./gradlew assembleDebug./gradlew assembleRelease生成的 APK 文件位于：app/build/outputs/apk/
我们欢迎所有形式的贡献！无论是新功能、bug 修复、文档改进还是其他建议。 贡献文档
发现 bug？请通过 Issues 报告。 Bug Issue 模版 Feature request 模版
该项目使用 Git 进行版本管理。您可以在 Releases 页面查看当前可用版本。
- 主版本号：不兼容的 API 修改
- 次版本号：向下兼容的功能性新增
- 修订号：向下兼容的问题修正
开发者信息
- 邮箱：you2899047197@163.com
- GitHub：@Sakurapainting
本项目采用 AGPL v3 许可证 - 查看 LICENSE 文件了解详情
GNU AFFERO GENERAL PUBLIC LICENSE
Version 3, 19 November 2007
Copyright (C) 2025 Sakurapainting
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
感谢以下开源项目和服务：
Retrofit - HTTP 客户端库 MPAndroidChart - Android 图表库 Glide - 图片加载库
⭐ 如果这个项目对你有帮助，请给个 Star！⭐
Made with ❤️ by Sakurapainting