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可以管理设备的特定行为。如下所示：

1. 暂停触摸事件 beginIgnoringInteractionEvents
2. 注册远程推送 unregisterForRemoteNotifications
3. 触发 undo-redo UI applicationSupportsShakeToEdit
4. 确定是否有一个安装程序处理 URL scheme canOpenURL:
5. 扩展App应用程序的执行，以便它可以在后台完成一个任务beginBackgroundTaskWithExpirationHandler:, beginBackgroundTaskWithName:expirationHandler:
6. 添加和取消本地的通知 scheduleLocalNotification:, cancelLocalNotification:
7. 协调遥控接收事件 beginReceivingRemoteControlEvents, endReceivingRemoteControlEvents
8. 执行app-level状态恢复任务 methods in the Managing the State Restoration Behavior task group

获得实例

// 返回应用单个实例
+ (UIApplication *)sharedApplication

获得AppDelegate

// 这个应用的代理
@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
// 目前的宿友的预定的本地通知

控制状态恢复

- (void)extendStateRestoration
// 异步恢复状态

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

- (void)ignoreSnapshotOnNextApplicationLaunch
// 阻止应用程序使用最近的快找图像，在接下来的循环中

+ (void)registerObjectForStateRestoration:(id<UIStateRestoring>)object
restorationIdentifier:(NSString *)restorationIdentifier
// 注册自定义对象的使用状态恢复系统

控制后台扩展

@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值 确定控制器是否停止运行在空闲的时间

控制 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
// 当用户更改内容大小的偏好设置