1 copyright © 2013 kony inc. confidential 1 ios 7 : kony platform compatibility date: 26-aug-2013

1Copyright © 2013 Kony Inc. CONFIDENTIAL 1

iOS 7 : Kony Platform CompatibilityDate: 26-Aug-2013

2Copyright © 2013 Kony Inc. CONFIDENTIAL

iOS 7 Compatibility patch 2


iOS 7 Compatibility patches

Plugin versions Compatibility Patch to be used

5.0.x 5.0.x.iOS7Patch2.zip





Please download the above compatibility patches from Kony Developer Portal

http://developer.kony.com/PluginReleases

http://developer.kony.com/PluginReleases


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.

Guidelines and Notes


Issues Fixed


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.

1. Issues fixed – UDID alternate APIs


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.

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 http://oleb.net/blog/2012/09/udid-apis-in-ios-6/

Brief Introduction to these alternate APIS to UDID


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)

Kony’s recommendation


Usage of IdentifierForVendorIf ( OS version is less than 6.0)

{

kony.os.deviceInfo().customdeviceid

}

else

{

kony.os.deviceInfo().IdentifierForVendor

}

Usage of advertisingIdentifier

If ( OS version is less than 6.0)

{

kony.os..deviceInfo().customdeviceid

}

else

{

kony.os.deviceInfo(). advertisingIdentifier

}

Usage of new APIs in JS


Usage of IdentifierForVendorIf ( OS version is less than 6.0)

{

os.platform().customdeviceid

}

else

{

os.platform().IdentifierForVendor

}

Usage of advertisingIdentifier

If ( OS version is less than 6.0)

{

os.platform().customdeviceid

}

else

{

os.platform(). advertisingIdentifier

}

Usage of new APIs in Lua


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.

2. Issues Fixed – UI Issues


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.

1. Known Issues –


FAQs


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.

1. Can I still continue with iOS 6 look and feel even on iOS 7 upgraded devices ?


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

https://developer.apple.com/library/prerelease/ios/documentation/UserExperience/Conceptual/MobileHIG/MobileHIG.pdf

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.

2. Can I get the iOS 6 or iOS 7 look & feel for my app based on the OS version of the device?




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.

https://developer.apple.com/devcenter/ios/checklist/

3. What are the OS distribution statics?




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.

4. Which devices are supported by iOS 7?


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.

5. When is iOS 7 GM scheduled to be released from Apple?


The following Kony plugins are supported (both Lua and JavaScript):

2.6

3.x

4.x

5.x

6. Which Kony plugins are to be supported for this upgrade?


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.

7. Kony compatibility patch release plan


Thank You

1 copyright © 2013 kony inc. confidential 1 ios 7 : kony platform compatibility date: 26-aug-2013

Documents

customdeviceid kony

js kony

use os

applicable kony

deviceid os

lua os

impacted kony apis

confidential apis