セマンティックバージョニングのAPIの変更とはメソッド名の変更も含まれますか？

Question

セマンティック バージョニング 2.0.0にAPIの変更に互換性のない場合はメジャーバージョンを上げると書いてあります。これは既存のメソッド名を変更した場合も含まれるのでしょうか？

Answer 1

APIのメソッドの名前が変更された場合も互換性がなくなるので、メジャーバージョンアップです。

そのAPIのメソッドを利用しているユーザーにとって、メソッドの名前変更されるとどうなりますか？APIの名前変更に追従しなければ当該のAPIを呼び出すことができません。コンパイルが必要な言語ではコンパイルエラーになります。そうならないようにすることが「互換性」です。

Comments

[mitsuru793]

いつもご回答、ありがとうざいます。大変助かっております。
やはりメソッドもAPIの一部なのですね。APIというとJSONなどを返すURLのイメージが強いです。

> コンパイルが必要な言語ではコンパイルエラーになります。
スクリプトの場合は、変更箇所のメソッドを使用しない場合はエラーになりませんね。勉強になりました。

Answer 2

公開しているライブラリのような場合、（よほどの理由がなければ）メソッド名の変更をする際も旧名はdeprecated（非推奨）にして残しつつ、次のメジャーバージョンアップなどで完全移行する、というのが一般的です。

Comments

[mitsuru793]

なるほど。deprecatedにしたものは次のメジャーバージョンアップで削除する予定を示す使い方もあるのですね。とても参考になりました。