2.3.0

Author: jtreanor

CHANGES

@@ -1,3 +1,14 @@
+= 2.3.0 (2015-06-24)
+
+* Users can now send image attachments.
+* Fixed bug where `+[Intercom reset]` could behave inconsistently (https://github.com/intercom/intercom-ios/issues/68).
+* Intercom now honours `prefersStatusBarHidden` (https://github.com/intercom/intercom-ios/issues/66).
+* Added `IntercomDidStartNewConversationNotification` as suggested in https://github.com/intercom/intercom-ios/issues/67.
+* Ensure sessions are ended when your app is backgrounded.
+* Renamed certs to fix https://github.com/intercom/intercom-cordova/issues/5.
+* Improved support for CocoPods Frameworks.
+* Added nullability modifiers to Intercom.h for improved Swift compatibility.
+
 = 2.2.4 (2015-05-28)
 
 * Fixed an issue where opening a push might not open the Intercom message if the app is in the background in some cases.

Intercom.framework/Versions/A/Headers/Intercom.h

@@ -1,7 +1,7 @@
 
 //
 //  Intercom.h
-//  Intercom for iOS - Version 2.2.3
+//  Intercom for iOS - Version 2.3
 //
 //  Created by Intercom on 8/01/2015.
 //  Copyright (c) 2014 Intercom. All rights reserved.
@@ -11,7 +11,19 @@
 #import <UIKit/UIKit.h>
 
 #if __IPHONE_OS_VERSION_MIN_REQUIRED < __IPHONE_7_0
-#error This version (2.2.4) of Intercom for iOS supports iOS 7.0 upwards.
+#error This version (2.3) of Intercom for iOS supports iOS 7.0 upwards.
+#endif
+
+#if __has_feature(nullability)
+#define ICM_ASSUME_NONNULL_BEGIN _Pragma("clang assume_nonnull begin")
+#define ICM_ASSUME_NONNULL_END _Pragma("clang assume_nonnull end")
+#define icm_nullable nullable
+#define __icm_nullable __nullable
+#else
+#define ICM_ASSUME_NONNULL_BEGIN
+#define ICM_ASSUME_NONNULL_END
+#define icm_nullable
+#define __icm_nullable
 #endif
 
 // Use these values to constrain an incoming notification view to a defined section of the window.
@@ -101,6 +113,7 @@ typedef NS_ENUM(NSUInteger, ICMPresentationMode){
  
  */
 @interface Intercom : NSObject
+ICM_ASSUME_NONNULL_BEGIN
 
 //=========================================================================================================
 /*! @name Getting set up */
@@ -335,29 +348,42 @@ typedef NS_ENUM(NSUInteger, ICMPresentationMode){
  */
 + (void)enableLogging;
 
+//=========================================================================================================
+/*! @name Status bar handling */
+//=========================================================================================================
+
+/*!
+ If you wish to change your status bar's style or visibility while an Intercom notification may be on 
+ screen, call this method so that Intercom's window can reflect these changes accordingly.
+ */
++ (void)setNeedsStatusBarAppearanceUpdate;
+
 //=========================================================================================================
 /*! @name Intercom Notifications */
 //=========================================================================================================
 /*!
- Notifications thrown by Intercom for iOS when the Intercom window is displayed and hidden. These notifications 
- are fired only when there is a change in the state of Intercom's UI: when a user receives a message for
- instance, willShow and didShow notifications will be fired accordingly when the Intercom Notification (chat head)
- is presented.
+ These are notifications thrown by Intercom for iOS when the Intercom window is displayed and hidden or when
+ a new conversation has been started. These notifications are fired only when there is a change in the state
+ of Intercom's UI: when a user receives a message for instance, willShow and didShow notifications will be 
+ fired accordingly when the Intercom Notification (chat head) is presented. 
  
  Once the user taps on the chat head, the message is presented in your app. It will be presented covering
  the entire screen, but no notifications will be thrown here as Intercom has already been visible.
+ 
+ In the case of a new conversation this notification may be used to prompt users to enable push notifications.
  */
 
 UIKIT_EXTERN NSString *const IntercomWindowWillShowNotification;
 UIKIT_EXTERN NSString *const IntercomWindowDidShowNotification;
 UIKIT_EXTERN NSString *const IntercomWindowWillHideNotification;
 UIKIT_EXTERN NSString *const IntercomWindowDidHideNotification;
+UIKIT_EXTERN NSString *const IntercomDidStartNewConversationNotification;
 
 /**
  @warning Deprecated methods will be removed in version 2.4.
  */
 
-typedef void(^ICMCompletion)(NSError *error) __attribute((deprecated));
+typedef void(^ICMCompletion)(NSError * __icm_nullable) __attribute((deprecated));
 
 //=========================================================================================================
 /*! @name Deprecated methods */
@@ -371,17 +397,17 @@ typedef void(^ICMCompletion)(NSError *error) __attribute((deprecated));
 /*!
  @deprecated Use registerUserWithEmail: instead
  */
-+ (void)beginSessionForUserWithEmail:(NSString *)email completion:(ICMCompletion)completion __attribute((deprecated("Use method 'registerUserWithEmail:' instead")));
++ (void)beginSessionForUserWithEmail:(NSString *)email completion:(icm_nullable ICMCompletion)completion __attribute((deprecated("Use method 'registerUserWithEmail:' instead")));
 
 /*!
  @deprecated Use registerUserWithUserId: instead
  */
-+ (void)beginSessionForUserWithUserId:(NSString *)userId completion:(ICMCompletion)completion __attribute((deprecated("Use method 'registerUserWithUserId:' instead")));
++ (void)beginSessionForUserWithUserId:(NSString *)userId completion:(icm_nullable ICMCompletion)completion __attribute((deprecated("Use method 'registerUserWithUserId:' instead")));
 
 /*!
  @deprecated Use registerUnidentifiedUser instead
  */
-+ (void)beginSessionForAnonymousUserWithCompletion:(ICMCompletion)completion __attribute((deprecated("Use method 'registerUnidentifiedUser' instead")));
++ (void)beginSessionForAnonymousUserWithCompletion:(icm_nullable ICMCompletion)completion __attribute((deprecated("Use method 'registerUnidentifiedUser' instead")));
 
 /*!
  @deprecated Use reset instead
@@ -391,17 +417,17 @@ typedef void(^ICMCompletion)(NSError *error) __attribute((deprecated));
 /*!
  @deprecated Use updateUserWithAttributes: instead
  */
-+ (void)updateUserWithAttributes:(NSDictionary *)attributes completion:(ICMCompletion)completion __attribute((deprecated("Use method 'updateUserWithAttributes:' instead")));
++ (void)updateUserWithAttributes:(NSDictionary *)attributes completion:(icm_nullable ICMCompletion)completion __attribute((deprecated("Use method 'updateUserWithAttributes:' instead")));
 
 /*!
  @deprecated Use logEventWithName: instead
  */
-+ (void)logEventWithName:(NSString *)name completion:(ICMCompletion)completion __attribute((deprecated("Use method 'logEventWithName:' instead")));
++ (void)logEventWithName:(NSString *)name completion:(icm_nullable ICMCompletion)completion __attribute((deprecated("Use method 'logEventWithName:' instead")));
 
 /*!
  @deprecated Use logEventWithName:metaData: instead
  */
-+ (void)logEventWithName:(NSString *)name optionalMetaData:(NSDictionary *)metadata completion:(ICMCompletion)completion __attribute((deprecated("Use method 'logEventWithName:metaData:' instead")));
++ (void)logEventWithName:(NSString *)name optionalMetaData:(NSDictionary *)metadata completion:(icm_nullable ICMCompletion)completion __attribute((deprecated("Use method 'logEventWithName:metaData:' instead")));
 
 /*!
  @deprecated This is no longer supported
@@ -421,7 +447,7 @@ typedef void(^ICMCompletion)(NSError *error) __attribute((deprecated));
 /*!
  @deprecated This is no longer supported. You can change your app's theme through settings on Intercom in the web.
  */
-+ (void)setBaseColor:(UIColor *)color __attribute((deprecated("This is no longer supported.")));
++ (void)setBaseColor:(icm_nullable UIColor *)color __attribute((deprecated("This is no longer supported.")));
 
 /*!
  @deprecated Use setMessagesHidden: instead
@@ -436,11 +462,12 @@ typedef void(^ICMCompletion)(NSError *error) __attribute((deprecated));
 /*!
  @deprecated This is no longer supported.
  */
-+ (void)setSessionListener:(id<IntercomSessionListener>)sessionListener __attribute((deprecated("This is no longer supported.")));
++ (void)setSessionListener:(icm_nullable id<IntercomSessionListener>)sessionListener __attribute((deprecated("This is no longer supported.")));
 
 /*!
  @deprecated Use method setDeviceToken instead.
  */
 + (void)registerForRemoteNotifications __attribute((deprecated("Use method 'setDeviceToken' instead.")));
 
-@end
+ICM_ASSUME_NONNULL_END
+@end

Intercom.framework/Versions/A/Intercom

@@ -1,12 +1,12 @@
 Pod::Spec.new do |s|
   s.name                = 'Intercom'
-  s.version             = '2.2.4'
+  s.version             = '2.3.0'
   s.summary             = 'The Intercom iOS SDK, for integrating Intercom into your iOS application.'
   s.license             = { :type => "Apache license", :file => "LICENSE" }
   s.authors             = {"Adam McCarthy"=>"[email protected]", "James Treanor"=>"[email protected]"}
   s.homepage            = 'https://github.com/intercom/intercom-ios'
   s.description         = 'The Intercom iOS SDK, for integrating Intercom into your iOS application. The SDK supports iOS 7 and iOS 8.'
-  s.frameworks          = ["Foundation", "UIKit", "Security", "SystemConfiguration", "MobileCoreServices", "ImageIO", "AudioToolbox", "QuartzCore", "CoreGraphics"]
+  s.frameworks          = ["Foundation", "UIKit", "Security", "SystemConfiguration", "MobileCoreServices", "ImageIO", "AudioToolbox", "QuartzCore", "CoreGraphics", 'AssetsLibrary']
   s.library             = "icucore"
   s.requires_arc        = true
   s.source              = { :git => 'https://github.com/intercom/intercom-ios.git', :tag => s.version.to_s }