Files
AsyncDisplayKit/_docs/upgrading.md
2016-08-27 10:13:08 -07:00

1.5 KiB

title, layout, permalink, prevPage, nextPage
title layout permalink prevPage nextPage
Upgrading to 2.0 <b><i>(New)</i></b> docs /docs/upgrading.html installation.html image-modification-block.html

AsyncDisplayKit 2.0 Beta is (almost) here! Here's a brief summary of the changes on master as of today:

Find & replace API naming improvements:

  • .usesImplicitHierarchyManagement renamed to .automaticallyManagesSubnodes
  • ASRelativeDimensionTypePercent and associated functions renamed to use Fraction to be consistent with Apple terminology.

Updated Interface State callback method names The new names are meant to unify the range update methods to show how they relate to each other & hopefully be a bit more self explanatory:

  • didEnter/ExitPreloadState

  • didEnter/ExitDisplayState

  • didEnter/ExitVisibleState These new methods replace the following:

  • loadStateDidChange:(BOOL)inLoadState

  • displayStateDidChange:(BOOL)inDisplayState

  • visibleStateDidChange:(BOOL)isVisible

Make sure to check:

  • constrainedSizeForNodeAtIndexPath: moved from the .dataSource to the .delegate to be consistent with UIKit definitions of the roles. Note: Make sure that you provide a delegate for any ASTableNode, ASCollectionNode or ASPagerNodes that use this method.

Good to know:

  • Layout Transition API (transitionLayoutWithDuration:) has been moved out of Beta

The majority of the remaining (unmerged) changes will be in the Layout API.