summaryrefslogtreecommitdiffstats
path: root/macosx/Sparkle.framework
diff options
context:
space:
mode:
authorDamiano Galassi <[email protected]>2018-06-10 16:55:57 +0200
committerDamiano Galassi <[email protected]>2018-06-10 16:55:57 +0200
commitea8ab220c1ae2e5ec6099b2a277daab93d951a06 (patch)
tree0d75c796dc2e7f9c70857d7a3ce05899763ca28c /macosx/Sparkle.framework
parentdd89061cef5a1f586ae5d8637bdedf2fc00c5d83 (diff)
MacGui: update Sparkle to 1.19.0.
Diffstat (limited to 'macosx/Sparkle.framework')
-rwxr-xr-xmacosx/Sparkle.framework/Versions/A/Headers/SPUDownloadData.h43
-rwxr-xr-xmacosx/Sparkle.framework/Versions/A/Headers/SPUDownloader.h25
-rwxr-xr-xmacosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderDelegate.h38
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderDeprecated.h13
-rwxr-xr-xmacosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderProtocol.h34
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderSession.h20
-rwxr-xr-xmacosx/Sparkle.framework/Versions/A/Headers/SPUURLRequest.h35
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SUAppcast.h24
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SUAppcastItem.h9
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SUErrors.h15
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SUStandardVersionComparator.h14
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SUUpdater.h361
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SUUpdaterDelegate.h281
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SUVersionComparisonProtocol.h9
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/SUVersionDisplayProtocol.h8
-rw-r--r--macosx/Sparkle.framework/Versions/A/Headers/Sparkle.h11
-rw-r--r--macosx/Sparkle.framework/Versions/A/PrivateHeaders/SUUnarchiver.h24
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Info.plist18
-rwxr-xr-xmacosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/Autoupdatebin166964 -> 188636 bytes
-rwxr-xr-xmacosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/fileopbin0 -> 85836 bytes
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/AppIcon.icnsbin155776 -> 37132 bytes
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/SUStatus.nibbin6572 -> 11639 bytes
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/en.lproj/Sparkle.stringsbin9108 -> 9096 bytes
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/Info.plist16
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/SUStatus.nibbin6572 -> 11639 bytes
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUAutomaticUpdateAlert.nibbin7078 -> 12246 bytes
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdateAlert.nibbin16580 -> 21594 bytes
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdatePermissionPrompt.nibbin12614 -> 18252 bytes
-rw-r--r--macosx/Sparkle.framework/Versions/A/Resources/en.lproj/Sparkle.stringsbin9108 -> 9096 bytes
-rwxr-xr-xmacosx/Sparkle.framework/Versions/A/Sparklebin466940 -> 582636 bytes
30 files changed, 703 insertions, 295 deletions
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloadData.h b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloadData.h
new file mode 100755
index 000000000..41cd57434
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloadData.h
@@ -0,0 +1,43 @@
+//
+// SPUDownloadData.h
+// Sparkle
+//
+// Created by Mayur Pawashe on 8/10/16.
+// Copyright © 2016 Sparkle Project. All rights reserved.
+//
+
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
+
+#import "SUExport.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*!
+ * A class for containing downloaded data along with some information about it.
+ */
+SU_EXPORT @interface SPUDownloadData : NSObject <NSSecureCoding>
+
+- (instancetype)initWithData:(NSData *)data textEncodingName:(NSString * _Nullable)textEncodingName MIMEType:(NSString * _Nullable)MIMEType;
+
+/*!
+ * The raw data that was downloaded.
+ */
+@property (nonatomic, readonly) NSData *data;
+
+/*!
+ * The IANA charset encoding name if available. Eg: "utf-8"
+ */
+@property (nonatomic, readonly, nullable, copy) NSString *textEncodingName;
+
+/*!
+ * The MIME type if available. Eg: "text/plain"
+ */
+@property (nonatomic, readonly, nullable, copy) NSString *MIMEType;
+
+@end
+
+NS_ASSUME_NONNULL_END
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloader.h b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloader.h
new file mode 100755
index 000000000..5eee9bd5e
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloader.h
@@ -0,0 +1,25 @@
+//
+// SPUDownloader.h
+// Downloader
+//
+// Created by Mayur Pawashe on 4/1/16.
+// Copyright © 2016 Sparkle Project. All rights reserved.
+//
+
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
+#import "SPUDownloaderProtocol.h"
+
+@protocol SPUDownloaderDelegate;
+
+// This object implements the protocol which we have defined. It provides the actual behavior for the service. It is 'exported' by the service to make it available to the process hosting the service over an NSXPCConnection.
+@interface SPUDownloader : NSObject <SPUDownloaderProtocol>
+
+// Due to XPC remote object reasons, this delegate is strongly referenced
+// Invoke cleanup when done with this instance
+- (instancetype)initWithDelegate:(id <SPUDownloaderDelegate>)delegate;
+
+@end
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderDelegate.h b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderDelegate.h
new file mode 100755
index 000000000..76e7e750a
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderDelegate.h
@@ -0,0 +1,38 @@
+//
+// SPUDownloaderDelegate.h
+// Sparkle
+//
+// Created by Mayur Pawashe on 4/1/16.
+// Copyright © 2016 Sparkle Project. All rights reserved.
+//
+
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class SPUDownloadData;
+
+@protocol SPUDownloaderDelegate <NSObject>
+
+// This is only invoked for persistent downloads
+- (void)downloaderDidSetDestinationName:(NSString *)destinationName temporaryDirectory:(NSString *)temporaryDirectory;
+
+// Under rare cases, this may be called more than once, in which case the current progress should be reset back to 0
+// This is only invoked for persistent downloads
+- (void)downloaderDidReceiveExpectedContentLength:(int64_t)expectedContentLength;
+
+// This is only invoked for persistent downloads
+- (void)downloaderDidReceiveDataOfLength:(uint64_t)length;
+
+// downloadData is nil if this is a persisent download, otherwise it's non-nil if it's a temporary download
+- (void)downloaderDidFinishWithTemporaryDownloadData:(SPUDownloadData * _Nullable)downloadData;
+
+- (void)downloaderDidFailWithError:(NSError *)error;
+
+@end
+
+NS_ASSUME_NONNULL_END
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderDeprecated.h b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderDeprecated.h
new file mode 100644
index 000000000..36302df48
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderDeprecated.h
@@ -0,0 +1,13 @@
+//
+// SPUDownloaderDeprecated.h
+// Sparkle
+//
+// Created by Deadpikle on 12/20/17.
+// Copyright © 2017 Sparkle Project. All rights reserved.
+//
+
+#import "SPUDownloader.h"
+
+@interface SPUDownloaderDeprecated : SPUDownloader <SPUDownloaderProtocol>
+
+@end
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderProtocol.h b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderProtocol.h
new file mode 100755
index 000000000..ebe477fe7
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderProtocol.h
@@ -0,0 +1,34 @@
+//
+// SPUDownloaderProtocol.h
+// PersistentDownloader
+//
+// Created by Mayur Pawashe on 4/1/16.
+// Copyright © 2016 Sparkle Project. All rights reserved.
+//
+
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class SPUURLRequest;
+
+// The protocol that this service will vend as its API. This header file will also need to be visible to the process hosting the service.
+@protocol SPUDownloaderProtocol
+
+- (void)startPersistentDownloadWithRequest:(SPUURLRequest *)request bundleIdentifier:(NSString *)bundleIdentifier desiredFilename:(NSString *)desiredFilename;
+
+- (void)startTemporaryDownloadWithRequest:(SPUURLRequest *)request;
+
+- (void)downloadDidFinish;
+
+- (void)cleanup;
+
+- (void)cancel;
+
+@end
+
+NS_ASSUME_NONNULL_END
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderSession.h b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderSession.h
new file mode 100644
index 000000000..4bde75aac
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SPUDownloaderSession.h
@@ -0,0 +1,20 @@
+//
+// SPUDownloaderSession.h
+// Sparkle
+//
+// Created by Deadpikle on 12/20/17.
+// Copyright © 2017 Sparkle Project. All rights reserved.
+//
+
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
+#import "SPUDownloader.h"
+#import "SPUDownloaderProtocol.h"
+
+NS_CLASS_AVAILABLE(NSURLSESSION_AVAILABLE, 7_0)
+@interface SPUDownloaderSession : SPUDownloader <SPUDownloaderProtocol>
+
+@end
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SPUURLRequest.h b/macosx/Sparkle.framework/Versions/A/Headers/SPUURLRequest.h
new file mode 100755
index 000000000..694961470
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SPUURLRequest.h
@@ -0,0 +1,35 @@
+//
+// SPUURLRequest.h
+// Sparkle
+//
+// Created by Mayur Pawashe on 5/19/16.
+// Copyright © 2016 Sparkle Project. All rights reserved.
+//
+
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+// A class that wraps NSURLRequest and implements NSSecureCoding
+// This class exists because NSURLRequest did not support NSSecureCoding in macOS 10.8
+// I have not verified if NSURLRequest in 10.9 implements NSSecureCoding or not
+@interface SPUURLRequest : NSObject <NSSecureCoding>
+
+// Creates a new URL request
+// Only these properties are currently tracked:
+// * URL
+// * Cache policy
+// * Timeout interval
+// * HTTP header fields
+// * networkServiceType
++ (instancetype)URLRequestWithRequest:(NSURLRequest *)request;
+
+@property (nonatomic, readonly) NSURLRequest *request;
+
+@end
+
+NS_ASSUME_NONNULL_END
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SUAppcast.h b/macosx/Sparkle.framework/Versions/A/Headers/SUAppcast.h
index 8f3efc8e8..f2f433895 100644
--- a/macosx/Sparkle.framework/Versions/A/Headers/SUAppcast.h
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SUAppcast.h
@@ -9,18 +9,32 @@
#ifndef SUAPPCAST_H
#define SUAPPCAST_H
+#if __has_feature(modules)
+@import Foundation;
+#else
#import <Foundation/Foundation.h>
+#endif
#import "SUExport.h"
+NS_ASSUME_NONNULL_BEGIN
+
@class SUAppcastItem;
-SU_EXPORT @interface SUAppcast : NSObject<NSURLDownloadDelegate>
+SU_EXPORT @interface SUAppcast : NSObject
-@property (copy) NSString *userAgentString;
-@property (copy) NSDictionary *httpHeaders;
+@property (copy, nullable) NSString *userAgentString;
-- (void)fetchAppcastFromURL:(NSURL *)url completionBlock:(void (^)(NSError *))err;
+#if __has_feature(objc_generics)
+@property (copy, nullable) NSDictionary<NSString *, NSString *> *httpHeaders;
+#else
+@property (copy, nullable) NSDictionary *httpHeaders;
+#endif
-@property (readonly, copy) NSArray *items;
+- (void)fetchAppcastFromURL:(NSURL *)url inBackground:(BOOL)bg completionBlock:(void (^)(NSError *_Nullable))err;
+- (SUAppcast *)copyWithoutDeltaUpdates;
+
+@property (readonly, copy, nullable) NSArray *items;
@end
+NS_ASSUME_NONNULL_END
+
#endif
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SUAppcastItem.h b/macosx/Sparkle.framework/Versions/A/Headers/SUAppcastItem.h
index 86843bfb7..5c861ddd8 100644
--- a/macosx/Sparkle.framework/Versions/A/Headers/SUAppcastItem.h
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SUAppcastItem.h
@@ -9,19 +9,25 @@
#ifndef SUAPPCASTITEM_H
#define SUAPPCASTITEM_H
+#if __has_feature(modules)
+@import Foundation;
+#else
#import <Foundation/Foundation.h>
+#endif
#import "SUExport.h"
SU_EXPORT @interface SUAppcastItem : NSObject
@property (copy, readonly) NSString *title;
-@property (copy, readonly) NSDate *date;
+@property (copy, readonly) NSString *dateString;
@property (copy, readonly) NSString *itemDescription;
@property (strong, readonly) NSURL *releaseNotesURL;
@property (copy, readonly) NSString *DSASignature;
@property (copy, readonly) NSString *minimumSystemVersion;
@property (copy, readonly) NSString *maximumSystemVersion;
@property (strong, readonly) NSURL *fileURL;
+@property (nonatomic, readonly) uint64_t contentLength;
@property (copy, readonly) NSString *versionString;
+@property (copy, readonly) NSString *osString;
@property (copy, readonly) NSString *displayVersionString;
@property (copy, readonly) NSDictionary *deltaUpdates;
@property (strong, readonly) NSURL *infoURL;
@@ -32,6 +38,7 @@ SU_EXPORT @interface SUAppcastItem : NSObject
@property (getter=isDeltaUpdate, readonly) BOOL deltaUpdate;
@property (getter=isCriticalUpdate, readonly) BOOL criticalUpdate;
+@property (getter=isMacOsUpdate, readonly) BOOL macOsUpdate;
@property (getter=isInformationOnlyUpdate, readonly) BOOL informationOnlyUpdate;
// Returns the dictionary provided in initWithDictionary; this might be useful later for extensions.
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SUErrors.h b/macosx/Sparkle.framework/Versions/A/Headers/SUErrors.h
index d73aadbae..7d2e73ae9 100644
--- a/macosx/Sparkle.framework/Versions/A/Headers/SUErrors.h
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SUErrors.h
@@ -9,7 +9,11 @@
#ifndef SUERRORS_H
#define SUERRORS_H
+#if __has_feature(modules)
+@import Foundation;
+#else
#import <Foundation/Foundation.h>
+#endif
#import "SUExport.h"
/**
@@ -17,16 +21,19 @@
*/
SU_EXPORT extern NSString *const SUSparkleErrorDomain;
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wc++98-compat"
typedef NS_ENUM(OSStatus, SUError) {
// Appcast phase errors.
SUAppcastParseError = 1000,
SUNoUpdateError = 1001,
SUAppcastError = 1002,
SURunningFromDiskImageError = 1003,
-
- // Downlaod phase errors.
+
+ // Download phase errors.
SUTemporaryDirectoryError = 2000,
-
+ SUDownloadError = 2001,
+
// Extraction phase errors.
SUUnarchivingError = 3000,
SUSignatureError = 3001,
@@ -39,9 +46,11 @@ typedef NS_ENUM(OSStatus, SUError) {
SURelaunchError = 4004,
SUInstallationError = 4005,
SUDowngradeError = 4006,
+ SUInstallationCancelledError = 4007,
// System phase errors
SUSystemPowerOffError = 5000
};
+#pragma clang diagnostic pop
#endif
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SUStandardVersionComparator.h b/macosx/Sparkle.framework/Versions/A/Headers/SUStandardVersionComparator.h
index d7f2a48cf..ed11921a5 100644
--- a/macosx/Sparkle.framework/Versions/A/Headers/SUStandardVersionComparator.h
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SUStandardVersionComparator.h
@@ -9,10 +9,16 @@
#ifndef SUSTANDARDVERSIONCOMPARATOR_H
#define SUSTANDARDVERSIONCOMPARATOR_H
+#if __has_feature(modules)
+@import Foundation;
+#else
#import <Foundation/Foundation.h>
+#endif
#import "SUExport.h"
#import "SUVersionComparisonProtocol.h"
+NS_ASSUME_NONNULL_BEGIN
+
/*!
Sparkle's default version comparator.
@@ -23,7 +29,14 @@
SU_EXPORT @interface SUStandardVersionComparator : NSObject <SUVersionComparison>
/*!
+ Initializes a new instance of the standard version comparator.
+ */
+- (instancetype)init;
+
+/*!
Returns a singleton instance of the comparator.
+
+ It is usually preferred to alloc/init new a comparator instead.
*/
+ (SUStandardVersionComparator *)defaultComparator;
@@ -35,4 +48,5 @@ SU_EXPORT @interface SUStandardVersionComparator : NSObject <SUVersionComparison
- (NSComparisonResult)compareVersion:(NSString *)versionA toVersion:(NSString *)versionB;
@end
+NS_ASSUME_NONNULL_END
#endif
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SUUpdater.h b/macosx/Sparkle.framework/Versions/A/Headers/SUUpdater.h
index a0ff707e7..a47447559 100644
--- a/macosx/Sparkle.framework/Versions/A/Headers/SUUpdater.h
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SUUpdater.h
@@ -9,355 +9,226 @@
#ifndef SUUPDATER_H
#define SUUPDATER_H
-#import <Foundation/Foundation.h>
+#if __has_feature(modules)
+@import Cocoa;
+#else
+#import <Cocoa/Cocoa.h>
+#endif
#import "SUExport.h"
#import "SUVersionComparisonProtocol.h"
#import "SUVersionDisplayProtocol.h"
-@class SUUpdateDriver, SUAppcastItem, SUHost, SUAppcast;
+@class SUAppcastItem, SUAppcast;
@protocol SUUpdaterDelegate;
/*!
The main API in Sparkle for controlling the update mechanism.
- This class is used to configure the update parameters as well as manually
+ This class is used to configure the update paramters as well as manually
and automatically schedule and control checks for updates.
*/
SU_EXPORT @interface SUUpdater : NSObject
@property (unsafe_unretained) IBOutlet id<SUUpdaterDelegate> delegate;
-+ (SUUpdater *)sharedUpdater;
-+ (SUUpdater *)updaterForBundle:(NSBundle *)bundle;
-- (instancetype)initForBundle:(NSBundle *)bundle;
-
-@property (readonly, strong) NSBundle *hostBundle;
-@property (strong, readonly) NSBundle *sparkleBundle;
-
-@property BOOL automaticallyChecksForUpdates;
-
-@property NSTimeInterval updateCheckInterval;
-
-/*!
- * The URL of the appcast used to download update information.
- *
- * This property must be called on the main thread.
- */
-@property (copy) NSURL *feedURL;
-
-@property (nonatomic, copy) NSString *userAgentString;
-
-@property (copy) NSDictionary *httpHeaders;
-
-@property BOOL sendsSystemProfile;
-
-@property BOOL automaticallyDownloadsUpdates;
-
-/*!
- Explicitly checks for updates and displays a progress dialog while doing so.
-
- This method is meant for a main menu item.
- Connect any menu item to this action in Interface Builder,
- and Sparkle will check for updates and report back its findings verbosely
- when it is invoked.
- */
-- (IBAction)checkForUpdates:(id)sender;
-
-/*!
- Checks for updates, but does not display any UI unless an update is found.
-
- This is meant for programmatically initating a check for updates. That is,
- it will display no UI unless it actually finds an update, in which case it
- proceeds as usual.
-
- If the fully automated updating is turned on, however, this will invoke that
- behavior, and if an update is found, it will be downloaded and prepped for
- installation.
- */
-- (void)checkForUpdatesInBackground;
-
-/*!
- Checks for updates and, if available, immediately downloads and installs them.
- A progress dialog is shown but the user will never be prompted to read the
- release notes.
-
- You may want to respond to the userDidCancelDownload delegate method in case
- the user clicks the "Cancel" button while the update is downloading.
- */
-- (void)installUpdatesIfAvailable;
-
-/*!
- Returns the date of last update check.
-
- \returns \c nil if no check has been performed.
- */
-@property (readonly, copy) NSDate *lastUpdateCheckDate;
-
/*!
- Begins a "probing" check for updates which will not actually offer to
- update to that version.
-
- However, the delegate methods
- SUUpdaterDelegate::updater:didFindValidUpdate: and
- SUUpdaterDelegate::updaterDidNotFindUpdate: will be called,
- so you can use that information in your UI.
+ The shared updater for the main bundle.
+
+ This is equivalent to passing [NSBundle mainBundle] to SUUpdater::updaterForBundle:
*/
-- (void)checkForUpdateInformation;
++ (SUUpdater *)sharedUpdater;
/*!
- Appropriately schedules or cancels the update checking timer according to
- the preferences for time interval and automatic checks.
+ The shared updater for a specified bundle.
- This call does not change the date of the next check,
- but only the internal NSTimer.
+ If an updater has already been initialized for the provided bundle, that shared instance will be returned.
*/
-- (void)resetUpdateCycle;
-
-@property (readonly) BOOL updateInProgress;
-
-@end
-
-// -----------------------------------------------------------------------------
-// SUUpdater Notifications for events that might be interesting to more than just the delegate
-// The updater will be the notification object
-// -----------------------------------------------------------------------------
-SU_EXPORT extern NSString *const SUUpdaterDidFinishLoadingAppCastNotification;
-SU_EXPORT extern NSString *const SUUpdaterDidFindValidUpdateNotification;
-SU_EXPORT extern NSString *const SUUpdaterDidNotFindUpdateNotification;
-SU_EXPORT extern NSString *const SUUpdaterWillRestartNotification;
-#define SUUpdaterWillRelaunchApplicationNotification SUUpdaterWillRestartNotification;
-#define SUUpdaterWillInstallUpdateNotification SUUpdaterWillRestartNotification;
-
-// Key for the SUAppcastItem object in the SUUpdaterDidFindValidUpdateNotification userInfo
-SU_EXPORT extern NSString *const SUUpdaterAppcastItemNotificationKey;
-// Key for the SUAppcast object in the SUUpdaterDidFinishLoadingAppCastNotification userInfo
-SU_EXPORT extern NSString *const SUUpdaterAppcastNotificationKey;
-
-// -----------------------------------------------------------------------------
-// SUUpdater Delegate:
-// -----------------------------------------------------------------------------
++ (SUUpdater *)updaterForBundle:(NSBundle *)bundle;
/*!
- Provides methods to control the behavior of an SUUpdater object.
+ Designated initializer for SUUpdater.
+
+ If an updater has already been initialized for the provided bundle, that shared instance will be returned.
*/
-@protocol SUUpdaterDelegate <NSObject>
-@optional
+- (instancetype)initForBundle:(NSBundle *)bundle;
/*!
- Returns whether to allow Sparkle to pop up.
+ Explicitly checks for updates and displays a progress dialog while doing so.
- For example, this may be used to prevent Sparkle from interrupting a setup assistant.
+ This method is meant for a main menu item.
+ Connect any menu item to this action in Interface Builder,
+ and Sparkle will check for updates and report back its findings verbosely
+ when it is invoked.
- \param updater The SUUpdater instance.
+ This will find updates that the user has opted into skipping.
*/
-- (BOOL)updaterMayCheckForUpdates:(SUUpdater *)updater;
+- (IBAction)checkForUpdates:(id)sender;
/*!
- Returns additional parameters to append to the appcast URL's query string.
-
- This is potentially based on whether or not Sparkle will also be sending along the system profile.
-
- \param updater The SUUpdater instance.
- \param sendingProfile Whether the system profile will also be sent.
-
- \return An array of dictionaries with keys: "key", "value", "displayKey", "displayValue", the latter two being specifically for display to the user.
+ The menu item validation used for the -checkForUpdates: action
*/
-- (NSArray *)feedParametersForUpdater:(SUUpdater *)updater sendingSystemProfile:(BOOL)sendingProfile;
+- (BOOL)validateMenuItem:(NSMenuItem *)menuItem;
/*!
- Returns a custom appcast URL.
-
- Override this to dynamically specify the entire URL.
+ Checks for updates, but does not display any UI unless an update is found.
- \param updater The SUUpdater instance.
- */
-- (NSString *)feedURLStringForUpdater:(SUUpdater *)updater;
+ This is meant for programmatically initating a check for updates. That is,
+ it will display no UI unless it actually finds an update, in which case it
+ proceeds as usual.
-/*!
- Returns whether Sparkle should prompt the user about automatic update checks.
+ If automatic downloading of updates it turned on and allowed, however,
+ this will invoke that behavior, and if an update is found, it will be downloaded
+ in the background silently and will be prepped for installation.
- Use this to override the default behavior.
-
- \param updater The SUUpdater instance.
+ This will not find updates that the user has opted into skipping.
*/
-- (BOOL)updaterShouldPromptForPermissionToCheckForUpdates:(SUUpdater *)updater;
+- (void)checkForUpdatesInBackground;
/*!
- Called after Sparkle has downloaded the appcast from the remote server.
-
- Implement this if you want to do some special handling with the appcast once it finishes loading.
+ A property indicating whether or not to check for updates automatically.
- \param updater The SUUpdater instance.
- \param appcast The appcast that was downloaded from the remote server.
+ Setting this property will persist in the host bundle's user defaults.
+ The update schedule cycle will be reset in a short delay after the property's new value is set.
+ This is to allow reverting this property without kicking off a schedule change immediately
*/
-- (void)updater:(SUUpdater *)updater didFinishLoadingAppcast:(SUAppcast *)appcast;
+@property BOOL automaticallyChecksForUpdates;
/*!
- Returns the item in the appcast corresponding to the update that should be installed.
+ A property indicating whether or not updates can be automatically downloaded in the background.
- If you're using special logic or extensions in your appcast,
- implement this to use your own logic for finding a valid update, if any,
- in the given appcast.
+ Note that automatic downloading of updates can be disallowed by the developer
+ or by the user's system if silent updates cannot be done (eg: if they require authentication).
+ In this case, -automaticallyDownloadsUpdates will return NO regardless of how this property is set.
- \param appcast The appcast that was downloaded from the remote server.
- \param updater The SUUpdater instance.
+ Setting this property will persist in the host bundle's user defaults.
*/
-- (SUAppcastItem *)bestValidUpdateInAppcast:(SUAppcast *)appcast forUpdater:(SUUpdater *)updater;
+@property BOOL automaticallyDownloadsUpdates;
/*!
- Called when a valid update is found by the update driver.
+ A property indicating the current automatic update check interval.
- \param updater The SUUpdater instance.
- \param item The appcast item corresponding to the update that is proposed to be installed.
+ Setting this property will persist in the host bundle's user defaults.
+ The update schedule cycle will be reset in a short delay after the property's new value is set.
+ This is to allow reverting this property without kicking off a schedule change immediately
*/
-- (void)updater:(SUUpdater *)updater didFindValidUpdate:(SUAppcastItem *)item;
+@property NSTimeInterval updateCheckInterval;
/*!
- Called when a valid update is not found.
-
- \param updater The SUUpdater instance.
- */
-- (void)updaterDidNotFindUpdate:(SUUpdater *)updater;
+ Begins a "probing" check for updates which will not actually offer to
+ update to that version.
-/*!
- Called immediately before downloading the specified update.
+ However, the delegate methods
+ SUUpdaterDelegate::updater:didFindValidUpdate: and
+ SUUpdaterDelegate::updaterDidNotFindUpdate: will be called,
+ so you can use that information in your UI.
- \param updater The SUUpdater instance.
- \param item The appcast item corresponding to the update that is proposed to be downloaded.
- \param request The mutable URL request that will be used to download the update.
+ Updates that have been skipped by the user will not be found.
*/
-- (void)updater:(SUUpdater *)updater willDownloadUpdate:(SUAppcastItem *)item withRequest:(NSMutableURLRequest *)request;
+- (void)checkForUpdateInformation;
/*!
- Called after the specified update failed to download.
+ The URL of the appcast used to download update information.
- \param updater The SUUpdater instance.
- \param item The appcast item corresponding to the update that failed to download.
- \param error The error generated by the failed download.
- */
-- (void)updater:(SUUpdater *)updater failedToDownloadUpdate:(SUAppcastItem *)item error:(NSError *)error;
+ Setting this property will persist in the host bundle's user defaults.
+ If you don't want persistence, you may want to consider instead implementing
+ SUUpdaterDelegate::feedURLStringForUpdater: or SUUpdaterDelegate::feedParametersForUpdater:sendingSystemProfile:
-/*!
- Called when the user clicks the cancel button while and update is being downloaded.
-
- \param updater The SUUpdater instance.
+ This property must be called on the main thread.
*/
-- (void)userDidCancelDownload:(SUUpdater *)updater;
+@property (copy) NSURL *feedURL;
/*!
- Called immediately before installing the specified update.
-
- \param updater The SUUpdater instance.
- \param item The appcast item corresponding to the update that is proposed to be installed.
+ The host bundle that is being updated.
*/
-- (void)updater:(SUUpdater *)updater willInstallUpdate:(SUAppcastItem *)item;
+@property (readonly, strong) NSBundle *hostBundle;
/*!
- Returns whether the relaunch should be delayed in order to perform other tasks.
-
- This is not called if the user didn't relaunch on the previous update,
- in that case it will immediately restart.
-
- \param updater The SUUpdater instance.
- \param item The appcast item corresponding to the update that is proposed to be installed.
- \param invocation The invocation that must be completed before continuing with the relaunch.
-
- \return \c YES to delay the relaunch until \p invocation is invoked.
+ The bundle this class (SUUpdater) is loaded into.
*/
-- (BOOL)updater:(SUUpdater *)updater shouldPostponeRelaunchForUpdate:(SUAppcastItem *)item untilInvoking:(NSInvocation *)invocation;
+@property (strong, readonly) NSBundle *sparkleBundle;
/*!
- Returns whether the application should be relaunched at all.
+ The user agent used when checking for updates.
- Some apps \b cannot be relaunched under certain circumstances.
- This method can be used to explicitly prevent a relaunch.
-
- \param updater The SUUpdater instance.
+ The default implementation can be overrided.
*/
-- (BOOL)updaterShouldRelaunchApplication:(SUUpdater *)updater;
+@property (nonatomic, copy) NSString *userAgentString;
/*!
- Called immediately before relaunching.
+ The HTTP headers used when checking for updates.
- \param updater The SUUpdater instance.
+ The keys of this dictionary are HTTP header fields (NSString) and values are corresponding values (NSString)
*/
-- (void)updaterWillRelaunchApplication:(SUUpdater *)updater;
+#if __has_feature(objc_generics)
+@property (copy) NSDictionary<NSString *, NSString *> *httpHeaders;
+#else
+@property (copy) NSDictionary *httpHeaders;
+#endif
/*!
- Returns an object that compares version numbers to determine their arithmetic relation to each other.
-
- This method allows you to provide a custom version comparator.
- If you don't implement this method or return \c nil,
- the standard version comparator will be used.
-
- \sa SUStandardVersionComparator
+ A property indicating whether or not the user's system profile information is sent when checking for updates.
- \param updater The SUUpdater instance.
+ Setting this property will persist in the host bundle's user defaults.
*/
-- (id<SUVersionComparison>)versionComparatorForUpdater:(SUUpdater *)updater;
+@property BOOL sendsSystemProfile;
/*!
- Returns an object that formats version numbers for display to the user.
-
- If you don't implement this method or return \c nil,
- the standard version formatter will be used.
-
- \sa SUUpdateAlert
-
- \param updater The SUUpdater instance.
+ A property indicating the decryption password used for extracting updates shipped as Apple Disk Images (dmg)
*/
-- (id<SUVersionDisplay>)versionDisplayerForUpdater:(SUUpdater *)updater;
+@property (nonatomic, copy) NSString *decryptionPassword;
/*!
- Returns the path which is used to relaunch the client after the update is installed.
+ This function ignores normal update schedule, ignores user preferences,
+ and interrupts users with an unwanted immediate app update.
- The default is the path of the host bundle.
+ WARNING: this function should not be used in regular apps. This function
+ is a user-unfriendly hack only for very special cases, like unstable
+ rapidly-changing beta builds that would not run correctly if they were
+ even one day out of date.
- \param updater The SUUpdater instance.
- */
-- (NSString *)pathToRelaunchForUpdater:(SUUpdater *)updater;
+ Instead of this function you should set `SUAutomaticallyUpdate` to `YES`,
+ which will gracefully install updates when the app quits.
-/*!
- Called before an updater shows a modal alert window,
- to give the host the opportunity to hide attached windows that may get in the way.
+ For UI-less/daemon apps that aren't usually quit, instead of this function,
+ you can use the delegate method
+ SUUpdaterDelegate::updater:willInstallUpdateOnQuit:immediateInstallationInvocation:
+ to immediately start installation when an update was found.
- \param updater The SUUpdater instance.
- */
-- (void)updaterWillShowModalAlert:(SUUpdater *)updater;
+ A progress dialog is shown but the user will never be prompted to read the
+ release notes.
-/*!
- Called after an updater shows a modal alert window,
- to give the host the opportunity to hide attached windows that may get in the way.
+ This function will cause update to be downloaded twice if automatic updates are
+ enabled.
- \param updater The SUUpdater instance.
+ You may want to respond to the userDidCancelDownload delegate method in case
+ the user clicks the "Cancel" button while the update is downloading.
*/
-- (void)updaterDidShowModalAlert:(SUUpdater *)updater;
+- (void)installUpdatesIfAvailable;
/*!
- Called when an update is scheduled to be silently installed on quit.
+ Returns the date of last update check.
- \param updater The SUUpdater instance.
- \param item The appcast item corresponding to the update that is proposed to be installed.
- \param invocation Can be used to trigger an immediate silent install and relaunch.
+ \returns \c nil if no check has been performed.
*/
-- (void)updater:(SUUpdater *)updater willInstallUpdateOnQuit:(SUAppcastItem *)item immediateInstallationInvocation:(NSInvocation *)invocation;
+@property (readonly, copy) NSDate *lastUpdateCheckDate;
/*!
- Calls after an update that was scheduled to be silently installed on quit has been canceled.
+ Appropriately schedules or cancels the update checking timer according to
+ the preferences for time interval and automatic checks.
- \param updater The SUUpdater instance.
- \param item The appcast item corresponding to the update that was proposed to be installed.
+ This call does not change the date of the next check,
+ but only the internal NSTimer.
*/
-- (void)updater:(SUUpdater *)updater didCancelInstallUpdateOnQuit:(SUAppcastItem *)item;
+- (void)resetUpdateCycle;
/*!
- Called after an update is aborted due to an error.
+ A property indicating whether or not an update is in progress.
- \param updater The SUUpdater instance.
- \param error The error that caused the abort
+ Note this property is not indicative of whether or not user initiated updates can be performed.
+ Use SUUpdater::validateMenuItem: for that instead.
*/
-- (void)updater:(SUUpdater *)updater didAbortWithError:(NSError *)error;
+@property (readonly) BOOL updateInProgress;
@end
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SUUpdaterDelegate.h b/macosx/Sparkle.framework/Versions/A/Headers/SUUpdaterDelegate.h
new file mode 100644
index 000000000..dbc140240
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SUUpdaterDelegate.h
@@ -0,0 +1,281 @@
+//
+// SUUpdaterDelegate.h
+// Sparkle
+//
+// Created by Mayur Pawashe on 12/25/16.
+// Copyright © 2016 Sparkle Project. All rights reserved.
+//
+
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
+
+#import "SUExport.h"
+
+@protocol SUVersionComparison, SUVersionDisplay;
+@class SUUpdater, SUAppcast, SUAppcastItem;
+
+NS_ASSUME_NONNULL_BEGIN
+
+// -----------------------------------------------------------------------------
+// SUUpdater Notifications for events that might be interesting to more than just the delegate
+// The updater will be the notification object
+// -----------------------------------------------------------------------------
+SU_EXPORT extern NSString *const SUUpdaterDidFinishLoadingAppCastNotification;
+SU_EXPORT extern NSString *const SUUpdaterDidFindValidUpdateNotification;
+SU_EXPORT extern NSString *const SUUpdaterDidNotFindUpdateNotification;
+SU_EXPORT extern NSString *const SUUpdaterWillRestartNotification;
+#define SUUpdaterWillRelaunchApplicationNotification SUUpdaterWillRestartNotification;
+#define SUUpdaterWillInstallUpdateNotification SUUpdaterWillRestartNotification;
+
+// Key for the SUAppcastItem object in the SUUpdaterDidFindValidUpdateNotification userInfo
+SU_EXPORT extern NSString *const SUUpdaterAppcastItemNotificationKey;
+// Key for the SUAppcast object in the SUUpdaterDidFinishLoadingAppCastNotification userInfo
+SU_EXPORT extern NSString *const SUUpdaterAppcastNotificationKey;
+
+// -----------------------------------------------------------------------------
+// SUUpdater Delegate:
+// -----------------------------------------------------------------------------
+
+/*!
+ Provides methods to control the behavior of an SUUpdater object.
+ */
+@protocol SUUpdaterDelegate <NSObject>
+@optional
+
+/*!
+ Returns whether to allow Sparkle to pop up.
+
+ For example, this may be used to prevent Sparkle from interrupting a setup assistant.
+
+ \param updater The SUUpdater instance.
+ */
+- (BOOL)updaterMayCheckForUpdates:(SUUpdater *)updater;
+
+/*!
+ Returns additional parameters to append to the appcast URL's query string.
+
+ This is potentially based on whether or not Sparkle will also be sending along the system profile.
+
+ \param updater The SUUpdater instance.
+ \param sendingProfile Whether the system profile will also be sent.
+
+ \return An array of dictionaries with keys: "key", "value", "displayKey", "displayValue", the latter two being specifically for display to the user.
+ */
+#if __has_feature(objc_generics)
+- (NSArray<NSDictionary<NSString *, NSString *> *> *)feedParametersForUpdater:(SUUpdater *)updater sendingSystemProfile:(BOOL)sendingProfile;
+#else
+- (NSArray *)feedParametersForUpdater:(SUUpdater *)updater sendingSystemProfile:(BOOL)sendingProfile;
+#endif
+
+/*!
+ Returns a custom appcast URL.
+
+ Override this to dynamically specify the entire URL.
+
+ An alternative may be to use SUUpdaterDelegate::feedParametersForUpdater:sendingSystemProfile:
+ and let the server handle what kind of feed to provide.
+
+ \param updater The SUUpdater instance.
+ */
+- (nullable NSString *)feedURLStringForUpdater:(SUUpdater *)updater;
+
+/*!
+ Returns whether Sparkle should prompt the user about automatic update checks.
+
+ Use this to override the default behavior.
+
+ \param updater The SUUpdater instance.
+ */
+- (BOOL)updaterShouldPromptForPermissionToCheckForUpdates:(SUUpdater *)updater;
+
+/*!
+ Called after Sparkle has downloaded the appcast from the remote server.
+
+ Implement this if you want to do some special handling with the appcast once it finishes loading.
+
+ \param updater The SUUpdater instance.
+ \param appcast The appcast that was downloaded from the remote server.
+ */
+- (void)updater:(SUUpdater *)updater didFinishLoadingAppcast:(SUAppcast *)appcast;
+
+/*!
+ Returns the item in the appcast corresponding to the update that should be installed.
+
+ If you're using special logic or extensions in your appcast,
+ implement this to use your own logic for finding a valid update, if any,
+ in the given appcast.
+
+ \param appcast The appcast that was downloaded from the remote server.
+ \param updater The SUUpdater instance.
+ */
+- (nullable SUAppcastItem *)bestValidUpdateInAppcast:(SUAppcast *)appcast forUpdater:(SUUpdater *)updater;
+
+/*!
+ Called when a valid update is found by the update driver.
+
+ \param updater The SUUpdater instance.
+ \param item The appcast item corresponding to the update that is proposed to be installed.
+ */
+- (void)updater:(SUUpdater *)updater didFindValidUpdate:(SUAppcastItem *)item;
+
+/*!
+ Called when a valid update is not found.
+
+ \param updater The SUUpdater instance.
+ */
+- (void)updaterDidNotFindUpdate:(SUUpdater *)updater;
+
+/*!
+ Called immediately before downloading the specified update.
+
+ \param updater The SUUpdater instance.
+ \param item The appcast item corresponding to the update that is proposed to be downloaded.
+ \param request The mutable URL request that will be used to download the update.
+ */
+- (void)updater:(SUUpdater *)updater willDownloadUpdate:(SUAppcastItem *)item withRequest:(NSMutableURLRequest *)request;
+
+/*!
+ Called after the specified update failed to download.
+
+ \param updater The SUUpdater instance.
+ \param item The appcast item corresponding to the update that failed to download.
+ \param error The error generated by the failed download.
+ */
+- (void)updater:(SUUpdater *)updater failedToDownloadUpdate:(SUAppcastItem *)item error:(NSError *)error;
+
+/*!
+ Called when the user clicks the cancel button while and update is being downloaded.
+
+ \param updater The SUUpdater instance.
+ */
+- (void)userDidCancelDownload:(SUUpdater *)updater;
+
+/*!
+ Called immediately before installing the specified update.
+
+ \param updater The SUUpdater instance.
+ \param item The appcast item corresponding to the update that is proposed to be installed.
+ */
+- (void)updater:(SUUpdater *)updater willInstallUpdate:(SUAppcastItem *)item;
+
+/*!
+ Returns whether the relaunch should be delayed in order to perform other tasks.
+
+ This is not called if the user didn't relaunch on the previous update,
+ in that case it will immediately restart.
+
+ \param updater The SUUpdater instance.
+ \param item The appcast item corresponding to the update that is proposed to be installed.
+ \param invocation The invocation that must be completed with `[invocation invoke]` before continuing with the relaunch.
+
+ \return \c YES to delay the relaunch until \p invocation is invoked.
+ */
+- (BOOL)updater:(SUUpdater *)updater shouldPostponeRelaunchForUpdate:(SUAppcastItem *)item untilInvoking:(NSInvocation *)invocation;
+
+/*!
+ Returns whether the application should be relaunched at all.
+
+ Some apps \b cannot be relaunched under certain circumstances.
+ This method can be used to explicitly prevent a relaunch.
+
+ \param updater The SUUpdater instance.
+ */
+- (BOOL)updaterShouldRelaunchApplication:(SUUpdater *)updater;
+
+/*!
+ Called immediately before relaunching.
+
+ \param updater The SUUpdater instance.
+ */
+- (void)updaterWillRelaunchApplication:(SUUpdater *)updater;
+
+/*!
+ Called immediately after relaunching. SUUpdater delegate must be set before applicationDidFinishLaunching: to catch this event.
+
+ \param updater The SUUpdater instance.
+ */
+- (void)updaterDidRelaunchApplication:(SUUpdater *)updater;
+
+/*!
+ Returns an object that compares version numbers to determine their arithmetic relation to each other.
+
+ This method allows you to provide a custom version comparator.
+ If you don't implement this method or return \c nil,
+ the standard version comparator will be used.
+
+ \sa SUStandardVersionComparator
+
+ \param updater The SUUpdater instance.
+ */
+- (nullable id<SUVersionComparison>)versionComparatorForUpdater:(SUUpdater *)updater;
+
+/*!
+ Returns an object that formats version numbers for display to the user.
+
+ If you don't implement this method or return \c nil,
+ the standard version formatter will be used.
+
+ \sa SUUpdateAlert
+
+ \param updater The SUUpdater instance.
+ */
+- (nullable id<SUVersionDisplay>)versionDisplayerForUpdater:(SUUpdater *)updater;
+
+/*!
+ Returns the path which is used to relaunch the client after the update is installed.
+
+ The default is the path of the host bundle.
+
+ \param updater The SUUpdater instance.
+ */
+- (nullable NSString *)pathToRelaunchForUpdater:(SUUpdater *)updater;
+
+/*!
+ Called before an updater shows a modal alert window,
+ to give the host the opportunity to hide attached windows that may get in the way.
+
+ \param updater The SUUpdater instance.
+ */
+- (void)updaterWillShowModalAlert:(SUUpdater *)updater;
+
+/*!
+ Called after an updater shows a modal alert window,
+ to give the host the opportunity to hide attached windows that may get in the way.
+
+ \param updater The SUUpdater instance.
+ */
+- (void)updaterDidShowModalAlert:(SUUpdater *)updater;
+
+/*!
+ Called when an update is scheduled to be silently installed on quit.
+ This is after an update has been automatically downloaded in the background.
+ (i.e. SUUpdater::automaticallyDownloadsUpdates is YES)
+
+ \param updater The SUUpdater instance.
+ \param item The appcast item corresponding to the update that is proposed to be installed.
+ \param invocation Can be used to trigger an immediate silent install and relaunch.
+ */
+- (void)updater:(SUUpdater *)updater willInstallUpdateOnQuit:(SUAppcastItem *)item immediateInstallationInvocation:(NSInvocation *)invocation;
+
+/*!
+ Calls after an update that was scheduled to be silently installed on quit has been canceled.
+
+ \param updater The SUUpdater instance.
+ \param item The appcast item corresponding to the update that was proposed to be installed.
+ */
+- (void)updater:(SUUpdater *)updater didCancelInstallUpdateOnQuit:(SUAppcastItem *)item;
+
+/*!
+ Called after an update is aborted due to an error.
+
+ \param updater The SUUpdater instance.
+ \param error The error that caused the abort
+ */
+- (void)updater:(SUUpdater *)updater didAbortWithError:(NSError *)error;
+
+@end
+
+NS_ASSUME_NONNULL_END
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SUVersionComparisonProtocol.h b/macosx/Sparkle.framework/Versions/A/Headers/SUVersionComparisonProtocol.h
index 10c426694..c654fc4d0 100644
--- a/macosx/Sparkle.framework/Versions/A/Headers/SUVersionComparisonProtocol.h
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SUVersionComparisonProtocol.h
@@ -9,9 +9,15 @@
#ifndef SUVERSIONCOMPARISONPROTOCOL_H
#define SUVERSIONCOMPARISONPROTOCOL_H
-#import <Cocoa/Cocoa.h>
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
#import "SUExport.h"
+NS_ASSUME_NONNULL_BEGIN
+
/*!
Provides version comparison facilities for Sparkle.
*/
@@ -27,4 +33,5 @@
@end
+NS_ASSUME_NONNULL_END
#endif
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/SUVersionDisplayProtocol.h b/macosx/Sparkle.framework/Versions/A/Headers/SUVersionDisplayProtocol.h
index 97fae4c90..980efb3fe 100644
--- a/macosx/Sparkle.framework/Versions/A/Headers/SUVersionDisplayProtocol.h
+++ b/macosx/Sparkle.framework/Versions/A/Headers/SUVersionDisplayProtocol.h
@@ -6,7 +6,11 @@
// Copyright 2009 Elgato Systems GmbH. All rights reserved.
//
-#import <Cocoa/Cocoa.h>
+#if __has_feature(modules)
+@import Foundation;
+#else
+#import <Foundation/Foundation.h>
+#endif
#import "SUExport.h"
/*!
@@ -20,6 +24,6 @@
Both versions are provided so that important distinguishing information
can be displayed while also leaving out unnecessary/confusing parts.
*/
-- (void)formatVersion:(NSString **)inOutVersionA andVersion:(NSString **)inOutVersionB;
+- (void)formatVersion:(NSString *_Nonnull*_Nonnull)inOutVersionA andVersion:(NSString *_Nonnull*_Nonnull)inOutVersionB;
@end
diff --git a/macosx/Sparkle.framework/Versions/A/Headers/Sparkle.h b/macosx/Sparkle.framework/Versions/A/Headers/Sparkle.h
index 20ed6979c..661b1312b 100644
--- a/macosx/Sparkle.framework/Versions/A/Headers/Sparkle.h
+++ b/macosx/Sparkle.framework/Versions/A/Headers/Sparkle.h
@@ -9,8 +9,6 @@
#ifndef SPARKLE_H
#define SPARKLE_H
-#import <Cocoa/Cocoa.h>
-
// This list should include the shared headers. It doesn't matter if some of them aren't shared (unless
// there are name-space collisions) so we can list all of them to start with:
@@ -18,8 +16,17 @@
#import "SUAppcastItem.h"
#import "SUStandardVersionComparator.h"
#import "SUUpdater.h"
+#import "SUUpdaterDelegate.h"
#import "SUVersionComparisonProtocol.h"
#import "SUVersionDisplayProtocol.h"
#import "SUErrors.h"
+#import "SPUDownloader.h"
+#import "SPUDownloaderDelegate.h"
+#import "SPUDownloaderDeprecated.h"
+#import "SPUDownloadData.h"
+#import "SPUDownloaderProtocol.h"
+#import "SPUDownloaderSession.h"
+#import "SPUURLRequest.h"
+
#endif
diff --git a/macosx/Sparkle.framework/Versions/A/PrivateHeaders/SUUnarchiver.h b/macosx/Sparkle.framework/Versions/A/PrivateHeaders/SUUnarchiver.h
index 6397fe71a..a52bf5a2d 100644
--- a/macosx/Sparkle.framework/Versions/A/PrivateHeaders/SUUnarchiver.h
+++ b/macosx/Sparkle.framework/Versions/A/PrivateHeaders/SUUnarchiver.h
@@ -6,30 +6,16 @@
// Copyright 2006 Andy Matuschak. All rights reserved.
//
-#ifndef SUUNARCHIVER_H
-#define SUUNARCHIVER_H
-
#import <Foundation/Foundation.h>
-@class SUHost;
-@protocol SUUnarchiverDelegate;
-
-@interface SUUnarchiver : NSObject
+NS_ASSUME_NONNULL_BEGIN
-@property (copy, readonly) NSString *archivePath;
-@property (copy, readonly) NSString *updateHostBundlePath;
-@property (weak) id<SUUnarchiverDelegate> delegate;
+@protocol SUUnarchiverProtocol;
-+ (SUUnarchiver *)unarchiverForPath:(NSString *)path updatingHostBundlePath:(NSString *)host;
+@interface SUUnarchiver : NSObject
-- (void)start;
-@end
++ (nullable id <SUUnarchiverProtocol>)unarchiverForPath:(NSString *)path updatingHostBundlePath:(nullable NSString *)hostPath decryptionPassword:(nullable NSString *)decryptionPassword;
-@protocol SUUnarchiverDelegate <NSObject>
-- (void)unarchiverDidFinish:(SUUnarchiver *)unarchiver;
-- (void)unarchiverDidFail:(SUUnarchiver *)unarchiver;
-@optional
-- (void)unarchiver:(SUUnarchiver *)unarchiver extractedProgress:(double)progress;
@end
-#endif
+NS_ASSUME_NONNULL_END
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Info.plist b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Info.plist
index 26a021222..9008e169a 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Info.plist
+++ b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Info.plist
@@ -3,13 +3,13 @@
<plist version="1.0">
<dict>
<key>BuildMachineOSBuild</key>
- <string>15E27e</string>
+ <string>17F35e</string>
<key>CFBundleDevelopmentRegion</key>
<string>English</string>
<key>CFBundleExecutable</key>
<string>Autoupdate</string>
<key>CFBundleIconFile</key>
- <string>AppIcon</string>
+ <string>AppIcon.icns</string>
<key>CFBundleIdentifier</key>
<string>org.sparkle-project.Sparkle.Autoupdate</string>
<key>CFBundleInfoDictionaryVersion</key>
@@ -17,7 +17,7 @@
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
- <string>1.13.1 git-2afc553</string>
+ <string>1.19.0</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>CFBundleSupportedPlatforms</key>
@@ -25,21 +25,21 @@
<string>MacOSX</string>
</array>
<key>CFBundleVersion</key>
- <string>1.13.1</string>
+ <string>1.19.0</string>
<key>DTCompiler</key>
<string>com.apple.compilers.llvm.clang.1_0</string>
<key>DTPlatformBuild</key>
- <string>7C68</string>
+ <string>9C34b</string>
<key>DTPlatformVersion</key>
<string>GM</string>
<key>DTSDKBuild</key>
- <string>15C43</string>
+ <string>17C67a</string>
<key>DTSDKName</key>
- <string>macosx10.11</string>
+ <string>macosx10.13</string>
<key>DTXcode</key>
- <string>0720</string>
+ <string>0920</string>
<key>DTXcodeBuild</key>
- <string>7C68</string>
+ <string>9C34b</string>
<key>LSBackgroundOnly</key>
<string>1</string>
<key>LSMinimumSystemVersion</key>
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/Autoupdate b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/Autoupdate
index 7caea3d5f..e252ce6bd 100755
--- a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/Autoupdate
+++ b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/Autoupdate
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/fileop b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/fileop
new file mode 100755
index 000000000..7ef8291eb
--- /dev/null
+++ b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/MacOS/fileop
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/AppIcon.icns b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/AppIcon.icns
index 75c7c379f..7f2a571c8 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/AppIcon.icns
+++ b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/AppIcon.icns
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/SUStatus.nib b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/SUStatus.nib
index 30f3c2c4d..d7904ddc2 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/SUStatus.nib
+++ b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/SUStatus.nib
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/en.lproj/Sparkle.strings b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/en.lproj/Sparkle.strings
index f427ad697..8c38dc674 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/en.lproj/Sparkle.strings
+++ b/macosx/Sparkle.framework/Versions/A/Resources/Autoupdate.app/Contents/Resources/en.lproj/Sparkle.strings
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/Info.plist b/macosx/Sparkle.framework/Versions/A/Resources/Info.plist
index aba6f8137..922de9dcf 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/Info.plist
+++ b/macosx/Sparkle.framework/Versions/A/Resources/Info.plist
@@ -3,7 +3,7 @@
<plist version="1.0">
<dict>
<key>BuildMachineOSBuild</key>
- <string>15E27e</string>
+ <string>17F35e</string>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
@@ -17,7 +17,7 @@
<key>CFBundlePackageType</key>
<string>FMWK</string>
<key>CFBundleShortVersionString</key>
- <string>1.13.1 git-2afc553</string>
+ <string>1.19.0</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>CFBundleSupportedPlatforms</key>
@@ -25,20 +25,20 @@
<string>MacOSX</string>
</array>
<key>CFBundleVersion</key>
- <string>1.13.1</string>
+ <string>1.19.0</string>
<key>DTCompiler</key>
<string>com.apple.compilers.llvm.clang.1_0</string>
<key>DTPlatformBuild</key>
- <string>7C68</string>
+ <string>9C34b</string>
<key>DTPlatformVersion</key>
<string>GM</string>
<key>DTSDKBuild</key>
- <string>15C43</string>
+ <string>17C67a</string>
<key>DTSDKName</key>
- <string>macosx10.11</string>
+ <string>macosx10.13</string>
<key>DTXcode</key>
- <string>0720</string>
+ <string>0920</string>
<key>DTXcodeBuild</key>
- <string>7C68</string>
+ <string>9C34b</string>
</dict>
</plist>
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/SUStatus.nib b/macosx/Sparkle.framework/Versions/A/Resources/SUStatus.nib
index 30f3c2c4d..d7904ddc2 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/SUStatus.nib
+++ b/macosx/Sparkle.framework/Versions/A/Resources/SUStatus.nib
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUAutomaticUpdateAlert.nib b/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUAutomaticUpdateAlert.nib
index df090b491..4236118ee 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUAutomaticUpdateAlert.nib
+++ b/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUAutomaticUpdateAlert.nib
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdateAlert.nib b/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdateAlert.nib
index 7ed264797..44ea780df 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdateAlert.nib
+++ b/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdateAlert.nib
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdatePermissionPrompt.nib b/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdatePermissionPrompt.nib
index 9c0c887c0..1dd0f7849 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdatePermissionPrompt.nib
+++ b/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/SUUpdatePermissionPrompt.nib
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/Sparkle.strings b/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/Sparkle.strings
index f427ad697..8c38dc674 100644
--- a/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/Sparkle.strings
+++ b/macosx/Sparkle.framework/Versions/A/Resources/en.lproj/Sparkle.strings
Binary files differ
diff --git a/macosx/Sparkle.framework/Versions/A/Sparkle b/macosx/Sparkle.framework/Versions/A/Sparkle
index 158a25923..6bbd14b15 100755
--- a/macosx/Sparkle.framework/Versions/A/Sparkle
+++ b/macosx/Sparkle.framework/Versions/A/Sparkle
Binary files differ