24. AutomakeのAPIのバージョン管理

URL="https://bookshelf.jp/cgi-bin/goto.cgi?file=automake-ja&node=API+versioning"
"automake-ja/AutomakeのAPIのバージョン管理"へのコメント(無し)

通常，新しいAutomakeのリリースにはバグの修正と新しい機能が含まれています．残念ながら，それらは新しいバグと非互換性ももたらす可能性があります．このことは，パッケージがAutomakeの特定のバージョンを要求する可能性となる四つの理由になります．

大きなツリーのパッケージを管理するとき，それぞれが異なるバージョンの Automakeを要求することが問題になります．過去には，開発者(と時にはユーザが)異なるバージョンのAutomakeを異なる場所にインストールし，それぞれのパッケージに対して適切な`$PATH'に切替える必要があったという意味です．

バージョン1.6で開始していますが，Automakeはバージョン管理されたバイナリをインストールします．これは同じ`$prefix'で複数のバージョンの Automakeをインストールすることが可能で，`$PATH'で誤魔化すこと無く `automake-1.6'や`automake-1.7'を実行することで任意のバージョンのAutomakeを選択することが可能だということを意味します．さらに， Automake 1.6で生成された`Makefile'は，リビルドのルールで明示的に `automake-1.6'を使用します．

`automake-1.6'の`1.6'は，Automakeのバージョンではなく AutomakeのAPIのバージョンです．バグの修正版が作成された場合，例えば Automake 1.6.1になりますが，APIのバージョンは1.6のままです．これは， Automake 1.6で動作するパッケージは1.6.1でも動作することを意味します．結局，これは人々がバグの修正版に期待するものになります．

パッケージがリリースで導入された機能やバグの修正に依存している場合，古いリリースを使用しないことを確実にするため，Automakeへのオプションとしてこのバージョンを渡すことが可能です．例えば，`configure.ac'で以下の内容を使用してください．

  AM_INIT_AUTOMAKE(1.6.1)    dnl Require Automake 1.6.1 or better.

または特定の`Makefile.am'で以下の内容を使用してください．

  AUTOMAKE_OPTIONS = 1.6.1   # Require Automake 1.6.1 or better.

Automakeのバージョンが要求されたバージョンより古い場合，Automakeはエラーメッセージを出力します．

APIの中身

URL="https://bookshelf.jp/cgi-bin/goto.cgi?file=automake-ja&node=API%A4%CE%C3%E6%BF%C8"
"automake-ja/APIの中身"へのコメント(無し)

Automakeのプログラミングインターフェースは簡単に定義できません．基本的に，全てのドキュメント化されている変数と`Makefile.am'の著者が利用可能なターゲットを少なくとも含めるべきで，動作はそれらに関連していて(例えば，`-hook'が実行される場所)，`automake'と `aclocal'のコマンドラインインターフェースがあって，...

APIには無いもの

URL="https://bookshelf.jp/cgi-bin/goto.cgi?file=automake-ja&node=API%A4%CB%A4%CF%CC%B5%A4%A4%A4%E2%A4%CE"
"automake-ja/APIには無いもの"へのコメント(無し)

ドキュメント化されていない変数，ターゲット，またはコマンドラインオプションは全て，APIの一部ではありません．バージョンが変われば(バグの修正に役立つ場合は，バグの修正版でも) 変更されるかもしれないので，それらを使用することは避けるべきです．

そのようなドキュメント化されていない機能を使用する必要があると判明した場合，でコンタクトを取り，ドキュメントを書きテストスイートで試してみてください．

[ << ]

[ >> ]

[表紙]

[目次]

[索引]

[検索] [上端 / 下端] [?]