ライブラリー

どのようなものか

ライブラリーは、プログラムが、自分で書く代わりに使う、既製の処理を集
めたものです。誰かが、日付の解析、ファイルの圧縮、QRコードの描画など
の問題を一度解き、どのプログラムも使える、名前付きの呼び出し口を用意
して公開します。英語の複数形はlibrariesです。LinuxのCライブラリー
は、lib-という接頭辞を持つことが多く、Windowsは、共有する種類をDLLと
呼びます。Rustではcrateといい、Rust
Bookは、ライブラリーという言葉と置き換えて使うと説明します。大半の言
語には、何も加えず、どのインストールにもあるモジュールをまとめた、標
準ライブラリーも付属します。

ライブラリーは、再利用できるコードの一種です。近い概念と比べると分か
りやすくなります。アプリケーションは、自分で動き、利用者を持ちます。
ライブラリーには、そのどちらもなく、呼ぶプログラムの中だけで動きま
す。より近い比較対象は、フレームワークです。ライブラリーなら、利用側
のコードが処理を主導し、必要なときに呼びます。フレームワークなら、処
理の主導権はフレームワークにあり、それが定めた箇所で、利用側のコード
が呼ばれます。最後に、パッケージは、名前、版、必要とするものの一覧を
持つ、ライブラリーの配布用の箱です。ライブラリーは、その中のコードで
す。

ライブラリーを使えるものにするのは、そのインターフェースです。維持す
ると約束した関数、型、定数を指します。Semantic
Versioningの規則全体は、この約束を土台にしています。従うプロジェクト
は、公開APIを宣言しなければならず、そのAPIに互換性のない変更をするた
び、メジャーバージョンを上げます。

Program Library
HOWTOは、プログラムに加わる時点で、Linuxのライブラリーを分けます。静
的ライブラリーは、ビルド時に実行ファイルへコピーされます。共有ライブ
ラリーは、プログラムの起動時に読み込まれ、必要なすべてのプログラムが
使うため、各プログラムを再ビルドせずに更新できます。動的に読み込むラ
イブラリーは、プログラムの実行中に開かれ、プラグインは、通常、この方
式で動きます。

なぜ重要なのか

プロジェクトでライブラリーの利用を検討するたびに、選択肢は三つありま
す。既存のものを使うか、プロジェクト内でコードを書くか、小さく目的を
絞った部分をリポジトリーへコピーし、その後は自分で責任を持つかです。
最後を、コードの取り込み（vendoring）と呼びます。

通常は、既存のライブラリーを使うのが正解です。作成者は、境界事例に出
会っており、ほかの利用者も、不具合を報告しています。代償は後から来る
ため、見落としやすいものです。ライブラリー自身の依存も加わり、そのセ
キュリティー情報は自分の問題となり、リリース予定に更新の速さを合わ
せ、ライセンスも自分の製品に入ります。保守担当者が放棄したライブラ
リーも、誰かが置き換えるまで、ビルドに残ります。

独自に書けば、制御できますが、ライブラリーが省いてくれたはずの、境界
事例、テスト、保守を、期限なく引き受けます。問題の範囲が狭く、中核で
ある場合、既存のライブラリーが必要以上に大きい場合、依存数を少なくす
る理由がある場合に、正しい選択です。

リンク方法も重要です。静的ライブラリーを使って作ったプログラムは、固
定のコピーを持つため、ライブラリーのセキュリティー修正を届けるには、
プログラムを再ビルドして、再配布しなければなりません。共有ライブラ
リーは、システム全体で一度修正できますが、プログラムは、システムが渡
す版を信頼します。ライセンスでは、この違いは消えます。GNUのライセン
スFAQは、GPLの対象となる著作物を、静的でも動的でも、ほかのモジュール
とリンクすると、一体の著作物になり、GPLの条件が、その全体に及ぶと述
べます。

ソフトウェアを発注する人が確かめるのは、成果物が、どのライブラリー
に、どのライセンスで依存し、供給者が持ち込むライブラリーを誰が所有す
るかです。

実際の活用例

ある文書生成器には、各文書のオンライン版へ案内するQRコードが必要でし
た。既存のQRライブラリーなら、どれでも足りましたが、公開から長い時間
が経っても、問題なくインストールできるよう、実行時の依存を、テンプ
レートエンジンとPDFレンダラーの、二つに絞っていました。解決策は、522
行のQRエンコーダーを、リポジトリーに取り込むことでした。バイトモード
の符号化、GF(256)上のReed-Solomon誤り訂正、位置検出、タイミング、位
置合わせの各パターン、形式と版の情報、四つのペナルティー規則で採点す
る、八つすべてのマスクパターンを実装しました。別に書いたデコーダー
が、毎回、生成したすべてのコードを読み戻し、復号結果が入力と一致する
ことを確認します。ページは、主張を慎重に区切ります。対応するのは、そ
の文書が使うモードと版だけです。理由も、成熟したライブラリーに勝つと
いう考えでなく、依存数の上限です。

macOSのネイティブクライアントは、Cインターフェースを通して、中核のラ
イブラリーを呼びます。初期は、そのインターフェースを、手書きのヘッ
ダーで表していました。その後、中核から外れた三つの関数への呼び出し
は、コンパイルもリンクも通り、実行時に異常終了しました。コンパイラー
とリンカーは、手書きの代用品しか見ておらず、中核の実際の宣言を、一度
も見ていなかったためです。修正は、すべての呼び出し箇所を検証するパー
サーです。実際の7,308行のヘッダーと、その268の宣言を照合し、宣言のな
い呼び出しや列挙定数が、一つでもあれば、ビルドを失敗させます。調べる
のは宣言なので、シグネチャーを保ったまま、意味を変えた関数は、通りま
す。

各案件の契約条件は、所有者を定めます。顧客のために書いたコードは、全
額の支払い後、顧客に属します。会社が以前に書いたか、自社のために書い
た、ライブラリーや汎用ツールは例外です。所有権は会社に残り、顧客に
は、納品物の中で使うための、期限がなく、取り消せないライセンスを与え
ます。第三者のオープンソースコードは、作成者が選んだライセンスに従
い、成果物に入った部品を、顧客へ知らせます。

問題が起きるところ

通常の更新で、ビルドが壊れます

依存が2.3から2.4へ変わり、昨日コンパイルできたコードが失敗するか、違
う動きをします。メジャーバージョンを上げずに公開インターフェースを変
えたか、内部関数や文書化されていない動作など、約束していなかったもの
に、プロジェクトが依存したためです。ロックファイルで版を厳密に固定
し、変更履歴を見ながら、意図して更新します。公開APIとして文書化され
たものだけを呼びます。

ライブラリーの説明だけを、プログラムが信じます

ビルドに成功したプログラムが、最初に機能を使ったときに、異常終了しま
す。手書きのヘッダー、型スタブ、バインディングを使ってコンパイルしま
したが、それらが、実際にリンクしたライブラリーとずれていました。ライ
ブラリー自身の公開インターフェースからバインディングを生成するか、ビ
ルド時に、すべての呼び出しを照合します。不一致があれば、利用者が使う
前の、その段階でビルドを失敗させます。

小さな機能が、大きな依存ツリーを連れてきます

一つの関数が必要だっただけなのに、提供するライブラリーには、何十もの
依存が付いてきました。それぞれに、セキュリティー情報、ライセンス、更
新があります。加える前に、ライブラリー自身の大きさだけでなく、何を引
き込むかを調べます。必要な範囲が狭く、明確なら、自身のテストを備え
た、小さな取り込み済みコードの方が、自前で管理する負担を小さくできる
場合があります。

コードとともに、ライセンスが入ります

プロジェクトの終わりに近づいて、ソースコードを公開していない製品に含
むライブラリーの条件が、一体になった著作物全体へ及ぶと、誰かが気付き
ます。追加時に誰もライセンスを確認せず、動的にリンクしても、何も変わ
りませんでした。追加する時点で、すべてのライブラリーのライセンスを確
認し、公開する版とともに一覧を残し、供給者にも、その一覧を求めます。

参考資料

  * Program Library HOWTO：導入 —
Linuxのプログラムライブラリーとは何か、静的、共有、動的読み込みの違
いです。

  * The Rust Programming Language：パッケージとcrate —
ライブラリーcrateとバイナリーcrate、パッケージが、それらを保持する仕
組みです。

  * Semantic Versioning 2.0.0 — ライブラリーの公開APIを、約束にす
る、版番号の規則です。

  * Python標準ライブラリー — 標準ライブラリーの全体像です。どの
Pythonのインストールにも付属する、すべてを示します。

  * GNUライセンスFAQ — 対象ライブラリーを、静的または動的にリンクす
るプログラムにとって、GPLが意味することです。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/library/	engineer.company	70
