Уровни поддержки

Homebrew определяет три уровня поддержки, чтобы помочь пользователям понять, насколько хорошо Homebrew должен работать на разных системах.

Эти уровни описывают степень совместимости, охват автоматизированного тестирования и поддержку сообщества, которые проект активно обеспечивает. Они также определяют наши ожидания при работе с проблемами, запросами на включение изменений и регрессиями.

Эти уровни описывают поддержку Homebrew для самой хост-системы и не гарантируют, что каждая сторонняя формула или cask всегда будет запускаться в этой системе. Отдельные правила для пакетов, например поэтапный отказ от cask-пакетов, зависящих от Rosetta, на Apple Silicon, описаны отдельно в разделе Допустимые cask-пакеты.

Уровень 1

Конфигурация уровня 1 считается полностью поддерживаемой. Для таких конфигураций обеспечивается наибольший охват CI, а их проблемы и разработка формул рассматриваются в приоритетном порядке.

Пользователи могут рассчитывать на следующее:

• наиболее надежную работу с Homebrew
• расследование воспроизводимых ошибок и, по возможности, их исправление сопровождающими Homebrew
• отсутствие предупреждений, связанных с конфигурацией системы
• полный охват CI для тестирования и сборки бинарных пакетов
• поддержку через системы отслеживания проблем Homebrew на GitHub
• блокировку запросов на включение изменений, если они не проходят проверки в системах уровня 1

macOS

Чтобы конфигурация macOS соответствовала уровню 1, она должна отвечать всем следующим условиям:

• Используется официальное оборудование Apple (не Hackintosh и не виртуальная машина)
• Установлена последняя версия исправлений выпуска macOS, поддерживаемого Apple для этого оборудования и включенного в охват CI Homebrew (обычно это последняя стабильная версия или предварительная версия, а также две предыдущие версии)
• Homebrew установлен в префикс по умолчанию:
  • /opt/homebrew на Apple Silicon
  • /usr/local на Intel x86_64
• Используется поддерживаемая архитектура (Apple Silicon или Intel x86_64)
• Официальные пакеты не собираются из исходного кода (то есть используются бинарные пакеты)
• Homebrew установлен на внутренний накопитель Mac (не на внешний или съемный накопитель)
• Доступен доступ sudo
• Установлены и обновлены инструменты командной строки Xcode

Linux

Чтобы конфигурация Linux соответствовала уровню 1, она должна отвечать всем следующим условиям:

• Используется одна из следующих систем:
  • Ubuntu в пределах периода стандартной поддержки или
  • образ Docker, предоставляемый Homebrew
• Используется версия glibc системы ≥ 2.39
• Используется версия ядра Linux ≥ 3.2
• Homebrew установлен в префикс по умолчанию: /home/linuxbrew/.linuxbrew
• Используется поддерживаемая архитектура (ARM64/AArch64 или Intel x86_64 с поддержкой SSSE3)
• Официальные пакеты не собираются из исходного кода (то есть используются бинарные пакеты)
• Доступен доступ sudo

Уровень 2

Конфигурация уровня 2 не является полностью поддерживаемой. Такие конфигурации выходят за рамки полного охвата CI, и их работа может быть нестабильной.

Как правило, применяются следующие условия:

• Homebrew может быть пригоден к использованию, но его надежность или производительность могут быть снижены
• Запросы на включение изменений, устраняющих проблемы, специфичные для этих конфигураций, могут быть рассмотрены, но сопровождающие не обязуются исправлять связанные ошибки
• brew doctor будет выводить предупреждения, связанные с конфигурацией
• Охват CI может быть неполным; бинарные пакеты могут быть недоступны или не устанавливаться
• Проблемы, затрагивающие только эти конфигурации, могут быть закрыты без расследования
• Поддержка обычно ограничивается ответами сообщества в обсуждениях Homebrew

К конфигурациям уровня 2 относятся:

• Предварительные версии macOS до их перевода на уровень 1
• Системы macOS с устаревшими версиями инструментов командной строки Xcode
• Системы Linux с версиями glibc от 2.13 до 2.38 (формула glibc, поддерживаемая самим Homebrew, будет установлена автоматически)
• Homebrew, установленный вне префикса по умолчанию, что требует сборки официальных пакетов из исходного кода (то есть установленный вне /opt/homebrew, /usr/local или /home/linuxbrew/.linuxbrew)
• Архитектуры, которые Homebrew пока официально не поддерживает
• Компьютеры Mac с OpenCore Legacy Patcher и процессором Intel Westmere или новее

Уровень 3

Конфигурация уровня 3 не поддерживается. Такие конфигурации находятся далеко за пределами инфраструктуры тестирования Homebrew и могут работать ненадежно, даже если базовая установка возможна.

Как правило, применяются следующие условия:

• Homebrew может работать, но качество и стабильность оставляют желать лучшего
• Настоятельно рекомендуется перейти на конфигурацию уровня 1 или 2 либо на инструмент, отличный от Homebrew
• Запросы на включение изменений должны соответствовать очень высоким требованиям: они должны устранять проблему, а не просто обходить ее, и не должны создавать значительных постоянных затрат на сопровождение (например, необходимые исправления уже должны быть включены в вышестоящий проект)
• Сопровождающие Homebrew не обязуются исправлять ошибки, затрагивающие эти системы
• Функциональность может намеренно ухудшаться, если это принесет пользу поддерживаемым конфигурациям
• Во время работы будут выводиться заметные предупреждения о конфигурации
• Охват CI отсутствует; бинарные пакеты будут собираться или публиковаться редко
• Проблемы, затрагивающие только эти конфигурации, могут быть закрыты без ответа
• Поддержка ограничивается ответами сообщества в обсуждениях Homebrew

К конфигурациям уровня 3 относятся:

• Версии macOS, которые больше не охватываются CI и для которых Apple больше не выпускает регулярные обновления безопасности
• Системы, собирающие официальные пакеты из исходного кода, несмотря на наличие бинарных пакетов
• Homebrew, установленный вне префикса по умолчанию (например, /opt/homebrew, /usr/local или /home/linuxbrew/.linuxbrew, используемые с несовместимыми архитектурами)
• Установки Homebrew, управляемые Nix (например, nix-darwin или nix-homebrew)
• Установка формул с помощью --HEAD
• Установка устаревших или отключенных формул
• Компьютеры Mac с OpenCore Legacy Patcher и процессором Intel старше Westmere

Не поддерживается

Конфигурация не поддерживается, если:

• Homebrew не запускается без сторонних исправлений или изменений
• Требуется перейти на другой инструмент (например, MacPorts, Tigerbrew или встроенный менеджер пакетов Linux)

К неподдерживаемым конфигурациям относятся:

• FreeBSD
• macOS Mojave 10.14 и более ранние версии
• Многопользовательские среды Homebrew, в которых несколько пользователей используют одну и ту же установку
• Кластеры Beowulf
• Nokia 3210
• Процессоры, собранные внутри Minecraft
• Тостеры

Неподдерживаемое программное обеспечение

Пакеты, установленные из сторонних tap-репозиториев, не входящих в организацию Homebrew на GitHub, по умолчанию не поддерживаются.

Homebrew может помочь сторонним сопровождающим устранить проблемы, связанные с самой системой формул, cask-пакетов или tap-репозиториев, но не поддерживает поведение или работу стороннего программного обеспечения.

Проблемы, возникающие только при использовании сторонних формул или cask-пакетов, могут быть закрыты без расследования.

Если вы используете оболочку Homebrew, обращайтесь за поддержкой и сообщайте о проблемах ее разработчикам, а не Homebrew, если только та же проблема не воспроизводится при прямом запуске Homebrew.

Будущая поддержка macOS

Apple объявила, что macOS Tahoe 26 станет последней версией macOS с поддержкой оборудования Intel x86_64. В связи с этим Homebrew планирует прекратить поддержку macOS на Intel в одном из будущих выпусков после этого момента.

Ниже приведен предполагаемый график уровней поддержки, основанный на цикле выпусков Apple и охвате CI Homebrew.

• По состоянию на ноябрь 2025 года:

  Apple Silicon:

  • Уровень 1: macOS Tahoe 26, Sequoia 15, Sonoma 14
  • Уровень 3: macOS Big Sur 11 — Ventura 13

  Intel x86_64:

  • Уровень 1: macOS Tahoe 26, Sequoia 15, Sonoma 14
  • Уровень 3: macOS Catalina 10.15 — Ventura 13
  • Не поддерживается: macOS Mojave 10.14 и более ранние версии

• Ожидается в сентябре 2026 года или позже:

  Apple Silicon:

  • Уровень 1: macOS 27, Tahoe 26, Sequoia 15
  • Уровень 3: macOS Big Sur 11 — Sonoma 14

  Intel x86_64:

  • Уровень 3: macOS Big Sur 11 — Tahoe 26
  • Не поддерживается: macOS Catalina 10.15 и более ранние версии

• Ожидается в сентябре 2027 года или позже:

  Apple Silicon:

  • Уровень 1: macOS 28, 27, Tahoe 26
  • Уровень 3: macOS Monterey 12 — Sequoia 15
  • Не поддерживается: macOS Big Sur 11

  Intel x86_64:

  • Не поддерживаются: все версии macOS

Rosetta 2

Apple также объявила, что Rosetta 2 останется доступной в качестве универсального инструмента совместимости до macOS 27; после этого планируется поддерживать лишь более узкий набор приложений, ориентированных на старые игры.

Это не меняет уровень поддержки в остальном поддерживаемого компьютера Mac с Apple Silicon, но сокращает ожидаемый срок поддержки cask-пакетов только для x86_64, использующих requires_rosetta. Ожидаемые сроки приема, устаревания и удаления таких cask-пакетов см. в разделе Допустимые cask-пакеты.