如何 5 分钟集成 TEAChart：CocoaPods 安装 iOS 图表库的完整教程

TEAChart是一款简单直观的 iOS 图表库（iOS chart library），提供贡献图（Contribution Graph）、时钟图（Clock Chart）和柱状图（Bar Chart）三种开箱即用的图表组件，MIT 协议开源，支持 Storyboard 可视化配置，对 VoiceOver 完全无障碍友好。本文带你用 CocoaPods 在 5 分钟内完成 TEAChart 的安装集成，并快速上手三类图表。

一、认识 TEAChart：三大图表组件

TEAChart 专为 iOS 应用设计，最初服务于 Pomotodo 应用，核心能力包括：

所有图表均支持通过 Interface Builder 直接拖拽和属性配置，无需手写布局代码，这是 TEAChart 的一大亮点。

二、环境准备：安装 CocoaPods

在集成前，请确保你的 Mac 上已安装 CocoaPods 和 Xcode。若尚未安装 CocoaPods，可在终端执行：

sudo gem install cocoapods

💡 如果提示gem命令不可用，请先安装 Ruby，再重试上述命令。

三、最快配置方法：Podfile 配置与安装

步骤 1：创建并编辑 Podfile

在你的 iOS 项目根目录执行：

pod init

会生成Podfile文件，打开后添加 TEAChart 依赖。参考官方 TEAChart.podspec 可知，该库当前版本为 1.0.0，最低支持 iOS 6.0：

pod 'TEAChart', '~> 1.0'

步骤 2：执行安装

pod install

安装完成后，请关闭.xcodeproj，改用生成的.xcworkspace文件打开项目（例如YourApp.xcworkspace），否则会出现找不到头文件的错误。

步骤 3：在代码中导入

在需要使用图表的文件顶部引入主头文件即可，它在 TEAChart.h 中一次性导入了全部图表类：

#import "TEAChart.h"

到此，CocoaPods 集成 TEAChart 就完成了 ✅

四、快速上手三类图表

1. 柱状图：代码最少、见效最快

柱状图最简单，几行代码即可画出。头文件见 TEABarChart.h：

#import "TEAChart.h" TEABarChart *barChart = [[TEABarChart alloc] initWithFrame:CGRectMake(20, 20, 100, 40)]; barChart.data = @[@2, @7, @1, @8, @2, @8]; [self.view addSubview:barChart];

需要彩色柱时传入颜色数组，需要横轴标签时设置xLabels（标签建议每个只保留一个字符）：

barChart.barColors = @[[UIColor orangeColor], [UIColor yellowColor], [UIColor greenColor], [UIColor blueColor]]; barChart.xLabels = @[@"A", @"B", @"C", @"D", @"E", @"F"];

2. 在 Interface Builder 中可视化配置

TEAChart 的柱状图和时钟图都标记了IB_DESIGNABLE，你可以直接在 Interface Builder 中拖入视图并调整属性（颜色、间距、最大值等），所见即所得：

如图所示，Max、Bar Color、Bar Spacing 等属性均可在右侧检查器中直接修改，非常适合新手快速调整图表样式。

3. 时钟图：传入时间段数组

时钟图的数据类型为TEATimeRange数组，用法见 TEAClockChart.h：

self.clockChart.data = @[ [TEATimeRange timeRangeWithStart:[NSDate date] end:[NSDate dateWithTimeIntervalSinceNow:3600]] ];

4. 贡献图：实现数据源协议

贡献图通过实现TEAContributionGraphDataSource协议提供数据，必选方法只有两个（详见 TEAContributionGraph.h）：

// 返回要展示的月份 - (NSDate *)monthForGraph { return [NSDate date]; } // 返回某一天（1 到当月最后一天）的数值 - (NSInteger)valueForDay:(NSUInteger)day { return day % 6; }

可选方法还能自定义颜色分级（numberOfGrades、colorForGrade:）以及点击单元格回调dateTapped:，让图表支持交互。

五、替代方案：直接拖入源码

如果不想使用 CocoaPods，也可以直接把TEAChart文件夹拖入 Xcode 项目。库本体源码全部位于 TEAChart/ 目录下，核心文件包括：

• TEABarChart.m：柱状图实现
• TEAClockChart.m：时钟图实现
• TEAContributionGraph.m：贡献图实现
• TEATimeRange.m：时钟图时间段数据模型

官方示例工程在 TEAViewController.m 中演示了完整用法，可打开 TEAChartDemo/ 目录参考。

六、常见问题排查

Q1：pod install 后找不到 TEAChart 头文件？检查是否改用了.xcworkspace打开项目，而不是.xcodeproj。

Q2：图表显示为空白？

• 柱状图：确认data数组已赋值且数值大于 0；
• 贡献图：确认已设置delegate并正确实现monthForGraph与valueForDay:；
• 时钟图：确认data中传入了有效的TEATimeRange对象。

Q3：最低系统版本要求？根据 TEAChart.podspec，TEAChart 支持 iOS 6.0 及以上，并强制使用 ARC（requires_arc = true）。

七、总结

🎉 至此，你已掌握 TEAChart 的完整集成流程：

1. pod init→ 写入pod 'TEAChart', '~> 1.0'→pod install；
2. 用.xcworkspace打开项目，#import "TEAChart.h"；
3. 按需选用柱状图、时钟图或贡献图，支持 Storyboard 可视化配置。

TEAChart 体积极小、API 直观，是 iOS 项目快速加入图表功能的轻量之选。更多细节可查看各头文件中的完整注释文档。

项目许可证：MIT（详见 LICENSE）