鸿蒙原生农历查询 (Lunar Calendar)

鸿蒙原生农历查询 (Lunar Calendar)

项目概述

简介

农历查询是一款简单实用的应用，可以帮助用户查询公历日期对应的农历信息、干支纪年、宜忌、休咎、方位等传统历法信息。应用支持多平台部署，包罗Android、iOS以及鸿蒙体系。
配景和动机

作为中华传统文化的重要组成部分，农历在我国有着深远的影响。为了传承和弘扬中华优秀传统文化，同时支持国产鸿蒙生态的发展，我投入了大量心血开发了这款应用。在开发过程中，我克服了诸多技能难题，特别是在适配鸿蒙体系方面付出了巨大努力。开源这个项目是希望能够为中国软件生态贡献一份力量，也期望更多开发者能够加入到支持国产操作体系的行列中来，共同推动技能创新和文化传承。
效果

功能特点

• 多样化信息展示：提供农历日期、干支纪年、生肖、星座、宜忌、方位等全面信息
  
• 分类标签页：通过标签页分类展示不同范例的信息，使界面更加清楚
  
• 方位指南针：直观展示方位信息，帮助用户理解传统方位概念
  
• 深色模式支持：支持淡色、深色和跟随体系三种主题模式
  
• 当地缓存功能：减少重复API哀求，提高应用性能和离线使用体验
  
• 网络状态监测：实时检测网络毗连状态，提供友爱的错误提示
  
• 长按复制功能：支持长按复制信息内容，提高用户体验
  
• 多平台适配：支持Android、iOS和鸿蒙体系
  

安装与设置

环境要求

• Flutter SDK 3.21.0 或更高版本
  
• Dart SDK 3.0.0 或更高版本
  
• Android Studio / VS Code
  
• 对于鸿蒙开发：DevEco Studio
  

安装步骤

• 克隆项目仓库
  
  1. git clone git@gitcode.com:nutpi/flutter_harmony_lunar.git

  复制代码
• 进入项目目次
  
  1. cd flutter_harmony_lunar

  复制代码
• 设置API密钥
  
  1. cp lib/config/api_config.template.dart lib/config/api_config.dart

  复制代码
  然后编辑 lib/config/api_config.dart 文件，将 YOUR_API_TOKEN_HERE 替换为您的现实API密钥。
  
• 安装依赖
  
  1. flutter pub get

  复制代码
• 运行应用
  
  1. flutter run

  复制代码

使用方法

根本操作

• 启动应用后，默认显示当天的农历信息
  
• 点击"选择日期"按钮可以选择任意日期查询对应的农历信息
  
• 点击右上角的刷新图标可以强制刷新数据
  
• 点击右上角的主题图标可以切换深色/淡色模式
  
• 点击右上角的信息图标可以查看应用的关于页面
  
• 在信息卡片上长按可以复制相应的内容
  

界面导航

• 根本信息：显示公历日期、农历日期、生肖、星座等根本信息
  
• 干支命理：显示年柱、月柱、日柱、时柱等干支信息
  
• 宜忌：显示当日宜忌事项和休咎神信息
  
• 方位：显示财神、福神、喜神等方位信息和方位指南针
  

技能实现

架构计划

项目采用 Flutter 框架开发，使用分层架构计划，主要分为以下几个模块：

• 数据模型层：定义农历数据结构
  
• 服务层：处置处罚API哀求、数据解析和缓存
  
• UI层：实现用户交互界面
  
• 工具类：提供辅助功能
  

技能特点

• 当地缓存：使用SharedPreferences实现数据缓存，减少网络哀求
  
• 网络监测：使用connectivity_plus监测网络状态变化
  
• 主题管理：支持深色模式和淡色模式，并生存用户偏好
  
• 响应式UI：使用Flutter的响应式UI框架，适配不同屏幕尺寸
  
• 错误处置处罚：美满的错误处置处罚机制，提供友爱的用户提示
  
• API安全：将API密钥存储在单独的设置文件中，避免泄露
  

技能栈

• 前端框架：Flutter
  
• 状态管理：StatefulWidget
  
• 网络哀求：http
  
• 当地存储：shared_preferences
  
• 国际化：intl + flutter_localizations
  
• 链接处置处罚：url_launcher
  
• 网络监测：connectivity_plus
  
• 版本信息：package_info_plus
  

贡献指南

贡献流程

• Fork 项目仓库
  
• 创建功能分支 (git checkout -b feature/amazing-feature)
  
• 提交更改 (git commit -m 'Add some amazing feature')
  
• 推送到分支 (git push origin feature/amazing-feature)
  
• 创建 Pull Request
  

代码规范

• 遵循 Flutter 官方保举的代码风格
  
• 使用故意义的变量名和函数名
  
• 添加必要的注释
  
• 确保代码通过 lint 检查
  

许可证信息

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。
维护与支持

维护者信息

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

题目反馈

如有题目或建议，请通过以下方式反馈：

• 在项目仓库创建 Issue
  
• 发送邮件至维护者
  
• 关注公众号"nutpi"并留言
  

相关资源

• Flutter 官方文档
  
• Dart 官方文档
  
• [鸿蒙开发文档](
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。