1.5.0 - Surveys on Engagement Framework

This release moves Surveys to the engagement framework. You are now able to target surveys to events that you engage: in your app. This change enables surveys to be chained with other interactions, such as the Ratings Prompt. From your Apptentive dashboard, you can now present a Survey if someone answers "No" to your "Do you Love App_Name?" prompt.

This release also fully removes the ATAppRatingFlow.h and ATSurveys.h header files. You can now simply import ATConnect.h when using Apptentive.

If you were using a version prior to 1.5.0, please read MigratingTo_1.5.0.md for information on how to migrate your API calls to this release. We are sorry for the inconvenience, but we hope the new features will more than make up for it!

Finally, we have migrated and improved our documentation for this release. The GitHub README now presents a smaller and simpler overview of Apptentive, and links to relevant sections on the Apptentive Documentation site.

1.4.3 - Debugging Options, Custom Data Improvements, Chinese/Japanese Text Input

This release adds checks to ensure that custom person data is sent in a timely manner and is immediately visible in the dashboard alongside messages.

Added debuggingOptions property on ATConnect that allows the developer to specify debug logging preferences for their app. This property is included in the ATConnect_Debugging.h header file, which you will need to include in your project in order to use the property.

Use debuggingOptions to hide the debug panel or limit the debug logging of HTTP requests.

Also fixes an issue where Chinese and Japanese keyboard input could hide buttons in the Feedback dialog.

Fixes:

• IOS-489 Chinese input hides feedback dialog buttons.
• IOS-381 Japanese input hides feedback dialog buttons.
• IOS-478 Issue where setting custom person data is not synced to server.
• IOS-370 Investigate sending order of Person and Message.
• IOS-485 HTML Response logs contents of the HTML.
• Contains operator should be case insensitive.

1.4.2 - Integration with Amazon SNS Push Notifications

This release adds push notification integration with Amazon Web Services (AWS) Simple Notification Service (SNS).

Use addAmazonSNSIntegrationWithDeviceToken: to enable Amazon SNS push notifications for a device. You will also need to configure the integration on your Apptentive dashboard.

Fixes:

• IOS-461 Add integration with Amazon SNS
• #90 ATLogger fails to catch exception if no space left on device
• #91 ATAppConfigurationUpdateTask needs to retain self before updating task state

1.4.1 - Fix for Engagement Framework Event Labels

Fixed an issue where some event labels were not being properly escaped.

You will want to upgrade from v1.4.0 to v1.4.1 if you are using engaging complex event labels:

[[ATConnect sharedConnection] engage:@"complex%event/label#" fromViewController:viewController];

Fixes:

• IOS-479 URL encode each token of a codepoint name

1.4.0 - Engagement Framework

This marks the first release of a more generalized engagement framework. This will allow us to chain interactions together in interesting ways, provide better server-side configuration of what customers see and when they see it, and lay the foundation for some very interesting features in the future.

If you were using a version prior to 1.4.0, please read MigratingTo_1.4.0md for information on how to migrate your API calls to this release. We're sorry for the inconvenience, but we hope the new features will more than make up for it!

Fixes:

• Lots of changes for the engagement framework.
• IOS-447 Add identifierForVendor as device property.
• Fix for a memory leak in ATInteractionUsageData.

1.3.0 - Dropping iOS 4 Support, Various Fixes

Important:

• We've (provisionally) dropped iOS 4.x support. If you really need iOS 4.x support, please contact us.
• We added AssetsLibrary to the list of required frameworks in this version (part of the fix for IOS-409).

Fixes:

• IOS-426 Drop iOS 4 Support
• IOS-414 Add convenience method for integrating with Urban Airship (addUrbanAirshipIntegrationWithDeviceToken:)
• IOS-408 Dragging down in message center moves the keyboard as well
• IOS-388 Change build_distribution.py to build Release rather than Debug builds
• IOS-429 Remove unused images in SDK
• IOS-420 Text clipped in screenshot instructions
• IOS-398 Crash in TTTAttributedLabel
• IOS-421 Pull in image compression improvements
• IOS-409 Sending horizontal panorama photos crashes message center
• #84 dismissMessageCenterAnimated does not call completion block in some cases
• #83 Calling dismissMessageCenterAnimated can break future calls to presentMessageCenterFromViewController
• IOS-422 Ensure device info is sent before retrieving Interactions.
• IOS-449 Clicking next from email entry doesn't highlight message text entry.

1.2.9 - Changes to `initialUserEmailAddress` and other small fixes

This release adds several small fixes to alleviate common support requests.

Fixes:

• IOS-415 Allow initialUserEmailAddress to be updated after sending feedback with no email
• IOS-418 Ability to delete a previously entered email
• Compressed images with ImageOptim
• IOS-394 Log warning if passed view controller is nil
• IOS-364 Don't fetch surveys until at least one DeviceInfo has been sent
• IOS-380 Re-add "sending..." label to pending messages

1.2.8 - Bug fixes for NSAssert and setting `initialEmailAddress`

This release fixes several issues reported by developers. We now strip NSAssert calls from the Apptentive static library. Also fixes an issue where setting a nil email address caused problems with the email validator. Additional debug logging added to make API key issues easier to recognize and debug.

Fixes:

• IOS-387 and #79 Set ENABLE_NS_ASSERTIONS to NO in both Debug and Release builds. (NSAssert calls now ignored).
• IOS-386 Fixes crash when setting nil email for initialEmailAddress.
• IOS-383 Added debug messages to help developer notice when API key is invalid or not set.
• IOS-384 Added Kahuna integration key constant.
• IOS-379 Added additional information to readme about

1.2.7 - Various changes: `engage:` return type, `initiallyUseMessageCenter`, etc.

This release adds a BOOL return type to the engage: method, allowing the developer to take action if an interaction is or isn't shown. The initiallyUseMessageCenter property has been added to set the initial Message Center state; this will be overridden when the Apptentive configuration file is first downloaded.

This release also makes some behind-the-scenes tweaks to the Engagement Framework.

Fixes:

• IOS-354 Add BOOL return type to engage: method
• Change ATEvent monitoring from NSAssert to ATLogError.
• Made changes to Engagement Framework criteria:
• IOS-375 Add is_update_version to Enagagement Framework criteria
• IOS-377 Change days_since... to time_since... in Engagement Framework criteria.
• IOS-373 Add build property to Interactions.
• IOS-378 Add API method to set initial/local useMessageCenter setting

1.2.6 - Message Attachments

This release adds message attachments. Attachment messages appear in your online Apptentive dashboard, but will not appear in Message Center on the user's device. They may be useful for sending debug logs or other useful information.

- (void)sendAttachmentText:(NSString *)text;
- (void)sendAttachmentImage:(UIImage *)image;
- (void)sendAttachmentFile:(NSData *)fileData withMimeType:(NSString *)mimeType;

Fixes:

• IOS-368 Added cases for always or never showing an interaction based on its criteria.
• IOS-363 Changed key to "hardware" from "model". Human readable string "model" will now be set on server.
• IOS-172 Prevent duplicate Message Center automated messages
• Issue #70 unreadCount incremented when typing a message
• IOS-310 unreadMessageCount incremented when typing a message
• IOS-341 Investigate loading of initial config file at app launch.
• IOS-355 Strip whitespace from Survey text response
• IOS-356 Can't see send button in Message Center with white tintColor
• IOS-357 Add support for hidden text/file messages