Prepare for release

Author: sunnyxx

README.md

@@ -25,30 +25,27 @@ If you have a **self-satisfied** cell, then all you have to do is:
 
 ## Height Caching API
 
-Since iOS8, `-tableView:heightForRowAtIndexPath:` will be called more times than we expect, we can feel these extra calculations when scrolling. So we provide another API with caches:   
+Since iOS8, `-tableView:heightForRowAtIndexPath:` will be called more times than we expect, we can feel these extra calculations when scrolling. So we provide another API with cache by index path:   
 
 ``` objc
-- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath
-{
+- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
     return [tableView fd_heightForCellWithIdentifier:@"identifer" cacheByIndexPath:indexPath configuration:^(id cell) {
         // configurations
     }];
 }
 ```
 
-### Auto cache invalidation
-
-Extra calculations will be saved if a height at an index path has been cached, besides, **NO NEED** to worry about invalidating cached heights when data source changes, it will be done **automatically** when you call "-reloadData" or any method that triggers UITableView's reloading.
+Or, if your entity has an unique identifier, use cache by key API:
 
-## Precache
-
-Pre-cache is an advanced function which helps to cache the rest of offscreen UITableViewCells automatically, just in **"idle"** time. It helps to improve scroll performance, because no extra height calculating will be used when scrolls. It's enabled by default if you use "fd_heightForCellWithIdentifier:cacheByIndexPath:configuation:" API.
-
-## About estimatedRowHeight
-`estimatedRowHeight` helps to delay all cells' height calculation from load time to scroll time. Feel free to set it or not when you're using FDTemplateLayoutCell. If you use "cacheByIndexPath" API, setting this estimatedRowHeight property is a better practice for imporve load time, and it **DOES NO LONGER** affect scroll performance because of "precache".
 ``` objc
-self.tableView.estimatedRowHeight = 200;
+- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
+	Entity *entity = self.entities[indexPath.row];
+    return [tableView fd_heightForCellWithIdentifier:@"identifer" cacheByKey:entity.uid configuration:^(id cell) {
+        // configurations
+    }];
+}
 ```
+
 ## Frame layout mode
 
 `FDTemplateLayoutCell` offers 2 modes for asking cell's height.  
@@ -64,8 +61,7 @@ cell.fd_enforceFrameLayout = YES;
 And if you're using frame layout mode, you must override `-sizeThatFits:` in your customized cell and return content view's height (separator excluded)
 
 ```
-- (CGSize)sizeThatFits:(CGSize)size
-{
+- (CGSize)sizeThatFits:(CGSize)size {
     return CGSizeMake(size.width, A+B+C+D+E+....);
 }
 ```
@@ -119,7 +115,7 @@ A template layout cell is created by `-dequeueReusableCellWithIdentifier:` metho
 
 ## Installation
 
-Latest version: **1.3**
+Latest version: **1.4.beta**
 
 ```
 pod search UITableView+FDTemplateLayoutCell 
@@ -134,6 +130,9 @@ pod setup
 
 We recommend to use the latest release in cocoapods.
 
+- 1.4
+Refactor, add "cacheByKey" mode, bug fixed
+
 - 1.3  
 Frame layout mode, handle cell's accessory view/type
 

UITableView+FDTemplateLayoutCell.podspec

@@ -1,7 +1,7 @@
 
 Pod::Spec.new do |s|
   s.name         = "UITableView+FDTemplateLayoutCell"
-  s.version      = "1.3"
+  s.version      = "1.4.beta"
   s.summary      = "Template auto layout cell for automatically UITableViewCell height calculate, cache and precache"
   s.description  = "Template auto layout cell for automatically UITableViewCell height calculate, cache and precache. Requires a `self-satisfied` UITableViewCell, using system's `- systemLayoutSizeFittingSize:`, provides heights caching."
   s.homepage     = "https://github.com/forkingdog/UITableView-FDTemplateLayoutCell"
@@ -13,7 +13,7 @@ Pod::Spec.new do |s|
   # ――― Platform Specifics ――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
   s.platform = :ios, "6.0"
   # ――― Source Location ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
-  s.source = { :git => "https://github.com/forkingdog/UITableView-FDTemplateLayoutCell.git", :tag => "1.3" }
+  s.source = { :git => "https://github.com/forkingdog/UITableView-FDTemplateLayoutCell.git", :tag => "1.4.beta" }
   # ――― Source Code ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
   s.source_files  = "Classes/*.{h,m}"
   # ――― Project Settings ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #