All Versions
Latest Version
Avg Release Cycle
79 days
Latest Release
930 days ago

Changelog History
Page 1

  • v2.1.0 Changes

    November 11, 2020
    • ๐Ÿ‘Œ Improve macOS 11 compatibility (#58). dbe099f
  • v2.0.1 Changes

    July 25, 2020
    • ๐Ÿ›  Fix building on Apple Silicon ece67e7
  • v2.0.0 Changes

    June 02, 2020

    ๐Ÿ’ฅ Breaking

    • ๐Ÿ“‡ Rename PreferencePane.Identifier to Preferences.PaneIdentifiera1acf5b
    • ๐Ÿ’… Rename PreferencesStyle to Preferences.Style99f0e0b

    ๐Ÿ‘Œ Improvements

  • v1.0.1 Changes

    December 03, 2019
    • ๐Ÿ›  Fix macOS version requirement in Package.swift 6c731a6
  • v1.0.0 Changes

    November 01, 2019

    ๐Ÿ“ฆ This package is now considered stable.

    • โฌ†๏ธ Upgrade to Swift 5.1 b999a0a
    • ๐ŸŽ Lower the minimum required macOS version from 10.12 to 10.10 669fc93
  • v0.4.1 Changes

    July 06, 2019
    • ๐Ÿ›  Fix window-restoration cc25d58
    • ๐Ÿ›  Fix transition animation bug on macOS 10.13 and earlier 6b44965
  • v0.4.0 Changes

    June 14, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix automatic localization of "Preferences" in the window title when there's only one preference pane. 18f009c
  • v0.3.0 Changes

    May 14, 2019

    Screen Shot 2019-05-14 at 15 48 49

    ๐Ÿš€ The main feature of this release is a segmented control style. We have also considerably improved the API and codebase.

    ๐Ÿ’ฅ Breaking

    • The Preferenceable protocol was renamed to PreferencePane
    • The required toolbarItemTitle property was renamed to preferencePaneTitle
    • You now have to provide a preferencePaneIdentifier property in your view controller
    • โœ‚ Remove .hideWindow() in favor of NSWindowController#close() (#21) d9ad07c
    • The PreferencesWindowController viewControllers parameter was renamed to preferencePanes
    • The .showWindow() method was renamed to .show() and you can now optionally pass in which preference pane to show

    Migrating a view controller:

    +extension PreferencePane.Identifier {+ static let general = Identifier("general")+}-final class GeneralPreferenceViewController: NSViewController, Preferenceable {+final class GeneralPreferenceViewController: NSViewController, PreferencePane {+ let preferencePaneIdentifier = PreferencePane.Identifier.general- let toolbarItemTitle = "General"+ let preferencePaneTitle = "General" let toolbarItemIcon = NSImage(named: NSImage.preferencesGeneralName)! // โ€ฆ

    โœจ Enhancements

    • โž• Add segmented control style (#6) 3b62df8 (See the readme for example)
    • ๐Ÿ‘‰ Use the preference pane title as window title (#19) 891d9df
      ๐ŸŽ To better align with the macOS Human Interface Guidelines.
    • โช Restore active preference when reopening window (#26) 2bb3fc7
    • โž• Add option to hide the toolbar when there's one or less items (#25) 27f4b3e
    • โฌ†๏ธ Upgrade to Swift 5 e0ef252

    Known issues

    • โ†ช It doesn't show the Preferences window if you're not using auto-layout for your view controllers. It's being worked on in #28. Temporary workaround.
    • It doesn't correctly localize the window title when there's only one tab. It's being worked on in #24.


  • v0.2.1 Changes

    January 02, 2019
    • ๐Ÿ›  Fix Gatekeeper validation errors when distributing apps (#7) 998120b
  • v0.2.0

    October 10, 2018