AsyncDisplayKit/_docs/upgrading.md

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 for Automatic Subnode Management
• 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.