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

實際的清單涵蓋範圍相當廣,大致包含以下幾大類:
// 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.h // 開源項目之子類別,成員:name 與陣列 #import <Foundation/Foundation.h> @interface SubCategory : NSObject /** 子分類的名稱:如 JSON、XML 等 */ @property (nonatomic, copy) NSString *name; /** 陣列,元素為一個個 Project 物件 */ @property (nonatomic, strong) NSArray *list; @end
// 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
這裡有個關鍵設計:大分類底下可能有子分類,也可能直接就是專案清單,兩種情況要分別處理。程式碼利用 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,就是一個好用的個人元件百科。