iOS Charts 折线图框架的基本使用

1. 导入框架

• 通过 cocoapods 管理应用程序时，在 Podfile 文件中，use_frameworks! 的使用区别如下：

  • 使用 use_frameworks! 时 dynamic frameworks 方式 -> .framework
    cocoapods 会生成对应的 frameworks 文件
    在 Link Binary With Libraries：会生成 Pods_工程名.framework，包含了其它用 cocoapods 导入的第三方框架的 .framework 文件

  • 不使用 use_frameworks! 时 static libraries 方式 -> 生成.a文件
    cocoapods 会生成相应的 .a文件（静态链接库）
    Link Binary With Libraries: libPods-工程名.a 包含了其他用 cocoapods 导入有第三库的 .a 文件

• 通过 cocoapods 导入 swift 库时，都必须使用 use_frameworks!
  use_frameworks! pod 'Charts' pod 'ChartsRealm'

• 终端执行 pod install 完成框架集成

2. Xcode配置

• 导入框架之后 command + B 编译报如下错误：提示Swift 版本不兼容
  

• 解决方式: Pods -> TARGETS 选择对应的库文件 -> Build Settings -> Swift Compiler - Language 修改对应 swift 版本， Charts、ChartsRealm、RealmSwift 都需要设置
  

• 当外部 Framework 在编译时需开启 Defines Module，如果没有开启且没有 Framework 源码的情况无需设置。
  

3. 创建视图及配置

• 使用框架时，demo先行，选择需要的折线图类型进而研究并使用

  这里介绍主要使用的几个库类，仅供参考！

• ChartViewBase

  属性	描述
  .xAxis	X坐标轴
  _defaultValueFormatter	实现IValueFormatter协议的类，用来将数值进行格式化处理
  _data	持有未经过任何处理的原始数据的对象
  _highlightPerTapEnabled	点击时显示高亮的标志位，默认为true
  dragDecelerationEnabled	拖拽时允许减速的标志位，默认为true
  _dragDecelerationFrictionCoef	拖拽减速的摩擦系数，值为[0,1)区间内，值越大，减速越慢，当值为0时，减速会立即停止，1是非法的值，当设定该值大于等于1时，会自动把1转换成0.999，默认值为0.9
  chartDescription	存储一些图表描述的对象
  _legend	图例
  noDataText	当没有数据时，显示在图标中间的缺省文字，默认为“No chart data available.”
  noDataFont	没有数据时，提示文字的字体
  noDataTextColor	没有数据时，提示文字的颜色
  _legendRenderer	图例的渲染器
  renderer	数据的渲染器
  _viewPortHandler	管理图表的边界，并且绘制约束的对象
  _animator	响应动画的对象
  _offsetsCalculated	记录是否已经计算好偏移值的标志位
  _indicesToHighlight	存高亮对象的数组（目前代码中其实好像就只会有一个元素）
  drawMarkers	是否绘制标记（点击图标时，弹出来的浮标），默认值为true，（getter=isDrawMarkersEnabled）
  marker	表示如何显示样式对象
  _interceptTouchEvents	是否拦截点击事件，默认为false
  extraTopOffset，extraRightOffset，extraBottomOffset，extraLeftOffset	上右下左的边距，默认为0

  重要方法	描述
  open func notifyDataSetChanged()	通知数据改变了，用以设置数据时，重新绘图，但在ChartViewBase中会抛出异常
  internal func calculateOffsets()	计算上左下右偏移量，同样在基类中不做具体实现，并抛出异常
  internal func calcMinMax()	计算y轴最大最小值，还有x轴跟y轴的范围
  internal func setupDefaultFormatter(min: Double, max: Double)	设置默认的格式化器
  internal func drawDescription(context: CGContext)	绘制描述的方法
  open func highlightValue(x: Double, y: Double, dataSetIndex: Int, callDelegate: Bool)	处理高亮的值的方法
  open func getHighlightByTouchPoint(_ pt: CGPoint) -> Highlight?	从触摸点活动高亮对象
  internal func drawMarkers(context: CGContext)	绘制标记
  internal func drawMarkers(context: CGContext)	获取标记的位置
  open func getChartImage(transparent: Bool) -> NSUIImage?	当前图表转换成UIImage的对象
  open func save(to path: String, format: ImageFormat, compressionQuality: Double) -> Bool	把当前图标保存到本地

• AxisBase

  属性	描述
  _axisValueFormatter	轴上坐标值的格式化类，遵守IAxisValueFormatter协议的一个类
  labelFont	坐标轴数值字体
  labelTextColor	坐标轴数值字体颜色
  axisLineColor	轴线颜色，默认为gray
  axisLineWidth	轴线线宽，默认为0.5
  axisLineDashPhase	轴线虚线的相位
  axisLineDashLengths	轴线为虚线的长度数组，如@[@4.f, @2.f]，则为长为4的实线和长为2的虚线空白间隔
  gridColor	网格线颜色
  gridLineWidth	网格线线宽
  gridLineCap	网格线边缘形状
  drawGridLinesEnabled	是否绘制网格线
  drawAxisLineEnabled	是否绘制轴线
  drawLabelsEnabled	是否显示坐标轴数值
  _centerAxisLabelsEnabled	坐标值标签是否居中
  _limitLines	限制线的数组
  drawLimitLinesBehindDataEnabled	限制线绘制在数据后面还是前面，默认为false，即绘制在数据前面
  gridAntialiasEnabled	网格是否抗锯齿
  _labelCount	坐标轴显示数值的数目，默认为6
  decimals	要使用的小数位数，默认为0
  granularityEnabled	如果为true，则轴标签由 granularity 属性控制，如果为false，则可能会重复轴值，如果两个相邻的轴值取整为相同的值，则可能会发生这种情况，如果使用粒度，可以通过减少可见的轴值来避免。
  forceLabelsEnabled	如果为true的时候，y坐标值数将会强制限制

  重要方法	描述
  open func getFormattedLabel(_ index: Int) -> String	根据索引获取已格式化的字符串
  open func calculate(min dataMin: Double, max dataMax: Double)	计算最大最小值并且y轴显示的范围。dataMin根据表格数据得到的y最小值，dataMax根据表格获得y的最大值

• LineChartDataSet 子类 - 折线的设置

  属性	描述
  axisDependency	设置数据依赖的轴 - （左/右）
  lineWidth	线宽，默认为1
  drawValuesEnabled	是否绘制线上文字
  highlightEnabled	选中拐点,是否开启高亮效果(显示十字线)
  highlightColor	点击选中拐点的十字线的颜色
  highlightLineDashLengths	十字线的虚实长度数组
  highlightLineWidth	十字线宽度
  drawCirclesEnabled	是否绘制拐点
  circleRadius	拐点半径
  circleColors	拐点颜色
  drawCircleHoleEnabled	是否绘制拐点的空心
  circleHoleRadius	拐点空心半径
  circleHoleColor	拐点空心的颜色

4. 部分注意点

• 自定义 X 轴，Y 轴，折线上数据

  • x轴，y轴的数据自定义需要遵守协议：IChartAxisValueFormatter
  • 折线上的数据自定义需要遵守协议：IChartValueFormatter

  - (NSString *)stringForValue:(double)value axis:(ChartAxisBase *)axis {
      return [NSString stringWithFormat:@"%.f月",value];
  }

5. 部分源码修改

• 修改十字线虚线样式 ( LineScatterCandleRadarRenderer.swift )
  

     @objc open func drawHighlightLines(context: CGContext, point: CGPoint, set: ILineScatterCandleRadarChartDataSet)
  {
  
      // draw vertical highlight lines
      if set.isVerticalHighlightIndicatorEnabled
      {
          context.beginPath()
          // 文修2019年08月15日17:55:58
  //            context.move(to: CGPoint(x: point.x, y: viewPortHandler.contentTop))
  //            context.addLine(to: CGPoint(x: point.x, y: viewPortHandler.contentBottom))
          context.move(to: CGPoint(x: point.x, y: viewPortHandler.contentBottom))
          context.addLine(to: CGPoint(x: point.x, y: point.y))
          context.strokePath()
      }
  
      // draw horizontal highlight lines
      if set.isHorizontalHighlightIndicatorEnabled
      {
          context.beginPath()
          // 文修2019年08月15日17:55:58
  //            context.move(to: CGPoint(x: viewPortHandler.contentLeft, y: point.y))
  //            context.addLine(to: CGPoint(x: viewPortHandler.contentRight, y: point.y))
          context.move(to: CGPoint(x: viewPortHandler.contentLeft, y: point.y))
          context.addLine(to: CGPoint(x: point.x, y: point.y))
          context.strokePath()
      }
  }