写点什么

鸿蒙二十四节气应用

作者:坚果
  • 2025-03-13
    广东
  • 本文字数:1441 字

    阅读完需:约 5 分钟

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.21.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_solartermflutter 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/


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

发布于: 11 小时前阅读数: 2
用户头像

坚果

关注

此间若无火炬,我便是唯一的光 2020-10-25 加入

润开鸿生态技术专家、华为HDE、InfoQ签约作者、坚果派组织者

评论

发布
暂无评论
鸿蒙二十四节气应用_鸿蒙_坚果_InfoQ写作社区