【开源项目】鸿蒙二十四节气应用
鸿蒙二十四节气应用
一个鸿蒙二十四节气查询应用，同时支持 Android、iOS 和鸿蒙 HarmonyOS系统。提供按年份和日期查询节气信息，展示节气的详细文化内容。
特色功能
- 多系统适配: 完美支持鸿蒙 HarmonyOS、Android 和 iOS 系统
- 年份查询: 一键查看指定年份的全部二十四节气信息
- 日期查询: 快速获取特定日期的节气数据
- 详细内容: 包含节气名称、日期、谚语、习俗、气候特点等丰富资料
- 主题切换: 支持亮色/暗色模式，自动跟随系统或手动设置
- 离线功能: 内置缓存机制，减少网络请求，提升用户体验
鸿蒙系统适配
本应用专门适配了华为鸿蒙操作系统(HarmonyOS)，具有以下特点：
- 原生体验: 遵循鸿蒙系统设计语言，提供一致的用户体验
- API 兼容: 使用鸿蒙特有 API，如 notifications、permissions 等
- 性能优化: 针对鸿蒙系统进行性能优化，保证流畅运行
- 统一构建: 一次开发，同时支持鸿蒙、Android 和 iOS 平台
技术架构
- 前端框架: Flutter 3.21+
- 状态管理: Provider
- 网络请求: HTTP
- 数据持久化: SharedPreferences
- 国际化: Flutter Localizations (中/英)
项目结构
lib/
├── config/ # 配置文件
│ ├── api_config.dart # API配置
│ └── theme_config.dart # 主题配置
├── l10n/ # 本地化资源
│ ├── app_en.arb # 英文
│ └── app_zh.arb # 中文
├── main.dart # 应用入口
├── models/ # 数据模型
│ └── solar_term.dart # 节气模型
├── providers/ # 状态管理
│ ├── locale_provider.dart # 语言状态
│ ├── theme_provider.dart # 主题状态
│ └── solar_term_provider.dart # 节气数据状态
├── screens/ # 页面
│ ├── about_screen.dart # 关于页面
│ ├── date_view.dart # 日期查询
│ ├── home_screen.dart # 主页
│ ├── settings_screen.dart # 设置页面
│ └── year_view.dart # 年份查询
├── services/ # 服务
│ └── solar_term_service.dart # API服务
└── widgets/ # 组件
├── solar_term_card.dart # 节气卡片
└── ... # 其他组件
安装与运行
环境要求
- Flutter SDK: >=3.21.0
- Dart SDK: >=3.4.0
- 支持的平台:
- 鸿蒙 HarmonyOS
- Android 5.0+
- iOS 11.0+
运行步骤
- 克隆项目
git clone https://gitcode.com/nutpi/flutter_solarterm.git
- 安装依赖
cd flutter_solarterm
flutter pub get
- 配置 API (详见 API 配置章节)
- 运行应用
# 运行到鸿蒙设备
flutter run -d harmony
# 运行到Android设备
flutter run -d android
# 运行到iOS设备
flutter run -d ios
构建鸿蒙应用
为鸿蒙系统构建应用需要特定配置：
- 确保已安装鸿蒙 SDK 和 DevEco Studio
- 构建鸿蒙应用包
flutter build app --release
- 生成的 HAP 文件位于
build/harmony/outputs/
API 配置说明
本项目使用外部 API 服务获取节气数据。为保护 API 凭据安全，采用以下配置方法：
- 复制 API 配置模板
cp lib/config/api_config_template.dart lib/config/api_config.dart
- 在
api_config.dart中填入实际 API 凭据
class ApiConfig {
static const String baseUrl = '坚果派';
static const String token = 'YOUR_API_TOKEN_HERE';
}
界面展示
主页 | 详情 | 设置 |
|---|---|---|
本文参与 腾讯云自媒体同步曝光计划，分享自微信公众号。
原始发表：2025-03-13，如有侵权请联系 cloudcommunity@tencent.com 删除
评论
登录后参与评论
推荐阅读
目录
腾讯云开发者
