Flutter开发的鸿蒙二十四节气应用

一个使用Flutter开发的二十四节气查询应用，同时支持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.4.0
• Dart SDK: >=3.4.0
• 支持的平台:
  • 鸿蒙HarmonyOS
  • Android 5.0+
  • iOS 11.0+

运行步骤

1. 克隆项目

git clone https://gitcode.com/nutpi/flutter_solarterm.git

1. 安装依赖

cd flutter_solarterm
flutter pub get

1. 配置API (详见API配置章节)

2. 运行应用

# 运行到鸿蒙设备
flutter run -d harmony

# 运行到Android设备
flutter run -d android

# 运行到iOS设备
flutter run -d ios

构建鸿蒙应用

为鸿蒙系统构建应用需要特定配置：

1. 确保已安装鸿蒙SDK和DevEco Studio

2. 构建鸿蒙应用包

flutter build harmony --release

1. 生成的HAP文件位于 build/harmony/outputs/

API配置说明

本项目使用外部API服务获取节气数据。为保护API凭据安全，采用以下配置方法：

1. 复制API配置模板

cp lib/config/api_config_template.dart lib/config/api_config.dart

1. 在api_config.dart中填入实际API凭据

class ApiConfig {
  static const String baseUrl = 'https://v3.alapi.cn/api';
  static const String token = 'YOUR_API_TOKEN_HERE';
}

界面展示

主页	详情	设置

版权信息

• 作者: 坚果派
• 公众号: nutpi
• 电话: 17752170152
• 官网: https://www.nutpi.net/

© 2025 坚果派. 保留所有权利。