2.3.2 Generate Appcast Improvements

• Fix potential crash during download if appcast item includes invalid enclosure URL (#2317) (Zorg)
• Add delegate method to hide showing version history option (#2303) (Zorg)
• Finnish localization grammar fixes (#2311) (Lauri-Matti Parppei)

Please also see the release notes for Sparkle 2.3.0 and Sparkle 2.3.1.

2.3.1 Generate Appcast Improvements

• Fix update permission alert title text overlapping with question text in some languages (#2284) (Zorg)
• Log the URL that failed to download correctly (#2296) (Zorg)
• Update Czech translation (#2275) (Sam)
• Add zh_HK (Chinese, Hong Kong) localization (#2273) (Bing Zheung)

Please also see the release notes for Sparkle 2.3.0.

2.3.0 Generate Appcast Improvements

• Bump minimum deployment target to macOS 10.13 (#2196) (Zorg)
• Remove and preserve necessary updates in generate_appcast (#2218) (Zorg)
• Move old update files no longer needed to old_updates/ in archive directory in generate_appcast (#2228) (Zorg)
• Expose maximum-versions option (per branch) in generate_appcast to preserve in the feed (#2259) (Zorg)
• Add -p option to sign_update to only print the signed signature (#2268) (Zorg)
• Hide automatic install check box when allowsAutomaticUpdates is disabled (#2202) (Jie)
• Allow developer to always force allowing automatic updates (#2266) (Zorg)
• Fix update window going haywire during resize when release notes are hidden by disabling resizing (#2200) (Zorg)
• Allow user to re-try installing/relaunching application when quit is delayed/cancelled (#2234) (Zorg)
• Add delta update attributes for validating an app hasn't been stripped from removed localizations or architectures (#2219) (Zorg)
• Fix delta patches not applying edge case if files from source that need to be diffed are not writeable (#2211) (Zorg)
• Add delegate callback when user makes choice to install, dismiss, or skip an update (#2250) (Zorg)
• Reject serving updates with DSA only and no EdDSA (#2167) (Zorg)
• Find potential matching running apps that are translocated in the updater agent (#2233) (Zorg)
• Expose -[SPUStandardUserDriver activeUpdateAlert] as private API (#2255) (Zorg)
• Add zh_CN l10n for "Version History" (#2247) (kakaiikaka)
• Update zh_TW localization (#2271) (Chiahong)
• Remove ed25519 git submodule in favor of including the dependency directly (#2244) (Zorg)
• Clean up left-over code (#2243) (Eitot)
• Update Package.resolved (#2245) (Zorg)
• Remove model translation table for system profiling (#2188) (Zorg)
• Improve documentation usage for SPUUpdater properties (#2256) (Zorg)

This release improves generate_appcast by automatically removing updates that are no longer needed in the generated appcast, and moving old update files to old_updates/ in the archives directory. New delta update attributes are also added to let Sparkle know when to skip downloading delta updates if the application has been stripped.

macOS 10.13 or later is now required (due to Xcode 14 dropping support for deploying to older OS versions).

If you're not generating appcasts automatically, remember to add <sparkle:minimumSystemVersion>10.13</sparkle:minimumSystemVersion> element to <item>s in your appcast.

Discussion for Sparkle 2.3.

2.3.0-beta.2

Changes in beta 2:

• Allow developer to always force allowing automatic updates (#2266) (Zorg)
• Add -p option to sign_update to only print the signed signature (#2268) (Zorg)

Overall changes:

• Bump minimum deployment target to macOS 10.13 (#2196) (Zorg)
• Remove and preserve necessary updates in generate_appcast (#2218) (Zorg)
• Move old update files no longer needed to old_updates/ in archive directory in generate_appcast (#2228) (Zorg)
• Expose maximum-versions option (per branch) in generate_appcast to preserve in the feed (#2259) (Zorg)
• Add -p option to sign_update to only print the signed signature (#2268) (Zorg)
• Hide automatic install check box when allowsAutomaticUpdates is disabled (#2202) (Jie)
• Allow developer to always force allowing automatic updates (#2266) (Zorg)
• Fix update window going haywire during resize when release notes are hidden by disabling resizing (#2200) (Zorg)
• Allow user to re-try installing/relaunching application when quit is delayed/cancelled (#2234) (Zorg)
• Add delta update attributes for validating an app hasn't been stripped from removed localizations or architectures (#2219) (Zorg)
• Fix delta patches not applying edge case if files from source that need to be diffed are not writeable (#2211) (Zorg)
• Add delegate callback when user makes choice to install, dismiss, or skip an update (#2250) (Zorg)
• Reject serving updates with DSA only and no EdDSA (#2167) (Zorg)
• Find potential matching running apps that are translocated in the updater agent (#2233) (Zorg)
• Expose -[SPUStandardUserDriver activeUpdateAlert] as private API (#2255) (Zorg)
• Add zh_CN l10n for "Version History" (#2247) (kakaiikaka)
• Remove ed25519 git submodule in favor of including the dependency directly (#2244) (Zorg)
• Clean up left-over code (#2243) (Eitot)
• Update Package.resolved (#2245) (Zorg)
• Remove model translation table for system profiling (#2188) (Zorg)
• Improve documentation usage for SPUUpdater properties (#2256) (Zorg)

This release improves generate_appcast by automatically removing updates that are no longer needed in the generated appcast, and moving old update files to old_updates/ in the archives directory. New delta update attributes are also added to let Sparkle know when to skip downloading delta updates if the application has been stripped.

macOS 10.13 or later is now required (due to Xcode 14 dropping support for deploying to older OS versions).

If you're not generating appcasts automatically, remember to add <sparkle:minimumSystemVersion>10.13</sparkle:minimumSystemVersion> element to <item>s in your appcast.

Discussion for Sparkle 2.3.

2.3.0-beta.1

• Bump minimum deployment target to macOS 10.13 (#2196) (Zorg)
• Remove and preserve necessary updates in generate_appcast (#2218) (Zorg)
• Move old update files no longer needed to old_updates/ in archive directory in generate_appcast (#2228) (Zorg)
• Expose maximum-versions option (per branch) in generate_appcast to preserve in the feed (#2259) (Zorg)
• Hide automatic install check box when allowsAutomaticUpdates is disabled (#2202) (Jie)
• Fix update window going haywire during resize when release notes are hidden by disabling resizing (#2200) (Zorg)
• Allow user to re-try installing/relaunching application when quit is delayed/cancelled (#2234) (Zorg)
• Add delta update attributes for validating an app hasn't been stripped from removed localizations or architectures (#2219) (Zorg)
• Fix delta patches not applying edge case if files from source that need to be diffed are not writeable (#2211) (Zorg)
• Add delegate callback when user makes choice to install, dismiss, or skip an update (#2250) (Zorg)
• Reject serving updates with DSA only and no EdDSA (#2167) (Zorg)
• Find potential matching running apps that are translocated in the updater agent for external updaters (#2233) (Zorg)
• Expose -[SPUStandardUserDriver activeUpdateAlert] as private API (#2255) (Zorg)
• Add zh_CN l10n for "Version History" (#2247) (kakaiikaka)
• Remove ed25519 git submodule in favor of including the dependency directly (#2244) (Zorg)
• Clean up left-over code (#2243) (Eitot)
• Update Package.resolved (#2245) (Zorg)
• Remove model translation table for system profiling (#2188) (Zorg)
• Improve documentation usage for SPUUpdater properties (#2256) (Zorg)

This release improves generate_appcast by automatically removing updates that are no longer needed in the generated appcast, and moving old update files to old_updates/ in the archives directory. New delta update attributes are also added to let Sparkle know when to skip downloading delta updates if the application has been stripped.

macOS 10.13 or later is now required (due to Xcode 14 dropping support for deploying to older OS versions).

If you're not generating appcasts automatically, remember to add <sparkle:minimumSystemVersion>10.13</sparkle:minimumSystemVersion> element to <item>s in your appcast.

2.2.2 Focus Improvements

• Critical update alerts may not show up as promptly as they should when they are being automatically installed (#2230) (Zorg)
• Remove module imports from framework headers and allow building with C++20 (#2217) (Zorg)
• Update Portuguese localization (#2224) (Kent Sutherland)
• Update zh_TW localization (#2246) (Chiahong)

Please also see the release notes for Sparkle 2.2.0.

2.2.1 Focus Improvements

• Make scroll bar dark in dark theme for Release Notes by default (#2187) (Pavel Moiseenko)
• Fix memory leaks when using generate_appcast (#2193) (Zorg)
• Update Italian localization (#2192) (VinBoiSoft)

Please also see the release notes for Sparkle 2.2.0.

2.2.0 Focus Improvements

• Update Focus Improvements (#924)
  • Present new scheduled updates in utmost focus only at opportune times (Zorg)
    • For regular apps opportune times are: app launch, app re-activation, and system being idle (without a power assertion being held to prevent display sleep).
    • For background (dockless) apps opportune time is just app launch. Otherwise, the update is now shown behind other applications and windows, instead of previously stealing focus from other active apps.
  • Add APIs and documentation for adding gentle update reminders to compliment Sparkle's standard user interface (Zorg) (#2122)
  • Allow status window to be minimizable for regular app installs (Zorg) (#2100)
  • Center status window and inherit key focus from the previously shown update alert window (Zorg)
  • Activate app when checking for updates if the app is not currently active (e.g, from a menu bar extra menu item) (Zorg)
  • Fix issue where bringing status window to front made other active windows exit in macOS Ventura's Stage Manager (#2153) (Zorg)
  • Fix showing update in focus not bringing the "checking for updates" window in focus (Zorg) (#2150)
• Rename XPC Service filenames for Sandboxing to show more friendly human-readable name in authorization dialog (Zorg) (#2096)
• Add support for running the framework and sparkle-cli as root (Zorg) (#2119)
• Fix issue where update cycle may not complete in unusual configuration if automatic checks are disabled + automatic downloading is enabled + install requires user interaction (Zorg) (#2133)
• Synchronize usage of XPC connections to main queue to fix potential race conditions (Zorg) (#2178)
• Update last update check time when choosing to install an update & relaunch (Zorg) (#2136)
• Improve error reporting in the framework and sparkle-cli when installation fails with no write permission (Zorg) (#2157)
• Use displayVersionString instead of versionString for OS version mismatch error message (samschott) (#2138)
• Make displayVersionString non-null and update fallback documentation (Zorg) (#2139)
• Ignore custom icons set via resource forks when applying delta updates (Zorg) (#2114)
• Fall back to regular update if delta update fails to download (Zorg) (#2118)
• Skip downloading delta updates when application has been moved to a file system (like FAT) that doesn't support regular permission modes (Zorg) (#2148)
• Bump initial installer message timeouts and declare daemon/agents processes as Interactive (Zorg) (#2162)
• Add and improve translation strings and update pt-BR (BR Lingo) (#2094)
• Update localisations (Eitot) (#2113)
• Update Greek localizations (seitsme) (#2184, #2185)
• Update Japanese localization (1024jp) (#2182)
• Replace deprecated code with newer APIs (Eitot) (#2112)
• Remove obsolete fallbacks for older OS versions (Eitot) (#2110)
• Remove SPUURLRequest (Zorg) (#2124)
• Silence ivar deprecation warnings (Zorg) (#2099)
• Fix Xcode 14 project warnings (Zorg) (#2147, #2179)
• Deprecate -s flag and add --ed-key-file option to generate_appcast (Zorg) (#2170)
• Update text for external licenses (Zorg) (#2164)

This update renames the bundled XPC Services, brings improvements to notifying users of new updates without disrupting their focus, and adds gentle update reminder APIs to further customize how Sparkle's standard user interface delivers new update alerts.

The -s flag for passing a raw private EdDSA key to sign_update and generate_appcast is now deprecated. If you were using this option previously, please see the help pages of these tools for more information.

Discussions

2.2.0-beta.2

New in beta 2:

• Bump initial installer message timeouts and declare daemon/agents processes as Interactive (Zorg) (#2162)
• Update text for external licenses (Zorg) (#2164)
• Update API and website documentation for gentle reminders (Zorg)

Overall changes in 2.2:

• Update Focus Improvements (#924)
  • Present new scheduled updates in utmost focus only at opportune times (Zorg)
    • For regular apps opportune times are: app launch, app re-activation, and system being idle (without a power assertion being held to prevent display sleep).
    • For background (dockless) apps opportune time is just app launch. Otherwise, the update is now shown behind other applications and windows, instead of previously stealing focus from other active apps.
  • Add APIs and documentation for adding gentle update reminders to compliment Sparkle's standard user interface (Zorg) (#2122)
  • Allow status window to be minimizable for regular app installs (Zorg) (#2100)
  • Center status window and inherit key focus from the previously shown update alert window (Zorg)
  • Activate app when checking for updates if the app is not currently active (e.g, from a menu bar extra menu item) (Zorg)
  • Fix issue where bringing status window to front made other active windows exit in macOS Ventura's Stage Manager (#2153) (Zorg)
  • Fix showing update in focus not bringing the "checking for updates" window in focus (Zorg) (#2150)
• Rename XPC Service filenames for Sandboxing to show more friendly human-readable name in authorization dialog (Zorg) (#2096)
• Add support for running the framework and sparkle-cli as root (Zorg) (#2119)
• Fix issue where update cycle may not complete in unusual configuration if automatic checks are disabled + automatic downloading is enabled + install requires user interaction (Zorg) (#2133)
• Update last update check time when choosing to install an update & relaunch (Zorg) (#2136)
• Improve error reporting in the framework and sparkle-cli when installation fails with no write permission (Zorg) (#2157)
• Use displayVersionString instead of versionString for OS version mismatch error message (samschott) (#2138)
• Make displayVersionString non-null and update fallback documentation (Zorg) (#2139)
• Ignore custom icons set via resource forks when applying delta updates (Zorg) (#2114)
• Fall back to regular update if delta update fails to download (Zorg) (#2118)
• Skip downloading delta updates when application has been moved to a file system (like FAT) that doesn't support regular permission modes (Zorg) (#2148)
• Bump initial installer message timeouts and declare daemon/agents processes as Interactive (Zorg) (#2162)
• Add and improve translation strings and update pt-BR (BR Lingo) (#2094)
• Update localisations (Eitot) (#2113)
• Replace deprecated code with newer APIs (Eitot) (#2112)
• Remove obsolete fallbacks for older OS versions (Eitot) (#2110)
• Remove SPUURLRequest (Zorg) (#2124)
• Silence ivar deprecation warnings (Zorg) (#2099)
• Fix Xcode 14 project warnings (Zorg) (#2147)
• Update text for external licenses (Zorg) (#2164)

This update renames the bundled XPC Services, brings improvements to notifying users of new updates without disrupting their focus, and adds gentle update reminder APIs to further customize how Sparkle's standard user interface delivers new update alerts.

Discussions

2.2.0-beta.1

• Update Focus Improvements (#924)
  • Present new scheduled updates in utmost focus only at opportune times (Zorg)
    • For regular apps opportune times are: app launch, app re-activation, and system being idle (without a power assertion being held to prevent display sleep) instead of previously being able to show up while actively using the app.
    • For background (dockless) apps opportune time is just app launch. Otherwise, the update is now shown behind other applications and windows, instead of previously stealing focus from other active apps.
  • Add APIs and documentation for adding gentle update reminders to compliment Sparkle's standard user interface (Zorg) (#2122)
  • Allow status window to be minimizable for regular app installs (Zorg) (#2100)
  • Center status window and inherit key focus from the previously shown update alert window (Zorg)
  • Activate app when checking for updates if the app is not currently active (e.g, from a menu bar extra menu item) (Zorg)
  • Fix issue where bringing status window to front made other active windows exit in macOS Ventura's Stage Manager (#2153) (Zorg)
  • Fix showing update in focus not bringing the "checking for updates" window in focus (Zorg) (#2150)
• Rename XPC Service filenames for Sandboxing to show more friendly human-readable name in authorization dialog (Zorg) (#2096)
• Add support for running the framework and sparkle-cli as root (Zorg) (#2119)
• Fix issue where update cycle may not complete in unusual configuration if automatic checks are disabled + automatic downloading is enabled + install requires user interaction (Zorg) (#2133)
• Update last update check time when choosing to install an update & relaunch (Zorg) (#2136)
• Improve error reporting in the framework and sparkle-cli when installation fails with no write permission (Zorg) (#2157)
• Use displayVersionString instead of versionString for OS version mismatch error message (samschott) (#2138)
• Make displayVersionString non-null and update fallback documentation (Zorg) (#2139)
• Ignore custom icons set via resource forks when applying delta updates (Zorg) (#2114)
• Fall back to regular update if delta update fails to download (Zorg) (#2118)
• Skip downloading delta updates when application has been moved to a file system (like FAT) that doesn't support regular permission modes (Zorg) (#2148)
• Add and improve translation strings and update pt-BR (BR Lingo) (#2094)
• Update localisations (Eitot) (#2113)
• Replace deprecated code with newer APIs (Eitot) (#2112)
• Remove obsolete fallbacks for older OS versions (Eitot) (#2110)
• Remove SPUURLRequest (Zorg) (#2124)
• Silence ivar deprecation warnings (Zorg) (#2099)
• Fix Xcode 14 project warnings (Zorg) (#2147)

This update renames the bundled XPC Services, brings improvements to notifying users of new updates without disrupting their focus, and adds gentle update reminder APIs to further customize how Sparkle's standard user interface delivers new update alerts.

Discussions.