|
9 | 9 | #ifndef SUUPDATER_H |
10 | 10 | #define SUUPDATER_H |
11 | 11 |
|
12 | | -#import <Sparkle/SUVersionComparisonProtocol.h> |
| 12 | +#import "SUVersionComparisonProtocol.h" |
| 13 | +#import "SUVersionDisplayProtocol.h" |
13 | 14 |
|
14 | | -@class SUUpdateDriver, SUAppcastItem, SUHost, SUAppcast; |
15 | | -@interface SUUpdater : NSObject { |
| 15 | +@class SUUpdateDriver, SUAppcastItem, SUHost, SUAppcast, SUUpdateAlert; |
| 16 | + |
| 17 | +@interface SUUpdater : NSObject |
| 18 | +{ |
| 19 | +@private |
16 | 20 | NSTimer *checkTimer; |
17 | 21 | SUUpdateDriver *driver; |
18 | | - |
| 22 | + |
| 23 | + NSString *customUserAgentString; |
19 | 24 | SUHost *host; |
20 | 25 | IBOutlet id delegate; |
21 | 26 | } |
22 | 27 |
|
23 | 28 | + (SUUpdater *)sharedUpdater; |
24 | 29 | + (SUUpdater *)updaterForBundle:(NSBundle *)bundle; |
| 30 | +- (id)initForBundle:(NSBundle *)bundle; |
| 31 | + |
25 | 32 | - (NSBundle *)hostBundle; |
26 | 33 |
|
27 | 34 | - (void)setDelegate:(id)delegate; |
28 | | -- delegate; |
| 35 | +- (id)delegate; |
29 | 36 |
|
30 | 37 | - (void)setAutomaticallyChecksForUpdates:(BOOL)automaticallyChecks; |
31 | 38 | - (BOOL)automaticallyChecksForUpdates; |
|
34 | 41 | - (NSTimeInterval)updateCheckInterval; |
35 | 42 |
|
36 | 43 | - (void)setFeedURL:(NSURL *)feedURL; |
37 | | -- (NSURL *)feedURL; |
| 44 | +- (NSURL *)feedURL; // *** MUST BE CALLED ON MAIN THREAD *** |
| 45 | + |
| 46 | +- (void)setUserAgentString:(NSString *)userAgent; |
| 47 | +- (NSString *)userAgentString; |
38 | 48 |
|
39 | 49 | - (void)setSendsSystemProfile:(BOOL)sendsSystemProfile; |
40 | 50 | - (BOOL)sendsSystemProfile; |
|
44 | 54 |
|
45 | 55 | // This IBAction is meant for a main menu item. Hook up any menu item to this action, |
46 | 56 | // and Sparkle will check for updates and report back its findings verbosely. |
47 | | -- (IBAction)checkForUpdates:sender; |
| 57 | +- (IBAction)checkForUpdates:(id)sender; |
48 | 58 |
|
49 | 59 | // This kicks off an update meant to be programmatically initiated. That is, it will display no UI unless it actually finds an update, |
50 | 60 | // in which case it proceeds as usual. If the fully automated updating is turned on, however, this will invoke that behavior, and if an |
51 | 61 | // update is found, it will be downloaded and prepped for installation. |
52 | 62 | - (void)checkForUpdatesInBackground; |
53 | 63 |
|
54 | | -// Date of last update check. Returns null if no check has been performed. |
| 64 | +// Date of last update check. Returns nil if no check has been performed. |
55 | 65 | - (NSDate*)lastUpdateCheckDate; |
56 | 66 |
|
57 | 67 | // This begins a "probing" check for updates which will not actually offer to update to that version. The delegate methods, though, |
|
62 | 72 | - (void)resetUpdateCycle; |
63 | 73 |
|
64 | 74 | - (BOOL)updateInProgress; |
| 75 | + |
65 | 76 | @end |
66 | 77 |
|
| 78 | + |
| 79 | +// ----------------------------------------------------------------------------- |
| 80 | +// SUUpdater Delegate: |
| 81 | +// ----------------------------------------------------------------------------- |
| 82 | + |
67 | 83 | @interface NSObject (SUUpdaterDelegateInformalProtocol) |
| 84 | + |
| 85 | +// Use this to keep Sparkle from popping up e.g. while your setup assistant is showing: |
| 86 | +- (BOOL)updaterMayCheckForUpdates:(SUUpdater *)bundle; |
| 87 | + |
68 | 88 | // This method allows you to add extra parameters to the appcast URL, potentially based on whether or not Sparkle will also be sending along the system profile. This method should return an array of dictionaries with keys: "key", "value", "displayKey", "displayValue", the latter two being specifically for display to the user. |
69 | 89 | - (NSArray *)feedParametersForUpdater:(SUUpdater *)updater sendingSystemProfile:(BOOL)sendingProfile; |
70 | 90 |
|
| 91 | +// Override this to dynamically specify the entire URL. |
| 92 | +- (NSString*)feedURLStringForUpdater:(SUUpdater*)updater; |
| 93 | + |
71 | 94 | // Use this to override the default behavior for Sparkle prompting the user about automatic update checks. |
72 | 95 | - (BOOL)updaterShouldPromptForPermissionToCheckForUpdates:(SUUpdater *)bundle; |
73 | 96 |
|
|
88 | 111 | - (void)updater:(SUUpdater *)updater willInstallUpdate:(SUAppcastItem *)update; |
89 | 112 |
|
90 | 113 | // Return YES to delay the relaunch until you do some processing; invoke the given NSInvocation to continue. |
| 114 | +// This is not called if the user didn't relaunch on the previous update, in that case it will immediately |
| 115 | +// restart. |
91 | 116 | - (BOOL)updater:(SUUpdater *)updater shouldPostponeRelaunchForUpdate:(SUAppcastItem *)update untilInvoking:(NSInvocation *)invocation; |
92 | 117 |
|
| 118 | +// Some apps *can not* be relaunched in certain circumstances. They can use this method |
| 119 | +// to prevent a relaunch "hard": |
| 120 | +- (BOOL)updaterShouldRelaunchApplication:(SUUpdater *)updater; |
| 121 | + |
93 | 122 | // Called immediately before relaunching. |
94 | 123 | - (void)updaterWillRelaunchApplication:(SUUpdater *)updater; |
95 | 124 |
|
96 | 125 | // This method allows you to provide a custom version comparator. |
97 | 126 | // If you don't implement this method or return nil, the standard version comparator will be used. |
98 | 127 | - (id <SUVersionComparison>)versionComparatorForUpdater:(SUUpdater *)updater; |
99 | 128 |
|
| 129 | +// This method allows you to provide a custom version comparator. |
| 130 | +// If you don't implement this method or return nil, the standard version displayer will be used. |
| 131 | +- (id <SUVersionDisplay>)versionDisplayerForUpdater:(SUUpdater *)updater; |
| 132 | + |
100 | 133 | // Returns the path which is used to relaunch the client after the update is installed. By default, the path of the host bundle. |
101 | 134 | - (NSString *)pathToRelaunchForUpdater:(SUUpdater *)updater; |
102 | 135 |
|
| 136 | +// Called before and after, respectively, an updater shows a modal alert window, to give the host |
| 137 | +// the opportunity to hide attached windows etc. that may get in the way: |
| 138 | +-(void) updaterWillShowModalAlert:(SUUpdater *)updater; |
| 139 | +-(void) updaterDidShowModalAlert:(SUUpdater *)updater; |
| 140 | + |
| 141 | +// To resize the release notes view. |
| 142 | +- (void)updateAlert:(SUUpdateAlert *)updateAlert willShowReleaseNotesWithSize:(NSSize*)size; |
| 143 | + |
| 144 | +@end |
| 145 | + |
| 146 | +@protocol SUUserDefaults <NSObject> |
| 147 | +- (id)objectForKey:(NSString *)key; |
| 148 | +- (void)setObject:(id)value forKey:(NSString *)key; |
| 149 | +- (BOOL)boolForKey:(NSString *)key; |
| 150 | +- (void)setBool:(BOOL)value forKey:(NSString *)key; |
| 151 | +@end |
| 152 | + |
| 153 | +@interface NSObject (SUUserDefaults) |
| 154 | +@property (readonly) id <SUUserDefaults> userDefaults; |
103 | 155 | @end |
104 | 156 |
|
| 157 | + |
| 158 | +// ----------------------------------------------------------------------------- |
| 159 | +// Constants: |
| 160 | +// ----------------------------------------------------------------------------- |
| 161 | + |
105 | 162 | // Define some minimum intervals to avoid DOS-like checking attacks. These are in seconds. |
106 | | -#ifdef DEBUG |
| 163 | +#if defined(DEBUG) && DEBUG && 0 |
107 | 164 | #define SU_MIN_CHECK_INTERVAL 60 |
108 | 165 | #else |
109 | 166 | #define SU_MIN_CHECK_INTERVAL 60*60 |
110 | 167 | #endif |
111 | 168 |
|
112 | | -#ifdef DEBUG |
| 169 | +#if defined(DEBUG) && DEBUG && 0 |
113 | 170 | #define SU_DEFAULT_CHECK_INTERVAL 60 |
114 | 171 | #else |
115 | 172 | #define SU_DEFAULT_CHECK_INTERVAL 60*60*24 |
|
0 commit comments