RubyGems

RubyGems 是 Ruby 的包管理框架。

一个包（也称为库）包含一组可由 Ruby 程序调用的功能，例如读取和解析 XML 文件。我们将这些包称为“gems”，而 RubyGems 是一个用于在 Ruby 环境中安装、创建、管理和加载这些包的工具。

RubyGems 也是 RubyGems.org 的客户端，这是一个公共的 Gems 仓库，允许你发布可供其他开发者共享和使用的 Gem。请参阅我们在 guides.rubygems.org 上关于发布 Gem 的指南。

入门

安装和管理 Gem 是通过 gem 命令完成的。要安装像 Faraday 这样的 Gem：

gem install faraday

RubyGems 将从 RubyGems.org 下载 Faraday Gem 并将其安装到你的 Ruby 环境中。

最后，在你的 Ruby 程序中，加载 Faraday gem 并开始动手：

require 'faraday'
response = Faraday.get('https://rubygems.org')
# do something with `response`...

有关如何使用 RubyGems 的更多信息，请参阅我们位于 guides.rubygems.org 的 RubyGems 基础指南

要求

RubyGems 支持 Ruby 3.0 或更高版本。

安装

RubyGems 已安装在您的 Ruby 环境中，您可以在终端模拟器中运行 gem --version 来检查已安装的版本。

在某些情况下，Ruby 和 RubyGems 可能作为操作系统包提供。这不是使用 Ruby 和 RubyGems 的推荐方式。最好使用 Ruby 版本管理器，例如 rbenv 或 chruby。如果您仍希望使用操作系统包管理器提供的版本，请也使用您的操作系统包管理器来升级 rubygems，并忽略下面给出的其他安装说明。

如果您想手动安装 RubyGems：

从 https://rubygems.org/pages/download 下载，解包，并 cd 到 RubyGems 的 src
或者克隆此仓库并 cd 到该仓库

通过运行以下命令安装 RubyGems：

$ ruby setup.rb

有关更多详细信息和其他选项，请参阅：

$ ruby setup.rb --help

升级 RubyGems

要升级到最新版本的 RubyGems，请运行：

$ gem update --system

有关更多详细信息和替代说明，请参阅 UPGRADING。

发布策略

RubyGems 和 Bundler 同步发布，尽管它们不共享主版本号。计划在未来也将它们的主版本号同步。

发布策略与 Ruby 本身的发布策略有些相似：

频繁的补丁版本发布（每 2-4 周一次），包括错误修复、次要增强、小型功能，甚至被声明为实验性以供实战测试的中型功能。
年度次要版本发布，包含较大的功能，以及次要的破坏性变更（仅影响边缘情况和极少数用户）。
偶尔的主要版本发布（取代年度次要版本），包含主要的破坏性变更。

文档

RubyGems 使用 rdoc 进行文档编写。编译后的文档集合可以在 docs.ruby-lang.org 在线查看。

RubyGems 还提供了一套全面的指南，涵盖众多主题，例如创建新 gem、安全实践以及其他资源，位于 https://guides.rubygems.org

获取帮助

提交工单

发现了一个 bug 但不确定？你确定有一个 bug，但不知道接下来该怎么做？无论如何，请告诉我们！让 RubyGems 团队了解你遇到的 bug 或问题的最佳地点是 GitHub 上的 RubyGems issues 页面。

Bundler 兼容性

请参阅 https://bundler.io/compatibility 了解已知问题。

支持

RubyGems 是一个社区项目。请考虑赞助个人贡献者以表彰他们出色的 OSS 工作。

此外，Ruby Central 管理着用于改进 ruby/rubygems 的资助项目，并运营 RubyGems.org（该服务）。你可以通过参加或赞助 RubyConf，或加入成为支持成员来支持 Ruby Central。

贡献

如果您想为 RubyGems 做出贡献，那太棒了，我们 <3 您。请查阅我们的贡献指南以获取更多信息。

行为准则

所有在 RubyGems 项目的代码库、问题跟踪器、聊天室和邮件列表中互动的人员，都期望遵守贡献者行为准则。