這份筆記把日常開發中最常翻查的語法與踩過的坑整理在一起,分成語法基礎、UI 元件、檔案與資料、架構與協作四大塊,方便隨時回頭查。
取出的元素可能是 NSNull 單例,這時下面這些寫法都不會成立:
if (!element)
if ([element length] > 0)
if (element == NULL)
if (element == nil)
正確的判斷方式是直接比對 NSNull:
NSString *element = [array objectAtIndex:2];
if ((NSNull *)element == [NSNull null]) {
// 該位置是空值
}
第一步,定義協議:
@protocol UploadUserInfoDelegate <NSObject>
@required
- (void)uploadCallBack:(NSInteger)code msg:(NSString *)msg;
@end
第二步,宣告委派屬性,用 weak 避免循環引用:
@property (nonatomic, weak) id<UploadUserInfoDelegate> delegate;
第三步,呼叫前先確認對方實作,這是避免 crash 的關鍵習慣:
if ([self.delegate respondsToSelector:@selector(uploadCallBack:msg:)]) {
[self.delegate uploadCallBack:111 msg:@"mmm"];
}
第四步,實作方宣告遵循協議並把自己傳進去:
@interface ViewController () <UploadUserInfoDelegate>
obj.delegate = self;
- (void)uploadCallBack:(NSInteger)code msg:(NSString *)msg { /* ... */ }
直接宣告成屬性:
@property (copy, nonatomic) void (^submitUserInfoBlock)(NSString *gender, NSInteger age, NSString *hobbys);
用 typedef 定義型別,方便當參數傳遞:
typedef void (^Callback)(NSInteger code, NSString *msg);
- (void)uploadUserInfoWith:(NSString *)name callBack:(Callback)callback;
先用 typedef 定義型別,再合成屬性:
typedef void (^HeaderInputBlock)(NSString *inputStr);
@property (nonatomic, copy) HeaderInputBlock inputBlock;
直接把 Block 當成方法參數:
- (AFHTTPRequestOperation *)httpGetWithMethodName:(NSString *)methodName
param:(id)parameters
response:(void (^)(id dict, NSError *error))callback;
+ (ViewController *)shared {
static ViewController *instance;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
instance = [[ViewController alloc] init];
});
return instance;
}
Block 會對捕獲的變量產生強引用,self 也不例外。如果 self 又強引用著這個 Block,就會形成循環引用並造成記憶體洩漏。標準解法是在 Block 外先產生一個弱引用:
__block typeof(self) weakSelf = self;
[self methodThatTakesABlock:^{
[weakSelf doSomething];
}];
也可以包成宏,寫起來更省事:
#define WS(weakSelf) __weak __typeof(&*self)weakSelf = self;
新建 NSString+Util 檔案,介面中宣告方法:
@interface NSString (Util)
- (void)hello;
+ (void)say;
@end
實作後即可在任何地方引入使用:
@implementation NSString (Util)
- (void)hello { NSLog(@"hello"); }
+ (void)say { NSLog(@"static say."); }
@end
// 使用
#import "NSString+Util.h"
NSString *mm = @"aa";
[mm hello];
[NSString say];
關於 Category 的幾個限制值得記住:不能新增實例變量;若與原類方法同名,Category 的實作會覆蓋原本的方法,容易踩坑。它的主要價值在於把龐大類別的實作拆分到多個檔案甚至多個框架、為私有方法建立前向宣告,以及以 NSObject 的分類形式實作「非正式協議」。
NSDate *now = [[NSDate alloc] init];
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
[formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];
NSString *dateString = [formatter stringFromDate:now];
instancetype 會回傳與所在類別相同型別的物件,型別資訊在編譯期即可確定;id 只能回傳未知型別。另外 instancetype 只能作為回傳值,不能像 id 那樣當參數使用。
下列情況會停用 autosynthesis:同時重寫了 setter 與 getter、重寫了唯讀屬性的 getter、使用 @dynamic、在 @protocol 中宣告的屬性、在 Category 中宣告的屬性、被覆寫的屬性。
規律其實很單純:當你想手動管理 property 的全部存取行為時,編譯器就假定你要自己來,於是停用自動合成。此時若同時重寫了 setter 與 getter,系統連 ivar 都不會幫你產生,你有兩個選擇——手動宣告 ivar,或明確寫上 @synthesize foo = _foo; 把 property 與 ivar 綁起來。
非集合類物件:不可變物件 copy 是淺拷貝(指標複製),mutableCopy 是深拷貝;可變物件不論 copy 或 mutableCopy 都是深拷貝。
[immutableObject copy] // 淺拷貝
[immutableObject mutableCopy] // 深拷貝
[mutableObject copy] // 深拷貝
[mutableObject mutableCopy] // 深拷貝
集合類物件看起來類似,但關鍵差異是:集合的「內容複製」只複製容器本身,裡面的元素仍然是指標複製,也就是所謂的單層深拷貝。
[immutableObject copy] // 淺拷貝
[immutableObject mutableCopy] // 單層深拷貝
[mutableObject copy] // 單層深拷貝
[mutableObject mutableCopy] // 單層深拷貝
引用在語言內部通常是以指標實作;對一般應用而言,把引用理解成指標不會造成嚴重語義錯誤;更精確地說,引用是操作被限制過的指標,僅允許取值操作。
UIBarButtonItem 並非繼承自 UIView,因此不能任意擺放,必須交由導航列、標籤列或工具列管理;它本身也不是按鈕,而是承載按鈕屬性的條目物件。可分為按鈕元素與空白元素兩類。
需要微調間距時,常用固定寬度的空白項,甚至刻意給負值:
UIBarButtonItem *negativeSpacer = [[UIBarButtonItem alloc]
initWithBarButtonSystemItem:UIBarButtonSystemItemFixedSpace
target:nil action:nil];
// width 為負值時等同於按鈕右移,按鈕與邊界預設間距 5px,
// 因此設為 -5 剛好讓間距歸零;正值則方向相反。
negativeSpacer.width = -5;
另外,在工具列首尾加入 FlexibleSpace 會讓其他項目呈現不同的水平對齊方式;而 leftItemsSupplementBackButton 預設為 NO,也就是顯示自訂的返回按鈕。
用一個標記位與當前 indexPath 記錄展開狀態,再配合 beginUpdates/endUpdates 觸發高度重算:
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
UITableViewCell *cell = [tableView cellForRowAtIndexPath:indexPath];
if ([cell isSelected] && cellIsSelected == NO) {
cellIsSelected = YES;
_indexPath = indexPath;
} else {
cellIsSelected = NO;
}
[tableView beginUpdates];
[tableView endUpdates];
}
- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
if (cellIsSelected && _indexPath.row == indexPath.row) {
return 50 * 2.0;
}
return 50;
}
indexPath.row 用於 TableView,indexPath.item 用於 CollectionView。將 UITableView 的 style 設為 Grouped,可讓 header 與 footer 跟著一起滾動。
隱藏返回按鈕與整個導航列:
self.navigationItem.leftBarButtonItem = nil;
self.navigationController.navigationBar.hidden = YES;
設定標題時建議直接用 self.navigationItem.title。若改用 self.title,在同時存在 tabBar 的情況下,tabBarItem 的標題也會一起被改掉。
NSMutableAttributedString *str = [[NSMutableAttributedString alloc] initWithString:@"Using NSAttributed String"];
[str addAttribute:NSForegroundColorAttributeName value:[UIColor blueColor] range:NSMakeRange(0, 5)];
[str addAttribute:NSForegroundColorAttributeName value:[UIColor redColor] range:NSMakeRange(6, 12)];
[str addAttribute:NSFontAttributeName value:[UIFont fontWithName:@"Arial-BoldItalicMT" size:30.0] range:NSMakeRange(0, 5)];
self.attrLabel.attributedText = str;
NSDictionary *attributes = @{NSFontAttributeName: [UIFont systemFontOfSize:16.0]};
CGSize size = [content boundingRectWithSize:CGSizeMake(UI_SCREEN_WIDTH, CGFLOAT_MAX)
options:NSStringDrawingUsesFontLeading | NSStringDrawingUsesLineFragmentOrigin
attributes:attributes context:nil].size;
left/top/right/bottom 對應四邊;leading/trailing 對應首尾部(隨語言方向翻轉);width/height 為寬高;centerX/centerY 為橫縱中點;baseline 為文字基線。
[button sendActionsForControlEvents:UIControlEventTouchUpInside];
Documents:存放使用者產生的資料,iTunes/iCloud 備份會涵蓋此目錄。要注意審核風險——若把從網路下載的檔案直接丟在這裡,提審時可能被退回。
Library/Preferences:存放偏好設定,應透過 NSUserDefaults 存取,不要手動建立檔案。
Library/Caches:存放可再生的快取,不會被 iTunes 同步,適合體積大又不需要備份的檔案,但 App 必須自行提供清除快取的機制。
tmp:純臨時用途,系統可能在 App 未執行時清理,開發者不需要理會釋放。
AppName.app:程式包目錄,內容已被簽名,執行期間不可修改,否則可能導致無法啟動。
只有 BOOL、NSNumber、NSString、NSData、NSDate、NSArray、NSDictionary 這些型別能寫入 plist。NSFileHandle 負責檔案內容的讀寫,NSFileManager 負責刪除、移動、複製等檔案層級操作。
NSString *htmlPath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"html"];
NSString *appHtml = [NSString stringWithContentsOfFile:htmlPath encoding:NSUTF8StringEncoding error:nil];
NSURL *baseURL = [NSURL fileURLWithPath:htmlPath];
[webView loadHTMLString:appHtml baseURL:baseURL];
中文或空白字元未編碼,記得先做一次百分號轉義:
NSURL *url = [NSURL URLWithString:[urlString stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];
NSData *data = [NSJSONSerialization dataWithJSONObject:o
options:NSJSONReadingMutableLeaves | NSJSONReadingAllowFragments error:nil];
NSString *str = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
先判斷是否安裝,再決定要不要跳轉:
if ([[UIApplication sharedApplication] canOpenURL:url]) {
[[UIApplication sharedApplication] openURL:url];
}
被喚起的一方需要在 Target → Info → URL Types → URL Schemes 中註冊自己的 scheme,並在 AppDelegate 中接收參數:
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation {
NSString *str = [[url host] stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
return YES;
}
設定桌面圖示角標 applicationIconBadgeNumber、控制螢幕是否自動鎖定 idleTimerDisabled(相當耗電,務必審慎使用)、顯示網路活動指示器 networkActivityIndicatorVisible,以及查詢當前狀態 applicationState。openURL 還可以用來撥打電話(tel://)、傳送簡訊(sms://)、開啟預設郵件客戶端(mailto:)與地圖搜尋。
iOS 上的 VoIP 應用可以正常在後台接聽來電:SIP 報文走 TCP、語音走 UDP。把 NSStream 的 voip 屬性打開後,系統會代管這條通道並保持連線;當伺服器推來資料,系統會喚醒 App 執行約十秒,這段時間內就能透過本地通知提醒使用者有來電。
做法是讓每個標籤對應一個獨立的 view controller,由它負責自己列表的資料與交互,scrollView 裡裝的是這些 view controller 的 view。承載 scrollView 的那一層可稱為 containerViewController,實際扮演類似 NavigationController 的容器角色,內容部分則是 contentViewController。
這樣拆分的好處很明確:同一個 content VC 可以在不同容器間自由抽換,降低耦合;數量與樣式都能動態調整;還可以用「三塊木板過河」的思路,只讓三個 view 作為中間層,無論有多少標籤,同時掛在 scrollView 上的永遠只有三個,記憶體與效能都可控。結構本身是清晰的,最終好不好維護仍取決於實作者功力。
在 MVC 基礎上把 Controller 拆出一個專責資料處理的 ViewModel,就是 MVVM。為了讓 View 與 ViewModel 之間保持鬆耦合綁定,實務上常搭配 ReactiveCocoa——蘋果本身並未提供合適的綁定機制。KVO、Notification、Block、Delegate、target-action 都能做資料通知,但都不如 RACSignal 來得優雅。即使不用 ReactiveCocoa,綁定會緊一些,整體仍然是 MVVM。
轉換成本不低:陣列裡每一項都要變成 Item 物件,若 Item 內部還有巢狀陣列就更棘手。轉完之後資料通常還不能直接顯示,往往得再轉一次。只有在 API 回傳高度標準化時,這些 Item 才具備真正的複用價值,否則容易型別爆炸、維護成本反而上升。此外,除錯時直接看 NSDictionary/NSArray 比翻物件屬性直觀得多;同一份 API 資料被多個 View 使用時,轉換邏輯也容易散落到各處變得難以掌控。
最有效的一條約定:新增或調整檔案結構前先更新,改完立刻提交,並讓全體成員都遵守。這個檔案是衝突重災區,靠工具事後解衝突遠不如靠流程預防。
可以借助 UncaughtExceptionHandler 這類方案攔截常見閃退,例如 NSArray/NSDictionary/NSString/KVC 相關錯誤,以及 performSelector 找不到 selector 的問題。使用時在 AppDelegate 中呼叫 Install 方法完成註冊即可。
需要特別理解的是,NSSetUncaughtExceptionHandler 無法處理記憶體訪問錯誤、重複釋放這類以 signal 形式發出的錯誤,因此還要自行註冊 SignalHandler。另外 SignalHandler 不適合在 debug 環境驗證,因為除錯器會優先攔截;實測時應先執行一次再關閉除錯,直接點擊已安裝的 App 啟動。UncaughtExceptionHandler 則可以在除錯狀態下正常攔截。
認證時,令牌與伺服器各自依相同的密鑰、相同的隨機數與相同演算法算出同一組動態口令。動態密碼並非真正隨機,而是有規律可循,主要分為時間性與事件性兩類,前者以時間為參數,後者以使用次數為參數。
以時間性為例:令牌以時間與種子為參數反覆疊代產生密碼,內部內建時鐘晶片;伺服器讀取系統時間加上同款種子,用相同方法運算後比對。實務上兩邊時間不可能永遠一致,解法是伺服器在一個時間窗內比對,例如現在是 12:00,就產生 11:55 至 12:05 之間的所有密碼逐一比對。同時伺服器會記錄令牌與自身的時間偏移量,下次先套用這個偏移以減少疊代次數,這就構成了偏移值自動校正機制。
用 #pragma mark - 替 ViewController 分組,可讀性提升非常明顯,常見分區包含 Lifecycle、UITableViewDataSource/Delegate、Event Response、Private Methods 等。
用特殊標記做待辦管理:// TODO:、// FIXME:、// !!!:、// ???: 以及 #warning,Xcode 會自動在跳轉列表中列出來。
顯示/隱藏 macOS 隱藏檔案:
defaults write com.apple.finder AppleShowAllFiles YES
defaults write com.apple.finder AppleShowAllFiles NO
執行後需重新啟動 Finder 才會生效。