公交出行

一、项目概述

1.1 应用简介

鸿蒙公交出行 App 是一款基于 HarmonyOS 框架开发的智能出行导航应用。该应用聚焦公交出行场景，整合线路查询、实时公交、乘车服务等核心功能，提供简洁高效的操作体验，帮助用户快速规划出行路线、掌握公交动态，轻松解决公交出行难题。

由于本人能力有限，此模板只包含郑州市1-15路的公交路线。

1.2 核心功能模块

首页：聚合新闻热点、乘车码、禁携物品查询、失物招领等便民服务

出行模块：实时公交查询与路线规划，提供精准出行指引

乘车码：电子卡开通与扫码乘车，实现便捷支付

我的模块：账号管理、订单查询、个人设置等个性化功能

二、技术架构设计

2.1 数据管理架构

应用采用模块化数据管理模式，通过核心模型层统一封装公交路线、站点信息、用户数据等核心资源，确保各模块数据一致性与高效流转。

数据流设计特点：

• 分层数据流：数据从网络请求层经模型层处理后，分发至各功能页面
• 实时响应机制：公交动态、路线信息等数据更新时，界面实时同步刷新
• 跨模块数据共享：通过公共接口与常量定义，实现多模块数据互通

2.2 组件通信机制

应用基于 HarmonyOS 框架特性，构建灵活的组件通信体系：

• 公共组件复用：核心功能组件（路线详情、路线搜索）独立封装，支持多页面调用
• 路由参数传递：通过路由管理模块实现页面间参数传递，适配公交详情、路线推荐等场景
• 服务集成通信：与华为账号、地图等服务深度集成，通过接口封装实现服务间数据交互

三、功能模块详解

3.1 首页

核心功能：

• 展示公交相关新闻热点及详情
• 快速开通 / 打开乘车码，便捷乘车
• 查询禁携物品清单与失物招领信息

技术特点：

• 轮播图组件展示重点信息
• 功能入口模块化布局，操作路径简洁

3.2 出行模块

核心功能：

• 实时公交：查看附近站点、公交实时位置及到站时间
• 路线规划：输入起点终点，获取多条推荐路线及换乘指引
• 线路搜索：快速查询特定公交路线信息

技术特点：

• 集成地图服务，可视化展示公交路线与站点分布
• 公交动态数据实时更新，精准预估到站时间
• 路线筛选功能，支持按时间、换乘次数等条件排序

3.3 乘车码模块

核心功能：

• 电子卡领取与开通，完成乘车资质认证
• 生成乘车码，支持扫码支付乘车
• 卡片管理，查看电子卡使用状态

技术特点：

• 乘车码快速生成，支持离线缓存使用
• 开卡流程简化，引导式操作降低使用门槛

3.4 我的模块

核心功能：

• 华为账号一键登录，同步个人数据
• 管理我的钱包、订单记录，查看消费明细
• 个人信息设置、隐私管理
• 意见反馈与版本更新，优化使用体验

技术特点：

• 账号安全验证，保护个人信息隐私
• 订单数据分类展示，支持历史记录查询
• 功能入口清晰，个性化设置便捷

四、开发环境

• 操作系统：Windows/macOS（兼容 DevEco Studio 运行环境）
• 开发工具：DevEco Studio 5.1.0 Release 及以上

• 开发环境搭建
  安装DevEco Studio，详情请参考下载和安装软件。

  设置DevEco Studio开发环境，DevEco Studio开发环境需要依赖于网络环境，需要连接上网络才能确保工具的正常使用，详情请参考配置开发环境。

五、需求说明

用户能够通过软件实现公交出行全流程服务，包括获取公交动态、规划出行路线、扫码乘车等，核心需求如下：

• 查询附近公交站点及线路信息，掌握公交实时动态
• 输入起点终点，获取精准的公交路线规划
• 快速开通电子公交卡，实现扫码乘车支付
• 查看乘车订单、管理个人账号与支付信息
• 了解公交出行相关新闻、禁携物品及失物招领信息

六、数据持久化方案

6.1 存储策略

• 本地存储：用户偏好设置、乘车码缓存、常用路线、订单记录等数据本地化

6.2 数据操作

• 本地缓存：常用公交路线、站点信息本地缓存，提升离线使用体验

6.3 数据格式

• 结构化数据：采用 JSON 格式存储配置信息、用户数据等，确保可读性

七、使用说明

核心导航操作

底部导航栏包含 4 个核心功能入口，点击对应图标即可切换页面：

• 点击 “首页” 图标，进入应用首页（聚合便民服务与公交资讯）
• 点击 “出行” 图标，进入实时公交与路线规划页面
• 点击 “乘车码” 图标，进入电子卡与扫码乘车页面
• 点击 “我的” 图标，进入个人账号与信息管理页面

首页功能使用

1. 快捷服务操作

• 点击 “新闻热点” 图标，查看公交相关资讯列表；点击单条资讯，查看详情内容
• 点击 “乘车码” 图标，快速跳转至扫码乘车页面（需提前开通电子卡）
• 点击 “禁携物品” 图标，查看公交出行禁止携带的物品清单
• 点击 “失物招领” 图标，查看遗失物品信息或发布失物招领

出行模块使用

1. 实时公交查询

• 进入 “出行” 页面后，默认展示 “实时公交” 功能（自动获取当前位置）
• 页面显示附近公交站点列表，点击站点可查看停靠的公交线路
• 点击目标公交线路，查看公交实时位置、预计到站时间及线路地图展示

2. 路线规划操作

• 在 “出行” 页面点击 “路线规划” 标签，切换至规划页面
• 输入起点和终点（支持手动输入或选择地图点位）
• 系统自动推荐多条公交路线，点击单条路线可查看换乘站点、总耗时、步行距离详情

3. 线路搜索功能

• 在 “实时公交” 或 “路线规划” 页面，点击顶部搜索栏
• 输入公交线路号（如 “105 路”）或站点名称，点击搜索图标
• 搜索结果展示匹配的线路或站点，点击即可查看详情

乘车码使用

1. 电子卡开通

• 进入 “乘车码” 页面，点击 “领取电子卡” 按钮
• 按照提示完成实名认证（绑定身份信息）
• 选择支付方式并绑定，完成电子卡开通

2. 扫码乘车操作

• 开通电子卡后，进入 “乘车码” 页面自动生成乘车码
• 将乘车码对准公交扫码设备，完成支付后即可乘车
• 无网络环境下，可使用离线缓存的乘车码（需提前联网打开过该页面）

我的模块使用

1. 账号登录

• 进入 “我的” 页面，点击 “登录” 按钮
• 选择 “华为账号一键登录”，完成身份验证即可登录

2. 个人信息管理

• 登录后点击 “个人信息”，可修改昵称、联系方式等
• 点击 “设置”，可调整通知权限、隐私设置等应用配置

3. 订单与钱包管理

• 点击 “我的订单”，查看历史乘车记录、消费金额、乘车时间

4. 客服与反馈

• 点击 “联系客服”，咨询出行问题或反馈使用故障
• 点击 “意见建议”，提交对 App 功能的优化建议
• 点击 “版本更新”，检查并升级至最新版本

5. 隐私与安全

• 点击 “隐私管理”，查看隐私服务条款
• 可根据需求开启或关闭位置权限、通知权限等

八、项目结构说明

BusTravel ├─AppScope │  └─resources                  // 全局资源文件 │     └─base                    // 基础资源（字符串、图片等） ├─common/src/main/ets           // 核心模块 │  ├─AxiosHttpRequest           // 网络请求封装 │  ├─components                 // 细化业务组件 │  ├─constants                  // 公共常量定义 │  ├─Interface                  // 公共接口常量 │  ├─logger                     // 日志打印工具 │  ├─model                      // 数据模型定义 │  ├─page                       // 公共页面组件 │  └─utils                      // 公共工具方法 ├─components                    // 核心功能组件 │  ├─route_detail               // 公交路线详情组件 │  └─route_search               // 公交路线搜索组件 ├─entry                         // 应用入口模块 │  ├─src/main/ets │  │  ├─constants               // 应用常量定义 │  │  ├─dataModel                // Tab页配置定义 │  │  ├─entryability             // 主入口生命周期管理 │  │  ├─entrybackupability       // 备份入口生命周期管理 │  │  ├─pages                    // 核心页面（主页、隐私协议页等） │  │  └─viewmodels               // 视图模型（路由、隐私管理等） └─feature                       // 功能模块    ├─CodeScan/src/main/ets      // 乘车码模块    ├─frontpage/src/main/ets     // 首页模块    ├─PersonalCenter/src/main/ets// 个人中心模块    └─RouteDesign/src/main/ets   // 出行模块

核心模块说明：

• entry 模块：应用入口，负责生命周期管理与基础配置
• feature 模块：按功能拆分的核心业务模块，包含首页、出行、乘车码、个人中心
• common 模块：公共基础组件与工具类，支撑各业务模块运行
• components 模块：独立封装的功能组件，支持跨模块复用

项目功能演示  

乘车码                                                            搜索出行路线

         

路线查看                                                        新闻

          

项目地址：https://gitee.com/zhang-haoyuan-050106/gongjiao