iOS旋屏开发实践

最近一段时间的开发都以iPhone为主，iPad相关的涉及不多。iPhone开发很少会有横屏的需求，因此关于旋屏的问题很久不接触了。最近有开发同学来问关于特定界面支持旋屏的问题，一查资料发现，随着iOS版本的升级先关API的接口发生了很多变化，而且网上的资料很多都是老版本的解决方案，并不能很好地帮助解决问题。经过几天断断续续地梳理，基本上把旋屏的大部分使用逻辑理清楚了，这里作一个统一的梳理。本文主要针对iOS7以后的版本，很多老版本的旋屏问题，不在本文的讨论范围。

一、如何不支持旋屏

以iPhone应用为例，如何保证一个app只支持竖屏，不支持旋屏呢。其实非常简单，只需要在下面工程设置中，只勾选Portrait即可。

对应的Info.plist配置文件也会改变，如下：

只要照着以上配置好，那么coding部分就不用关注任何旋屏的问题了。

二、常见的旋屏需求解决

首先要支持旋屏，以iPhone为例，一般都会支持上上、左、右三个方向，那么先进行下面的配置。

进行相关配置后，那么默认情况，所有的viewcontroller都支持横竖屏的切换。但是很多时候我们得到的需求是，多数的viewcontroller支持竖屏，只有个别的viewcontroller要求支持旋屏。
针对上述的需求，我们只需要弄清楚下面几个相关的回调或API使用即可：

1.是否支持旋屏

- (BOOL)shouldAutorotate
{
    return YES;
}

返回YES，表示该viewcontroller支持旋屏，否则不支持。

2.支持哪些方向

#if __IPHONE_OS_VERSION_MAX_ALLOWED > __IPHONE_8_4
- (UIInterfaceOrientationMask)supportedInterfaceOrientations
#else
- (NSUInteger)supportedInterfaceOrientations
#endif
{
    return UIInterfaceOrientationMaskAllButUpsideDown;
}

可通过该API进一步定制该viewcontroller支持哪些方向。

3.旋屏后，是否显示状态栏

- (BOOL)prefersStatusBarHidden
{
    return NO;
}

iOS8以后，系统的默认设置是竖屏显示状态栏，横屏不显示。如果希望横屏也显示状态栏，那么增加上面的回调，并且返回NO即可。

Important
特别需要说明的是，上述三个回调默认都是没有实现的，只有系统默认设置无法满足我们需求的时候，我们再考虑定制化这些回调的使用。

三、实际使用过程中可能会遇到的问题

其实上述三个API的使用，都非常简单。但是使用过程中，却会遇到很多莫名其妙的问题。这里把一些常见的问题总结一下。

1.shouldAutorotate回调没有被执行

- (BOOL)shouldAutorotate
{
    return YES;
}

造成这种情况的原因有很多种，但是共性的原因都是该回调被上级的UI链给劫持了。这里列举一个常见的情况：NavigationController。

如果入口的根viewcontroller这么写：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
    self.mainViewController = [[ViewController alloc] init];
    BaseNavigationViewController *rootNavgationController = [[BaseNavigationViewController alloc] initWithRootViewController:self.mainViewController];
    rootNavgationController.navigationBarHidden = YES;
    self.window.rootViewController = rootNavgationController;
    self.window.backgroundColor = [UIColor whiteColor];
 
    [self.window makeKeyAndVisible];
    
    return YES;
}

那么viewcontroller的整个shouldAutorotate回调都会被NavigationController给劫持。通常的解决方案是实现一个NavigationController的子类，并增加下面的代码：

-(BOOL)shouldAutorotate {
    return self.topViewController.shouldAutorotate;
}

#if __IPHONE_OS_VERSION_MAX_ALLOWED > __IPHONE_8_4
- (UIInterfaceOrientationMask)supportedInterfaceOrientations
#else
- (NSUInteger)supportedInterfaceOrientations
#endif
{
    return self.topViewController.supportedInterfaceOrientations;
}

增加断点，可以发现每次旋屏时，上述的回调都会被执行。

注意：self.topViewController返回的对象时整个导航器UI链，最后被push出来的那个viewcontroller。

2.prefersStatusBarHidden回调没有被执行

- (BOOL)prefersStatusBarHidden
{
    return NO;
}

如果在Info.plist里面增加了下面的配置，并且值设置为NO，那么上面的回调就不会被执行。

参数"View controller-based status bar appearance"的作用：
iOS8以后，系统默认横屏时状态栏是隐藏的。
上述参数默认为YES，意味着用户可以通过在回调- (BOOL)prefersStatusBarHidden中进行配置，自定义状态栏旋屏后的隐藏状态。
如果设置为NO，prefersStatusBarHidden回调将不会被执行。意味着禁止用户自定义状态栏旋屏后的隐藏状态，使用系统的默认设置。

3.偶然会碰到的坑：主viewcontroller禁止旋屏，但是状态栏依旧会旋转。

像下面的截图：

看下Info.plist里面的配置，是否有Main storyboard file相关的配置，如果多余的话，去掉就好了。

四、demo示例

一个简单的测试demo
https://github.com/kmplayer/pracRotate