iPhone Duo: адаптация приложения

// SwiftUI
@Environment(\.horizontalSizeClass) private var horizontalSizeClass
@Environment(\.verticalSizeClass) private var verticalSizeClass

// UIKit
traitCollection.horizontalSizeClass
traitCollection.verticalSizeClass

Что удалить из кодовой базы

• UIScreen.main — будет deprecated. На двухэкранном устройстве это неоднозначно. Вместо: environment, traitCollection, scene.bounds, или динамически windowScene.screen.
• Проверки UIDevice.userInterfaceIdiom для layout-решений.
• Проверки interface orientation для layout-решений.
• Фиксированные константы ширины экрана.

Concentricity — форма углов на Duo другая

ConcentricRectangle()        // SwiftUI
UICornerConfiguration        // UIKit

UIRequiresFullScreen не спасает: приложение всё равно ресайзится при открытии и закрытии и масштабируется в Split View.

let width = view.bounds.width - view.safeAreaInsets.left * 2

let width = view.bounds.inset(by: view.safeAreaInsets).width

// Foreground — в пределах safe area
foreground.frame = view.bounds.inset(by: view.safeAreaInsets)

// Background — edge-to-edge
backgroundView.frame = view.bounds            // UIKit
BackgroundView().ignoresSafeArea()            // SwiftUI

Свои кастомные бары — новый API iOS 27.1

Позволяет выйти за safe area, не конфликтуя с системным UI:

ReservedRegion          // SwiftUI
UIViewReservedRegion    // UIKit

Включение — два шага, оба обязательны

1. Пересобрать против iOS 27.1 SDK.   2. Использовать бары от навигационных контейнеров:

// SwiftUI ✅
NavigationStack {
    ContentView()
        .toolbar {
            ToolbarItem(placement: .bottomBar) { … }
        }
}

// UIKit ✅
let vc = UIViewController()
vc.toolbarItems = [...]
let nav = UINavigationController(rootViewController: vc)

// UIKit ❌ — содержимое будет проигнорировано, ошибки не будет
let toolbar = UIToolbar()
toolbar.items = [...]

Размещение элементов

// Back / Close
.toolbar { ToolbarItem(placement: .cancellationAction) { … } }
// UIKit:
navigationItem.leftItemsSupplementBackButton = false   // default
navigationItem.leadingItemGroups = [UIBarButtonItemGroup(...)]

// Prominent action (Done)
.toolbar { ToolbarItem(placement: .topBarPinnedTrailing) { … } }
// UIKit:
navigationItem.pinnedTrailingGroup = UIBarButtonItemGroup(...)

Управление осью вручную

// Элемент, переключающийся текст ↔ символ (кастомный Select/Done)
.axisBehavior(.horizontalOnly)
item.axisBehavior = .horizontalOnly

// Кастомный view, умеющий вертикальное представление (напр. компас)
.axisBehavior(.verticalPreferred)
let item = UIBarButtonItem(customView: CompassView())
item.axisBehavior = .verticalPreferred

Системная Edit-кнопка уже ведёт себя правильно автоматически.

Бейджи (iOS 26+)

InboxButton().badge(7)        // SwiftUI
item.badge = .count(7)        // UIKit

Чтение контекста в кастомных view

@Environment(\.toolbarVerticalEdge) var edge   // SwiftUI
traitCollection.verticalBarEdge                // UIKit
// nil / .unspecified — когда вертикального бара нет

Кастомные view, идущие вертикально, должны либо влезать в фиксированную ширину, либо иметь вертикально адаптированную раскладку — например прятать подписи и становиться ниже.

Спейсеры: flexible в вертикальной оси = нулевой размер; fixed уважают минимум. Используйте ToolbarItemGroup / UIBarButtonItemGroup.

Отключение

.toolbarVerticalBehavior(.disabled)   // SwiftUI

override var preferredVerticalBarBehavior: UIVerticalBarBehavior { .disabled }  // UIKit

// Приоритет toolbar vs tab bar — на уровне экрана
TabView {
    Tab("Recents", systemImage: "clock") {
        ContentView()
            .toolbarVerticalCompressionBehavior(.prefersToolbarItems)
    }
}
// UIKit:
navigationItem.verticalBarCompressionBehavior = .prefersBarItems

// Слияние собственного overflow с системным
.toolbar {
    ToolbarOverflowMenu {
        Button("Scan")    { … }
        Button("Connect") { … }
    }
}
// UIKit:
navigationItem.additionalOverflowItems = UIDeferredMenuElement { provider in
    provider(self.persistentOverflowItems())
}

// Приоритеты видимости
.toolbar {
    ToolbarItem { Button(…) { … } }
        .visibilityPriority(.high)      // .high / .low / кастомное
}
// UIKit:
item.visibilityPriority = .high

// SwiftUI — через GeometryReader или onGeometryChange
GeometryReader { proxy in
    let regions = proxy.reservedRegions(kind: .division)
    let frames  = regions.map(\.frame)
}

// Включая неактивные
proxy.reservedRegions(kind: .division, options: .includeInactive)

// Камеры
proxy.reservedRegions(kind: .occlusion)

// UIKit
let regions = view.reservedRegions(kind: .division)

• Division region делит площадь на несколько зон. Активен только при сложенном устройстве; когда плоское — неактивен, ширина 0.
• Occlusion region не делит, а перекрывает — маленький фрейм внутри ваших bounds.
• Зачем includeInactive: позволяет принимать решения высокого уровня заранее. Например, выбрать чётное количество колонок в сетке по одному факту наличия division region, не дожидаясь складывания.

// SwiftUI
NavigationStack {
    ArrangementView {
        PlayerView()
    } secondary: {
        UpNextView()
    }
    .arrangementViewStyle(.split.axes(.horizontal))   // или .overlay
}

// UIKit
let arrangementVC = UIArrangementViewController()
let nav = UINavigationController(rootViewController: arrangementVC)

arrangementVC.setViewController(playerVC, for: .primary)
arrangementVC.setViewController(upNextVC, for: .secondary)
arrangementVC.updateArrangement(.split.axes(.horizontal))

Overlay: читаем z-index, чтобы изменить представление

struct UpNextView: View {
    @Environment(\.overlayArrangementZIndex) private var zIndex: Int
    var minimization: UpNextMinimization { zIndex > 0 ? .collapsed : .expanded }
    var body: some View { UpNextList(minimization: minimization) }
}

// UIKit
let primaryState = arrangementVC.state(for: .primary)
model.minimization = (primaryState?.zIndex ?? 0) > 0 ? .collapsed : .expanded

// Split
NavigationSplitView { … } detail: { … }     // SwiftUI
UISplitViewController                        // UIKit

// Tab bar как sidebar
TabView { … }.defaultTabBarPlacement(.sidebar)          // SwiftUI
tabBarController.sidebar.preferredPlacement = .sidebar  // UIKit

Split view, собранный из стандартных компонентов, сам адаптирует ширины колонок и поля под сгиб.

• Системные .sheet, .alert, .confirmationDialog, .popover, UIMenu — из коробки.
• Для кастомных оверлеев — reservedRegions(kind: .division) и смещение вручную.
• Управление наличием бара в sheet — через toolbarVerticalBehavior(.disabled) / preferredVerticalBarBehavior.

Реализуется через reserved regions (.division) или overlay-arrangement, а не через угол шарнира.

• Инструменты те же: size classes + scene geometry. Ничего специального.
• Если работает resizing на iPad или в iPhone Mirroring — базово уже работает.
• Тест в симуляторе: открыть на внутреннем дисплее в Device Hub, потянуть от home-индикатора вбок. Проследить, как вертикальные бары перепрыгивают на противоположную сторону.

• Если поддерживаете multiple scenes на iPad — работает и здесь.
• Доступность динамическая — в отличие от iPad, где окно можно создать в любой момент.
• Обрабатывайте ошибки создания сцены.
• Используйте UIWindowScene.ActivationAction — он автоматически прячется, когда создание недоступно.

struct InstrumentView: View {
    @State private var pitchBend: Double = 0

    var body: some View {
        GuitarView(pitchBend: pitchBend)
            .onHingeChange { _, context in
                if let hinge = context.hinge, hinge.status == .partiallyOpen {
                    pitchBend = calculatePitchBend(angle: hinge.angle)
                } else {
                    pitchBend = 0     // обязательный сброс
                }
            }
    }
}

• UIKit: UIHingeInteraction.
• Даёт дискретный status: .closed / .partiallyOpen / .fullyOpen, и непрерывный angle.
• context.hinge == nil → устройство без шарнира. Обрабатывать обязательно.
• Не забывайте else-ветку со сбросом состояния.

struct CameraRootView: View {
    @State private var model = TeleprompterModel()

    var body: some View {
        CameraView(model: model)
            .sceneAccessory {
                CameraCaptureAccessory(isEnabled: $model.isEnabled) {
                    TeleprompterView(model: model)
                }
                .onAvailabilityChange { model.isAvailable = $0 }
            }
            .toolbar {
                TeleprompterToggle(isEnabled: $model.isEnabled)
                    .disabled(!model.isAvailable)
            }
    }
}

Условия доступности CameraCaptureAccessory

• приложение fullscreen на внутреннем дисплее
• активная camera session
• регистрировать на том же view, что и камерный UI — тогда аксессуар живёт ровно столько, сколько видна камера

// Типы устройств
.builtInOuterUltrawideCamera      // новый
.builtInInnerUltrawideCamera      // новый
// Виртуальная: обычный DiscoverySession с position: .front + wide/ultrawide

// Direction coordinator — где камеры относительно КОНКРЕТНОГО view
directionCoordinator = AVCaptureDeviceDirectionCoordinator(
    view: view,
    deviceTypes: [.builtInOuterUltrawideCamera,
                  .builtInInnerUltrawideCamera,
                  .builtInDualWideCamera],
    changeHandler: { [weak self] map in self?.updateCameraSession(map) }
)

Правила concurrency

• Coordinator изолирован к Main Actor.
• В change handler не вызывайте AVFoundation напрямую. Он отдаёт AVCaptureDeviceDescriptor — Sendable-представление, которое безопасно передаётся в ваш camera actor, и уже там создаётся AVCaptureDevice.
• Используете оба дисплея одновременно — отдельный coordinator на каждый view; каждый отчитывается относительно своего view.

В change handler три вещи: переконфигурировать AVCaptureSession · пересмотреть решение о зеркалировании · обновить UI.

Превью и производительность

previewLayer.videoGravity            // как превью ложится в bounds слоя
device.dynamicAspectRatio            // landscape-соотношение с квадратного сенсора
AVCaptureDeviceRotationCoordinator   // обязательно, обновляется при переезде между дисплеями
photoOutput.isCameraSensorOrientationCompensationEnabled = false

Те же принципы resizability; избегайте привязки к конкретному экрану.

1. Xcode 27.1
2. Сборка против iOS 27.1 SDK
3. Симулятор iPhone Duo в Device Hub — кнопки снизу: open / close / rotate / fold
4. Агентский скилл Xcode app-resizability (бывший app-modernization, теперь поддерживает SwiftUI и Duo). Промпт: «Make my app follow all resizability best practices». В частности автоматически заменяет UIScreen.main.scale → traitCollection.displayScale.

Уровни поддержки по версии SDK — чтобы понимать, где вы сейчас

• Этап 0. Xcode 27.1, сборка против iOS 27.1 SDK
• Прогнан app-resizability skill
• Прогнаны все позы в Device Hub
• Этап 1. Удалён UIScreen.main
• Удалены проверки idiom / interface orientation из layout-логики
• Удалены фиксированные ширины и кастомные брейкпоинты
• Исправлен весь код, предполагающий симметричные safe area insets
• Foreground → safe area, background → edge-to-edge
• ConcentricRectangle / UICornerConfiguration для углов
• Этап 2. Все бары от навигационных контейнеров; ни одного ручного UIToolbar
• Label / UIBarButtonItem с title + symbol везде
• Back/Close → .cancellationAction; prominent → .topBarPinnedTrailing
• .badge() вместо inline-счётчиков
• .axisBehavior для кастомных view и «переключателей» текст↔символ
• Кастомные view читают toolbarVerticalEdge / verticalBarEdge
• ToolbarOverflowMenu / additionalOverflowItems вместо своего меню
• visibilityPriority на группах и элементах
• toolbarVerticalCompressionBehavior выбран для каждого экрана
• Ручные спейсеры заменены на ToolbarItemGroup
• Этап 3. Кастомные контролы используют reservedRegions
• Кастомные HStack/VStack/ZStack-макеты → ArrangementView
• Split View multitasking проверен в обеих половинах
• Обработка ошибок создания сцен + UIWindowScene.ActivationAction
• Этап 4. onHingeChange — только для эффектов
• Scene accessories / CameraCaptureAccessory
• Камера: direction + rotation coordinator, выключена sensor orientation compensation