apple tv release notes - adobe inc. apple tv release notes apple tv support with air 26, apple tv...

Download Apple TV Release Notes - Adobe Inc. Apple TV Release Notes Apple TV support With AIR 26, Apple TV will

Post on 20-Jul-2020

0 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

  • 1.

    2.

    1.

    2.

    3.

    4.

    1. 2.

    Apple TV Release Notes

    Apple TV support

    With AIR 26, Apple TV will be part of regular AIR SDK releases. It will not be restricted for beta channels only. Although it will be of Beta quality.

    We had added tvOS (v9.2 or later) as a new platform in in AIR SDK 24. With the following modifications, most of the existingAIR Beta Channel 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,

    and .Devices, and Profiles, 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.

    UIDeviceFamily 3 ]]>

    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. T irection of the tap can be judged by referringhis helps in navigating through a collection of items one-by-one. D 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 property in Swipe Events to manage the fast movements based on the strength of swipe.velocity 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. 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.focus To assign focus to StageText, use stageText.assignFocus()

    ANE Support for Apple TV

    https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/TestingYouriOSApp/TestingYouriOSApp.html https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html https://developer.apple.com/library/content/documentation/General/Conceptual/AppleTV_PG/ https://developer.apple.com/tvos/human-interface-guidelines/remote-and-controllers/ http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/Stage.html#focus http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#assignFocus%28%29

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

    sample.a SampleExtInitializer SampleExtFinalizer

    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 -C appleTV-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 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 file from the package. You can package the app with the extracted as shown in the following ADT command.Assets.car Assets.car

    -package -target ipa-app-store -provisioning-profile -keystore -storetype pkcs12 -storepass Assets.car

    Add the tags mentioned below in the application descriptor file before packaging for your images:

    https://developer.apple.com/tvos/human-interface-guidelines/icons-and-images/

  • UILaunchImages

    UILaunchImageSize {1920, 1080} UILaunchImageName LaunchImage UILaunchImageMinimumOSVersion 9.0 UILaunchImageOrientation Landscape

    TVTopShelfImage

    TVTopShelfPrimaryImage Top Shelf Image TVTopShelfPrimaryImageWide Top Shelf Image Wide

    CFBundleIcons

    CFBundlePrimaryIcon App Icon - Small

    Support for embed bitcode in Apple TV applications

    Starting AIR 25, supports a new switch - to add bitcode in your iOS and tvOS applications. To read more about Bitcode read ADT embedBitcode .here

    Switch details: Name of the switch: -embedBitcode Values(iOS): yes or no. Defaults to no Values(tvOS):yes or no. Defaults to no(yes for ipa-app-store target as it is a mandatory requirement by Apple) Usage: -embedBitcode yes Order: Just before the code signing options Example ADT packaging command: /bin/adt -package -target -embedBitcode yes -provisioning-profile -storetype pkcs12 -keystore -storepass Example.ipa Example-app.xml Example.swf

    Note:

    1. Embedding bitcode will enable AIR developers to upload their tvOS applications on the AppStore where bitcode is required.

    2. Embedding bitcode in your application will increase both application’s size and packaging time.

    3. Embedding bitcode requires that all your ANE’s should also include bitcode. If not present, adt can throw error packaging errors as below-

    ld: bitcode bundle could not be generated because '/var/folders/d3/yxwv5yn5715fk31lq36lnk780000gn/T/805ef2d4-5fe2-4ec9-a773-a3cc39845fa1/lib.nativeExtension.systemVersion.a(systemVersi on.o)' was built without full bitcode. All object files and libraries for bitcode must be generated from Xcode Archive or Install build for architecture arm64

    Compilation failed while executing : ld64

    Using Adobe Scout for Apple Tv

    Developers can now use Adobe Scout for profiling on Apple TV. Please refer to http://www.adobe.com/devnet/scout/articles/adobe-scout-getting- for more details.started.html#appletv

    http://help.adobe.com/en_US/air/build/WS5b3ccc516d4fbf351e63e3d118666ade46-7fd9.html https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/AppThinning/AppThinning.html#//apple_ref/doc/uid/TP40012582-CH35-SW2 http://www.adobe.com/devnet/scout/articles/adobe-scout-getting-started.html#appletv http://www.adobe.com/devnet/scout/articles/adobe-scout-getting-started.html#appletv

  • 1. 2.

    3.

    4. 5.

    6.

    1.

    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.

    Known Issues

    Local Shared Object .sol file does not get created on tvOS because of filesystem issues

    https://developer.apple.com/tvos/human-interface-guidelines/ https://developer.apple.com/tvos/

Recommended

View more >