基于 Swift 多地图源业务向地图控件实现(三):交互事件处理

967 阅读3分钟

有的时候地图控件上还会有交互需求。比如在我的业务场景里,需要编辑无人机巡航的区域。要编辑区域,区域的多边形顶点就需要可以拖动。

简化一下需求,我们现在来实现一下点拖动编辑的功能。

首先我们定义一下可以移动的顶点 View:

class MapMoveableAnnotation: UIImageView {
    
    init(type: MoveableAnnotationType) {
        self.type = type
        super.init(frame: CGRect.zero)
        isUserInteractionEnabled = true
        setupUI()
    }
    
    private func setupUI() {
        bounds = CGRect(x: 0, y: 0, width: 44, height: 44)
        contentMode = .center
        image = Asset.Map.iconAreaEditPoint.image
        highlightedImage = Asset.Map.iconAreaEditPointSelected.image
    }
}

上面要注意的细节是需要设置 isUserInteractionEnabled 为 true。

接着我们定义一个 view 专门响应用户的交互事件,因为要首先响应交互,这个 view 要在地图控件的最顶层。

class MapInteractionView: UIView {
	
    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
        for subview in subviews {
            let subPoint = subview.convert(point, from: self)
            if let result = subview.hitTest(subPoint, with: event) {
                return result
            }
        }
        return nil
    }
}

因为 MapInteractionView 里所有元素都会响应交互事件,因此直接重新实现了 hitTest 方法。如果交互的点在内部元素上响应事件,如果不在的话不响应,让交互事件可以传到下层的地图源响应。

接下来我们在 MapInteractionView 中定义添加可拖动控制点的方法:

class MapInteractionView: UIView {
	
    private var areaControlAnnotations: [MapMoveableAnnotation] = []
	
    func renderAreaEdit(vertexs: [CGPoint]) {
        if areaControlAnnotations.count != vertexs.count {
            areaControlAnnotations.forEach { $0.removeFromSuperview() }
            areaControlAnnotations.removeAll()
            areaControlAnnotations = vertexs.map { _ in MapMoveableAnnotation() }
            areaControlAnnotations.forEach {
          	  addSubview($0)
       	    }
        }

        for (index, point) in vertexs.enumerated() {
            areaControlAnnotations[index].center = point
            areaControlAnnotations[index].tag = index
        }
    }
}

接着我们给 MapInteractionView 添加手势响应:

protocol MapInteractionDelegate: class {
    func areaVertexMoved(index: Int, point: CGPoint, isFinish: Bool)
    func areaFinishChanging()
}

class MapInteractionView: UIView {

    weak var delegate: MapInteractionDelegate?

    private var panGesture: UIPanGestureRecognizer?

    override init(frame: CGRect) {
       super.init(frame: frame)
	   panGesture = UIPanGestureRecognizer(target: self, action: #selector(handlePanGesture))
            addGestureRecognizer(panGesture!)
    }

    private var panSelectedView: UIView?

	@objc private func handlePanGesture(_ gesture: UIPanGestureRecognizer) {
        switch gesture.state {
        case .began:
            guard let selectedView = hitTest(gesture.location(in: self), with: nil) else { return }
            panSelectedView = selectedView
            if let movableAnnotation = selectedView as? MapMoveableAnnotation {
                movableAnnotation.isHighlighted = true
            }
        case .changed:
            guard let panSelectedView = panSelectedView else { return }
            let touchPoint = gesture.location(in: self)
            panSelectedView.center = touchPoint
            delegate?.areaVertexMoved(index: panSelectedView.tag, point: touchPoint, isFinish: false)
        case .ended:
            if let movableAnnotation = panSelectedView as? MapMoveableAnnotation {
                movableAnnotation.isHighlighted = false
                if movableAnnotation.type == .areaControlPoint {
                    delegate?.areaVertexMoved(index: movableAnnotation.tag, point: movableAnnotation.center, isFinish: true)
                }
                delegate?.areaFinishChanging()
            }
            panSelectedView = nil
        default:
            break
        }
    }
}

这里要强调的还是每个类职责的划分。在架构中我们常说单一职责,单一职责对于维护性的影响至关重要。我们对 MapInteractionView 的定义就是接受用户的交互事件。因此它在上面的场景中,处理移动手势,通知外界哪个顶点开始移动,移动结束。

如何检验单一职责执行的好不好呢?我的一个建议是思考这个模块是否可以抽离出来独立验证,也就是可测试性。以 MapInteractionView 为例,现在这样设计如果想要单独测试这个类,可以做到吗?相对而言是比较容易的,可以在单元测试项目中初始化添加到 VC 中,输入特定的坐标点,接着在模拟控制坐标点位置模拟拖动手势。在 MapInteractionDelegate 中断言返回的结果和模拟的手势值是否一致。

最后一环就是把 MapInteractionView 添加到地图控件的最顶层,这块代码比较简单代码我就不列举了。

总结

复杂的业务必然会有“复杂”的实现。架构设计要解决的是:面对复杂的需求,复杂的实现应该让开发者容易理解,容易维护。怎样做到呢?我们在规划时就划分好各个模块,让各个模块通过合理的组合实现复杂的功能。这样开发者在维护的时候只需要关注两件事:1.模块是如何划分的 2.我要维护的部分在模块中是如何实现的。每个模块因为职责清晰,所以即便不清楚全局,也可以维护这个模块的实现细节。这样的设计就达到了易理解、已维护的目标。