版本 4.0.0，已同步到 MPAndroidChart #f6a398b

• Xcode 14 / Swift 5.7 (master 分支)
• iOS >= 12.0（用作嵌入式框架）
• tvOS >= 12.0
• macOS >= 10.13

好的，这里有一个漂亮的库叫做 MPAndroidChart，由 Philipp Jahoda 开发，在 Android 开发者中非常受欢迎，但是没有合适的 iOS 图表解决方案。

我选择使用 Swift 编写它，因为它可以通过编译器进行高度优化，并且可以在 Swift 和 ObjC 项目中使用。Demo 项目是用 ObjC 编写的，用于演示它的工作原理。

这个库的一个惊人特性是，它现在适用于 Android、iOS、tvOS 和 macOS，可以节省您为两个平台开发的时间，因为学习曲线是单一的——只会发生一次，并且代码保持非常相似，因此开发人员不必到处重新发明应用程序，使用不同的库来产生相同的输出。（甚至没有考虑到目前还没有其他真正好的选择...）

• ChartsDemo/ChartsDemo.xcodeproj 是 iOS/tvOS 的 demo 项目
• ChartsDemo-OSX/ChartsDemo-OSX.xcodeproj 是 macOS 的 demo 项目
• 请确保您运行的是支持的 Xcode 版本。
  • 通常在上面几行中指定。
  • 在大多数情况下，这将是最新的 Xcode 版本。
• 请确保您的项目支持 Swift 5.0
• 可选：在项目文件夹中运行 carthage checkout，以获取依赖项（即测试依赖项）。
  • 如果您没有 Carthage，可以从这里获取。

为了正确编译

1. 将 DGCharts.xcodeproj 拖到您的项目中
2. 转到您的 target 设置，点击“Frameworks, Libraries, and Embedded Content”部分下的“+”，然后选择 DGCharts.framework
3. @import DGCharts
4. 在 ObjC 项目中使用 Swift 时

• 您需要导入您的 Bridging Header。通常它是“YourProject-Swift.h”，所以在 ChartsDemo 中它是“ChartsDemo-Swift.h”。不要尝试在您的项目中实际包含“ChartsDemo-Swift.h” :-)
• (Xcode 8.1 及更早版本) 在“Build Options”下，标记“Embedded Content Contains Swift Code”
• (Xcode 8.2+) 在“Build Options”下，标记“Always Embed Swift Standard Libraries”

5. 当使用 Realm.io 时
   • 请注意，Realm 框架未与 Charts 链接 - 它仅用于可选绑定。这意味着您需要在项目中拥有该框架，并且版本与 DGCharts 编译的版本兼容。我们将尽最大努力始终针对最新版本进行编译。
   • 您还需要添加 ChartsRealm 作为依赖项。

• Swift 中的图表 - 使用 iOS Charts 设置基本折线图（Alex Nagy）
• SwiftUI 中的 Charts 框架 - 条形图 (Stewart Lynch)

• 在 iOS 10 中使用 Realm 和 Charts 与 Swift 3 (Sami Korpela)
• 在 Swift 3 和 iOS 10 中创建折线图 (Osian Smith)
• 使用 Charts 和 Swift 3 的初始设置和示例
• 在 Swift 中创建雷达图 (David Piper)
• 使用 SwiftUI 在 IOS 中绘制图表（使用 Charts 框架）(Evgeny Basisty)
• 使用 iOS-Charts 设置基本条形图 (Penny Huang)
• iOS-Charts 教程：使用自定义标记突出显示选定的值 (Penny Huang)
• 在 SwiftUI 之前在 iOS 中绘制图表 (Gennady Stepanov)

希望您的教程在此处显示？创建一个 PR！

• 请注意从 CocoaPods 或 Carthage 安装编译框架与复制源代码之间的区别。
• 请再次阅读用法部分。
• 在 issues 中搜索
• 尝试在 issues 部分礼貌地提问

• 在 issues 中搜索
• 尝试在 issues 部分礼貌地提问

将 pod 'DGCharts' 添加到您的 Podfile。“DGCharts”是库的名称。
对于 Realm 支持，请同时添加 pod 'ChartsRealm'。

注意： pod 'ios-charts' 不是正确的库，而是指其他人的不同项目。

DGCharts 现在包含 Carthage 预构建的二进制文件。

github "danielgindi/Charts" == 5.1.0
github "danielgindi/Charts" ~> 5.1.0

为了为新版本构建二进制文件，请使用 carthage build --no-skip-current && carthage archive Charts。

Swift Package Manager

dependencies: [
    .package(url: "https://github.com/danielgindi/Charts.git", .upToNextMajor(from: "5.1.0"))
]

Xamarin (by @Flash3001): iOS - GitHub/NuGet. Android - GitHub/NuGet.

如果您喜欢您在这里看到的内容，并希望支持此存储库中所做的工作，您可以

• 贡献代码、issues 和 pull requests
• 让人们知道这个库的存在（:fire: 传播它 :fire:）
• （您可以请我喝一杯啤酒，或者您可以请我吃晚餐 :-)

注意： MPAndroidChart 的作者是此库存在的原因，并且在他的页面上接受捐赠。他值得这些捐赠！

如果您有疑问或问题，您应该

• 确保您使用的是该库的最新版本。查看 release-section。
• 研究 Android 版本的 Documentation-Wiki
• 在 stackoverflow 上搜索或提出问题，使用 ios-charts 标签
• 搜索 已知问题 以查找您的问题（已打开和已关闭）
• 创建新 issue（请 🔥 在创建 issue 之前搜索已知问题 🔥，不要创建重复的 issue）

核心特性

• 8 种不同的图表类型
• 在两个轴上缩放（通过触摸手势，轴单独缩放或捏合缩放）
• 拖动/平移（通过触摸手势）
• 组合图（折线图、条形图、散点图、烛台图、气泡图）
• 双（独立）轴
• 可自定义的轴（x 轴和 y 轴）
• 突出显示值（使用可自定义的弹出视图）
• 将图表保存到相机胶卷/导出为 PNG/JPEG
• 预定义的颜色模板
• 图例（自动生成，可自定义）
• 动画（构建动画，在 x 轴和 y 轴上）
• 限制线（提供附加信息，最大值，...）
• 完全可自定义（画笔、字体、图例、颜色、背景、手势、虚线，...）
• 直接从 Realm.io 移动数据库绘制数据（这里）

图表类型

截图目前取自原始存储库，因为它们的渲染效果完全相同 :-)

• 折线图（带有图例，简单设计）

• 折线图（带有图例，简单设计）

• 折线图（立方体线）

• 折线图（渐变填充）

• 组合图（在本例中为条形图和折线图）

• 条形图（带有图例，简单设计）

• 条形图（分组数据集）

• 水平条形图

• 饼图（带有选择，...）

• 散点图（带有正方形、三角形、圆形、...等等）

• 烛台图（用于财务数据）

• 气泡图（气泡覆盖的区域表示值）

• 雷达图（蜘蛛网图）

目前 iOS/tvOS/macOS 版本不需要文档，因为 API 与 Android 版本95% 相同。
您可以阅读官方 MPAndroidChart 文档：Wiki

或者您可以查看 Objective-C 和 Swift 版本的 Charts Demo 项目（ChartsDemo-iOS）以及 macOS 版本（ChartsDemo-macOS），并从中学习使用方法。

感谢 @liuxuan30、@petester42 和 @AlBirdie 提供新功能、修复错误，并大量参与我们的开源社区！ 你们对所有带着问题和疑问来到这里的人们提供了巨大的帮助，如果没有你们，我无法回复所有这些问题。

Debricked: 安全地使用开源

版权所有 2016 Daniel Cohen Gindi & Philipp Jahoda

根据 Apache License, Version 2.0（“许可证”）获得许可；除非符合许可证的规定，否则您不得使用此文件。 您可以在以下位置获得许可证的副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则软件是基于“按原样”分发的，不附带任何形式的明示或暗示的保证或条件。 有关管理权限和限制的特定语言，请参见许可证。