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

iOS 開發中 17 個實用宏定義整理

編輯:iOS 開發基礎

宏定義能把重複的樣板程式碼收攏到一處,也能讓編譯期就完成許多判斷。以下是我日常累積的常用清單,附上使用情境與該注意的陷阱。

1. 只在開發模式印出 NSLog

#ifdef DEBUG
    #define NSLog(FORMAT, ...) fprintf(stderr, "%s:%d\t%s\n", \
        [[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String], \
        __LINE__, \
        [[NSString stringWithFormat:FORMAT, ##__VA_ARGS__] UTF8String]);
#else
    #define NSLog(FORMAT, ...) nil
#endif

這個寫法額外輸出了檔名與行號,對排查問題很有效率;正式包則直接把日誌吃掉。

2. 僅在 Objective-C 環境引入標頭檔

#ifdef __OBJC__
    // 在此引入標頭檔
#endif

3. 變數的弱引用宣告

#define WS(weakSelf)  __weak __typeof(&*self) weakSelf = self;

搭配 strongSelf 使用,是處理 block 循環參照最省字角的寫法。

4. 取得螢幕寬高

#define ScreenWidth  [[UIScreen mainScreen] bounds].size.width
#define ScreenHeight [[UIScreen mainScreen] bounds].size.height

5. 系統版本判斷

#define IOS8UP ([[UIDevice currentDevice].systemVersion floatValue] >= 8)

要提醒的是,用 floatValue 比版本號並不可靠——「8.10」會被解析成小於「8.2」。嚴肅的版本判斷請改用 NSFoundationVersionNumber 或 @available。

6 & 7. RGB 與含透明度的顏色

#define RGB(a, b, c)  [UIColor colorWithRed:(a / 255.0) green:(b / 255.0) blue:(c / 255.0) alpha:1.0]
#define RGBA(a, b, c, d) [UIColor colorWithRed:(a / 255.0) green:(b / 255.0) blue:(c / 255.0) alpha:d]

8. 兼容橫向解析度的螢幕尺寸

#if __IPHONE_OS_VERSION_MAX_ALLOWED >= 80000
  #define SCREEN_WIDTH  ([[UIScreen mainScreen] respondsToSelector:@selector(nativeBounds)] ? \
      [UIScreen mainScreen].nativeBounds.size.width / [UIScreen mainScreen].nativeScale : \
      [UIScreen mainScreen].bounds.size.width)
  #define SCREEN_HEIGHT ([[UIScreen mainScreen] respondsToSelector:@selector(nativeBounds)] ? \
      [UIScreen mainScreen].nativeBounds.size.height / [UIScreen mainScreen].nativeScale : \
      [UIScreen mainScreen].bounds.size.height)
  #define SCREEN_SIZE   ([[UIScreen mainScreen] respondsToSelector:@selector(nativeBounds)] ? \
      CGSizeMake([UIScreen mainScreen].nativeBounds.size.width / [UIScreen mainScreen].nativeScale, \
                 [UIScreen mainScreen].nativeBounds.size.height / [UIScreen mainScreen].nativeScale) : \
      [UIScreen mainScreen].bounds.size)
#else
  #define SCREEN_WIDTH  [UIScreen mainScreen].bounds.size.width
  #define SCREEN_HEIGHT [UIScreen mainScreen].bounds.size.height
  #define SCREEN_SIZE   [UIScreen mainScreen].bounds.size
#endif

9. 隨機顏色

#define LRRandomColor [UIColor colorWithRed:arc4random_uniform(256) / 255.0 \
                                       green:arc4random_uniform(256) / 255.0 \
                                        blue:arc4random_uniform(256) / 255.0 \
                                       alpha:1.0]

10. 為 view 設定圓角與邊框

#define LRViewBorderRadius(View, Radius, Width, Color) \
    [View.layer setCornerRadius:(Radius)]; \
    [View.layer setMasksToBounds:YES]; \
    [View.layer setBorderWidth:(Width)]; \
    [View.layer setBorderColor:[Color CGColor]];

11. 取得圖片資源

#define kGetImage(imageName) [UIImage imageNamed:[NSString stringWithFormat:@"%@", imageName]]

12. 取得目前語言

#define LRCurrentLanguage ([[NSLocale preferredLanguages] objectAtIndex:0])

13. 裝置與系統版本判斷

// 是否為 iPhone
#define IS_IPHONE (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPhone)
// 是否為 iPad
#define IS_IPAD (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPad)
// 是否為 iPod
#define IS_IPOD ([[[UIDevice currentDevice] model] isEqualToString:@"iPod touch"])
// 是否為 iPhone 5SE
#define iPhone5SE ([[UIScreen mainScreen] bounds].size.width == 320.0f && \
                   [[UIScreen mainScreen] bounds].size.height == 568.0f)
// 是否為 iPhone 6 / 6s
#define iPhone6_6s ([[UIScreen mainScreen] bounds].size.width == 375.0f && \
                    [[UIScreen mainScreen] bounds].size.height == 667.0f)
// 是否為 iPhone 6Plus / 6sPlus
#define iPhone6Plus_6sPlus ([[UIScreen mainScreen] bounds].size.width == 414.0f && \
                            [[UIScreen mainScreen] bounds].size.height == 736.0f)
// 系統版本
#define IOS_SYSTEM_VERSION [[[UIDevice currentDevice] systemVersion] floatValue]

14. 判斷真機或模擬器

#if TARGET_OS_IPHONE
// 真機
#endif

#if TARGET_IPHONE_SIMULATOR
// 模擬器
#endif

15. 沙盒目錄路徑

// tmp
#define kPathTemp NSTemporaryDirectory()
// Documents
#define kPathDocument [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject]
// Caches
#define kPathCache [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) firstObject]

16. 宏與 const 的取捨

很多人定義常量字串時習慣用宏,最典型的例子就是伺服器位址。但其實這種情境更適合用 const。差異如下:

  • 編譯時機不同:宏屬於預編譯階段,const 屬於編譯階段。
  • 能力不同:宏可以定義程式碼片段,const 不行。多個宏會讓編譯時間變長,影響開發效率與除錯速度;const 只編譯一次。
  • 錯誤檢查:宏不會檢查型別錯誤,const 會。

結論:定義常量字串用 const,定義程式碼片段用宏。

static NSString * const loginAccount = @"loginAccount";
static NSString * const loginPassword = @"loginPassword";

17. 快速單例化一個類

// SynthesizeSingleton.h
#ifndef SynthesizeSingleton_h
#define SynthesizeSingleton_h

// 宣告
#define DECLARE_SYNTHESIZE_SINGLETON_FOR_CLASS(classname) \
    + (classname *)sharedInstance;

// 實作
#define IMPLEMENT_SYNTHESIZE_SINGLETON_FOR_CLASS(classname) \
    static classname *shared##classname = nil; \
    + (classname *)sharedInstance { \
        @synchronized(self) { \
            if (shared##classname == nil) { \
                shared##classname = [[self alloc] init]; \
            } \
        } \
        return shared##classname; \
    } \
    + (id)allocWithZone:(NSZone *)zone { \
        @synchronized(self) { \
            if (shared##classname == nil) { \
                shared##classname = [super allocWithZone:zone]; \
                return shared##classname; \
            } \
        } \
        return nil; \
    } \
    - (id)copyWithZone:(NSZone *)zone { \
        return self; \
    }

#endif

使用方式是在需要單例的類的 .h 與 .m 中分別寫入(記得先引入上面的標頭檔):

// ViewController.h
@interface ViewController : UIViewController
SingletonH(viewController)
@end

// ViewController.m
@implementation ViewController
SingletonM(ViewController)
@end

幾點補充

宏不是萬靈丹。它有幾個先天限制值得知道:因為是純文字替換,除錯時看不到型別資訊,出錯訊息也往往指向展開後的位置而非你寫的那一行;而且宏沒有作用域概念,容易與其他標頭檔的定義撞名。近幾年 Swift 上線後,型別安全的 let 常數、計算屬性與全域變數已經能取代絕大多數場景,如果你在寫純 Swift 專案,這份清單的適用範圍會小很多。

本文整理自「上吊的豆腐」於簡書發佈的相關文章。

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