PrefixHeader.pch 预编译文件

一、前言

PrefixHeader.pch （.pch 即:Prefix Header）是一个预编译文件，一般用来存放常用的宏、头文件、配置日期、函数声明或类前缀定义等，在Prefix Header中通过import导入的头文件和define定义可以直接在项目中使用，无需在单独的文件中重新导入或定义便可以被项目中的其它文件访问到，以便在项目的多个文件中共享这些定义。

二、Xcode 设置 Prefix Header

Xcode 8 之后新建项目不会默认创建PrefixHeader.pch 文件，需要自己创建，这显得很不方便。下面讲解下如何快速创建并配置PrefixHeader.pch 文件。

首先，在需要插入pch文件的目录下，选择新建文件，选择 PCH File，点击下一步后文件会自动创建到目录中。

然后，在Targets的Build Settings中搜索Prefix Header。

然后，将Precomplie Prefix Header选项改为YES，这样pch会被预编译，预编译后的pch文件会被缓存起来，从而提高编译速度。

双击Prefix Header右侧的空白项，会弹出一个小窗，输入下面的路径字符串，会自动替换你的工程实际路径名称。

$(SRCROOT)/$(PROJECT_NAME)/PrefixHeader.pch

例如：

$(SRCROOT)/DEMO-APP/DEMO-APP-Header.pch

Command+B编译一下程序，看是否会报错。如果有错误，检查下路径是否添加正确。

至此，PrefixHeader.pch 文件配置完成。

三、PrefixHeader.pch 文件讲解

注1⚠️：因为 pch 文件在预编译后会将头文件缓存起来，再次编译时则不需要重新编译该文件中的内容，进而提升了编译速率。所以尽量不要将开发中共用性较低的文件或宏定义(宏定义可单独创建一个头文件进行存放，再将该宏文件引入至 pch)引入进 pch 文件中导致重复编译的操作，反而降低其速率使文件所带来的作用大大折扣。

注2⚠️：pch 文件的命名方式，建议以项目名称开头，例如项目名称为"TestDemo"则 pch 文件名称则为"TestDemo-Prefix"，当然实际命名以用途为准。

.pch文件示例如下：

//
//  Hello-Header.pch
//

#ifndef Hello_Header_pch
#define Hello_Header_pch

#define WEAKSELF typeof(self) __weak weakSelf = self;
#define STRONGSELF typeof(self) __strong strongSelf = self;
#define STRONGSELFFor(object) typeof(object) __strong strongSelf = object;
#define kScreen [UIScreen mainScreen].bounds.size
#define kScreenWidth [UIScreen mainScreen].bounds.size.width
#define kScreenHeight [UIScreen mainScreen].bounds.size.height
#define HexCorlor(hexValue) [UIColor colorWithRed:((float)((hexValue & 0xFF0000) >> 16)) / 255.0 green:((float)((hexValue & 0xFF00) >> 8)) / 255.0 blue:((float)(hexValue & 0xFF)) / 255.0 alpha:1.0]

#define DEFAULTFRAME CGRectMake(0, 0, 1, 1)
#define BIGHEIGHT kScreen.width*9/16
#define SMALLHEIGHT (kScreen.width/2)*9/16

#define is_iPhoneXSerious ({\
BOOL isPhoneX = NO;\
if (@available(iOS 11.0, *)) {\
    UIWindow *window = [[UIApplication sharedApplication].windows firstObject];\
    isPhoneX = window.safeAreaInsets.bottom > 0;\
}\
isPhoneX;\
})


#define is_portrait ({\
BOOL is_portrait = NO;\
UIInterfaceOrientation orientation = [UIApplication sharedApplication].statusBarOrientation;\
is_portrait = !UIInterfaceOrientationIsLandscape(orientation);\
is_portrait;\
})

#define STATUS_BAR_HEIGHT (is_iPhoneXSerious ? 44.f : 20.f)

#define NAVIGATION_BAR_HEIGHT (is_iPhoneXSerious ? 88.f : 64.f)

#define TAB_BAR_HEIGHT (is_iPhoneXSerious ? (49.f+34.f) : 49.f)

#define HOMEINDICATOR_HEIGHT (is_iPhoneXSerious ? 34.f : 0)

#define KViewRadius(View, Radius)\
\
[View.layer setCornerRadius:(Radius)];\
[View.layer setMasksToBounds:YES];\
[View.layer setShouldRasterize:YES];\
[View.layer setRasterizationScale:[UIScreen mainScreen].scale];

#define KViewBorderRadius(View, Radius, Width, Color)\
\
[View.layer setCornerRadius:(Radius)];\
[View.layer setMasksToBounds:YES];\
[View.layer setShouldRasterize:YES];\
[View.layer setRasterizationScale:[UIScreen mainScreen].scale];\
[View.layer setBorderWidth:(Width)];\
[View.layer setBorderColor:[Color CGColor]];

// notifacation
#define K_NOTIC_CENTER [NSNotificationCenter defaultCenter]
#define K_Notic_LogOutNative @"K_Notic_LogOutNative"
#define K_Notic_LoginSuccess @"K_Notic_LoginSuccess"

// Include any system framework and library headers here that should be included in all compilation units.
// You will also need to set the Prefix Header build setting of one or more of your targets to reference this file.

#import <XYRTCEngine/NemoSDK.h>
#import <BPUIBaseComponents/BPBaseToastView.h>
#import <BPUIBaseComponents/BPBaseToastViewConfig.h>
#import "Masonry.h"

//#import "AppDelegate.h"
#import "XYConferenceHintView.h"
#import "XYAlertView.h"
#import "XYLocalString.h"

#import "XYFloatingManager.h"
#import "XYSDKManager.h"
#import "XYLayoutManager.h"

#import "UIView+XYFrame.h"
#import "UIColor+XYColor.h"
#import "NSDictionary+Utils.h"
#import "UIView+GradientView.h"
#import "UIView+Orientation.h"

#import "Masonry.h"
#import "XYHUDManager.h"

#define Font(key)      BOCSystemFont((key))

#endif /* Hello_Header_pch */

四、拓展阅读

• 《iOS学习专栏》