1.

2.

1.

2.

3.

4.

1. 2.

Apple TV Beta Release Notes

Apple TV support

We have added tvOS (v9.2 or later) as a new platform in   beginning with AIR SDK 24. With the following modifications, most ofAIR Beta Channelthe 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 differentfrom the one that is used for iOS. The packaging command and the targets to be used for packaging tvOS applications remain the sameas that for iOS. Refer to these resources for more details:   Exporting Your App for Testing (iOS, tvOS, watchOS), Maintaining Identifiers,

 and  .Devices, and Profiles, App Programming Guide for tvOSDevelopers must provide UIDeviceFamily value of 3 in the application descriptor for tvOS platform. However, if this value is not providedand tvOS provisioning is given, then the UIDeviceFamily value equal to 3 is added automatically in the final IPA that is generated. 

<iPhone>    <InfoAdditions><![CDATA[        <key>UIDeviceFamily</key>        <array>            <string>3</string>        </array>    ]]></InfoAdditions></iPhone>

 

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 directionaltap from the Siri Remote. T irection of the tap can be judged by referringhis helps in navigating through a collection of items one-by-one. Dto 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, thevalues of stageX and stageY properties remain fixed as received from the native operating system, which is the center of the screen. AIRdevelopers can read a new   property in Swipe Events to manage the fast movements based on the strength of swipe.velocityMouse 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 toTOUCH_POINT.Menu and Play/Pause Buttons - In addition to Siri Remote Touch surface support, we have also added support for the Menu andPlay/Pause buttons. AIR developers can subscribe to KeyboardEvents.KEY_DOWN and KEY_UP events to listen to these buttonpresses. Use the preventDefault method to override the default behavior or Menu button.

  keycode keyname

Menu 0x01000012 KEYNAME_MENU="Menu"

Play/Pause 0x01000020 KEYNAME_PLAYPAUSE="PlayPause"

Follow   for using Siri Remote Buttons and Gestures in your applications.Apple's Guidelines

StageText Support for Apple TV

StageText on Apple TV takes focus by default. To manage focus between different objects in your application keep a note of below points:

To override default focus from StageText, or to assign focus to any other display object use stage.focusTo assign focus to StageText, use stageText.assignFocus()

ANE Support for Apple TV

ANE for tvOS can be packaged by adding a new platform "appleTV-ARM" in extension.xml.

 

<platform name="appleTV-ARM">     <applicationDeployment>         <nativeLibrary>sample.a</nativeLibrary>         <initializer>SampleExtInitializer</initializer>         <finalizer>SampleExtFinalizer</finalizer>     </applicationDeployment> </platform>

 

You need to place the native .a and library.swf in a folder called appleTV-ARM. Sample ane packaging command -  

adt -package -target ane sampleAne.ane extension.xml -swc sampleLibrary.swc -platform appleTV-ARM -CappleTV-ARM library.swf sample.a

 

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 TVapplication.

Step 1. On your Mac, open Xcode and choose File > New > Project > tvOS Application > Single View Application. Provide a name to the app andclick 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   file from the package. You can package the app with the extracted   as shown in the following ADT command.Assets.car Assets.car 

<path to adt> -package -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: 

1. 2.

3.

4. 5.

6.

1. 2. 3.

<key>UILaunchImages</key><array>  <dict>    <key>UILaunchImageSize</key>    <string>{1920, 1080}</string>    <key>UILaunchImageName</key>    <string>LaunchImage</string>    <key>UILaunchImageMinimumOSVersion</key>    <string>9.0</string>    <key>UILaunchImageOrientation</key>    <string>Landscape</string>    </dict></array><key>TVTopShelfImage</key><dict><key>TVTopShelfPrimaryImage</key><string>Top Shelf Image</string></dict><key>CFBundleIcons</key><dict><key>CFBundlePrimaryIcon</key><string>App Icon - Small</string></dict>

 

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 writeaccess 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 TVApple 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 anyeffect.Apple TV does not support Clipboard.

Known Issues

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.ANE workflows for tvOS have not been tested enough, please expect some instability.