Background Information
To add Mobile App Manager to your app code for customers who have been using iOS SDK versions prior to iOS SDK v4.0.
- Simple integration including Cocoapods
- Asynchronous operations
- Tyrpesafe APIs
- Inbox messages - support of Appoxee UI for Inbox has been removed and we instead a reference implementation is provided in our example application (code API gitHub). In addition, Instead of using AppoxeeMessage object, developer will need to use APXRichMessage object.
- More Apps, User Feedback removed – SDK 4 implemented an empty implementation of these features
- Custom Field – fetching a custom field will be from the device cache only (values will not be fetched from server. So when migrating, on getting a custom field which wasn’t set, a nil value will be returned).
- Deep-Linking - SDK 4 uses iOS URL schemes for deep-linking.You must implement the URL schemes and register them (see apple documentation)
Procedure
Existing customers who will upgrade to the new SDK will have to perform the below steps
1. Remove from the project the previously integrated SDK
2. Import Statements. Replace #import "Appoxee.h" with #import <AppoxeeSDK/AppoxeeSDK.h>
3. For customers who are using Appoxee Inbox changes are required:
- Customers which use the Appoxee Inbox UI - Need to use the reference Inbox UI implementation
- Instead of using AppoxeeMessage, developer will need to use APXRichMessage
4. SDK 4 uses iOS URL schemes for deep-linking.If you have not registered the deep-link URLs, you will need to register them in order for deep-linking to work (see apple documentation).
5. Follow Add the Mobile Push SDK
Optional Steps:
- Remove all frameworks which were required in SDK3 and are not required by SDK 4 :AudioToolbox.framework, QuartzCore.framework, CoreGraphics.framework, libxml2.dylib, AWSSQS.framework, AWSRuntime.framework
- Upgrade and use SDK 4 APIs. While SDK has backward compatibility with SDK 3 APIs, the APIs exposed on SDK 4 have additional capabilities including more sophisticated error handling.