프로젝트 소스 공개

2026-09-06 17:11:40 +09:00
commit 0f0431de5a
676 changed files with 106118 additions and 0 deletions
@@ -0,0 +1,38 @@
+//
+//  SPUAppcastItemStateResolver.h
+//  Sparkle
+//
+//  Created by Mayur Pawashe on 5/31/21.
+//  Copyright © 2021 Sparkle Project. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+#if defined(BUILDING_SPARKLE_SOURCES_EXTERNALLY)
+// Ignore incorrect warning
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wquoted-include-in-framework-header"
+#import "SUExport.h"
+#pragma clang diagnostic pop
+#else
+#import <Sparkle/SUExport.h>
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class SUStandardVersionComparator, SPUAppcastItemState;
+@protocol SUVersionComparison;
+
+/**
+ Private exposed class used to resolve Appcast Item properties that rely on external factors such as a host.
+ This resolver is used for constructing appcast items.
+ */
+SU_EXPORT @interface SPUAppcastItemStateResolver : NSObject
+
+- (instancetype)init NS_UNAVAILABLE;
+
+- (instancetype)initWithHostVersion:(NSString *)hostVersion applicationVersionComparator:(id<SUVersionComparison>)applicationVersionComparator standardVersionComparator:(SUStandardVersionComparator *)standardVersionComparator;
+
+@end
+
+NS_ASSUME_NONNULL_END
@@ -0,0 +1,22 @@
+//
+//  SPUGentleUserDriverReminders.h
+//  Sparkle
+//
+//  Copyright © 2022 Sparkle Project. All rights reserved.
+//
+
+#ifndef SPUGentleUserDriverReminders_h
+#define SPUGentleUserDriverReminders_h
+
+/**
+ A private protocol for user drivers implementing gentle scheduled reminders
+ */
+@protocol SPUGentleUserDriverReminders
+
+- (void)logGentleScheduledUpdateReminderWarningIfNeeded;
+
+- (void)resetTimeSinceOpportuneUpdateNotice;
+
+@end
+
+#endif /* SPUGentleUserDriverReminders_h */
@@ -0,0 +1,19 @@
+//
+//  SPUInstallationType.h
+//  Sparkle
+//
+//  Created by Mayur Pawashe on 7/24/16.
+//  Copyright © 2016 Sparkle Project. All rights reserved.
+//
+
+#ifndef SPUInstallationType_h
+#define SPUInstallationType_h
+
+#define SPUInstallationTypeApplication @"application" // the default installation type for ordinary application updates
+#define SPUInstallationTypeGuidedPackage @"package" // the preferred installation type for package installations
+#define SPUInstallationTypeInteractivePackage @"interactive-package" // removed installation type; use guided package instead
+
+#define SPUInstallationTypesArray (@[SPUInstallationTypeApplication, SPUInstallationTypeGuidedPackage])
+#define SPUValidInstallationType(x) ((x != nil) && [SPUInstallationTypesArray containsObject:(NSString * _Nonnull)x])
+
+#endif /* SPUInstallationType_h */
@@ -0,0 +1,40 @@
+//
+//  SPUStandardUserDriver+Private.h
+//  Sparkle
+//
+//  Copyright © 2022 Sparkle Project. All rights reserved.
+//
+
+#ifndef SPUStandardUserDriver_Private_h
+#define SPUStandardUserDriver_Private_h
+
+#if defined(BUILDING_SPARKLE_SOURCES_EXTERNALLY)
+// Ignore incorrect warning
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wquoted-include-in-framework-header"
+#import "SPUStandardUserDriver.h"
+#import "SUExport.h"
+#pragma clang diagnostic pop
+#else
+#import <Sparkle/SPUStandardUserDriver.h>
+#import <Sparkle/SUExport.h>
+#endif
+
+@class NSWindowController;
+
+NS_ASSUME_NONNULL_BEGIN
+
+SU_EXPORT @interface SPUStandardUserDriver (Private)
+
+/**
+ Private API for accessing the active update alert's window controller.
+ This is the window controller that shows the update's release notes and install choices.
+ This can be accessed in -[SPUStandardUserDriverDelegate standardUserDriverWillHandleShowingUpdate:forUpdate:state:]
+ */
+@property (nonatomic, readonly, nullable) NSWindowController *activeUpdateAlert;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif /* SPUStandardUserDriver_Private_h */
@@ -0,0 +1,29 @@
+//
+//  SPUUserAgent+Private.h
+//  Sparkle
+//
+//  Created by Mayur Pawashe on 11/12/21.
+//  Copyright © 2021 Sparkle Project. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+#if defined(BUILDING_SPARKLE_SOURCES_EXTERNALLY)
+// Ignore incorrect warning
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wquoted-include-in-framework-header"
+#import "SUExport.h"
+#pragma clang diagnostic pop
+#else
+#import <Sparkle/SUExport.h>
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class SUHost;
+
+SU_EXPORT NSString *SPUMakeUserAgentWithHost(SUHost *responsibleHost, NSString * _Nullable displayNameSuffix);
+
+SU_EXPORT NSString *SPUMakeUserAgentWithBundle(NSBundle *responsibleBundle, NSString * _Nullable displayNameSuffix);
+
+NS_ASSUME_NONNULL_END
@@ -0,0 +1,50 @@
+//
+//  SUAppcastItem+Private.h
+//  Sparkle
+//
+//  Created by Mayur Pawashe on 4/30/21.
+//  Copyright © 2021 Sparkle Project. All rights reserved.
+//
+
+#ifndef SUAppcastItem_Private_h
+#define SUAppcastItem_Private_h
+
+#import <Foundation/Foundation.h>
+#import <Sparkle/SUAppcastItem.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+// Available in SPUAppcastItemStateResolver.h (a private exposed header)
+@class SPUAppcastItemStateResolver;
+@class SUSignatures;
+
+@interface SUAppcastItem (Private) <NSSecureCoding>
+
+/**
+ Initializes with data from a dictionary provided by the RSS class and state resolver
+
+ This initializer method is intended to be marked "private" and discouraged from public usage.
+ This method is available however. Talk to us to describe your use case and if you need to construct appcast items yourself.
+ */
+- (nullable instancetype)initWithDictionary:(NSDictionary *)dict relativeToURL:(NSURL * _Nullable)appcastURL stateResolver:(SPUAppcastItemStateResolver *)stateResolver signingValidationStatus:(SPUAppcastSigningValidationStatus)signingValidationStatus failureReason:(NSString * _Nullable __autoreleasing *_Nullable)error;
+
+/**
+ The EdDSA and DSA signatures of the update along with their statuses.
+ */
+@property (readonly, nonatomic, nullable) SUSignatures *signatures;
+
+/**
+ The EdDSA signature of the external release notes along with its status.
+ */
+@property (readonly, nonatomic, nullable) SUSignatures *releaseNotesSignatures;
+
+/**
+ The expected content length of the release notes file.
+ */
+@property (readonly, nonatomic) uint64_t releaseNotesContentLength;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif /* SUAppcastItem_Private_h */
@@ -0,0 +1,37 @@
+//
+//  SUInstallerLauncher+Private.h
+//  SUInstallerLauncher+Private
+//
+//  Created by Mayur Pawashe on 8/21/21.
+//  Copyright © 2021 Sparkle Project. All rights reserved.
+//
+
+#ifndef SUInstallerLauncher_Private_h
+#define SUInstallerLauncher_Private_h
+
+#if defined(BUILDING_SPARKLE_SOURCES_EXTERNALLY)
+// Ignore incorrect warning
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wquoted-include-in-framework-header"
+#import "SUExport.h"
+#import "SPUInstallationType.h"
+#pragma clang diagnostic pop
+#else
+#import <Sparkle/SUExport.h>
+// Chances are clients will need this too
+#import <Sparkle/SPUInstallationType.h>
+#endif
+
+@class NSString;
+
+/**
+ Private API for determining if the system needs authorization access to update a bundle path
+ 
+ This API is not supported when used directly from a Sandboxed applications and will always return @c YES in that case.
+ 
+ @param bundlePath The bundle path to test if authorization is needed when performing an update that replaces this bundle.
+ @return @c YES if Sparkle thinks authorization is needed to update the @c bundlePath, otherwise @c NO.
+ */
+SU_EXPORT BOOL SPUSystemNeedsAuthorizationAccessForBundlePath(NSString *bundlePath);
+
+#endif /* SUInstallerLauncher_Private_h */