自2015年起,针对道桥、路桥、房屋建设等方面开发道桥系列应用(包括项目在线、BIM+、高新科技园区、路桥在线、地下工程建设等十多个应用)。2018年对该系列项目进行整合,衍生出「工程在线」。
本文补充记录开发移动iOS端「工程在线」过程中遇到的问题及解决方案。

项目模式

描述

移动应用中主要划分两类角色,侧重点不同。具体包括:

  • 监管人员
    • 可以理解为项目管理人员,监管权限下有多个项目的监管权限。
    • 监管人员有特定的功能模块。
    • 针对不同的项目,监管人员还有用不同的功能模块权限。
  • 项目使用人员
    • 具体项目的使用人员。主要针对其负责的项目(或者标段)进行操作。

项目具体类别有包括以下3大类:

  • 路桥类:比如黄河桥、农业路
  • 地铁类:比如地铁2号线、5号线
  • 园区类:比如高新科技园区

项目的功能上具体跟项目挂钩,且部分功能,比如「问题上报」、「设计图纸」、「现场巡检」、「建设资料」要求支持离线操作。

方案

将方案之前,补充说明下移动端使用的是MVMCV模式(可以理解成是MVVM模式的变种),简单理解就是将View-Model进行分解,将一些逻辑放在controller中。UI布局上使用Tabbar形式,分别表示首页、功能集聚页、待办页面。

程序在线/离线模式的切换,基于观察者模式来实现。 当网络状态发生变更的时候,可以通过主动获取和推送两种方式灵活使用。

项目首页模式的切换,基于状态模式来实现。 比如监管模式下,点击地图上项目详情,进入项目模式;项目模式下返回到首页时进入监管模式等。

  • 程序(或者功能)的在线/离线模式

    • 在管理程序的ViewModel,监听网络变更。变更时发通知。
    • 不同用户模式下程序在线/离线模式会根据网络情况进行反应。
    • 功能集聚页会额外根据网络变更通知即使调整功能图标。
    • 其他:比如具体离线功能内根据不同的模式进行UI调整。
  • 项目首页的模式

    • 在首页的ViewModel,定义两种模式。
      • 监管模式
      • 项目模式
    • 监管人员
      • 默认监管模式
      • 切换管理项目时,将首页模式调整为项目模式。并根据不同的项目类别,加载不同的项目首页
        • 路桥首页
        • 地铁首页
        • 园区首页
      • 项目首页返回到监管首页时,首页模式调整为监管模式
    • 项目使用人员
      • 项目模式,并根据不同的项目类别,加载不同的项目首页
  • 功能集聚页

    • 为监管模式定义特殊的Key。
    • 项目模式使用约定的Key。
    • 功能列表根据不同的Key从缓存数据库中获取。

应用中,首页模式的切换,联动着不同首页的push和pop;集聚功能页(及其他)获取具体功能的key变更。

离线操作

描述

程序的工作环境有时候比较特殊,比如地铁、房屋修建,经常会用到一些比如上报工作进度、问题,或者是查看项目相关的文档、模型等功能,如果应用对网络有强需求,那么程序本身是不容易让人接受的。因此,「工程在线」在项目整合之处,就要求同时支持离线操作模式。
此处拿问题上报的离线功能来举例。通常情况下,问题上报会涉及上传照片/视频、问题类别等多种条目。且功能的使用存在不确定性。iOS的沙盒机制决定了我们在进行离线功能设计的时候,不能仅仅依靠本地数据库,还需要借助于文件操作。

方案

功能离线模式通过本地数据库和文件管理两种方式来完成。

  • 本地数据库
    • 离线功能所需数据的缓存。
      • 比如问题上报中涉及的位置、问题类别、相关人员等信息。
    • 离线数据的维护。
      • 比如URL,HTTP请求方式,参数,所属功能,文件夹标识,请求状态等。
  • 文件系统
    • 程序会在Library的Cache目录下单独建立文件夹来存放离线功能产生/使用的文件。
    • 文件夹标识
      • 使用唯一标识,程序使用yyyyMMddHHmmss格式。
      • 在使用到照片/视频时,创建文件夹。且将过程中用到的文件移动/复制到该目录下。
      • 在线模式功能提交成功后,会删除该文件夹及内部文件。

离线模式下,点击保存就是将相关的URL、HTTP请求方式、参数、文件标识存入离线数据库中。

当程序处于网络状态下,程序会后台上传离线数据库中的相关请求数据。此时考虑到多文件、多请求上传会影响程序性能。程序在处理离线任务上传时,对网络请求进行了专门的控制。

  • 每次只有一个离线任务进行上传。
  • 上传完成后,删除数据库及文件缓存中相关的数据
  • 统计并提示最终离线任务结果。针对失败的任务,由用户自行决定是放弃还是后续上传。

项目总览

描述

部分用户(比如领导、项目管理人员)会比较关心项目整体情况,比如进度、问题、投入等信息。我们的设计师对项目总览功能页面设计出了很多手势相关的操作。功能整体上下滑动,内部左右滚动。
首先UI本身并不复杂,但是好的体验就需要用心去做了。比如,切换不同类别页面时,数据的预加载。不同类别的数据如何组织等。

方案

整个项目总览页面使用UIPageViewController来实现,右侧的UIPageControl则通过实现UIPageViewController的相关协议来更新。在每个页面内部,根据具体的类别及数据源来更好的表现/维护代码。为了达到更好的用户体验,总览功能使用了一个viewModel来维护。

  • 总体
    • 在UIPageViewController的Controller中,控制导航栏、PageControl。
    • 在总览页退出时,取消各个子页面中未完成的网络请求
  • 子页面
    • 为了保证数据的展示,建立一定的规则
      • 比如为每个请求提供有3次重试的机会。这样当用户滑动过快时(或者某个接口太慢用户直接滑过相关页面时),程序接口可以继续运行
    • 针对不同数据源,选择合适的处理方法
      • 比如进度对比页,需要支持多种摄像头设备现场。使用策略模式来针对不同设备进行登录/退出、视频通道等适配
        • 大华硬盘录像机设备
        • 大华视频服务器设备
        • 海康威视硬盘录像机设备
        • 海康威视视频服务器设备