Welcome to the latest AIR Runtime and SDK version 24 beta! We've been hard at work adding new features to AIR and we're looking forward to receiving feedback from our development community.
This beta release includes new features as well as enhancements and bug fixes related to security, stability, performance, and device compatibility for AIR Runtime and SDK 24. For full details, please see our release notes
New and Updated Features
Apple TV support
We have added tvOS (v9.2 or later) as a new platform in AIR Beta Channel beginning with AIR SDK 24. With the following modifications, most of the existing content in your AIR application should work seamlessly on tvOS (Apple TV 4th generation and later):
- To create a package for tvOS, the developers need to provide a valid provisioning profile for tvOS. This provisioning profile is different from the one that is used for iOS. The packaging command and the targets to be used for packaging tvOS applications remain the same as that for iOS. Refer to these resources for more details: Exporting Your App for Testing (iOS, tvOS, watchOS), Maintaining Identifiers, Devices, and Profiles, and App Programming Guide for tvOS.
- Developers must provide UIDeviceFamily value of 3 in the application descriptor for tvOS platform. However, if this value is not provided and tvOS provisioning is given, then the UIDeviceFamily value equal to 3 is added automatically in the final IPA that is generated.
Following warnings appear if there is a mismatch between the provisioning profile and the UIDeviceFamily value:
Warning: Provisioning profile specified for tvOS, ignoring iOS UIDeviceFamily value(s).
Warning: Provisioning profile specified for iOS, ignoring tvOS UIDeviceFamily value(s).
Apple TV Siri Remote support
- TransformGestureEvent.GESTURE_DIRECTIONAL_TAP - A new UIDeviceFamily gesture has been introduced to support directional tap from the Siri Remote. This helps in navigating through a collection of items one-by-one. Direction of the tap can be judged by referring to the offsetX and offsetY values of the event object similar to a SwipeEvent.
- TransformGestureEvent.GESTURE_SWIPE - Swipe Events are now supported on Apple TV similar to other platforms. However, the values of stageX and stageY properties remain fixed as received from the native operating system, which is the center of the screen. AIR developers can read a new velocity property in Swipe Events to manage the fast movements based on the strength of swipe.
- Mouse Events and Touch Events - Mouse Events on Apple TV are generated only on Siri Remote Click, and are thus limited to CLICK, MOUSE_UP, and MOUSE_DOWN. Touch Events are generated on Siri Remote Touch when Multitouch.inputMode is set to TOUCH_POINT.
- Menu and Play/Pause Buttons - In addition to Siri Remote Touch surface support, we have also added support for the Menu and Play/Pause buttons. AIR developers can subscribe to KeyboardEvents.KEY_DOWN and KEY_UP events to listen to these button presses.
keycode keyname Menu 0x01000012 KEYNAME_MENU="Menu" Play/Pause 0x01000020 KEYNAME_PLAYPAUSE="PlayPause"
Creating icons and images for Apple TV applications
Follow the steps below to create Assets.car using Xcode for generating application icons, launch images, and TopShelf Images for your Apple TV application.
Step 1. On your Mac, open Xcode and choose File > New > Project > tvOS Application > Single View Application. Provide a name to the app and click create. In the general tab of your project, select Deployment Target as 9.2.
Step 2. Click Assets.xcassets in the left column and drag your images to different sections App Icon - Large, App Icon - Small, Top Shelf Image, and Launch Image.
For icon sizes and specifications, follow Apple's guidelines for tvOS icons and images.
Step 3. Run this native app on your tvOS device (tvOS 9.2+) and check if your icons and images appear correctly.
Go to the .app file created in your file system where you created the project — right click on .app file and show package contents.
Copy the Assets.car file from the package. You can package the app with the extracted Assets.car as shown in the following ADT command.
<path to adt> -
-target ipa-app-store -provisioning-profile <.mobileprovision> -keystore <.p12> -storetype pkcs12 -storepass <password> <.ipa> <.xml> <.swf> Assets.car
Add the tags mentioned below in the application descriptor file before packaging for your images:
<string>Top Shelf Image</string>
<string>App Icon - Small</string>
Points to note
- The maximum size for a tvOS app bundle is 200 MB.
- Accessing File system, except Cache Directory, throws error 3001: File or directory access denied. The applications on tvOS have write access only in the cache Directory. This is purge-able by the operating system when space is low.
- Creating a cursor-like implementation in your app on tvOS can lead to app rejection by Apple, as it does not comply with the Human Interface Guidelines for Apple TV.
- Apple TV applications are 64-bit only.
- The AIR property SoundMixer.audioPlaybackMode defaults to VOICE on Apple TV. Changing its value to MEDIA does not have any effect.
- Apple TV does not support Clipboard.
- StageText takes complete focus in the application and therefore nothing else can be clicked.
- tvOS applications do not upload to the Apple App Store.
- Local Shared Object .sol file does not get created on tvOS because of filesystem issues.
- GameInput APIs may work on Apple TV AIR applications but can be unstable.
- The AIR property Microphone.isSupported returns true instead of false.
- Apple TV simulator does not launch using the launchApp command.
- ANE workflows for tvOS do not work.
Android SDK Upgrade
Beginning with AIR 24, Android SDK (API Level 24) has been upgraded in the AIR Runtime.
Important: If you upload an app on Google Play using AIR SDK 24 and default targetSdkVersion value as 24 in the application descriptor, Google Play does not allow uploading the next version of your app with AIR SDK 23 or earlier (see the error message below). Using targetSdkVersion value as 21 allows you to switch between AIR SDK 24 and AIR SDK 23 for your app updates.
Here is the list of version numbers of the tools upgraded in AIR 24.
|Android Support Repository||36|
|Android Google Repository||32|
|Android Build Tool||24.0.1|
Permissions on Android and iOS
Beginning with Android 6.0 (API level 23), the users now need to grant permissions to apps while it is running, not when they install the application. To handle the permissions requests and status, we have introduced Permissions API for Android and iOS. The developers can request permissions for classes like Camera, Microphone, Geolocation, CameraRoll, CameraUI, File, and FileReference. The applications must be packaged with AIRSDK 24 or greater and must have SWF version 35 or later. Apps built using these APIs throw a dialog only on Android 6.0 and later. For Android 5.0 or earlier, you can continue to mention permissions in the application descriptor file.
For iOS, the APIs listed below are optional if you do not want to handle permissions explicitly in ActionScript. On Android, If you do not want to handle permissions in your application, use targetSdkVersion less than 23 in your application descriptor file.
- permissionStatus: This property informs whether the application has been granted the required permission or not. This property always returns the status as GRANTED on AIR desktop and Android apps that have targetSDKVersion less than 23. The list of properties for PermissionStatus class includes UNKNOWN,GRANTED, and DENIED. The property UNKNOWN specifies that the permission hasn’t been requested yet or the permission has been denied by user with check box option 'Don’t ask again.'.
- requestPermission(): The method requestPermission requests for the permission to be granted to the application. A PermissionEvent is dispatched when the user grants or denies a permission.
- PermissionError: Accessing properties and methods of such ActionScript classes without requesting for permission throws Error #3800 PermissionError.
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
cam = Camera.getCamera();
(Camera.permissionStatus != PermissionStatus.GRANTED)
(e.status == PermissionStatus.GRANTED)
// permission denied
// another request is in progress
For training resource on Android permissions, see https://developer.android.com/training/permissions/index.html.For information about iOS permissions, see Apple's documentation https://developer.apple.com/ios/human-interface-guidelines/interaction/requesting-permissi on/.
Points to note
- A new feature for iOS 10 submissions requires you to add the 'purpose string' to your app when accessing a user's private data such as Camera or Photos. For information about providing keys in your app descriptor file, see Information Property List Key Reference | Cocoa Keys.
- While requesting for multiple permissions simultaneously, runtime throws the error below:
Error #3801: Another permission request is in progress.
- Accessing the File class without requesting for permissions throws Error #3012, which is the old behavior of File API.
- On Android, the application crashes while accessing some of the properties or methods of File and FileReference class before requesting permissions.
- On Android, excluding permission from the application descriptor file returns PermissionStatus as UNKNOWN.
- On Android, CameaUI does not work for targetSdkVersion as 24.
- On iOS, CameraRoll does not work when the user taps 'Allow' on requesting permission.
- On iOS, the application crashes while requesting geo.setUpdateHandler.
Custom fonts support for StageText on iOS and Android
Beginning with AIR 24, we have introduced support for Custom fonts on StageText for iOS and Android. Earlier, StageText was created with specific system fonts. With the introduction of this feature, the AS developers now have more flexibility in using fonts apart from the ones present in system. The developers can use ttf and otf font files. The changes required to use custom fonts are listed below.
1. Changes required in the application descriptor xml.
Note: To access this functionality, the Namespace value in the app descriptor must be 24.0 or greater.
2. Changes required in the ActionScript code
The developers can provide any value under fontName tag, for example FontID1 here.
.stage = stage;
- For packaging the .apk file using Flash Builder, the developer needs to provide absolute fontPath.
- With Java 1.6 on Windows, otf files are not rendered for IPAs.
Asynchronous texture upload for mobile
Till AIR 23, the texture upload was synchronous. Therefore, the developers had to wait till the new texture was uploaded successfully.With AIR 24, you can now upload textures asynchronously while the current texture is being rendered. This ensures a better UI performance for AIR applications and a smoother user experience.On successful completion of asynchronous texture upload, a TEXTURE_READY event will be generated. Asynchronous upload of texture data for all the texture formats is done using the following two new APIs:
- uploadFromBitmapDataAsync( source:BitmapData, miplevel:uint = 0)
- uploadFromByteArrayAsync( data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0 )
This feature supports Normal and Rectangular texture for miplevel 0 only.
Anti-Aliasing using configureBackBuffer() on iOS
Anti-Aliasing is useful in improving the perceived image quality in applications. Hardware base Multisampling Anti-Aliasing (MSAA) is now available for iOS using Contex3D.configureBackBuffer.This feature was previously available for Desktop and Flash Player. To enable MSAA, set the level from 0 to 2 using the configureBackBuffer. The following are the effect of levels of antialiasing values:
0=1 subsample, No antialiasing
1=2 subsamples, medium antialiasing
2=4 subsamples, high antialiasing.
If you provide higher level of antialiasing (more than 2), the level will be clipped to either the maximum level of anti-aliasing supported by GPU or the value of 2.
Note: This feature is currently not available on Android using configureBackbuffer.
API assumptions and dependencies
- Anti-Aliasing is not available in software mode rendering.
- The application use extra GPU memory when using anti-aliasing and hence can cause slight performance degradation.
- Exponential Increase in GDI object handler due to which application quits unexpectedly (4194045).
- [Windows 7]Memory leak is observed when using Cairo and HTML5 canvas in AIR Desktop Runtime(4192545).
- Starling.display.Image mask is not rendering on mobile when rendered with starling.textures.RenderTexture (4196946).
- [iOS] Failed to find class DTiPhoneSimulatorSystemRoot at runtime error on trying to install App on iPhone Simulator (4186457).
- [iOS] Capabilities.cpuArchitecture returning wrong value for iOS Simulator.
- [Mac] Application quits unexpectedly on Mac with OS X exception (SIGSEGV) KERN_INVALID_ADDRESS(4195975).
- [Mac] FLEX AIR application (digi.me) quits unexpectedly (4152837).
- [Mac] AIR application quits unexpectedly on network changes or screen invalidation(4011481).
- [iOS] UIDeviceFamily values are now integers.
- [Android] While using Android Video, video will hang for a second when other operations occur such ad addChild (4161877).
- [Android]Video blacks out and only audio plays when user stops and restarts the video ( 4194916)
- [Android] HLS video using video texture is not playing.
- [iOS] Background sound stuttering when going idle (4184841).
- [iOS] GameInput API now supports iOS8 devices.
- [Android] StageWebView plays video without sound in full screen for URL(ok.ru).
- [Android] While using immersive mode on devices having soft navigational keys, pink bar appears under that navigational area (4100625).
Authoring for Flash Player 24 and AIR 24
- Update application descriptor namespace to 24
- SWF version should be 35
For system requirements of the current release of AIR in production, visithttp://www.adobe.com/products/air/systemreqs/
About the Beta Channel
To get the latest Beta build of AIR Runtime and SDK visit Adobe labs
If you would like real-time notification for announcements related to the AIR Beta Channel please follow the Flash Runtime Announcements forums by choosing "Follow this forum" from the right-hand menu on the Forums page.