Gems 简介 #

┌─────────────────────────────────────────────────────────────┐
│                       RubyGems                               │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  包管理      │  │  依赖解析    │  │  版本控制    │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  包发布      │  │  本地缓存    │  │  可执行文件  │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
└─────────────────────────────────────────────────────────────┘

2003年 ─── RubyGems 项目启动
    │
    │      Chad Fowler, Rich Kilmer, Jim Weirich 等人创建
    │      解决 Ruby 缺乏标准包管理器的问题
    │
2004年 ─── RubyGems 0.1 发布
    │
    │      基本的包安装和管理功能
    │      RubyGems.org 前身上线
    │
2007年 ─── Ruby 1.9 集成
    │
    │      RubyGems 成为 Ruby 标准库的一部分
    │      无需单独安装
    │
2010年 ─── Bundler 发布
    │
    │      解决项目级依赖管理问题
    │      引入 Gemfile 和 Gemfile.lock
    │
2013年 ─── RubyGems 2.0
    │
    │      改进的依赖解析算法
    │      更好的性能
    │
至今   ─── 生态系统核心
    │
    │      超过 18 万个包
    │      累计下载超过 1000 亿次

# 手动下载和管理库
wget https://example.com/library.tar.gz
tar -xzf library.tar.gz
cd library
ruby install.rb

# 版本冲突
# 项目A需要 library 1.0
# 项目B需要 library 2.0
# 无法同时安装

# 依赖地狱
# library A 依赖 B、C
# B 依赖 D、E
# 手动管理极其困难

# 一条命令安装包
gem install rails

# 自动处理依赖
gem install sinatra
# 自动安装 tilt, rack, etc.

# 项目级依赖隔离
bundle install
# 每个项目独立的依赖

# 版本管理
gem 'rails', '~> 7.0'
# 灵活的版本约束

# 无需单独安装
ruby -v
# ruby 3.2.0 (2022-12-25 revision a528908271)

gem -v
# 3.4.0

gem install rails      # 安装
gem update rails       # 更新
gem uninstall rails    # 卸载
gem list               # 列出已安装
gem search rails       # 搜索

# Gemfile
source 'https://rubygems.org'

gem 'rails', '~> 7.0'
gem 'pg', '~> 1.4'

group :development do
  gem 'pry'
end

# 内置安全检查
gem install rails --verify

# 校验签名
gem install mygem -P HighSecurity

# 检查已知漏洞
bundle audit

my_gem-1.0.0.gem
├── lib/              # Ruby 代码
│   └── my_gem.rb
├── bin/              # 可执行文件
│   └── my_gem
├── spec/             # 测试
├── README.md         # 说明文档
├── LICENSE           # 许可证
└── my_gem.gemspec    # 规范文件

# my_gem.gemspec
Gem::Specification.new do |spec|
  spec.name          = "my_gem"
  spec.version       = "1.0.0"
  spec.authors       = ["Developer"]
  spec.summary       = "A sample gem"
  spec.description   = "A longer description"
  spec.homepage      = "https://example.com"
  spec.license       = "MIT"
  
  spec.files         = Dir["lib/**/*"]
  spec.require_paths = ["lib"]
  
  spec.add_dependency "rails", "~> 7.0"
  spec.add_development_dependency "rspec", "~> 3.0"
end

# Gemfile
source 'https://rubygems.org'

ruby '3.2.0'

gem 'rails', '~> 7.0'
gem 'pg', '~> 1.4'

group :development, :test do
  gem 'pry'
  gem 'rspec'
end

group :production do
  gem 'puma'
end

GEM
  remote: https://rubygems.org/
  specs:
    actionpack (7.0.4)
      actionview (= 7.0.4)
      activesupport (= 7.0.4)
    rails (7.0.4)
      actionpack (= 7.0.4)

PLATFORMS
  ruby

DEPENDENCIES
  rails (~> 7.0)

BUNDLED WITH
   2.4.0

my_gem/
├── lib/
│   ├── my_gem.rb          # 主入口文件
│   └── my_gem/
│       ├── version.rb     # 版本信息
│       └── helper.rb      # 其他模块
├── bin/
│   └── my_gem             # 可执行脚本
├── spec/                   # 测试文件
│   ├── spec_helper.rb
│   └── my_gem_spec.rb
├── README.md               # 说明文档
├── LICENSE                 # 许可证
├── CHANGELOG.md            # 变更日志
└── my_gem.gemspec          # Gem 规范

# 查看 Gem 安装路径
gem environment gemdir
# /usr/local/lib/ruby/gems/3.2.0

# 目录结构
gems/
├── rails-7.0.4/
│   ├── lib/
│   ├── bin/
│   └── README.md
├── bundler-2.4.0/
└── specifications/
    ├── rails-7.0.4.gemspec
    └── bundler-2.4.0.gemspec

# 最简单的 gemspec
Gem::Specification.new do |spec|
  spec.name    = "my_gem"
  spec.version = "1.0.0"
  spec.files   = Dir["lib/**/*"]
  # 其他字段有默认值
end

# 创建 Gem 骨架
bundle gem my_gem
cd my_gem

# 安装依赖
bundle install

# 运行测试
bundle exec rake spec

# 一条命令发布
gem build my_gem.gemspec
gem push my_gem-1.0.0.gem

# 或者使用 Rake
rake release

# 使用 Bundler 隔离依赖
bundle install --path vendor/bundle

# 使用 rbenv/rvm 管理多版本 Ruby
rbenv install 3.2.0

# 预编译原生扩展
gem install nokogiri --platform ruby