🌦️ Weather Forecast App | 天气预报应用

English | 中文

📱 Weather Forecast App

A beautiful, feature-rich weather forecast application that provides accurate and detailed weather information for multiple cities.

✨ Features

• 🌡️ Real-time Weather Data - Current temperature, weather conditions, wind information and more
• 📅 7-Day Forecast - Plan your week with accurate daily weather predictions
• 🏙️ Multi-City Management - Add, search, and manage multiple city weather profiles
• 📍 Location Services - Get weather updates for your current location
• 🧥 Life Indices - Clothing, driving, cold, sport and UV indices to plan your day
• 🔄 Real-time Updates - Latest weather data from professional weather services
• 🎨 Beautiful UI - Elegant interface with customizable background themes
• 📱 User-Friendly Design - Intuitive swipe gestures and easy navigation

🛠️ Technologies Used

• Java - Primary programming language
• High Precision APIs - Utilizing Gaode Location API and QWeather API
• SQLite Database - For local storage of city and weather information
• ViewPager - For smooth transitions between city weather pages
• Fragment-based Architecture - For modular and maintainable code

🚀 Getting Started

Prerequisites

• Android Studio 4.0+
• Android SDK 21+ (Android 5.0 or above)
• Gaode Maps API key (for location services)
• QWeather API key (for weather data)

Installation

1. Clone this repository

git clone https://github.com/YYYanZZZ/Weather-Forecast-App.git

2. Open the project in Android Studio

3. Set up your API keys securely:

   • Copy local.properties.example to local.properties (this file is ignored by git)
   • Add your actual API keys to the local.properties file:

   # API Keys (replace with your own keys)
   weather.api.key=YOUR_QWEATHER_API_KEY
   amap.api.key=YOUR_GAODE_MAP_API_KEY

4. Build and run the application

🔮 Future Enhancements

• 🌚 Dark mode support
• 🔔 Weather alerts and notifications
• 📊 Historical weather data and graphs
• 🖼️ Additional customization options
• 🌐 Support for more languages

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

• QWeather API for providing weather data
• Gaode Map for location services
• All contributors who have helped this project grow

---

📱 天气预报应用

一款美观、功能丰富的天气预报应用，为多个城市提供准确详细的天气信息。

✨ 功能特点

• 🌡️ 实时天气数据 - 当前温度、天气状况、风力信息等
• 📅 七天天气预报 - 通过准确的每日天气预测规划您的一周
• 🏙️ 多城市管理 - 添加、搜索和管理多个城市的天气信息
• 📍 位置服务 - 获取您当前位置的天气更新
• 🧥 生活指数 - 穿衣、驾车、感冒、运动和紫外线指数帮助您规划一天
• 🔄 实时更新 - 来自专业天气服务的最新天气数据
• 🎨 精美界面 - 优雅的界面设计，可自定义背景主题
• 📱 用户友好设计 - 直观的滑动手势和便捷的导航

🛠️ 技术栈

• Java - 主要编程语言
• 高精度API - 使用高德定位API和和风天气API
• SQLite数据库 - 用于本地存储城市和天气信息
• ViewPager - 实现城市天气页面之间的平滑过渡
• 基于Fragment的架构 - 提供模块化和可维护的代码结构

🚀 开始使用

前提条件

• Android Studio 4.0+
• Android SDK 21+ (Android 5.0或以上)
• 高德地图API密钥（用于位置服务）
• 和风天气API密钥（用于天气数据）

安装步骤

1. 克隆此仓库

git clone https://github.com/YYYanZZZ/Weather-Forecast-App.git

2. 在Android Studio中打开项目

3. 安全设置您的API密钥：

   • 将 local.properties.example 复制为 local.properties（此文件被git忽略）
   • 在 local.properties 文件中添加您的实际API密钥：

   # API密钥（替换为您自己的密钥）
   weather.api.key=您的和风天气API密钥
   amap.api.key=您的高德地图API密钥

4. 构建并运行应用程序

🔮 未来增强功能

• 🌚 深色模式支持
• 🔔 天气预警和通知
• 📊 历史天气数据和图表
• 🖼️ 更多自定义选项
• 🌐 支持更多语言

🤝 贡献

欢迎贡献！请随时提交拉取请求。

1. Fork此仓库
2. 创建您的功能分支（git checkout -b feature/令人惊叹的功能）
3. 提交您的更改（git commit -m '添加一些令人惊叹的功能'）
4. 推送到分支（git push origin feature/令人惊叹的功能）
5. 打开拉取请求

📄 许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

🙏 致谢

• 和风天气API提供天气数据
• 高德地图提供位置服务
• 所有帮助本项目成长的贡献者

---

⭐ 如果您觉得这个项目有帮助，请考虑在GitHub上给它一个星标！ ⭐