版本记录

前言

iOS圈内有几个人大家基本都知道，比如说王巍、唐巧，还有YYKit框架的作者现任职于滴滴的郭曜源 - ibireme等。这里有一篇唐巧对他的专访，还有他的 GitHub - Yaoyuan 和 博客，这里贴出来框架YYKit 框架。接下来几篇我们就一起来看一下这个框架。感兴趣的可以看上面写的几篇。
1. YYKit源码探究（一） —— 基本概览
2. YYKit源码探究（二） —— NSString分类之Hash（一）
3. YYKit源码探究（三） —— NSString分类之Encode and decode（二）
4. YYKit源码探究（四） —— NSString分类之Drawing（三）
5. YYKit源码探究（五） —— NSString分类之Regular Expression（四）
6. YYKit源码探究（六） —— NSString分类之NSNumber Compatible（五）
7. YYKit源码探究（七） —— NSString分类之Utilities（六）
8. YYKit源码探究（八） —— NSNumber分类（一）
9. YYKit源码探究（九） —— UIFont分类之架构分析和Font Traits（一）
10. YYKit源码探究（十） —— UIFont分类之Create font（二）
11. YYKit源码探究（十一） —— UIFont分类之Load and unload font（三）
12. YYKit源码探究（十二） —— UIFont分类之Dump font data（四）
13. YYKit源码探究（十三） —— UIImage分类之框架结构和Create image部分（一）
14. YYKit源码探究（十四） —— UIImage分类之Image Info（二）
15. YYKit源码探究（十五） —— UIImage分类之Modify Image（三）
16. YYKit源码探究（十六） —— UIImage分类之Image Effect（四）
17. YYKit源码探究（十七） —— UIImageView分类之架构和image部分（一）
18. YYKit源码探究（十八） —— UIImageView分类之highlight image部分（二）
19. YYKit源码探究（十九） —— UIScreen分类（一）
20. YYKit源码探究（二十） —— UIScrollView分类（一）
21. YYKit源码探究（二十一） —— UITableView分类（一）
22. YYKit源码探究（二十二） —— UITextField分类（一）
23. YYKit源码探究（二十三） —— UIView分类（一）
24. YYKit源码探究（二十四） —— UIPasteboard分类（一）
25. YYKit源码探究（二十五） —— UIGestureRecognizer分类（一）
26. YYKit源码探究（二十六） —— UIDevice分类框架及Device Information（一）
27. YYKit源码探究（二十七） —— UIDevice分类之Network Information（二）
28. YYKit源码探究（二十八） —— UIDevice分类之Disk Space（三）
29. YYKit源码探究（二十九） —— UIDevice分类之Memory Information（四）
30. YYKit源码探究（三十） —— UIDevice分类之CPU Information（五）
31. YYKit源码探究（三十一） —— UIControl分类（一）
32. YYKit源码探究（三十二） —— UIColor分类之Create a UIColor Object（一）
33. YYKit源码探究（三十三） —— UIColor分类之Get color's description（二）
34. YYKit源码探究（三十四） —— UIColor分类之Retrieving Color Information（三）
35. YYKit源码探究（三十五） —— UIButton分类之image（一）
36. YYKit源码探究（三十六） —— UIButton分类之background image（二）
37. YYKit源码探究（三十七） —— UIBezierPath分类（一）
38. YYKit源码探究（三十八） —— UIBarButtonItem分类（一）

回顾

上一篇主要介绍了UIBarButtonItem分类，这一篇主要看一下UIApplication分类。

API

下面我们一起来看一下API文档。

/// "Documents" folder in this app's sandbox.
@property (nonatomic, readonly) NSURL *documentsURL;
@property (nonatomic, readonly) NSString *documentsPath;

/// "Caches" folder in this app's sandbox.
@property (nonatomic, readonly) NSURL *cachesURL;
@property (nonatomic, readonly) NSString *cachesPath;

/// "Library" folder in this app's sandbox.
@property (nonatomic, readonly) NSURL *libraryURL;
@property (nonatomic, readonly) NSString *libraryPath;

/// Application's Bundle Name (show in SpringBoard).
@property (nullable, nonatomic, readonly) NSString *appBundleName;

/// Application's Bundle ID.  e.g. "com.ibireme.MyApp"
@property (nullable, nonatomic, readonly) NSString *appBundleID;

/// Application's Version.  e.g. "1.2.0"
@property (nullable, nonatomic, readonly) NSString *appVersion;

/// Application's Build number. e.g. "123"
@property (nullable, nonatomic, readonly) NSString *appBuildVersion;

/// Whether this app is pirated (not install from appstore).
@property (nonatomic, readonly) BOOL isPirated;

/// Whether this app is being debugged (debugger attached).
@property (nonatomic, readonly) BOOL isBeingDebugged;

/// Current thread real memory used in byte. (-1 when error occurs)
@property (nonatomic, readonly) int64_t memoryUsage;

/// Current thread CPU usage, 1.0 means 100%. (-1 when error occurs)
@property (nonatomic, readonly) float cpuUsage;


/**
 Increments the number of active network requests.
 If this number was zero before incrementing, this will start animating the 
 status bar network activity indicator.
 
 This method is thread safe.
 
 This method has no effect in App Extension.
 */
- (void)incrementNetworkActivityCount;

/**
 Decrements the number of active network requests. 
 If this number becomes zero after decrementing, this will stop animating the 
 status bar network activity indicator.
 
 This method is thread safe.
 
 This method has no effect in App Extension.
 */
- (void)decrementNetworkActivityCount;


/// Returns YES in App Extension.
+ (BOOL)isAppExtension;

/// Same as sharedApplication, but returns nil in App Extension.
+ (nullable UIApplication *)sharedExtensionApplication;

下面我们就详细的看一下这个API

1. @property (nonatomic, readonly) NSURL *documentsURL;

这个属性的作用就是获取Documents的文件目录。

方法实现

- (NSURL *)documentsURL {
    return [[[NSFileManager defaultManager]
             URLsForDirectory:NSDocumentDirectory
             inDomains:NSUserDomainMask] lastObject];
}

2. @property (nonatomic, readonly) NSString *documentsPath;

这个属性的作用就是获取Documents的文件目录。

方法实现

- (NSString *)documentsPath {
    return [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
}

3. @property (nonatomic, readonly) NSURL *cachesURL;

这个属性的作用就是获取cache的文件目录。

方法实现

- (NSURL *)cachesURL {
    return [[[NSFileManager defaultManager]
             URLsForDirectory:NSCachesDirectory
             inDomains:NSUserDomainMask] lastObject];
}

4. @property (nonatomic, readonly) NSString *cachesPath;

这个属性的作用就是获取cache的文件目录。

方法实现

- (NSString *)cachesPath {
    return [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) firstObject];
}

5. @property (nonatomic, readonly) NSURL *libraryURL;

这个属性的作用就是获取library的文件目录。

方法实现

- (NSURL *)libraryURL {
    return [[[NSFileManager defaultManager]
             URLsForDirectory:NSLibraryDirectory
             inDomains:NSUserDomainMask] lastObject];
}

6. @property (nonatomic, readonly) NSString *libraryPath;

这个属性的作用就是获取library的文件目录。

方法实现

- (NSString *)libraryPath {
    return [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) firstObject];
}

7. @property (nullable, nonatomic, readonly) NSString *appBundleName;

这个属性的作用就是获取Application's Bundle Name。

方法实现

- (NSString *)appBundleName {
    return [[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleName"];
}

8. @property (nullable, nonatomic, readonly) NSString *appBundleID;

这个属性的作用就是获取Application's Bundle ID。

方法实现

- (NSString *)appBundleID {
    return [[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleIdentifier"];
}

9. @property (nullable, nonatomic, readonly) NSString *appVersion;

这个属性的作用就是获取Application's Version。

方法实现

- (NSString *)appVersion {
    return [[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleShortVersionString"];
}

10. @property (nullable, nonatomic, readonly) NSString *appBuildVersion;

这个属性的作用就是获取Application's Build number。

方法实现

- (NSString *)appBuildVersion {
    return [[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleVersion"];
}

11. @property (nonatomic, readonly) BOOL isPirated;

这个属性的作用就是判断是否是盗版的，也就是不是从apple store中下载的。

方法实现

- (BOOL)isPirated {
    if ([[UIDevice currentDevice] isSimulator]) return YES; // Simulator is not from appstore
    
    if (getgid() <= 10) return YES; // process ID shouldn't be root
    
    if ([[[NSBundle mainBundle] infoDictionary] objectForKey:@"SignerIdentity"]) {
        return YES;
    }
    
    if (![self _yy_fileExistInMainBundle:@"_CodeSignature"]) {
        return YES;
    }
    
    if (![self _yy_fileExistInMainBundle:@"SC_Info"]) {
        return YES;
    }
    
    //if someone really want to crack your app, this method is useless..
    //you may change this method's name, encrypt the code and do more check..
    return NO;
}

- (BOOL)_yy_fileExistInMainBundle:(NSString *)name {
    NSString *bundlePath = [[NSBundle mainBundle] bundlePath];
    NSString *path = [NSString stringWithFormat:@"%@/%@", bundlePath, name];
    return [[NSFileManager defaultManager] fileExistsAtPath:path];
}

12. @property (nonatomic, readonly) BOOL isBeingDebugged;

这个属性的作用就是判断是不是正在调试。

方法实现

- (BOOL)isBeingDebugged {
    size_t size = sizeof(struct kinfo_proc);
    struct kinfo_proc info;
    int ret = 0, name[4];
    memset(&info, 0, sizeof(struct kinfo_proc));
    
    name[0] = CTL_KERN;
    name[1] = KERN_PROC;
    name[2] = KERN_PROC_PID; name[3] = getpid();
    
    if (ret == (sysctl(name, 4, &info, &size, NULL, 0))) {
        return ret != 0;
    }
    return (info.kp_proc.p_flag & P_TRACED) ? YES : NO;
}

13. @property (nonatomic, readonly) int64_t memoryUsage;

这个属性的作用就是计算内存的使用。

方法实现

- (int64_t)memoryUsage {
    struct task_basic_info info;
    mach_msg_type_number_t size = sizeof(info);
    kern_return_t kern = task_info(mach_task_self(), TASK_BASIC_INFO, (task_info_t)&info, &size);
    if (kern != KERN_SUCCESS) return -1;
    return info.resident_size;
}

14. @property (nonatomic, readonly) float cpuUsage;

这个属性的作用就是计算当前CPU的使用。

方法实现

- (float)cpuUsage {
    kern_return_t kr;
    task_info_data_t tinfo;
    mach_msg_type_number_t task_info_count;
    
    task_info_count = TASK_INFO_MAX;
    kr = task_info(mach_task_self(), TASK_BASIC_INFO, (task_info_t)tinfo, &task_info_count);
    if (kr != KERN_SUCCESS) {
        return -1;
    }
    
    thread_array_t thread_list;
    mach_msg_type_number_t thread_count;
    
    thread_info_data_t thinfo;
    mach_msg_type_number_t thread_info_count;
    
    thread_basic_info_t basic_info_th;
    
    kr = task_threads(mach_task_self(), &thread_list, &thread_count);
    if (kr != KERN_SUCCESS) {
        return -1;
    }
    
    long tot_sec = 0;
    long tot_usec = 0;
    float tot_cpu = 0;
    int j;
    
    for (j = 0; j < thread_count; j++) {
        thread_info_count = THREAD_INFO_MAX;
        kr = thread_info(thread_list[j], THREAD_BASIC_INFO,
                         (thread_info_t)thinfo, &thread_info_count);
        if (kr != KERN_SUCCESS) {
            return -1;
        }
        
        basic_info_th = (thread_basic_info_t)thinfo;
        
        if (!(basic_info_th->flags & TH_FLAGS_IDLE)) {
            tot_sec = tot_sec + basic_info_th->user_time.seconds + basic_info_th->system_time.seconds;
            tot_usec = tot_usec + basic_info_th->system_time.microseconds + basic_info_th->system_time.microseconds;
            tot_cpu = tot_cpu + basic_info_th->cpu_usage / (float)TH_USAGE_SCALE;
        }
    }
    
    kr = vm_deallocate(mach_task_self(), (vm_offset_t)thread_list, thread_count * sizeof(thread_t));
    assert(kr == KERN_SUCCESS);
    
    return tot_cpu;
}

15. - (void)incrementNetworkActivityCount;

增加活动网络请求的数量。 如果此数字在增量之前为零，则会启动状态栏网络活动指示器的动画。这个方法是线程安全的，并且对App Extension没有影响。

方法实现

- (void)incrementNetworkActivityCount {
    [self _changeNetworkActivityCount:1];
}

- (void)_changeNetworkActivityCount:(NSInteger)delta {
    @synchronized(self){
        dispatch_async_on_main_queue(^{
            _YYUIApplicationNetworkIndicatorInfo *info = [self networkActivityInfo];
            if (!info) {
                info = [_YYUIApplicationNetworkIndicatorInfo new];
                [self setNetworkActivityInfo:info];
            }
            NSInteger count = info.count;
            count += delta;
            info.count = count;
            [info.timer invalidate];
            info.timer = [NSTimer timerWithTimeInterval:kNetworkIndicatorDelay target:self selector:@selector(_delaySetActivity:) userInfo:@(info.count > 0) repeats:NO];
            [[NSRunLoop mainRunLoop] addTimer:info.timer forMode:NSRunLoopCommonModes];
        });
    }
}

16. - (void)decrementNetworkActivityCount;

减少活动网络请求的数量。 如果此数字在递减后变为零，则会停止为状态栏网络活动指示器设置动画。这个方法是线程安全的，并且对App Extension没有影响。

方法实现

- (void)decrementNetworkActivityCount {
    [self _changeNetworkActivityCount:-1];
}

17. + (BOOL)isAppExtension;

如果是AppExtension就返回YES。

方法实现

+ (BOOL)isAppExtension {
    static BOOL isAppExtension = NO;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        Class cls = NSClassFromString(@"UIApplication");
        if(!cls || ![cls respondsToSelector:@selector(sharedApplication)]) isAppExtension = YES;
        if ([[[NSBundle mainBundle] bundlePath] hasSuffix:@".appex"]) isAppExtension = YES;
    });
    return isAppExtension;
}

18. + (nullable UIApplication *)sharedExtensionApplication;

与sharedApplication相同，但在App Extension中返回nil。

方法实现

+ (UIApplication *)sharedExtensionApplication {
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wundeclared-selector"
    return [self isAppExtension] ? nil : [UIApplication performSelector:@selector(sharedApplication)];
#pragma clang diagnostic pop
}

后记

本篇讲述了UIApplication的分类，感兴趣的可以给个赞或者关注~~~