1. iOS 7 : Kony Platform Compatibility Date: 26-Aug-2013

2. iOS 7 Compatibility patch 2

3. iOS 7 Compatibility patches
Plugin versions
Compatibility Patch to be used
5.0.x
5.0.x.iOS7Patch2.zip
4.1.x
4.1.x.iOS7Patch2.zip
4.0.x
4.0.x.iOS7Patch2.zip
3.0.x
3.0.x.iOS7Patch2.zip
2.6.x
2.6.x.iOS7Patch2.zip
Please download the above compatibility patches from Kony Developer Portal

4. Guidelines and Notes
Please continue to use the version of the xCode and version of the IDE that you are already using.  No need of changing IDE, xCode environment. 
Please be aware for any reason, if you upgrade xCode environment to latest from Apple i.e xCode 5.0 and build the apps then will result apps with the new iOS 7 specific look & feel when produced app is run on iOS 7 upgraded devices. 
Please read the FAQ section in deciding the xCode environment to be used for your project.
Upgrade the device ( iPhone 4, 4S, 5 etc) to iOS 7 latest beta. iOS 7 beta 6 is the latest from Apple.
Build and compile the apps in IDE, in xCode environment and load the final app on iOS 7 upgraded device.

5. Issues Fixed

6. 1. Issues fixed – UDID alternate APIs
APIs that used to return device MAC address now return fixed values instead of MAC address.
In iOS 7 release:
APIs that used to return a MAC address now return a fixed value 02:00:00:00:00:00.
Impacted Kony APIs:
kony.os.deviceInfo().customdeviceid
kony.os.deviceInfo().deviceid
os.platform().deviceid
os.platform().customdeviceid
Cause of this issue:
Apple has completely removed all possible ways of retrieving or making Unique Device Level Identifier (UDID) and instead, recommends developers using App Level Universally Unique Identifier (UUID). Uniqueness of this app level identifier is maintained across the apps from the same provider.
Kony’s response:
Kony has provided the alternative APIs with the Patch 2.

7. Brief Introduction to these alternate APIS to UDID
Apple with iOS 7 removes all possibilities of creating our own unique device level identifier
Apple from iOS 6 and above introduces few identifiers which are not true replacement for the unique device id as these identifiers can be reset in few scenarios.
identifierForVendor
An alphanumeric string that uniquely identifies a device to the app’s vendor. The value of this property is the same for apps that come from the same vendor running on the same device. A different value is returned for apps on the same device that come from different vendors, and for apps on different devices regardless of vendor.
Note that the OS automatically deletes the current identifierForVendor when the user deletes the last application from a particular vendor. If he later reinstalls one or more apps from that vendor, the OS will generate a new identifier.

8. Brief Introduction to these alternate APIS to UDID
advertisingIdentifier- An alphanumeric string unique to each device, used only for serving advertisements.
Unlike the identifierForVendor property of UIDevice, the same value is returned to all vendors. This identifier may change—for example, if the user erases the device.
Apart from advertising purposes, Apple suggest to use the advertising identifier only for the following purposes: frequency capping, conversion events, estimating the number of unique users, security and fraud detection, and debugging.
For more information regarding the behaviors exhibited by this API, please refer

9. Kony’s recommendation
Now these alternative identifiers APIs are available from Patch 2 onwards , Kony would recommend below changes in the app.
Use os.platform.deviceInfo().customdeviceid API for the devices with iOS version less than 6.0
For iOS versions iOS 6.0 and above, please use the alternative identifiers i.e identifierForVendor , advertisingIdentifier as needed and applicable
kony.os.deviceInfo().identifierForVendor (in JS)
Kony.os.deviceInfo().advertisingIdentifier (In JS)
os.platform(). identifierForVendor (in Lua)
-os.platform(). advertisingIdentifier (in Lua)

10. Usage of new APIs in JS Usage of IdentifierForVendor
If ( OS version is less than 6.0) {
kony.os.deviceInfo().customdeviceid }
else
kony.os.deviceInfo().IdentifierForVendor
Usage of advertisingIdentifier
kony.os..deviceInfo().customdeviceid
kony.os.deviceInfo(). advertisingIdentifier

11. Usage of new APIs in Lua Usage of IdentifierForVendor
If ( OS version is less than 6.0) {
os.platform().customdeviceid }
else
os.platform().IdentifierForVendor
Usage of advertisingIdentifier
os.platform(). advertisingIdentifier

12. 2. Issues Fixed – UI Issues
When app is built xCode 5 and run on iOS7, Full screen layout is introduced in iOS7 which is causing UI overlaps
Camera overlay issues
Checkbox group widget click not working as on-off switch is going out of the view.
Issues, crashes in Custom transitions are fixed.
Next, Prev tool bar, Navigation Bar look & feel is made compatible to iOS 7.

13. Known Issues

14. 1. Known Issues – Label size difference b/w iOS6 and iOS7.
Due to this difference on IOS 7 device you might see the labels getting wrapped in different manner compared to iOS 6.0
Segment edit style is not working on iOS7 device.
Segment separator lines are not touching the border.

15. FAQs

16. 1. Can I still continue with iOS 6 look and feel even on iOS 7 upgraded devices ?
Apps compiled using xCode versions less than 5.0 (<5.0) will get the iOS 6 look & feel even if these apps are installed and run on iOS 7 upgraded device.
If customers decide to have iOS 6 look &feel consistently across iOS 6 and iOS 7 devices then it is strongly recommended to use xCode versions less than5.0.
Rebuild your project using the Kony provided iOS 7 compatible patches (patch1) with xCode versions less than 5.0 and test the app on iOS 7 upgraded device and resubmit the app.
Kony recommends this option for the projects which are already in production or for the apps close to the submission process.
Please note that Kony iOS 7 compatibility patch (patch1) is necessary even if customers decide to have iOS 6 look and feel for their apps on iOS 7 upgraded devices.

17. 2. Can I get the iOS 6 or iOS 7 look & feel for my app based on the OS version of the device?
Yes. Apps compiled using xCode version 5.0 (latest from apple) will have appropriate look and feel based on the OS version the app runs on.
However, customers are expected to modify the skins in Kony IDE to match the iOS 7 app guidelines. This is significant effort and is not advised if your are already in production and just need the iOS 7 compatibility or for the apps close to submission process and all you need is iOS7 compatibility but not the new look & feel provided by iOS7.
Please check the below app guidelines from apple for iOS 7 look & feel
Kony recommends this option for the apps which are just started or mid-way through their execution.
Please note that Kony iOS 7 compatibility patch is necessary along with the Xcode 5.0 version. Kony would provide a detailed update around the Skin changes required for iOS 7 compatibility in the future iOS 7 communication notes.

18. 3. What are the OS distribution statics?
As per the Apple provided statistics pertaining to the distribution of OS versions, 94% of the customers are using iOS 6. These statistics indicate that users are eager to upgrade to the latest iOS versions of Apple.

19. 4. Which devices are supported by iOS 7?
iOS 7 is supported on the following devices
iPhone 4
iPhone 4S
iPhone 5
iPod touch (5th gen)
iPad 2
iPad with Retina display
iPad mini
Note: 3GS device does not support iOS 7.

20. 5. When is iOS 7 GM scheduled to be released from Apple?
Apple may release the final iOS 7 GM by mid of September 2013.
GM is the final version from Apple that will be released to developers and approximately a week after iOS 7 GM release, Apple will release the same for general public.
Expectation is to get the apps compatible with iOS7 before apple releases the iOS 7 final version for general public use.

21. 6. Which Kony plugins are to be supported for this upgrade?
The following Kony plugins are supported (both Lua and JavaScript):
2.6
3.x
4.x
5.x

22. 7. Kony compatibility patch release plan
Kony compatibility patch release plan (tentatively) is as follows:
Intermediate patch on August 25, 2013
Intermediate patch on August 30, 2013.
Intermediate patch on September 9th, 2013.
Apple GM compliant patch on September 16th, 2013.

23. Thank You