Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 По историческим причинам, утилитаgemне умеет управлять зависимостями конкретного проекта. С ее помощью нельзя легко указать зависимости, поставить их одной командой и разделить на основные зависимости и зависимости для разработки. Поэтому ее, в основном, используют для установки гемов, которые нужны в системе глобально, например линтера.

2 Для полноценного управления зависимостями используется гем<a>bundler</a>, который включен в RubyGems и поставляется с ним по умолчанию. В этом уроке, мы научимся подключать его к проекту и разберемся с некоторыми особенностями работы.

3 <h2>Установка зависимостей</h2>

4 Работа с Bundler начинается с создания файла<a>Gemfile</a>в котором указываются зависимости. Сам файл использует Ruby-код для своего описания:

5 Когда в файл добавлены зависимости, нужно выполнить их установку:

6 Во время установкиbundlerсоздаст файлGemfile.lock, в котором фиксируются версии всех зависимостей включая транзитивные. Любой последующий запуск командыinstallбудет ориентироваться на версии указанные в этом файле. Самlock-файл должен храниться в git-репозитории.

7 Благодаряlock-файлу, в Ruby не принято указывать версии гемов вGemfile, они и так зафиксированы. Технически указать версии можно и иногда это бывает важно, когда, по какой-то причине нужно зафиксировать версию:

8 Для обновления зависимостей используется команда bundle update:

9 Добавляют гемы прямым прописыванием в файлеGemfile. В Bundler есть команда добавления гема, но она мало полезна из-за того, как Bundler работает с разделением сред.

10 <h2>Группировка гемов</h2>

11 В Bundler нет предустановленного разделения на продакшен- и девелопмент-зависимости, как, например, в JavaScript. Единственное, что он предоставляет, это механизм группировки гемов.

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

13 По умолчанию команда bundle install устанавливает все гемы, включая те что указаны внутри групп. Чтобы установить только конкретную группу, ее можно указать явно:

14 Гемы указанные вне групп будут установлены в любом случае, так как, по смыслу, они нужны всем.

15 Сами гемы устанавливаются в стандартные пути RubyGems, а не локально в проект. Это позволяет экономить место если проектов на Ruby много, но не подходит в том случае, если мы работаем, например, в Docker. Поэтому путь для установки гемов<a>иногда меняют</a>наvendor/bundle.

16 Эта команда создаст файл.bundle/config, в котором будет указан путь установки. Bundler использует эту конфигурацию во время своей работы.

17 <h2>Интеграция в проект</h2>

18 Bundler появился намного позже чем RubyGems, поэтому он не включается автоматически. Для подключения Bundler, во входном файле нужно добавить сверху такой код:

19 В этом случае в пути загрузки добавятся все гемы из всех групп. Если нужно указать конкретные группы, то код меняется на такой:

20 Когда гемов становится много, то постоянные включения зависимостей начинают сильно разрастаться. Bundler может взять эту работу на себя и включить все нужные зависимости сразу во время настройки:

21 В целом, прямая работа с подключением Bundler нужна редко. В прикладных проектах типа Rails, весь процесс инициализации скрыт от программиста. А для библиотек используется автоматическая генерация кода.