Разбираемся с autorotation в iOS 6

Привет, друзья!

Если вы создаете приложения для гаджетов от Apple, то наверняка в курсе, что недавно произошло обновление iOS до версии 6.
Наравне с другими ^[1] новыми функциями Apple внесла изменения в механизм autorotation.
На всякий случай напомню, что autorotation — это механизм, позволяющий использовать устройство как в портретной (вытянутой в высоту), так в альбомной (растянутой в ширину) ориентации, а также изменять эту ориентацию при повороте устройства.

Если в вашем приложении контент отображается в обеих ориентациях (а особенно если на некоторых экранах вам нужно запретить поворот) — готов поспорить, что у вас уже возникли некоторые вопросы ^[2].
Если же вы не используете функцию изменения ориентации экрана — разницы могли и не заметить. Однако знание того, как в iOS6 работает autorotation, в любом случае будет полезно и пригодится в будущем.

Как было до iOS 6

Устройства под управлением iOS поддерживают 4 возможных ориентации экрана, описываемых соответствующими системными константами:

• UIInterfaceOrientationPortrait
• UIInterfaceOrientationPortraitUpsideDown
• UIInterfaceOrientationLandscapeLeft
• UIInterfaceOrientationLandscapeRight

В iOS 5 и более ранних версиях, для работы механизма autorotation используется метод

- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation {
   // Возвращаем YES для поддерживаемых ориентаций
   return (interfaceOrientation == UIInterfaceOrientationPortrait);
}

Когда устройство изменяет свою ориентацию в пространстве, при помощи вызова данного метода система запрашивает активный контроллер (view controller), поддерживает ли он переход в эту ориентацию.
При вызове метода параметр interfaceOrientation содержит одно из 4 возможных значений, и метод должен вернуть YES, если требуется повернуть окно приложения (или NO в противном случае).
Таким образом, для каждого отдельного контроллера достаточно переопределить метод shouldAutorotateToInterfaceOrientation: и указать поддерживаемые им виды ориентации.

Ключ UISupportedInterfaceOrientations в Info.plist содержит список ориентаций, поддерживаемых приложением (также можно выбрать их в разделе Summary ваших Targets) и используется системой только для определения начальной ориентации при запуске приложения.

Если не будет указано ни одного вида ориентации — ничего страшного не произойдет, приложение будет запущено в обычной портретной (UIInterfaceOrientationPortrait).

Стало в iOS 6

В iOS 6 метод shouldAutorotateToInterfaceOrientation объявлен устаревшим (deprecated), а за логику работы autorotation отвечают два других — supportedInterfaceOrientations и shouldAutorotate.

При изменения положения устройства (или когда контроллер презентуется модально) система опрашивает самый верхний полноэкранный контроллер (top-most full-screen view controller). При этом сначала происходит вызов shouldAutorotate, а затем (только в случае возврата значения YES) — вызов supportedInterfaceOrientations для получения битовой маски, описывающей поддерживаемые положения. Например, следущий код может использоваться для подержки обычной портретной и обеих альбомных ориентаций.

- (NSInteger)supportedInterfaceOrientations
{
   return UIInterfaceOrientationMaskPortrait | 
          UIInterfaceOrientationMaskLandscapeLeft | 
          UIInterfaceOrientationMaskLandscapeRight;
}

Далее, система использует полученное от supportedInterfaceOrientations значение, производя операцию конъюнкции ^[3] (logical AND) со списком глобально поддерживаемых приложением ориентаций (берется из Info.plist либо как результат метода AppDelegate application:supportedInterfaceOrientationsForWindow:). По итогам проведенной операции происходит (или не происходит) поворот.

Если вкратце, то решение принимается путем операции

app_mask && topmost_controller_mask

где app_mask берется из Info.plist (либо application:supportedInterfaceOrientationsForWindow:), а topmost_controller_mask как результат вызова supportedInterfaceOrientations верхнего полноэкранного контроллера.

Также стоит принять во внимание следующие моменты:

• так как значение app_mask действует глобально, следует изменять его осмотрительно
• для временного отключения возможности поворота рекомендуется использовать shouldAutorotate, а не проводить манипуляции с маской в supportedInterfaceOrientations
• если в AppDelegate используется метод application:supportedInterfaceOrientationsForWindow:, то значения из Info.plist будут проигнорированы
• если в какой-то момент результатом конъюнкции будет 0, это приведет к исключению UIApplicationInvalidInterfaceOrientationException
• если вы не переопределили методы supportedInterfaceOrientations и shouldAutorotate, по умолчанию контроллеры будут поддерживать все типы ориентации на устройствах iPad, а на iPhone — все, кроме PortraitUpsideDown
• новый метод preferredInterfaceOrientationForPresentation позволяет указать предпочитаемую ориентацию контроллера при его отображении
• shouldAutoRotateToInterfaceOrientation: больше не вызывается в iOS 6, однако вы должны по прежнему использовать его для поддержки устройств с прошлыми версиями iOS

Таковы изменения. Данный ход продиктован желанием Apple перенести ответственность за принятие решений о поддерживаемом положении экрана с каждого конкретного активного контроллера на контроллеры-контейнеры и само приложение.

Ключевые мысли от Apple (Session 236 from WWDC 2012) по этому поводу звучат следующим образом:

• контроллеры должны стремиться к поддержке всех возможных режимов
• дочерние контроллеры должны уметь отображаться в любом фрейме, указанном их родителем
• приложение должно иметь возможность указать поддерживаемые типы ориентации (Info.plist либо application:supportedInterfaceOrientationsForWindow:)
• при повороте только root или верхний полноэкранный контроллер будут опрошены

Что с этим делать

При разработке нового проекта, от которого требуется поддержка iOS 5 и более ранних версий, Apple рекомендует стараться эмулировать механизмы iOS 6:

• в root или полноэкранном контроллере указывать полный список поддерживаемых ориентаций экрана
• в child-контроллерах реализовывать поддержку всех необходимых ориентаций

Однако, что делать если необходимо мигрировать (желательно, с минимальными усилиями) на iOS 6 уже существующий проект, в котором решения о поворотах принимаются различными конечными контроллерами? Использование новых методов supportedInterfaceOrientations/shouldAutorotate рядом с shouldAutorotateToInterfaceOrientation ситуацию не спасет, если эти контроллеры не root и не top-most full-screen. Чтобы заставить контроллеры-контейнеры прислушиваться к мнению контролируемых можно воспользоваться следующими подходами.

1. Категория.
При помощи категории переопределить новые методы так, чтобы опрашивать соответствующие топ-контроллеры на предмет поворота. К примеру, для UINavigationController это может выглядеть так:

@implementation UINavigationController (RotationIOS6)

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

-(NSUInteger)supportedInterfaceOrientations
{
    return [self.topViewController supportedInterfaceOrientations];
}

- (UIInterfaceOrientation)preferredInterfaceOrientationForPresentation
{
    return [self.topViewController preferredInterfaceOrientationForPresentation];
}
@end 

2. Наследование.
Реализовать то же, что и в пункте 1, но путем наследования от UINavigationController — когда нет необходимости глобально подвергать модификации сразу все UINavigationController-ы.

// CustomNavigationController.h

@interface CustomNavigationController : UINavigationController

@end

// CustomNavigationController.m

#import "CustomNavigationController.h"

@implementation CustomNavigationController

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

-(NSUInteger)supportedInterfaceOrientations
{
    return [self.topViewController supportedInterfaceOrientations];
}

- (UIInterfaceOrientation)preferredInterfaceOrientationForPresentation
{
    return [self.topViewController preferredInterfaceOrientationForPresentation];
}

@end

3. Method swizzling.
Для любителей runtime и поклонников хардкора — используя swizzling ^[4], переопределить новые методы так, чтобы фактически использовать вызовы старого привычного метода shouldAutorotateToInterfaceOrientation:.

(код взят отсюда ^[5])

@implementation AppDelegate
void SwapMethodImplementations(Class cls, SEL left_sel, SEL right_sel) {
    Method leftMethod = class_getInstanceMethod(cls, left_sel);
    Method rightMethod = class_getInstanceMethod(cls, right_sel);
    method_exchangeImplementations(leftMethod, rightMethod);
}

+ (void)initialize {
    if (self == [AppDelegate class]) {
#ifdef __IPHONE_6_0
        SwapMethodImplementations([UIViewController class], @selector(supportedInterfaceOrientations), @selector(sp_supportedInterfaceOrientations));
        SwapMethodImplementations([UIViewController class], @selector(shouldAutorotate), @selector(sp_shouldAutorotate));
#endif
    }
}
@end

@implementation UIViewController (iOS6Autorotation)
#ifdef __IPHONE_6_0
/*
 * We've swizzled the new iOS 6 autorotation callbacks onto their iOS 5 and iOS 4 equivalents
 * to preserve existing functionality.
 *
 */
- (BOOL)sp_shouldAutorotate {
    BOOL shouldAutorotate = YES;
    if ([self respondsToSelector:@selector(shouldAutorotateToInterfaceOrientation:)]) {
        NSUInteger mask = 0;
        if ([self shouldAutorotateToInterfaceOrientation:UIInterfaceOrientationPortrait]) {
            mask |= UIInterfaceOrientationMaskPortrait;
        }
        if ([self shouldAutorotateToInterfaceOrientation:UIInterfaceOrientationLandscapeLeft]) {
            mask |= UIInterfaceOrientationMaskLandscapeLeft;
        }
        if ([self shouldAutorotateToInterfaceOrientation:UIInterfaceOrientationLandscapeRight]) {
            mask |= UIInterfaceOrientationMaskLandscapeRight;
        }
        if ([self shouldAutorotateToInterfaceOrientation:UIInterfaceOrientationPortraitUpsideDown]) {
            mask |= UIInterfaceOrientationMaskPortraitUpsideDown;
        }
        if (mask == 0) {
            // Shouldn't autorotate to *any* orientation.
            shouldAutorotate = NO;
        }
    } else {
        // This actually calls the original method implementation
        // instead of recursively calling into this method implementation.
        shouldAutorotate = [self sp_shouldAutorotate];
    }
    return shouldAutorotate;
}

- (NSUInteger)sp_supportedInterfaceOrientations {
    NSUInteger mask = 0;
    
    /*
     * In iOS 6, Apple dramatically changed the way autorotation works.
     * Rather than having each view controller respond to shouldAutorotateToInterfaceOrientation:
     * to specify whether or not it could support a particular orientation, the responsibility was
     * shifted to top-level container view controllers. That means UINavigationController becomes
     * responsible for declaring whether or not an orientation is supported. Since our app
     * has logic for how to autorotate on a per view controller basis, we call through to the
     * swizzled version of supportedInterfaceOrientations for the topViewController.
     *
     */
    if ([self isKindOfClass:[UINavigationController class]]) {
        return [[(UINavigationController *)self topViewController] supportedInterfaceOrientations];
    }
    
    if ([self respondsToSelector:@selector(shouldAutorotateToInterfaceOrientation:)]) {
        if ([self shouldAutorotateToInterfaceOrientation:UIInterfaceOrientationPortrait]) {
            mask |= UIInterfaceOrientationMaskPortrait;
        }
        if ([self shouldAutorotateToInterfaceOrientation:UIInterfaceOrientationLandscapeLeft]) {
            mask |= UIInterfaceOrientationMaskLandscapeLeft;
        }
        if ([self shouldAutorotateToInterfaceOrientation:UIInterfaceOrientationLandscapeRight]) {
            mask |= UIInterfaceOrientationMaskLandscapeRight;
        }
        if ([self shouldAutorotateToInterfaceOrientation:UIInterfaceOrientationPortraitUpsideDown]) {
            mask |= UIInterfaceOrientationMaskPortraitUpsideDown;
        }
    } else {
        // This actually calls the original method implementation
        // instead of recursively calling into this method implementation.
        mask = [self sp_supportedInterfaceOrientations];
    }
    return mask;
}
#endif
@end

В данном случае больше не потребуется вообще никаких изменений существующего кода — магия runtime сделает свое дело. Однако, как бы заманчиво это не выглядело, данный код категорически не рекомендуется к использованию (узнать, почему) ^[6].

В моем случае, удобнее всего оказалось воспользоватся категориями.

Надеюсь, изложенный материал кому-то пригодится и поможет сэкономить самый ценный ресурс разработчика — время :)

Полезные ссылки:

• View Controller Programming Guide for iOS ^[7]
• WWDC 2012, Session 236 «View Controller Evolution» ^[8]
• Method Swizzling ^[9]

Автор: xZenon