Skip to content

README 中文說明.md

Jump to bottom
yhlin edited this page Jun 28, 2016 · 1 revision

AppDevKit

Build Status codecov CocoaPods

AppDevKit 是一套iOS 開發套件，為了讓功能不用重複被實作，AppDevKit整理了很多經常使用的的功能。

AppDevKit是雅虎台灣iOS 團隊三年來開發經驗的累積。目前AppDevKit正應用在雅虎台灣的多個App當中，並帶來穩定和便利性。我們期望未來將持續使用並更強化這個套件的功能。使未來的App開發更加的容易並維持一致性。 AppDevKit主要分為五大功能：包含了基本的文字、日期、作業系統資訊。以及UI component，UIView animations、圖片濾鏡，以及table view, collection view工具。AppDevKit目前已提供CocoaPods install。AppDevKit使用開源BSD授權。

我們竭誠歡迎大家一起來讓這個開源計劃更好！如果您有任何建議或發現需要修正的地方，歡迎直接與cfsung@yahoo-inc.com聯繫，或和我們的開發團隊app-dev-kit@yahoo-inc.com聯絡

如何使用AppDevKit

透過CocoaPods引入

目前最簡單引入AppDevKit的方法，為使用cocoaPods，請修改您建立好的Podfile如下：

source 'https://github.com/CocoaPods/Specs.git'  

pod 'AppDevKit'

AppDevKit可拆解成5個sub-pods. 分別為AppDevCommonKit, AppDevUIKit, AppDevAnimateKit, AppDevImageKit and AppDevListViewKit. 如果只想使用AppDevKit的部分功能，可以改引入AppDevKit的Subspec如下:

source 'https://github.com/CocoaPods/Specs.git'  

# Only insatll image kit in AppDevKit
pod 'AppDevKit/AppDevImageKit'

基本用法

除了分別import需要的header檔外，也可以在prefix file (.pch, Xcode 6前會預設自動產生) import:

#import <AppDevKit.h>

如此可以讓整個專案都使用AppDevKit

Common Tools

  • ADKAppUtil > 包含版本判斷iOS版本、螢幕比例長寬等基本工具
  • ADKStringHelper > 提供了折扣數字(84折)、日期計算(1天前)等function(目前僅先支援繁體中文)
  • ADKCalculatorHelper > 包含了隨機數、常用的CGRect、screen size等
  • ADKNibCacheManager > 將計算過的nib instance快取起來，方便下次計算時使用
  • UIView+ADKGetUIViewController > 取得當前的view的view controller
  • UIColor+ADKHexPresentation > 提供多種UIColor對16進位色碼的處理工具
  • ADKViewExclusiveTouch > 處理防止view被同時點擊的問題

UI Tools

  • UIView+ADKAutoLayoutSupport > 提供常用的autolayout功能，包含隱藏/顯示長寬、各邊界
  • UIScrollView+ADKPullToRefreshView > 提供在UIScrollView, UITableView以及UICollectionView加入下拉重整元件，開發者可以輕易的在scroll view的頂部加上interactive的重整元件
  • UIScrollView+ADKInfiniteScrollingView > 提供在UIScrollView, UITableView以及UICollectionView加入載入更多元件，開發者可以輕易的在scroll view的底部加上interactive的載入更多元件
  • ADKModalMaskView > 讓自定大小的更簡單！並且可容易的加入動畫（可適用於iOS 7）
  • ADKGradientView > 提供多種方向的漸層view
  • ADKDashedLineView > 協助繪製虛線view

Animation Tools

  • UIView+ADKAnimationMacro > 將動畫包成巨集，輕易的在view上完成動畫

Image Tools

  • UIImage+ADKColorReplacement > 快速的將圖片變成不同顏色、或進行色彩取代
  • UIImage+ADKImageFilter > 提供對UIImage加上模糊、裁切、縮放、或者套用濾鏡
  • UIImage+ADKDrawingTemplate > 可將PDF畫成任意大小的無損圖片

ListView Tools

  • UICollectionView+ADKOperation > 提供讓scroll view停止減速，強制停止捲動的function
  • ADKNibSizeCalculator > 改變xib file大小時不需要再改code，並可依照需求設定縮放大小：如固定高度、等比縮放、不做縮放等
  • ADKCellDynamicSizeCalculator > 讓計算不固定寬/高度的UICollectionViewCell和UITableViewCell(如留言、對話)不再是麻煩事
  • ADKCollectionViewDynamicSizeCell > 動態寬/高的UICollectionViewCell base class
  • ADKTableViewDynamicSizeCell > 動態寬/高的UITableViewCell base class

相關資源

授權條款

本專案開源基於Yahoo! Inc. BSD license

請參考授權條款 獲得進一步資訊

Clone this wiki locally