MKRingProgressView

类似于 Apple Watch 上 Activity 应用的环形进度视图

• 进度动画
• 可自定义的起始/结束和背景环颜色
• 可自定义的环宽度
• 可自定义的进度线端点样式
• 可自定义的进度线端点下方的阴影
• 可以显示超过 100% (或 360°) 的进度值

要通过 CocoaPods 安装 MKRingProgressView，请将以下行添加到您的 Podfile 中

pod 'MKRingProgressView'

要通过 Carthage 安装 MKRingProgressView，请将以下行添加到您的 Cartfile 中

github "maxkonovalov/MKRingProgressView"

注意：以下说明适用于在没有 Xcode UI 的情况下使用 SwiftPM。 最简单的方法是转到您的项目设置 -> Swift Packages 并从那里添加 MKRingProgressView。

要使用 Apple 的 Swift 包管理器集成，而无需 Xcode 集成，请将以下内容作为依赖项添加到您的 Package.swift 中

.package(url: "https://github.com/maxkonovalov/MKRingProgressView.git", .upToNextMajor(from: "2.3.0"))

请参阅示例 Xcode 项目。 它包含 2 个目标

• ProgressRingExample - 一个简单的示例，包含一个带有可调参数的进度环。
• ActivityRingsExample - 一个高级用法示例，复制了 Apple 的 Activity 应用。 它还包含其他类，用于方便地将 3 个环形进度视图分组在一起。

MKRingProgressView 可以在 Interface Builder 中进行设置。 要使用它，请将自定义视图类设置为 MKRingProgressView。 大多数控件的参数都可以在 Interface Builder 中进行自定义。

let ringProgressView = RingProgressView(frame: CGRect(x: 0, y: 100, width: 100, height: 100))
ringProgressView.startColor = .red
ringProgressView.endColor = .magenta
ringProgressView.ringWidth = 25
ringProgressView.progress = 0.0
view.addSubview(ringProgressView)

可以使用 UIView 的基于块的动画以与通常动画任何属性相同的方式来动画 progress 值

UIView.animate(withDuration: 0.5) {
    ringProgressView.progress = 1.0
}

为了获得更好的性能，可以采用以下选项

• 将 gradientImageScale 设置为较低的值，例如 0.5（默认为 1.0）
• 将 startColor 和 endColor 设置为相同的值
• 将 shadowOpacity 设置为 0.0
• 将 allowsAntialiasing 设置为 false

• iOS 9.0
• tvOS 9.0

MKRingProgressView 在 MIT 许可证下可用。 有关更多信息，请参见 LICENSE 文件。