All notable changes to this project will be documented in this file.
- BREAKING CHANGE Added
HideRemindMeLaterButton()
toIUpdateAvailable
- BREAKING CHANGE Added
HideSkipButton()
toIUpdateAvailable
- Added
HideRemindMeLaterButton
to theNetSparkle
class. Defaults to false. Set to true to makeNetSparkle
callHideRemindMeLaterButton()
when showing the update window. - Added
HideSkipButton
to theNetSparkle
class. Defaults to false. Set to true to makeNetSparkle
callHideSkipButton()
when showing the update window.
- Release notes are now downloaded asynchronously, which should speed up the time it takes to show the download window
- Release note date is now Date.ToString("D") instead of "dd MMM yyyy" so that release notes show localized date strings
- POTENTIALLY BREAKING CHANGE Fixed bug where
ValidationResult.Unchecked
was not returned properly fromOnDownloadFinished
if download file signature is null (@keithclanton)
0.12.0 - 2017-08-02
- Added new
LogWriter
class for printing diagnostic messages to the console. You can now create your own child class that inherits fromLogWriter
to customize how information is logged to the console (or file, or wherever else you want diagnostic messages sent!)! - Added .gitattributes file for line ending consistency for all developers (@stephenwade)
- Moved
UpdateStatus
enum toNetSparkle.Enums
- Moved
UpdateInfo
class to its own file - Fixed bug in
Configuration.cs
where a few values were not set properly in the constructor due toInitWithDefaultValues
being called at the wrong time (@devstudiosoft) - BREAKING CHANGE Fixed bug in
AssemblyDiagnosticsAccessor
whereAssemblyProduct
returned the assembly version and not the assembly name (@devstudiosoft)
- BREAKING CHANGE Removed
public void NetSparkle.ReportDiagnosticMessage
in lieu of newLogWriter
class.
0.11.0 - 2017-07-16
- Refactored logic to quit application to a separate
QuitApplication()
function
RunDownloadedInstaller()
is now virtual and protected- Renamed some files and variables
- Moved
SecurityMode
andValidationResult
enums to theNetSparkle.Enums
namespace
0.10.0 - 2017-07-11
- This changelog
Sparkle
class documentation to the readme- Section about how the appcast works to the readme
Much thanks to @stephenwade for his contributions to 0.10.0
- Cleaned up and added documentation comments throughout the code (@stephenwade)
- Renamed lots of identifiers throughout the project to remove "NetSparkle" (i.e.,
NetSparkleAppCast
toAppCast
,NetSparkleConfiguration
toConfiguration
, etc.) (@stephenwade) - Renamed property
UseSyncronizedForms
toShowsUIOnMainThread
to better represent what it does (@stephenwade) - Renamed events
CloseWPFSoftware
andCloseWPFSoftwareAsync
toCloseApplication
andCloseApplicationAsync
(@stephenwade)- These events are now always run, if present (instead of only on
RunningFromWPF
) - If one of these events is set, it will be run instead of quitting your app (to allow you a custom quit procedure), so these events should take care of quitting your app.
- These events are now always run, if present (instead of only on
- Renamed
DSAVerificator
toDSAChecker
(@stephenwade) - Folder output changed to be more organized
- Updated LICENSE file
- Update NuGet package items
- deprecated property
EnableSilentMode
- property
RunningFromWPF
0.9.1.1 - 2017-06-06
ClearOldInstallers
Action that you can implement on your own to remove old installers. Use this if you download installers to a custom folder and need to erase them later.
- Fixed compilation issue with
EnableSilentMode
(not sure how I never came across this!)
0.9.1 - 2017-03-30
UpdateSize
toNetSparkleAppCastItem
, analogous to thelength
field within the<enclosure>
tagIsCriticalUpdate
toNetSparkleAppCastItem
- To use, add
sparkle:criticalUpdate="true"
as an attribute to the<enclosure>
tag - When any update that the user needs is marked as critical, the skip and remind me later buttons are disabled
- When an update is marked as critical, the release notes for that version state that the update is critical
- To do something about a critical update in your own software, check
Sparkle.LatestAppCastItems
orSparkle.UpdateMarkedCritical
to see if an update in the list of updates that the user needs is critical
- To use, add
0.9 - 2017-03-28
- Several more diagnostic messages for debugging on the console
- New
SilentMode
option to allow for the "normal" update process (NotSilent
), completely silent updates (DownloadAndInstall
), or silent downloads that you as the developer initiate the start of the update manually (DownloadNoInstall
)DownloadAndInstall
may be quite jarring to your users if you don't tell them the software is about to quit to restart. UseAboutToExitForInstallerRun
orAboutToExitForInstallerRunAsync
to monitor for these events.- For proper
DownloadNoInstall
use, monitor theDownloadedFileReady
event to know when things are ready. At some later time, call_sparkle.ShowUpdateNeededUI(true);
to show the software update window. You may want to monitor other events as well to keep your user from performing another update check while a software update is downloading.
TmpDownloadFilePath
to redirect the download location. This should be a folder, not a full path. Note that you still need to manually delete files that are downloaded here.
- Deprecated EnableSilentMode in lieu of SilentMode
- Stopped the software from redownloading the installer if it already exists on disk (saves bandwidth and time on the user's part)
- Note that NetSparkle does not perform resumable downloads in between software instances
- Fixed potential infinite software update download loop if the software keeps downloading corrupted files (corrupt files or ones that don't pass the DSA check).
For older changes, see HISTORY.md.