Как отлаживать проблемы с layout с помощью Xcode view debugger?

Отладка layout с Xcode View Debugger

Xcode View Debugger (View Hierarchy Debugger) — инструмент для визуальной инспекции иерархии view в рантайме. Позволяет находить проблемы с Auto Layout, перекрывающимися views и неправильной иерархией без перезапуска приложения.

Запуск View Debugger

# Запустить приложение в Simulator или на устройстве
# Debug menu -> View Debugging -> Capture View Hierarchy
# Или нажать иконку в Debug bar (кнопка с тремя прямоугольниками)
# Горячая клавиша: нет встроенной — назначьте через Xcode -> Key Bindings

Три панели View Debugger

• 3D canvas: взрыв-схема иерархии, можно вращать и раздвигать слои.
• View hierarchy (левая панель): дерево view и view controllers.
• Inspector (правая панель): frame, constraints, класс view.

Диагностика Auto Layout конфликтов

Конфликты constraints логируются в консоль при запуске:

# В консоли Xcode при запуске:
# [LayoutConstraints] Unable to simultaneously satisfy constraints.
# Probably at least one of the constraints in the following list is one you don't want.
#   "<NSLayoutConstraint:0x600003a40050 UIView.width == 200   (active)>",
#   "<NSLayoutConstraint:0x600003a40100 UIView.width == 300   (active)>"

Чтобы понять, какой constraint из вашего кода — добавьте identifier:

// Именование constraints для отладки
let widthConstraint = view.widthAnchor.constraint(equalToConstant: 200)
widthConstraint.identifier = "ProfileImage.width"
widthConstraint.isActive = true

// Теперь в логе появится:
// "<NSLayoutConstraint:0x... ProfileImage.width UIView.width == 200 (active)>"

Programmatic breakpoints для layout

// Добавьте symbolic breakpoint в Xcode:
// + -> Add Symbolic Breakpoint
// Symbol: UIViewAlertForUnsatisfiableConstraints
// Это остановит выполнение при каждом конфликте constraints

// Или в коде для визуальной отладки:
extension UIView {
    func debugBorders(color: UIColor = .red) {
        layer.borderColor = color.cgColor
        layer.borderWidth = 1
        subviews.forEach { $0.debugBorders(color: color.withAlphaComponent(0.7)) }
    }
}

Поиск проблем с иерархией

// Через View Debugger: фильтр по классу view
// В поисковой строке hierarchy введите имя класса: "UILabel"

// Programmatic: распечатать иерархию
print(view.value(forKey: "recursiveDescription") as? String ?? "")
// Эквивалент po view.recursiveDescription() в lldb консоли

LLDB команды для layout

# В Debug Console Xcode (lldb):
# Показать иерархию view
(lldb) po rootView.recursiveDescription()

# Принудительно обновить layout без перезапуска
(lldb) e -l objc -- (void)[CATransaction flush]

# Найти constraint по адресу
(lldb) po 0x600003a40050

Подводные камни

• View Debugger останавливает рантайм приложения — анимации зафиксированы, данные могут быть в промежуточном состоянии.
• Некоторые кастомные drawing (CALayer, Metal) не отображаются корректно в 3D-режиме — переключитесь в flat режим.
• В SwiftUI-UIKit bridge View Debugger показывает внутренние UIHostingController views, которые выглядят как черные ящики — используйте Instruments для SwiftUI.
• На реальном устройстве требуются права debugging — provisioning profile должен разрешать get-task-allow.
• Конфликты constraints с priority 999 не логируются как ошибки, но layout может быть неожиданным — проверяйте priorities явно.
• translatesAutoresizingMaskIntoConstraints = true (по умолчанию) при programmatic constraints — источник 50% всех layout конфликтов.
• Symbolic breakpoint UIViewAlertForUnsatisfiableConstraints замедляет запуск — отключайте на время profiling.
• View Debugger не работает при низком уровне battery или в режиме Low Power Mode на некоторых версиях iOS — запускайте на зарядке.

• Сводить «отлаживать проблемы с layout с помощью Xcode view debugger» к синтаксису и не объяснять responder chain.
• Игнорировать жизненный цикл, основной поток или момент освобождения ресурсов в сценарии uikit-28.
• Выбирать API по привычке, не проверяя состояние, ошибки, доступность и платформенные ограничения.

• Формулирует точную модель для «отлаживать проблемы с layout с помощью Xcode view debugger» и подтверждает ее корректным примером.
• Умеет связать ответ с reuse pool, тестированием и отладкой на устройстве.
• Называет ограничения подхода uikit-28, включая производительность, память и сопровождение.