setNeedsDisplay(): суть метода и механизм перерисовки в iOS

Что такое setNeedsDisplay()

setNeedsDisplay() — это метод UIView, который сигнализирует системе, что содержимое вью устарело и требует повторного рендеринга. Метод не принимает параметров и возвращает void. После вызова вью помечается как dirty, и в ближайшем цикле отрисовки система вызывает draw(_:) для этого вью.

Ключевая особенность — асинхронность. Несколько подряд вызовов setNeedsDisplay() для одного вью не приведут к множественным вызовам draw(_:) — система объединяет их в одну операцию. Это критически важно для производительности: если свойство вью меняется несколько раз за кадр, draw(_:) вызывается только один раз.

Как работает отложенная перерисовка

Механизм отложенной перерисовки основан на цикле рендеринга UIKit. Когда вызывается setNeedsDisplay(), система устанавливает внутренний флаг layer.needsDisplay в true. В конце текущего run loop система проходит по всем dirty-слоям и вызывает draw(_:) для каждого.

Run loop и шаги рендеринга

UIKit run loop включает фазу update, во время которой обрабатываются dirty-вью. На этой фазе происходит вызов layoutSubviews() при необходимости, затем draw(_:) для всех помеченных вью. После завершения отрисовки результат передаётся на GPU через Core Animation для композитинга.

class ProgressView: UIView {
    var progress: CGFloat = 0 {
        didSet {
            setNeedsDisplay()
        }
    }

    override func draw(_ rect: CGRect) {
        super.draw(rect)
        guard let ctx = UIGraphicsGetCurrentContext() else { return }

        // Background
        ctx.setFillColor(UIColor.lightGray.cgColor)
        ctx.fill(rect)

        // Progress bar
        let fillRect = CGRect(x: rect.minX, y: rect.minY,
                              width: rect.width * progress, height: rect.height)
        ctx.setFillColor(UIColor.systemGreen.cgColor)
        ctx.fill(fillRect)
    }
}

В этом примере progressView обновляет progress, и каждый сеттер автоматически вызывает setNeedsDisplay(). Система дождётся конца run loop и вызовет draw(_:) с актуальным значением progress. Если progress изменится трижды за кадр, draw(_:) выполнится только один раз — с последним значением.

setNeedsDisplay() vs setNeedsDisplay(_:)

Метод setNeedsDisplay(_:) принимает параметр rect типа CGRect, ограничивающий область перерисовки. Это позволяет перерисовывать только изменившуюся часть вью, а не всё целиком. Разница в производительности становится заметной при работе с большими вью, где изменения затрагивают малую область.

Для сложной графики рекомендуется сначала рисовать всю сцену в offscreen контекст, а затем вызывать setNeedsDisplay(_:) только для изменившейся области. Это стандартная техника в приложениях для рисования и графических редакторах на iOS.

displayIfNeeded() против setNeedsDisplay()

displayIfNeeded() — это синхронный метод, который немедленно запускает перерисовку всех dirty-вью в иерархии, не дожидаясь конца run loop. В отличие от setNeedsDisplay(), который лишь устанавливает флаг, displayIfNeeded() форсирует немедленное выполнение draw(_:).

Apple рекомендует использовать displayIfNeeded() только в крайних случаях, когда результат отрисовки нужен немедленно — например, перед созданием скриншота или при синхронной генерации изображения для UIGraphicsImageRenderer. В обычных сценариях асинхронная модель через setNeedsDisplay() предпочтительнее, так как не блокирует основной поток.

    // Asynchronous — recommended
someView.setNeedsDisplay()

    // Synchronous — only when necessary
someView.setNeedsDisplay()
someView.displayIfNeeded() // draw(_:) called immediately

Вызов displayIfNeeded() без предшествующего setNeedsDisplay() не даст эффекта — метод обрабатывает только уже помеченные как dirty вью. Если ни одно вью не требует перерисовки, displayIfNeeded() завершится без вызова draw(_:).

Оптимизация вызовов setNeedsDisplay()

Частые вызовы setNeedsDisplay() могут снизить производительность, особенно при анимации. Рассмотрим основные стратегии оптимизации.

Объединение изменений через модель

Вместо вызова setNeedsDisplay() при каждом изменении отдельного свойства накапливайте изменения и вызывайте метод один раз после применения всех обновлений. Например, при изменении цвета, размера и позиции элемента — вызовите setNeedsDisplay() один раз после установки всех свойств.

Использование CALayer для анимируемых свойств

Если свойство может быть анимировано через CALayer (backgroundColor, opacity, position, transform), используйте Core Animation вместо draw(_:). CALayer-свойства обновляются на GPU без вызова draw(_:), что даёт 60 FPS без нагрузки на CPU.

Пакетное обновление через CATransaction

Для группировки нескольких изменений в один проход рендеринга используйте CATransaction. Это позволяет объединить несколько setNeedsDisplay() в одну операцию draw(_:) в конце транзакции.

CATransaction.begin()
CATransaction.setDisableActions(true)

view1.setNeedsDisplay()
view2.setNeedsDisplay()
view3.setNeedsDisplay()

CATransaction.commit()

Не злоупотребляйте displayIfNeeded() — синхронная перерисовка блокирует main thread и может вызвать дроп кадров. Используйте её только для операций, где результат отрисовки критически важен до завершения текущего run loop.