DockProgress 3.2.0

DockProgress 3.2.0

×

由 Sindre Sorhus 维护。

DockProgress 3.2.0

DockProgress

在应用Dock图标中显示进度

此软件包在 Gifski 应用 中已用于生产。您也可能喜欢我的一些 其他应用。

要求

  • macOS 10.12+
  • Xcode 12+
  • Swift 5.3+

安装

Swift 包管理器

在 Xcode 的“Swift 包管理器”标签中添加 https://github.com/sindresorhus/DockProgress

Carthage

github "sindresorhus/DockProgress"

CocoaPods

pod 'DockProgress'

使用方法

手动设置进度

import Cocoa
import DockProgress

foo.onUpdate = { progress in
	DockProgress.progress = progress
}

指定一个 Progress 实例

import Cocoa
import DockProgress

let progress = Progress(totalUnitCount: 1)
progress?.becomeCurrent(withPendingUnitCount: 1)

DockProgress.progressInstance = progress

给定的 Progress 实例被弱引用存储。保留它取决于你。

样式

它包含三种样式。欢迎贡献更多。

请在 Xcode 项目中的示例应用中查看。

您还可以使用 .custom(drawHandler: (_ rect: CGRect) -> Void) 绘制自定义进度。

栏

import DockProgress

DockProgress.style = .bar

默认选项。

椭圆

import DockProgress

DockProgress.style = .squircle(color: NSColor.white.withAlphaComponent(0.5))

默认情况下，它应完美适应 macOS 11 图标，但如果需要调整，可以使用 inset 参数。

圆形

import DockProgress

DockProgress.style = .circle(radius: 55, color: .systemBlue)

请确保设置一个与您的应用图标匹配的 radius。

徽章

import DockProgress

DockProgress.style = .badge(color: .systemBlue, badgeValue: { getDownloadCount() })

大的 badgeValue 数字将以千短格式写出，例如，1012 → 1k。

注意：badgeValue 不应用作数字百分比。它是用于下载计数、正在转换的文件数等。

相关