UIApplication

96
李小六_
2016.07.12 16:05* 字数 549

UIApplication

UIApplication

UIApplication 类在整个 apps 运行过程中,扮演一个中央处理和协调的工作,任何程序应该只有一个 UIApplication 实例,当一个app 被推出时,系统会调用 UIApplicationMain 函数,在它的其它任务中,这个函数创建了一个单利 UIApplication 对象,此后,你可以调用 shareApplication 方法来获取此对象。

此外,UIApplication 还处理着用户的触摸事件,分发 action message 到它拥有的合适的目标对象上。应用程序对象维持一个打开的窗口列表,通过这个列表可以检索应用程序的任何 UIView 对象。

UIApplication 定义一个 delegate 对象,遵循 UIApplicationDelegate 协议,AppDelegate而且必须执行某些相关的协议方法。此外,应用程序对象通知这个代理对象一些很重要的运行时候的事件,比如app推出,内存紧张,app 终止等。

应用程序联合处理一些资源,如 email, 图片文件等,通过openURL: 方法,例如一个app调用 eamil url, 通过调用 open URL,可以唤醒 Mail app。

用UIApplication 相关的API可以管理设备的特定行为。如下所示:

  • 暂停触摸事件 beginIgnoringInteractionEvents

  • 注册远程推送 unregisterForRemoteNotifications

  • 触发 undo-redo UI applicationSupportsShakeToEdit

  • 确定是否有一个安装程序处理 URL scheme canOpenURL:

  • 扩展App应用程序的执行,以便它可以在后台完成一个任务beginBackgroundTaskWithExpirationHandler:, beginBackgroundTaskWithName:expirationHandler:

  • 添加和取消本地的通知 scheduleLocalNotification:, cancelLocalNotification:

  • 协调遥控接收事件 beginReceivingRemoteControlEvents, endReceivingRemoteControlEvents

  • 执行app-level状态恢复任务 methods in the Managing the State Restoration Behavior task group

获得实例
 + (UIApplication *)sharedApplication 
 // 返回应用单个实例
获得 app delegate
 @property(nonatomic, assign) id< UIApplicationDelegate > delegate
 // 这个应用的代理
获得 app Windows
 @property(nonatomic, readonly) UIWindow *keyWindow
 // app的主 window
 
 @property(nonatomic, readonly) NSArray <__kindof UIWindow *> *windows
 // 隐藏的和看得见的所有 window
控制和处理事件
 - (void)sendEvent:(UIEvent *)event
 // 发送事件给app内适用的响应者
 
 - (BOOL)sendAction:(SEL)action
            to:(id)target
          from:(id)sender
      forEvent:(UIEvent *)event
 // 发送一个含选择器的动作消息到指定的目标
 
 - (void)beginIgnoringInteractionEvents
 // 告诉接受者暂停处理 touch相关的事件
 
 - (void)endIgnoringInteractionEvents
 // 告诉接受者继续处理 touch相关的事件
 
 - (BOOL)isIgnoringInteractionEvents
 // 是否忽略交互事件
 
 @property(nonatomic) BOOL applicationSupportsShakeToEdit
 // 是否接受摇晃的时候, 展现 撤销和恢复 视图
打开 url 资源
 - (BOOL)openURL:(NSURL *)url
 // 通过特定的URL中打开资源

 - (BOOL)canOpenURL:(NSURL *)url
 // 返回一个bool值, 是否从已经安装的 apps 中跳转
配置用户通知设置
 - (void)registerUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings
 // 注册可选的通知
 
 - (UIUserNotificationSettings *)currentUserNotificationSettings
 // 返回关于 user 对于这个app的通知设置
注册远程通知
 - (void)registerForRemoteNotifications
 // 注册接受的远程通知,这些通知经由 APNS 发出
 
 - (void)unregisterForRemoteNotifications
 // 注销掉远程通知
 
 - (BOOL)isRegisteredForRemoteNotifications
 // 表明是否已经注册过了远程通知
注册本地通知
 - (void)scheduleLocalNotification:(UILocalNotification *)notification
 // 安排当地的本地通知,封装了日期和时间
 
 - (void)presentLocalNotificationNow:(UILocalNotification *)notification
 // 立刻弹出本地通知
 
 - (void)cancelLocalNotification:(UILocalNotification *)notification
 // 取消预定的交付的本地通知
 
 - (void)cancelAllLocalNotifications
 // 取消所有的预定的本地通知
 
 @property(nonatomic, copy) NSArray <UILocalNotification *> *scheduledLocalNotifications
 // 目前的宿友的预定的本地通知
控制后台扩展
@property(nonatomic, readonly) UIApplicationState applicationState
// app当前的运行的状态

@property(nonatomic, readonly) NSTimeInterval backgroundTimeRemaining
// app 在后台运行的时间

@property(nonatomic, readonly) UIBackgroundRefreshStatus backgroundRefreshStatus
// 进入到后台,因此能够进行后台的操作

- (void)setMinimumBackgroundFetchInterval:(NSTimeInterval)minimumBackgroundFetchInterval
// 指定最小时间间隔在后台获取操作

- (UIBackgroundTaskIdentifier)beginBackgroundTaskWithName:(NSString *)taskName
                                    expirationHandler:(void (^)(void))handler
// 标记新的长时间运行的任务以及指定任务的命名

- (UIBackgroundTaskIdentifier)beginBackgroundTaskWithExpirationHandler:(void (^)(void))handler
// 标记开始心的长时间运行的后台任务

- (void)endBackgroundTask:(UIBackgroundTaskIdentifier)identifier
// 结束指定的长时间的后台任务

@property(nonatomic, getter=isIdleTimerDisabled) BOOL idleTimerDisabled
// 一个bool值 确定控制器是否停止运行在空闲的时间
控制状态恢复
- (void)extendStateRestoration
// 异步恢复状态

- (void)completeStateRestoration
// 结束异步恢复状态

- (void)ignoreSnapshotOnNextApplicationLaunch
// 阻止应用程序使用最近的快找图像,在接下来的循环中
 
+ (void)registerObjectForStateRestoration:(id<UIStateRestoring>)object
                restorationIdentifier:(NSString *)restorationIdentifier    
// 注册自定义对象的使用状态恢复系统
控制 Home Screen 和 3D Touch
@property(nonatomic, copy) NSArray <UIApplicationShortcutItem *> *shortcutItems
// 重置此变量,设置一系列的 quick actions 用于3Dtouch展现
注册遥控事件
- (void)beginReceivingRemoteControlEvents
// 告诉app 开始接受遥控事件

- (void)endReceivingRemoteControlEvents
// 告诉app 结束接受遥控事件
控制应用程序外观
@property(nonatomic, readonly) CGRect statusBarFrame
// 获取状态栏的 rect

@property(nonatomic, getter=isNetworkActivityIndicatorVisible) BOOL networkActivityIndicatorVisible
// 是否指示网络活动,默认是NO

@property(nonatomic) NSInteger applicationIconBadgeNumber
// 未读消息数字

@property(nonatomic, readonly) UIUserInterfaceLayoutDirection userInterfaceLayoutDirection
// 返回用户界面的布局方向。
控制默认的方向
- (UIInterfaceOrientationMask)supportedInterfaceOrientationsForWindow:(UIWindow *)window
// 在指定的窗口中, 返回默认的视图控制器方向接口 
控制状态栏方向
@property(nonatomic, readonly) NSTimeInterval statusBarOrientationAnimationDuration
// 状态栏动画持续时间
字体大小偏好
@property(nonatomic, readonly) NSString *preferredContentSizeCategory
// 字体偏好
数据类型
UIBackgroundTaskIdentifier;
// 一个独特的标志,这个标志用于在后台请求运行


UIRemoteNotificationType
// 指示应用程序的通知类型
typedef enum : NSUInteger {
   UIRemoteNotificationTypeNone    = 0,
   UIRemoteNotificationTypeBadge   = 1 << 0,
   UIRemoteNotificationTypeSound   = 1 << 1,
   UIRemoteNotificationTypeAlert   = 1 << 2,
   UIRemoteNotificationTypeNewsstandContentAvailability = 1 << 3
} UIRemoteNotificationType;


UIStatusBarStyle
// 状态栏的样式
 typedef enum : NSInteger {
    UIStatusBarStyleDefault,         // 黑色状态,用于白背景
    UIStatusBarStyleLightContent,    // light 状态, 用于dark 背景

    UIStatusBarStyleBlackTranslucent, // 7.0 弃用
    UIStatusBarStyleBlackOpaque       // 7.0 弃用
 } UIStatusBarStyle;
 

UIStatusBarAnimation
// 在状态栏隐藏于显现之间的动画
 typedef enum : NSInteger {
    UIStatusBarAnimationNone,     
    UIStatusBarAnimationFade,     
    UIStatusBarAnimationSlide,
 } UIStatusBarAnimation;
常量(Constants)
UIApplicationState  // 应用状态
typedef enum : NSInteger {
   UIApplicationStateActive,
   UIApplicationStateInactive,
   UIApplicationStateBackground 
} UIApplicationState;


在后台运行时候常用的常量
const UIBackgroundTaskIdentifier UIBackgroundTaskInvalid;
// 无效的后台任务
const NSTimeInterval UIMinimumKeepAliveTimeout;
// 后台保持的最小的时间


 
UIBackgroundFetchResult
// 后台请求结果
typedef enum : NSUInteger {
   UIBackgroundFetchResultNewData,
   UIBackgroundFetchResultNoData,
   UIBackgroundFetchResultFailed 
} UIBackgroundFetchResult;

 
Fetch Intervals 
// 请求间隔
const NSTimeInterval UIApplicationBackgroundFetchIntervalMinimum; // 系统支持的最小的间隔
const NSTimeInterval UIApplicationBackgroundFetchIntervalNever;   // 最大间隔, 以阻止请求

 
 
UIBackgroundRefreshStatus
typedef enum : NSUInteger {
   UIBackgroundRefreshStatusRestricted,  // 限制 
   UIBackgroundRefreshStatusDenied,      // 否定
   UIBackgroundRefreshStatusAvailable    // 可用
} UIBackgroundRefreshStatus; 



UIInterfaceOrientation
// 应用程序的用户界面方向
typedef enum : NSInteger {
   UIInterfaceOrientationUnknown            = UIDeviceOrientationUnknown,
   UIInterfaceOrientationPortrait           = UIDeviceOrientationPortrait,
   UIInterfaceOrientationPortraitUpsideDown = UIDeviceOrientationPortraitUpsideDown,
   UIInterfaceOrientationLandscapeLeft      = UIDeviceOrientationLandscapeRight,
   UIInterfaceOrientationLandscapeRight     = UIDeviceOrientationLandscapeLeft 
} UIInterfaceOrientation;



UIInterfaceOrientationMask
// 指定一个视图控制器支持的接口方向。
typedef enum : NSUInteger {
   UIInterfaceOrientationMaskPortrait = (1 << UIInterfaceOrientationPortrait ),
   UIInterfaceOrientationMaskLandscapeLeft = (1 << UIInterfaceOrientationLandscapeLeft ),
   UIInterfaceOrientationMaskLandscapeRight = (1 << UIInterfaceOrientationLandscapeRight ),
   UIInterfaceOrientationMaskPortraitUpsideDown = (1 << UIInterfaceOrientationPortraitUpsideDown ),
   UIInterfaceOrientationMaskLandscape = (UIInterfaceOrientationMaskLandscapeLeft | UIInterfaceOrientationMaskLandscapeRight ),
   UIInterfaceOrientationMaskAll = (UIInterfaceOrientationMaskPortrait | UIInterfaceOrientationMaskLandscapeLeft |
   UIInterfaceOrientationMaskLandscapeRight | UIInterfaceOrientationMaskPortraitUpsideDown ),
   UIInterfaceOrientationMaskAllButUpsideDown = (UIInterfaceOrientationMaskPortrait | UIInterfaceOrientationMaskLandscapeLeft |
   UIInterfaceOrientationMaskLandscapeRight ),
} UIInterfaceOrientationMask;



 UserInfo Dictionary Keys
 // 这些键值用来接受用户信息字典,用于访问值一些UIApplication-posted通知。
 NSString *const UIApplicationStatusBarOrientationUserInfoKey;
 NSString *const UIApplicationStatusBarFrameUserInfoKey;
 
 
 
 Content Size Category Constants // 内容大笑类别常量
 NSString *const UIContentSizeCategoryExtraSmall;
 NSString *const UIContentSizeCategorySmall;
 NSString *const UIContentSizeCategoryMedium;
 NSString *const UIContentSizeCategoryLarge;
 NSString *const UIContentSizeCategoryExtraLarge;
 NSString *const UIContentSizeCategoryExtraExtraLarge;
 NSString *const UIContentSizeCategoryExtraExtraExtraLarge;


 // 内容尺寸改变的通知的key
 NSString *const UIContentSizeCategoryNewValueKey;
通知
 UIApplicationBackgroundRefreshStatusDidChangeNotification 
 // 在后台下载内容的应用程序的状态变化时候通知
 
 UIApplicationDidBecomeActiveNotification
 // 当程序变的活跃之后
 
 UIApplicationDidChangeStatusBarFrameNotification
 // 当状态栏frame 改变时候
 
 UIApplicationDidChangeStatusBarOrientationNotification
 // 当用户方向改变时候
 
 
 UIApplicationDidEnterBackgroundNotification
 // 当app已经进入后台之后
 
 
 UIApplicationDidFinishLaunchingNotification
 // 当app完全推出之后
  
 UIApplicationDidReceiveMemoryWarningNotification
 // 当应用内存紧张之后
 
 UIApplicationProtectedDataDidBecomeAvailable
 // 但受保护的文件进入活跃状态
 
 UIApplicationProtectedDataWillBecomeUnavailable
 // 当被保护的文件进入不活跃状态
 
 UIApplicationUserDidTakeScreenshotNotification
 // 当截屏的时候
 
 UIApplicationWillChangeStatusBarOrientationNotification
 // 当应用程序将要改变其接口方向
 
 UIApplicationWillChangeStatusBarFrameNotification
 // 当应用将要改变状态来frame 
 
 UIApplicationWillEnterForegroundNotification
 // 当应用程序从后台将要进入前台
 
 UIApplicationWillResignActiveNotification
 // 应用程序不再主动和失去焦点。

 UIApplicationWillTerminateNotification
 // 当应用程序将要终止。
 
 UIContentSizeCategoryDidChangeNotification
 // 当用户更改内容大小的偏好设置
iOS
Web note ad 1