125 lines
2.9 KiB
Markdown
125 lines
2.9 KiB
Markdown
|
# DockProgress
|
||
|
|
|
||
|
|
> Show progress in your app's Dock icon
|
||
|
|
|
||
|
|
<img src="screenshot.gif" width="485">
|
||
|
|
|
||
|
|
This package is used in production by the [Gifski app](https://github.com/sindresorhus/Gifski). You might also like some of my [other apps](https://sindresorhus.com/apps).
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
- macOS 10.12+
|
||
|
|
- Xcode 12+
|
||
|
|
- Swift 5.3+
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
#### Swift Package Manager
|
||
|
|
|
||
|
|
Add `https://github.com/sindresorhus/DockProgress` in the [“Swift Package Manager” tab in Xcode](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app).
|
||
|
|
|
||
|
|
#### Carthage
|
||
|
|
|
||
|
|
```
|
||
|
|
github "sindresorhus/DockProgress"
|
||
|
|
```
|
||
|
|
|
||
|
|
#### CocoaPods
|
||
|
|
|
||
|
|
```ruby
|
||
|
|
pod 'DockProgress'
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
### Manually set the progress
|
||
|
|
|
||
|
|
```swift
|
||
|
|
import Cocoa
|
||
|
|
import DockProgress
|
||
|
|
|
||
|
|
foo.onUpdate = { progress in
|
||
|
|
DockProgress.progress = progress
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### Specify a [`Progress` instance](https://developer.apple.com/documentation/foundation/progress)
|
||
|
|
|
||
|
|
```swift
|
||
|
|
import Cocoa
|
||
|
|
import DockProgress
|
||
|
|
|
||
|
|
let progress = Progress(totalUnitCount: 1)
|
||
|
|
progress?.becomeCurrent(withPendingUnitCount: 1)
|
||
|
|
|
||
|
|
DockProgress.progressInstance = progress
|
||
|
|
```
|
||
|
|
|
||
|
|
The given `Progress` instance is weakly stored. It's up to you to retain it.
|
||
|
|
|
||
|
|
## Styles
|
||
|
|
|
||
|
|
It comes with three styles. PR welcome for more.
|
||
|
|
|
||
|
|
Check out the example app in the Xcode project.
|
||
|
|
|
||
|
|
You can also draw a custom progress with `.custom(drawHandler: (_ rect: CGRect) -> Void)`.
|
||
|
|
|
||
|
|
### Bar
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
```swift
|
||
|
|
import DockProgress
|
||
|
|
|
||
|
|
DockProgress.style = .bar
|
||
|
|
```
|
||
|
|
|
||
|
|
This is the default.
|
||
|
|
|
||
|
|
### Squircle
|
||
|
|
|
||
|
|
<img src="screenshot-squircle.gif" width="158" height="158">
|
||
|
|
|
||
|
|
```swift
|
||
|
|
import DockProgress
|
||
|
|
|
||
|
|
DockProgress.style = .squircle(color: NSColor.white.withAlphaComponent(0.5))
|
||
|
|
```
|
||
|
|
|
||
|
|
By default, it should perfectly fit a macOS 11 icon, but there's a `inset` parameter if you need to make any adjustments.
|
||
|
|
|
||
|
|
### Circle
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
```swift
|
||
|
|
import DockProgress
|
||
|
|
|
||
|
|
DockProgress.style = .circle(radius: 55, color: .systemBlue)
|
||
|
|
```
|
||
|
|
|
||
|
|
Make sure to set a `radius` that matches your app icon.
|
||
|
|
|
||
|
|
### Badge
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
```swift
|
||
|
|
import DockProgress
|
||
|
|
|
||
|
|
DockProgress.style = .badge(color: .systemBlue, badgeValue: { getDownloadCount() })
|
||
|
|
```
|
||
|
|
|
||
|
|
Large `badgeValue` numbers will be written in kilo short notation, for example, `1012` → `1k`.
|
||
|
|
|
||
|
|
Note: The `badgeValue` is not meant to be used as a numeric percentage. It's for things like count of downloads, number of files being converted, etc.
|
||
|
|
|
||
|
|
## Related
|
||
|
|
|
||
|
|
- [Defaults](https://github.com/sindresorhus/Defaults) - Swifty and modern UserDefaults
|
||
|
|
- [Preferences](https://github.com/sindresorhus/Preferences) - Add a preferences window to your macOS app in minutes
|
||
|
|
- [KeyboardShortcuts](https://github.com/sindresorhus/KeyboardShortcuts) - Add user-customizable global keyboard shortcuts to your macOS app
|
||
|
|
- [LaunchAtLogin](https://github.com/sindresorhus/LaunchAtLogin) - Add "Launch at Login" functionality to your macOS app
|
||
|
|
- [More…](https://github.com/search?q=user%3Asindresorhus+language%3Aswift)
|