В экосистеме Ruby основным менеджером библиотек является RubyGems. Он играет ту же роль, что и npm в Node.js или pip в Python, и используется как для установки библиотек (называемых в Ruby "гемами" — gems), так и для управления ими. Дополнительно, для управления зависимостями в проектах используется инструмент Bundler, который работает поверх RubyGems и обеспечивает точную фиксацию версий.

📦 1. RubyGems — менеджер библиотек по умолчанию

RubyGems поставляется вместе с интерпретатором Ruby и позволяет:

• искать гемы (gem search)

• устанавливать (gem install)

• удалять (gem uninstall)

• обновлять (gem update)

• управлять списком установленных гемов (gem list)

• просматривать информацию о гемах (gem info)

Примеры:

gem install rails
gem list
gem uninstall sinatra
gem update bundler

Каждый гем устанавливается в системный или пользовательский каталог и становится доступным для использования через require.

📁 2. Структура гемов и где они хранятся

После установки гемов они попадают в директорию, зависящую от версии Ruby и ОС. Например:

~/.rbenv/versions/3.2.2/lib/ruby/gems/3.2.0/gems/

Гем состоит из:

• исходного кода Ruby (*.rb)

• файла gemspec с метаданными

• зависимостей

• опциональных расширений (C/C++)

📚 3. Bundler — контроль версий и управление зависимостями

Bundler — официальный инструмент для управления зависимостями проекта. Он позволяет:

• указать библиотеки, нужные проекту

• зафиксировать их точные версии

• гарантировать, что среда разработки и продакшен будут использовать одинаковые версии

Установка:

gem install bundler

Создание файла зависимостей:

Создаётся Gemfile в корне проекта:

source 'https://rubygems.org'
gem 'rails', '~> 7.0'
gem 'pg'
gem 'puma'

Установка зависимостей:

bundle install

Установка новой библиотеки:

bundle add devise

Этот вызов автоматически обновит Gemfile и Gemfile.lock.

📌 4. Gemfile и Gemfile.lock — управление версиями

• Gemfile — декларативный список библиотек и их версий (можно задавать гибкие диапазоны).

• Gemfile.lock — фактический список версий, используемых в проекте после выполнения bundle install.

Пример записи в Gemfile:

gem 'rails', '~> 7.0.4'

Значение '~> 7.0.4' означает, что будут использоваться версии >= 7.0.4 и < 7.1.0.

Gemfile.lock содержит уже точные версии, включая все вложенные зависимости. Его нельзя редактировать вручную, но обязательно нужно добавлять в систему контроля версий (например, git) для стабильных сборок.

⚙️ 5. Команды Bundler и контроль зависимостей

📦 6. Глобальные и локальные гемы

• Глобальная установка (gem install) — доступна во всех проектах, но не управляется версионно.

• Локальная установка через Bundler — зависит от конкретного проекта. Надёжный способ для production.

🧩 7. Использование версий Ruby (RVM, rbenv)

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

• rbenv
• RVM

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

🧪 8. Гемы из других источников

Можно добавлять гемы из нестандартных источников:

gem 'mygem', git: 'https://github.com/user/mygem.git'
gem 'mygem', path: '../local_gem_folder'

Также можно указывать определённую ветку, commit или tag:

gem 'mygem', git: 'https://github.com/user/mygem.git', branch: 'develop'

💡 9. Проверка конфликтов и изоляция окружений

• Bundler проверяет возможные конфликты версий между зависимостями и предупреждает при невозможности их разрешить.

• bundle exec изолирует запуск команд с точными версиями библиотек, определёнными в Gemfile.lock.

📄 10. Пример полного рабочего Gemfile

source 'https://rubygems.org'
ruby '3.2.2'
gem 'rails', '~> 7.0.4'
gem 'pg', '~> 1.5'
gem 'puma'
gem 'devise'
gem 'sidekiq'
gem 'redis'
gem 'httparty'
group :development do
gem 'pry'
gem 'rubocop', require: false
end
group :test do
gem 'rspec-rails'
end

При запуске bundle install будет создан файл Gemfile.lock, содержащий полное древо зависимостей с зафиксированными версиями.

📌 Итого (без вывода)

Для управления библиотеками в Ruby используется RubyGems как базовый инструмент и Bundler как инструмент управления зависимостями на уровне проекта. Они позволяют гибко подключать, фиксировать и обновлять библиотеки, обеспечивая стабильность среды и воспроизводимость сборок.