您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 開源專案大合輯:用 Plist 建立可搜尋的元件庫

編輯:iOS 開發綜合

GitHub 上的 iOS 開源庫多到沒人能全部記住,真正需要的時候又總是找不到。這個範例的作法是:把一份龐大的開源清單整理成 Plist,再用三個模型類別把它讀進來,做成一個可以分類瀏覽、隨時查閱的離線元件庫。

一、資料結構設計

整個清單是典型的三層結構,用 Plist 表達最直覺:

  • 最外層字典:大分類,例如「控件」、「網絡」、「音頻」、「遊戲」、「圖像」。
  • 中間層字典:子分類,例如 HUD、Slider、Progress、側滑、Popover、下拉刷新。
  • 最內層字典:具體的開源專案,包含專案名稱、作者與簡短描述。

實際的清單涵蓋範圍相當廣,大致包含以下幾大類:

  • 控件:HUD、Slider、Progress、側滑選單、Popover、下拉刷新、狀態列、GridView、Alert、Segment、Switch、Button、TableView 相關、Notification、Label 與富文本。
  • 系統基礎庫:各類 Category 與 Utility 擴充、加密雜湊、Keychain 存取、Core Data 包裝、SQLite 封裝。
  • 網絡:AFNetworking、ASIHTTPRequest、MKNetworkKit、RestKit、CocoaAsyncSocket、Reachability、XMPPFramework、SocketRocket,以及 JSON 與 XML 解析庫。
  • 圖像:GPUImage、圖片瀏覽器、Color Picker、繪圖與圖表庫。
  • 動畫:Core Animation 範例集、動畫曲線、iCarousel、翻頁與折紙效果。
  • 音頻與遊戲:TheAmazingAudioEngine、AudioStreamer、OpenAL 包裝,以及 cocos2d、Sparrow 等 2D 引擎。
  • 完整 App 與開發工具:各類客戶端實作、Reveal 之外的除錯工具、測試框架、Xcode 外掛。

二、三個模型類別

BigCategory —— 大分類

// BigCategory.h
// 開源項目之大類別,成員:name 與陣列
#import <Foundation/Foundation.h>

@interface BigCategory : NSObject
/** 大分類的名稱:如網絡、音頻、游戲、圖形、控件等 */
@property (nonatomic, copy) NSString *name;
/** 陣列,元素為 SubCategory 物件 */
@property (nonatomic, strong) NSArray *subCatArr;
/** 若沒有子分類,則直接放 projectArr */
@property (nonatomic, strong) NSArray *projectArr;
@end

SubCategory —— 子分類

// SubCategory.h
// 開源項目之子類別,成員:name 與陣列
#import <Foundation/Foundation.h>

@interface SubCategory : NSObject
/** 子分類的名稱:如 JSON、XML 等 */
@property (nonatomic, copy) NSString *name;
/** 陣列,元素為一個個 Project 物件 */
@property (nonatomic, strong) NSArray *list;
@end

Project —— 單一開源專案

// Project.h
// 具體的工程物件,成員:工程名、作者、描述
#import <Foundation/Foundation.h>

@interface Project : NSObject
/** 工程的名字 */
@property (nonatomic, copy) NSString *name;
/** 工程的描述 */
@property (nonatomic, copy) NSString *desc;
/** 工程作者 */
@property (nonatomic, copy) NSString *owner;
@end

三、控制器:從 Plist 讀進來並攤平輸出

這裡有個關鍵設計:大分類底下可能有子分類,也可能直接就是專案清單,兩種情況要分別處理。程式碼利用 MJExtension 提供的 objectArrayWithKeyValuesArray: 直接把字典陣列一口氣轉成模型陣列。

- (void)viewDidLoad {
    [super viewDidLoad];

    NSString *fileName = [[NSBundle mainBundle] pathForResource:@"ios_resources.plist" ofType:nil];

    // 透過 plist 建立模型陣列
    _BigCatArr = [BigCategory objectArrayWithFile:fileName];

    for (BigCategory *bigCat in _BigCatArr) {
        NSLog(@"|---分類:%@", bigCat.name);

        if (bigCat.subCatArr.count > 0) {
            // 有子分類,才需要遍歷子分類
            // 成員目前是字典陣列,需轉成物件陣列
            NSArray *subCatArr = bigCat.subCatArr;
            bigCat.subCatArr = [SubCategory objectArrayWithKeyValuesArray:subCatArr];

            for (SubCategory *subCat in bigCat.subCatArr) {
                NSLog(@"| |---子目錄:%@", subCat.name);

                NSArray *projectArr = subCat.list;
                subCat.list = [Project objectArrayWithKeyValuesArray:projectArr];

                for (Project *pro in subCat.list) {
                    NSLog(@"| | |---工程:%@", pro.desc);
                    NSString *url = [NSString stringWithFormat:@"[git]/%@/%@", pro.owner, pro.name];
                    NSLog(@"| | |---URL:%@", url);
                }
            }
        } else {
            // 沒有子分類,直接把大分類的 projectArr 字典轉物件
            bigCat.projectArr = [Project objectArrayWithKeyValuesArray:bigCat.projectArr];

            for (Project *pro in bigCat.projectArr) {
                NSLog(@"| | |---工程:%@", pro.desc);
                NSString *url = [NSString stringWithFormat:@"[git]/%@/%@", pro.owner, pro.name];
                NSLog(@"| | |---URL:%@", url);
            }
        }
    }
}

這個範例值得學的地方

分層模型的必要性:三層結構若只用 NSDictionary 硬取,取值程式碼會被 objectForKey: 塞滿,任何一層 key 打錯都會在執行期才炸掉。轉成模型之後,改欄位名稱會在編譯期就被抓到。

遞迴輸出的可讀性:用 |---、| |--- 這種前綴把樹狀結構印在 console,是很實用的除錯技巧,資料結構是否正確一眼就看得出來。

可延伸的方向:目前清單是靜態的 Plist,若要與時俱進,可以改成從 GitHub API 拉取資料並在本機快取;再搭配 UISearchBar 與三層的 UINavigationController,就是一個好用的個人元件百科。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved