【Ruby3.x】Gem::Specification::files()メソッドの使い方

filesメソッドは、RubyGemsの仕様を定義するGem::Specificationクラスに属し、そのGemに含めるべきファイルの一覧を取得または設定するメソッドです。RubyのプロジェクトをGemとして配布する際、どのファイルがGemパッケージに含まれるべきかを明確に指定する必要があります。このメソッドは、そのGemを構成するすべてのファイル（例えば、ソースコード、RDocドキュメント、実行ファイル、テストファイルなど）のパスを文字列の配列として扱います。

具体的には、filesメソッドは、Gemがビルドされる際に実際にGemファイル（.gemファイル）に同梱されるファイルのパスのリストを返します。開発者はGem::Specificationオブジェクトを作成する際に、このfilesプロパティに含めたいファイルのパスを相対パスの配列として設定します。これにより、Gemをインストールするユーザーは、開発者が意図したすべての関連ファイルを受け取ることができます。

この情報は、Gemが正しく動作し、ドキュメントが閲覧可能であり、関連するツールが利用可能であるために不可欠です。例えば、ユーザーがGemをインストールした際に、必要なライブラリファイルがなければGemは機能しませんし、テストファイルが欠けていれば開発者はGemの品質を確認できません。filesメソッドは、このような重要なファイルの包含情報を管理するための中心的な役割を担っています。これにより、Gemのパッケージングと配布が正確に行われ、ユーザーが期待通りのGemを利用できるようになります。

Copy
1spec = Gem::Specification.new
2spec.files = ["lib/my_gem.rb", "README.md"]

引数なし

引数はありません

Array<String>

このメソッドは、Gemの仕様に含まれるファイルパスを文字列の配列として返します。