open_weather_example_flutter
使用 OpenWeatherMap API 的 Flutter 天气应用示例
- 星标
- 311
- 复刻
- 74
- 最近推送(UTC)
- 2024年4月19日
- 项目状态
- 未归档
原始 README
以下为英文项目原文快照,最新内容请访问 GitHub。
Flutter Weather App Example
An example Flutter weather app using the OpenWeatherMap API.
Related Tutorials
Supported Features
- [x] Current weather (condition and temperature)
- [x] 5-day weather forecast
- [x] Search by city
App Architecture
The app is composed by three main layers.
Data Layer
The data layer contains a single HttpWeatherRepository that is used to fetch weather data from the OpenWeatherMap API.
The data is then parsed (using Freezed) and returned using type-safe entity classes (Weather and Forecast).
For more info about this, read this tutorial:
For more info about the project structure, read this:
Application Layer
This contains some providers that are used to fetch and cache the data from the HttpWeatherRepository.
// current city stored in the search box in the UI
final cityProvider = StateProvider<String>((ref) {
return 'London';
});
// provider to fetch the current weather
final currentWeatherProvider =
FutureProvider.autoDispose<WeatherData>((ref) async {
final city = ref.watch(cityProvider);
final weather =
await ref.watch(weatherRepositoryProvider).getWeather(city: city);
return WeatherData.from(weather);
});
// provider to fetch the hourly weather
final hourlyWeatherProvider =
FutureProvider.autoDispose<ForecastData>((ref) async {
final city = ref.watch(cityProvider);
final forecast =
await ref.watch(weatherRepositoryProvider).getForecast(city: city);
return ForecastData.from(forecast);
});
Presentation Layer
This layer holds all the widgets, which fetch the data from the FutureProviders above and map the resulting AsyncValue objects to the appropriate UI states (data, loading, error).
Packages in use
- riverpod for state management
- freezed for code generation
- http for talking to the REST API
- cached_network_image for caching images
- mocktail for testing
About the OpenStreetMap weather API
The app shows data from the following endpoints:
Note: to use the API you'll need to register an account and obtain your own API key. This can be set via --dart-define or inside lib/src/api/api_keys.dart.
LICENSE: MIT
分类
使用的依赖
依赖清单 14 项
- cached_network_image
^3.3.0 - cupertino_icons
^1.0.6 - flutter
{"sdk":"flutter"} - flutter_riverpod
^2.4.8 - freezed_annotation
^2.4.1 - http
^0.13.6 - intl
^0.18.1 - json_annotation
^4.8.1 - build_runner开发依赖
^2.4.6 - flutter_test开发依赖
{"sdk":"flutter"} - freezed开发依赖
^2.4.5 - json_serializable开发依赖
^6.7.1 - mocktail开发依赖
^1.0.1 - flutter_lints开发依赖
^3.0.1
所在榜单
如何选择适合项目的代码仓?
先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。
- 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
- 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
- 使用前在 GitHub 核对 README、许可证与 Issues。
来源与维护
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗