|
|
@@ -0,0 +1,186 @@
|
|
|
+//
|
|
|
+// iVersion.h
|
|
|
+//
|
|
|
+// Version 1.11.5
|
|
|
+//
|
|
|
+// Created by Nick Lockwood on 26/01/2011.
|
|
|
+// Copyright 2011 Charcoal Design
|
|
|
+//
|
|
|
+// Distributed under the permissive zlib license
|
|
|
+// Get the latest version from here:
|
|
|
+//
|
|
|
+// https://github.com/nicklockwood/iVersion
|
|
|
+//
|
|
|
+// This software is provided 'as-is', without any express or implied
|
|
|
+// warranty. In no event will the authors be held liable for any damages
|
|
|
+// arising from the use of this software.
|
|
|
+//
|
|
|
+// Permission is granted to anyone to use this software for any purpose,
|
|
|
+// including commercial applications, and to alter it and redistribute it
|
|
|
+// freely, subject to the following restrictions:
|
|
|
+//
|
|
|
+// 1. The origin of this software must not be misrepresented; you must not
|
|
|
+// claim that you wrote the original software. If you use this software
|
|
|
+// in a product, an acknowledgment in the product documentation would be
|
|
|
+// appreciated but is not required.
|
|
|
+//
|
|
|
+// 2. Altered source versions must be plainly marked as such, and must not be
|
|
|
+// misrepresented as being the original software.
|
|
|
+//
|
|
|
+// 3. This notice may not be removed or altered from any source distribution.
|
|
|
+//
|
|
|
+
|
|
|
+
|
|
|
+#pragma clang diagnostic push
|
|
|
+#pragma clang diagnostic ignored "-Wobjc-missing-property-synthesis"
|
|
|
+
|
|
|
+
|
|
|
+#import <Availability.h>
|
|
|
+#undef weak_delegate
|
|
|
+#if __has_feature(objc_arc_weak) && \
|
|
|
+(TARGET_OS_IPHONE || __MAC_OS_X_VERSION_MIN_REQUIRED >= __MAC_10_8)
|
|
|
+#define weak_delegate weak
|
|
|
+#else
|
|
|
+#define weak_delegate unsafe_unretained
|
|
|
+#endif
|
|
|
+
|
|
|
+
|
|
|
+#import <TargetConditionals.h>
|
|
|
+#if TARGET_OS_IPHONE
|
|
|
+#import <UIKit/UIKit.h>
|
|
|
+
|
|
|
+#define IVERSION_USE_STOREKIT 1
|
|
|
+
|
|
|
+#define IVERSION_EXTERN UIKIT_EXTERN
|
|
|
+#else
|
|
|
+#import <Cocoa/Cocoa.h>
|
|
|
+#define IVERSION_EXTERN APPKIT_EXTERN
|
|
|
+#endif
|
|
|
+
|
|
|
+
|
|
|
+#if defined(IVERSION_USE_STOREKIT) && IVERSION_USE_STOREKIT
|
|
|
+#import <StoreKit/StoreKit.h>
|
|
|
+#endif
|
|
|
+
|
|
|
+
|
|
|
+extern NSString *const iVersionErrorDomain;
|
|
|
+
|
|
|
+//localisation string keys
|
|
|
+IVERSION_EXTERN NSString *const iVersionInThisVersionTitleKey; //iVersionInThisVersionTitle
|
|
|
+IVERSION_EXTERN NSString *const iVersionUpdateAvailableTitleKey; //iVersionUpdateAvailableTitle
|
|
|
+IVERSION_EXTERN NSString *const iVersionVersionLabelFormatKey; //iVersionVersionLabelFormat
|
|
|
+IVERSION_EXTERN NSString *const iVersionOKButtonKey; //iVersionOKButton
|
|
|
+IVERSION_EXTERN NSString *const iVersionIgnoreButtonKey; //iVersionIgnoreButton
|
|
|
+IVERSION_EXTERN NSString *const iVersionRemindButtonKey; //iVersionRemindButton
|
|
|
+IVERSION_EXTERN NSString *const iVersionDownloadButtonKey; //iVersionDownloadButton
|
|
|
+
|
|
|
+
|
|
|
+typedef NS_ENUM(NSUInteger, iVersionErrorCode)
|
|
|
+{
|
|
|
+ iVersionErrorBundleIdDoesNotMatchAppStore = 1,
|
|
|
+ iVersionErrorApplicationNotFoundOnAppStore,
|
|
|
+ iVersionErrorOSVersionNotSupported
|
|
|
+};
|
|
|
+
|
|
|
+
|
|
|
+typedef NS_ENUM(NSInteger, iVersionUpdatePriority)
|
|
|
+{
|
|
|
+ iVersionUpdatePriorityDefault = 0,
|
|
|
+ iVersionUpdatePriorityLow = 1,
|
|
|
+ iVersionUpdatePriorityMedium = 2,
|
|
|
+ iVersionUpdatePriorityHigh = 3
|
|
|
+};
|
|
|
+
|
|
|
+
|
|
|
+@interface NSString(iVersion)
|
|
|
+
|
|
|
+- (NSComparisonResult)compareVersion:(NSString *)version;
|
|
|
+- (NSComparisonResult)compareVersionDescending:(NSString *)version;
|
|
|
+
|
|
|
+@end
|
|
|
+
|
|
|
+
|
|
|
+@protocol iVersionDelegate <NSObject>
|
|
|
+@optional
|
|
|
+
|
|
|
+- (BOOL)iVersionShouldCheckForNewVersion;
|
|
|
+- (void)iVersionDidNotDetectNewVersion;
|
|
|
+- (void)iVersionVersionCheckDidFailWithError:(NSError *)error;
|
|
|
+- (void)iVersionDidDetectNewVersion:(NSString *)version details:(NSString *)versionDetails;
|
|
|
+- (BOOL)iVersionShouldDisplayNewVersion:(NSString *)version details:(NSString *)versionDetails;
|
|
|
+- (BOOL)iVersionShouldDisplayCurrentVersionDetails:(NSString *)versionDetails;
|
|
|
+- (void)iVersionUserDidAttemptToDownloadUpdate:(NSString *)version;
|
|
|
+- (void)iVersionUserDidRequestReminderForUpdate:(NSString *)version;
|
|
|
+- (void)iVersionUserDidIgnoreUpdate:(NSString *)version;
|
|
|
+- (BOOL)iVersionShouldOpenAppStore;
|
|
|
+- (void)iVersionDidPresentStoreKitModal;
|
|
|
+- (void)iVersionDidDismissStoreKitModal;
|
|
|
+
|
|
|
+@end
|
|
|
+
|
|
|
+
|
|
|
+@interface iVersion : NSObject
|
|
|
+
|
|
|
++ (iVersion *)sharedInstance;
|
|
|
+
|
|
|
+//app store ID - this is only needed if your
|
|
|
+//bundle ID is not unique between iOS and Mac app stores
|
|
|
+@property (nonatomic, assign) NSUInteger appStoreID;
|
|
|
+
|
|
|
+//application details - these are set automatically
|
|
|
+@property (nonatomic, copy) NSString *applicationVersion;
|
|
|
+@property (nonatomic, copy) NSString *applicationBundleID;
|
|
|
+@property (nonatomic, copy) NSString *appStoreCountry;
|
|
|
+
|
|
|
+//usage settings - these have sensible defaults
|
|
|
+@property (nonatomic, assign) BOOL showOnFirstLaunch;
|
|
|
+@property (nonatomic, assign) BOOL groupNotesByVersion;
|
|
|
+@property (nonatomic, assign) float checkPeriod;
|
|
|
+@property (nonatomic, assign) float remindPeriod;
|
|
|
+
|
|
|
+//message text - you may wish to customise these
|
|
|
+@property (nonatomic, copy) NSString *inThisVersionTitle;
|
|
|
+@property (nonatomic, copy) NSString *updateAvailableTitle;
|
|
|
+@property (nonatomic, copy) NSString *versionLabelFormat;
|
|
|
+@property (nonatomic, copy) NSString *okButtonLabel;
|
|
|
+@property (nonatomic, copy) NSString *ignoreButtonLabel;
|
|
|
+@property (nonatomic, copy) NSString *remindButtonLabel;
|
|
|
+@property (nonatomic, copy) NSString *downloadButtonLabel;
|
|
|
+@property (nonatomic, copy) NSString *versionDetailsDefault;
|
|
|
+
|
|
|
+
|
|
|
+//debugging and prompt overrides
|
|
|
+@property (nonatomic, assign) iVersionUpdatePriority updatePriority;
|
|
|
+@property (nonatomic, assign) BOOL useUIAlertControllerIfAvailable;
|
|
|
+@property (nonatomic, assign) BOOL useAllAvailableLanguages;
|
|
|
+@property (nonatomic, assign) BOOL onlyPromptIfMainWindowIsAvailable;
|
|
|
+@property (nonatomic, assign) BOOL useAppStoreDetailsIfNoPlistEntryFound;
|
|
|
+@property (nonatomic, assign) BOOL checkAtLaunch;
|
|
|
+@property (nonatomic, assign) BOOL verboseLogging;
|
|
|
+@property (nonatomic, assign) BOOL previewMode;
|
|
|
+
|
|
|
+//advanced properties for implementing custom behaviour
|
|
|
+@property (nonatomic, copy) NSString *remoteVersionsPlistURL;
|
|
|
+@property (nonatomic, copy) NSString *localVersionsPlistPath;
|
|
|
+@property (nonatomic, copy) NSString *ignoredVersion;
|
|
|
+@property (nonatomic, strong) NSDate *lastChecked;
|
|
|
+@property (nonatomic, strong) NSDate *lastReminded;
|
|
|
+@property (nonatomic, strong) NSURL *updateURL;
|
|
|
+@property (nonatomic, assign) BOOL viewedVersionDetails;
|
|
|
+@property (nonatomic, weak_delegate) id<iVersionDelegate> delegate;
|
|
|
+
|
|
|
+//manually control behaviour
|
|
|
+- (BOOL)openAppPageInAppStore;
|
|
|
+- (void)checkIfNewVersion;
|
|
|
+- (NSString *)versionDetails;
|
|
|
+- (BOOL)shouldCheckForNewVersion;
|
|
|
+- (void)checkForNewVersion;
|
|
|
+
|
|
|
+
|
|
|
+- (NSString *)localizedStringForKey:(NSString *)key withDefault:(NSString *)defaultString;
|
|
|
+
|
|
|
+@end
|
|
|
+
|
|
|
+
|
|
|
+#pragma clang diagnostic pop
|
|
|
+
|
