1 copyright © 2013 kony inc. confidential 1 ios 7 : kony platform compatibility date: sep 16 th...

1Copyright © 2013 Kony Inc. CONFIDENTIAL 1

iOS 7 : Kony Platform CompatibilityDate: Sep 16th 2013

2Copyright © 2013 Kony Inc. CONFIDENTIAL

iOS 7 GM Compatibility patch


iOS 7 Compatibility patches

Plugin versions Compatibility Patch to be used

5.0.x iOS-GA-5.0.35.zip

4.1.x iOS-GA-4.1.58.zip

4.0.x iOS-GA-4.0.32.zip

3.0.x IPHN-GA-3.0.29.zip

2.6.x IPHN-GA-2.6.15.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: os.deviceInfo().customdeviceid 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

– os.platform.deviceInfo().identifierForVendor (in JS)– os.platform.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)

{

os.platform.deviceInfo().customdevicdeId

}

else

{

os.platform.deviceInfo().identifierForVendor

}

Usage of advertisingIdentifier

If ( OS version is less than 6.0)

{

os.platform.deviceInfo().customdevicdeId

}

else

{

os.platform.deviceInfo(). advertisingIdentifier

}

Usage of new APIs in JS


Usage of IdentifierForVendorIf ( OS version is less than 6.0)

{

os.platform().customdevicdeId

}

else

{

os.platform().identifierForVendor

}

Usage of advertisingIdentifier

If ( OS version is less than 6.0)

{

os.platform().customdevicdeId

}

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.

Camera scaleFactor and maxSideOfTheImage was not respected in old builds and now is getting respected.

This means you may need to check your camera / RDC functionality for any issues and fine tune scaleFactor or maxSideOf the image properties accordingly.

Separator Line was not getting stretched in Segmented UI on iOS 7. This was happening when the dictionary view support is on.

Browser widget height is calculated wrongly and same is set correct.

3. Issues Fixed – UI Issues


There is a change in how the back button and left button on the title bar works in iOS 7.

In iOS 6 even if both of them present only left button takes priority compared to Back button. In iOS 7, apple expects them one of them to be invisible and if both of them present leads to transition issues in the back button.

Kony team has fine tuned the platform code for this new behavior in iOS 7

Adhoc crashes during form transition.

3. Issues Fixed – UI Issues …


Known Issues


Label wrapping, sizing issues size difference b/w iOS6 and iOS7.

Even in GM there are still label wrapping issues are observed when label contains the extra white spaces, new lines and some special characters. Please see the below forum links:

– https://devforums.apple.com/message/886877#886877




– https://devforums.apple.com/search.jspa?resultTypes=MESSAGE&peopleEnabled=true&q=UILabel

Your app may see some issues compared to the iOS 6 in how the labels getting wrapping in iOS 7. Especially if label contains extra white spaces, new lines and some special characters.

Guideline to app developers - Avoid spaces, new lines, special characters to do text formatting rather have explicitly multiple label widgets for formatting the text into multiple lines.

We are expecting apple soon will correct these issues and kony will keep working on alternative solutions.

1. Known Issues –

https://devforums.apple.com/message/886877%23886877




https://devforums.apple.com/search.jspa?resultTypes=MESSAGE&peopleEnabled=true&q=UILabel


Label – character wrapping option is not working straight. We are expecting apple would fix this soon.

iOS 7 takes little more space for the same fonts when compared to iOS 6.

Places where you see slightly one or two pixels getting cut off is due to the fact that fonts in iOS 7 slightly require more space compared to iOS 6. This is very subtle difference between iOS 6 and iOS 7 and most of the cases should work as expected.

Few cases where you observe few pixels in the text getting cut off, only way out is to increase the % of width given to label little bit and see things won't get cut off few pixels.

These label wrapping issues, fonts taking little more space may get manifested in few places in your app. If you do observe these issues, increase the % of width given to label, buttons little bit and see things won't get cut off few pixels.

For all known issues, kony will keep posting the updates in dev forums, portal.

1. Known Issues –


iPhone 4 and iOS 7 – this combination is observed to be slow in rendering animations and complex widget hierarchies. This is because A4 old processors on iPhone 4 struggles to meet the demands of iOS 7.

http://arstechnica.com/apple/2013/09/new-lease-on-life-or-death-sentence-ios-7-on-the-iphone-4/

Fonts are more sharper on iOS 7 compared to iOS 6 and this means you may see some brightness changes in the text rendered in Labels, Button in iOS 7 compared to iOS6.

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?


Apple changed the specification for app icons that will be used for retina display.

So far iOS 6 had been using app icons at a resolution of 114×114 whereas the leap to iOS 7 has seen the size grow to 120×120. For iPads, this size has gone from 144×144 to 152×152 on iOS 7.

Essentially apple expects the above changes in the icons for their retina display devices. Currently apple is not blocking the submission if icons doesn't follow the new rules but may do the same soon.

Kony recommendsall customers the usage of icons with new specification ASAP.

For more details please see the below URL:

http://9to5mac.com/2013/08/30/apple-inadvertently-asking-developers-for-ios-7-optimized-app-icons/

7. App icons – do I need to adhere to the latest spec from Apple while submitting the apps ?




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 10th, 2013.

Apple GM compliant patch on September 10th, 2013.

Final GM compatible patch from Kony on September 16th, 2013

8. Kony compatibility patch release plan


Thank You

1 copyright © 2013 kony inc. confidential 1 ios 7 : kony platform compatibility date: sep 16 th...

Documents

use os

customdeviceid os

lua os

applicable os

confidential apis

ios versions ios

impacted kony apis

new ios