Platforms to show: All Mac Windows Linux Cross-Platform
SUUpdaterMBS class
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| class | Sparkle | MBS MacExtras Plugin | 8.6 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
This class is for use with the Sparkle 1.5b6 framework and implements the Cocoa classes inside this framework.
- 29 events
- event bestValidUpdateInAppcast(appcast as SUAppcastMBS) as SUAppcastItemMBS
- event didAbortWithError(error as NSErrorMBS)
- event didCancelInstallUpdateOnQuit(update as SUAppcastItemMBS)
- event didDismissUpdateAlertPermanently(permanently as boolean, item as SUAppcastItemMBS)
- event didDownloadUpdate(item as SUAppcastItemMBS)
- event didExtractUpdate(item as SUAppcastItemMBS)
- event didFindValidUpdate(update as SUAppcastItemMBS)
- event didFinishLoadingAppcast(update as SUAppcastMBS)
- event failedToDownloadUpdate(item as SUAppcastItemMBS, error as NSErrorMBS)
- event feedParametersForUpdater(sendingProfile as boolean) as dictionary()
- event feedURLStringForUpdater as String
- event pathToRelaunchForUpdater as string
- event shouldPostponeRelaunchForUpdate(sendingProfile as SUAppcastItemMBS) as boolean
- event updaterDidNotFindUpdate
- event updaterDidRelaunchApplication
- event updaterDidShowModalAlert
- event updaterMayCheckForUpdates as boolean
- event updaterShouldPromptForPermissionToCheckForUpdates as boolean
- event updaterShouldRelaunchApplication as boolean
- event updaterShouldShowUpdateAlertForScheduledUpdate(item as SUAppcastItemMBS) as boolean
- event updaterWillRelaunchApplication
- event updaterWillShowModalAlert
- event userDidCancelDownload
- event userDidSkipThisVersion(item as SUAppcastItemMBS)
- event versionComparatorForUpdater as SUVersionComparisonMBS
- event willDownloadUpdate(item as SUAppcastItemMBS, request as Variant)
- event willExtractUpdate(item as SUAppcastItemMBS)
- event willInstallUpdate(update as SUAppcastItemMBS)
- event willInstallUpdateOnQuit(update as SUAppcastItemMBS)
- 14 properties
- property automaticallyChecksForUpdates as boolean
- property automaticallyDownloadsUpdates as boolean
- property decryptionPassword as String
- property feedURL as string
- property Handle as Integer
- property hostBundle as Variant
- property httpHeaders as Dictionary
- property lastUpdateCheckDate as date
- property lastUpdateCheckDateTime as DateTime
- property sendsSystemProfile as boolean
- property sparkleBundle as Variant
- property updateCheckInterval as Double
- property updateInProgress as boolean
- property userAgentString as String
- 10 methods
- method checkForUpdateInformation
- method checkForUpdates
- method checkForUpdatesInBackground
- method Constructor
- method Constructor(Bundle as folderitem)
- method installUpdatesIfAvailable
- method InvokeImmediateInstallation
- method InvokeUpdate
- method resetUpdateCycle
- method validateMenuItem(menuItem as NSMenuItemMBS) as Boolean
- 9 shared methods
- shared method IsFrameworkLoaded as boolean
- shared method LoadFramework(path as folderitem) as boolean
- shared method SUSparkleErrorDomain as String
- shared method SUUpdaterAppcastItemNotificationKey as String
- shared method SUUpdaterAppcastNotificationKey as String
- shared method SUUpdaterDidFindValidUpdateNotification as String
- shared method SUUpdaterDidFinishLoadingAppCastNotification as String
- shared method SUUpdaterDidNotFindUpdateNotification as String
- shared method SUUpdaterWillRestartNotification as String
- 18 constants
Errors
| Constant | Value | Description |
|---|---|---|
| SUAppcastError | 1002 |
An error occurred in retrieving update information. |
| SUAppcastParseError | 1000 |
An error occurred while parsing the update feed. The appcast must be valid xml. |
| SUAuthenticationFailure | 4001 |
Unable to grant authorization to perform action because it is explicitly turned off. |
| SUDowngradeError | 4006 |
The update contains an older version. |
| SUDownloadError | 2001 |
Download error. |
| SUFileCopyFailure | 4000 |
File copy failed. |
| SUInstallationCancelledError | 4007 |
Installation was cancelled. |
| SUInstallationError | 4005 |
An error occurred while installing the update. |
| SUMissingInstallerToolError | 4003 |
The installer tool is missing. |
| SUMissingUpdateError | 4002 |
Couldn't find an appropriate update in the downloaded package. App name or bundle ID must match to current app. |
| SUNoUpdateError | 1001 |
You already have the newest version. |
| SURelaunchError | 4004 |
Failed to relaunch. |
| SURunningFromDiskImageError | 1003 |
The app runs from disk image and can't update. |
| SURunningTranslocated | 1004 |
The application got translocated. |
| SUSignatureError | 3001 |
The signture doesn't match. |
| SUSystemPowerOffError | 5000 |
The update will not be installed because the user requested for the system to power off. |
| SUTemporaryDirectoryError | 2000 |
Failed to get temp file. |
| SUUnarchivingError | 3000 |
Failed to unarchive the update. |
This class has no sub classes.
Some examples using this class:
Blog Entries
- MBS Xojo Plugins, version 22.2pr1
- MBS Xojo Plugins, version 20.5pr8
- News from the MBS Xojo Plugins Version 20.3
- MBS Xojo Plugins, version 20.3pr6
- MBS Xojo / Real Studio Plugins, version 15.1pr5
- MBS Real Studio Plugins, version 11.3pr2
- MonkeyBread Software Releases the MBS REALbasic plug-ins 8.6
Release notes
- Version 22.2
- Removed installUpdatesIfAvailable for SUUpdaterMBS class. Newer Sparkle framework doesn't have that anymore.
- Version 20.5
- Optimized a few more flags: iTunesLibraryMBS, GrowlMBS, AuthorizationMBS, SUUpdaterMBS, SpinningProgressIndicatorMBS, NSHelpManagerMBS and MAAttachedWindowMBS classes are now desktop only.
- Version 20.3
- Updated Sparkle classes to latest Sparkle framework version: SUAppcastMBS, SUAppcastItemMBS and SUUpdaterMBS.
The items on this page are in the following plugins: MBS MacExtras Plugin.
SummaryMBS - SUVersionComparisonMBS
