Skip to content

Kotlinの進化の原則 ​

実践的な進化の原則 ​

言語の設計は石に刻まれている。

しかし、この石は適度に柔らかい。

そして少しの努力を払えば、後から形を変えることができる。

Kotlinデザインチーム

Kotlinは、プログラマーにとっての実践的なツールとなるよう設計されています。言語の進化に関して言えば、その実践的な性質は以下の原則に集約されます。

  • 時代に合わせて言語をモダンに保ち続ける。
  • ユーザーとの継続的なフィードバックループを維持する。
  • 新しいバージョンへのアップデートをユーザーにとって容易かつ快適なものにする。

これらはKotlinがどのように前進していくかを理解する上で鍵となるため、これらの原則について詳しく見ていきましょう。

言語をモダンに保つ(Keeping the Language Modern)。システムは時間の経過とともにレガシー(過去の遺産)を蓄積していくことを私たちは認識しています。かつては最先端の技術であったものが、現在では絶望的なまでに時代遅れになってしまうことがあります。ユーザーのニーズに応え続け、その期待に沿い続けるためには、言語を進化させなければなりません。これには、新機能を追加することだけでなく、本番環境での使用が推奨されなくなりレガシーとなった古い機能を段階的に廃止していくことも含まれます。

快適なアップデート(Comfortable Updates)。言語から機能を削除するなどの非互換な変更は、適切な配慮なしに行われると、あるバージョンから次のバージョンへの移行で大きな痛みを伴う可能性があります。私たちは常にこのような変更を十分前もって告知し、非推奨(deprecated)のマークを付け、_変更が行われる前に_自動移行ツールを提供します。言語に変更が適用される頃には、世界中のほとんどのコードがすでにアップデートされ、新しいバージョンへの移行に何の問題もない状態になっていることを目指しています。

フィードバックループ(Feedback Loop)。非推奨化のサイクルを進めるには多大な労力が必要となるため、将来的に行う非互換な変更の数は最小限に抑えたいと考えています。私たち自身の最善の判断に頼るだけでなく、実際の現場で試してもらうことこそが設計を検証する最善の方法であると信じています。石に刻み込む前に、それらが実戦でテストされていることを望んでいます。そのため、私たちはあらゆる機会を活用し、設計の初期バージョンを言語の本番リリースで利用できるようにしていますが、それらは_プレ安定版(pre-stable)_ステータスであるExperimental、Alpha、またはBetaのいずれかとして提供されます。これらの機能は安定版ではなく、いつでも変更される可能性があり、それらの機能のオプトインを選択したユーザーは、将来の移行問題に対処する準備ができていることを明示的に示して利用することになります。これらのユーザーから得られる貴重なフィードバックを収集し、設計の改良を重ねて強固なものにしていきます。

非互換な変更 ​

あるバージョンから別のバージョンにアップデートした際に、以前は動作していたコードが動作しなくなった場合、それは言語における_非互換な変更(incompatible change)_(「破壊的変更(breaking change)」と呼ばれることもあります)です。場合によっては「動作しなくなる」が正確には何を意味するかについて議論が生じることもありますが、間違いなく以下が含まれます。

  • 問題なくコンパイルおよび実行できていたコードが、エラー(コンパイル時またはリンク時)で拒否されるようになった場合。 これには、言語構造の削除や新しい制限の追加が含まれます。
  • 通常通り実行されていたコードが、例外をスローするようになった場合。

「グレーゾーン」に属する、あまり自明でないケースとしては、コーナーケースの処理方法の変更、以前とは異なる型の例外のスロー、リフレクションを通じてのみ観測可能な挙動の変更、ドキュメント化されていない挙動や未定義の挙動の変更、バイナリアーティファクトの名前変更などが挙げられます。このような変更は、移行作業に劇的な影響を与える極めて重要なものとなる場合もあれば、取るに足らないものである場合もあります。

非互換な変更には絶対に該当しない例としては、以下のようなものがあります。

  • 新しい警告の追加。
  • 新しい言語構造の有効化、または既存の言語構造の制限緩和。
  • private/internal APIやその他の実装の詳細の変更。

「言語をモダンに保つ」および「快適なアップデート」という原則は、非互換な変更が時には必要であることを示唆していますが、それらは慎重に導入されなければなりません。私たちの目標は、ユーザーが快適にコードを移行できるよう、今後の変更を十分に前もって周知することです。

理想的には、すべての非互換な変更は、問題のあるコードに対して報告されるコンパイル時警告(通常は_非推奨警告(deprecation warning)_と呼ばれます)を通じてアナウンスされ、自動移行支援ツールが付属している必要があります。 したがって、理想的な移行ワークフローは以下のようになります。

  • バージョンA(変更が告知されるバージョン)にアップデートする
    • 今後の変更に関する警告を確認する
    • ツールの支援を受けながらコードを移行する
  • バージョンB(変更が実際に適用されるバージョン)にアップデートする
    • 問題はまったく発生しない

実際には、コンパイル時に正確に検出できず警告を報告できない変更もありますが、少なくともバージョンAのリリースノートを通じて、バージョンBで変更が予定されていることがユーザーに通知されます。

コンパイラのバグへの対処 ​

コンパイラは複雑なソフトウェアであり、開発者の懸命な努力にもかかわらずバグが存在します。コンパイラ自体をクラッシュさせたり、誤ったエラーを報告したり、明らかに不正なコードを生成したりするバグは、迷惑で時に恥ずかしいものではありますが、修正が非互換な変更を構成しないため、簡単に修正できます。一方、失敗しない誤ったコードをコンパイラが生成してしまうバグもあります。例えば、ソースコード内のエラーを見逃したり、単純に誤った命令を生成したりする場合です。このようなバグの修正は、技術的には非互換な変更(以前は問題なくコンパイルできていたコードがコンパイルできなくなる)ですが、不正なコードパターンがユーザーのコードベースに広がるのを防ぐため、できるだけ早く修正する方針をとっています。これにより、問題に遭遇するユーザーの数が減るため、「快適なアップデート」の原則が守られると考えています。もちろん、これはリリース版に登場してから早期に発見されたバグにのみ適用されます。

意思決定 ​

Kotlinの最初の開発元であるJetBrainsは、コミュニティの協力のもと、Kotlin Foundationと連携してKotlinの発展を推進しています。

Kotlinプログラミング言語に対するすべての変更は、リード言語デザイナー(Lead Language Designer)(現在はMichail Zarečenskij)によって監督されています。リードデザイナーは、言語の進化に関するすべての事項において最終的な決定権を持ちます。さらに、完全に安定したコンポーネントに対する非互換な変更は、Kotlin Foundationの下に設置された言語委員会(Language Committee)(現在はJeffrey van Gogh、Werner Dietl、Michail Zarečenskijで構成)によって承認される必要があります。

言語委員会は、どの非互換な変更を行うか、またユーザーのアップデートを可能な限りシームレスにするためにどのような具体的な措置を講じるべきかについての最終決定を下します。その際、一連の言語委員会ガイドライン(Language committee guidelines)に準拠します。

言語機能の提供 ​

Kotlinのリリースプロセスで説明されているように、言語機能は_言語リリース_(2.x.0)またはそれに続く_ツーリングリリース_(2.x.20)で提供されます。

言語リリースとツーリングリリースの互換性を維持するよう努めているため、コンパイラに対する変更は主に最適化や警告の追加/削除にとどまります。プレ安定版機能はいつでも追加、削除、または変更される可能性があります。

言語リリースでは、多くの場合、新機能の追加、プレ安定版機能の安定版への昇格が行われ、以前に非推奨とされた機能の削除や変更が行われることがあります。

EAPビルド ​

言語リリースおよびツーリングリリースの安定版をリリースする前に、コミュニティからのフィードバックを収集し迅速に改善を進められるよう、EAP(「Early Access Preview」の略)と呼ばれるプレビュービルドを多数公開しています。言語リリースのEAPでは通常、後の安定版コンパイラによって拒否されるバイナリが生成されます。これは、バイナリ形式にバグが存在した場合に、それがプレビュー期間を超えて残存しないようにするためです。RC2やRC3などの最終リリース候補(Release Candidate)には通常、この制限はありません。詳細については、Kotlin Early Access Previewへの参加を参照してください。

プレ安定版機能 ​

前述の「フィードバックループ」の原則に従い、私たちはオープンな場で設計の改善を進め、一部の機能が_プレ安定版_ステータスのいずれかを持ち、_変更されることが想定されている_言語のバージョンをリリースします。このような機能は、事前の予告なくいつでも追加、変更、削除される可能性があります。不注意なユーザーがプレ安定版機能を誤って使用してしまうことがないよう、最善を尽くしています。このような機能は通常、コード内またはプロジェクト設定内で明示的なオプトインを必要とします。

Kotlinの言語機能は、以下のいずれかのステータスを持ちます。

  • 調査と設計(Exploration and design)。言語への新機能の導入を検討している段階です。 これには、既存の機能とどのように統合されるかの議論、ユースケースの収集、潜在的な影響の評価が含まれます。 この機能がどのような問題を解決し、どのようなユースケースに対応するのかについて、ユーザーからのフィードバックが必要です。 可能な限り、これらのユースケースや問題がどのくらいの頻度で発生するかも見積もるようにしています。 通常、アイデアはYouTrackの課題として文書化され、そこで議論が続けられます。

  • KEEPでの議論(KEEP discussion)。その機能を言語に追加すべきであることがほぼ確実となった段階です。 私たちは、Kotlin Evolution and Enhancement Process(KEEP)と呼ばれるドキュメントで、動機、ユースケース、設計、およびその他の重要な詳細を提供することを目指します。 ユーザーからのフィードバックは、KEEPで提供されたすべての情報に関する議論に焦点を当てることを期待しています。

  • プレビュー中(In preview)。機能のプロトタイプが準備完了しており、機能固有のコンパイラオプションを使用して有効にできる段階です。 機能の使用体験について、コードベースへどの程度容易に統合できるか、既存のコードとどのように相互作用するか、IDEサポートの問題や提案などに関するフィードバックを求めます。 フィードバックに基づいて機能の設計が大幅に変更されたり、完全に撤回されたりすることがあります。機能が_プレビュー中_である場合、その機能はExperimentalまたはBetaの安定性レベルのいずれかを持ちます。

  • 安定(Stable)。その言語機能は、Kotlin言語における第一級の要素(ファーストクラスシチズン)となった段階です。 後方互換性とツーリングサポートの提供を保証します。

  • 取り下げ(Revoked)。提案を取り下げ、Kotlin言語にはその機能を実装しない段階です。 _プレビュー中_の機能であっても、Kotlinに適していないと判断された場合は取り下げられることがあります。

Kotlinの言語提案とそのステータスの全一覧を見る。

各コンポーネントのステータス ​

Kotlin/JVM、JS、Nativeコンパイラ、および各種ライブラリなど、Kotlinのさまざまなコンポーネントの安定性ステータスについて詳しく確認できます。

ライブラリ ​

エコシステムがなければ言語は成り立たないため、ライブラリの円滑な進化を可能にすることには特に細心の注意を払っています。

理想的には、ライブラリの新しいバージョンは、古いバージョンの「ドロップイン置換(そのまま差し替え可能な代替品)」として使用できるべきです。これは、アプリケーションを再コンパイルしない場合でも、バイナリの依存関係をアップグレードすることによって何も壊れないことを意味します(これは動的リンクにおいて可能です)。

これを達成するためには、一方で、個別コンパイル(separate compilation)の制約下において、コンパイラが一定の_Application Binary Interface_(ABI)の安定性を保証する必要があります。これが、言語におけるすべての変更がバイナリ互換性の観点から吟味される理由です。

他方で、安全に行える変更についてライブラリの作者が慎重であるかどうかに大きく左右されます。したがって、ライブラリの作成者が、ソースコードの変更が互換性にどのように影響するかを理解し、ライブラリのAPIとABIの両方を安定に保つための特定のベストプラクティスに従うことが極めて重要です。ライブラリの進化の観点から言語の変更を検討する際、私たちは以下の前提を置いています。

  • ライブラリのコードでは、public/protectedな関数およびプロパティの戻り値の型を常に明示的に指定すべきであり、public APIに対して型推論に依存してはならない。型推論のわずかな変更によって戻り値の型が意図せず変更され、バイナリ互換性の問題につながる可能性があります。
  • 同じライブラリによって提供されるオーバーロードされた関数やプロパティは、基本的に同じ動作をすべきである。型推論の変更により、呼び出し側で認識される静的型がより詳細な型になり、オーバーロード解決の結果が変わってしまう可能性があります。

ライブラリの作者は、@Deprecated および @RequiresOptIn アノテーションを使用して、APIサーフェスの進化を制御できます。@Deprecated(level=HIDDEN) を使用すれば、APIから削除された宣言に対してもバイナリ互換性を維持できる点に注意してください。

また、慣例として「internal」という名前のパッケージはpublic APIとは見なされません。「experimental」という名前のパッケージに含まれるすべてのAPIはプレ安定版と見なされ、いつでも変更される可能性があります。

安定したプラットフォーム向けのKotlin標準ライブラリ(kotlin-stdlib)は、上記の原則に従って進化させています。そのAPIの規約(コントラクト)の変更は、言語自体の変更と同じ手順を踏みます。

コンパイラオプション ​

コンパイラが受け付けるコマンドラインオプションも一種のpublic APIであり、同様の考慮事項の対象となります。サポート対象のオプション(「-X」または「-XX」プレフィックスが付いていないもの)は言語リリースでのみ追加でき、削除する前には適切に非推奨化される必要があります。「-X」および「-XX」オプションは実験的なものであり、いつでも追加および削除される可能性があります。

互換性ツール ​

レガシーな機能が削除されバグが修正されるにつれてソース言語は変化するため、適切に移行されていない古いコードはコンパイルできなくなる場合があります。通常の非推奨サイクルでは移行のための十分な猶予期間が設けられており、その期間が終了して変更が安定版に組み込まれた後でも、移行されていないコードをコンパイルする方法が用意されています。

互換性オプション ​

新しいKotlinバージョンで古いバージョンの動作をエミュレートする互換性オプションを提供しています。

  • -language-version X.Y – Kotlin言語バージョンX.Yに対する互換性モード。以降のバージョンで導入された言語機能をコードが使用している場合、コンパイラはエラーを報告します。
  • -api-version X.Y – Kotlin APIバージョンX.Yに対する互換性モード。以降のバージョンで導入されたKotlin標準ライブラリAPIを使用している宣言(コンパイラが生成したコードから参照されるAPIを含む)をコンパイラは無視します。

移行の時間をより多く確保できるように、JVM上では最新の安定版に加えて、少なくとも過去3つの言語およびAPIバージョンをサポートしています。これにより、ライブラリの作成者は、古いコンパイラバージョンを使用している利用者(コンシューマー)との互換性を保ちながら、新しいコンパイラリリースを採用することができます。他のプラットフォームでも古い言語およびAPIバージョンを設定できますが、JVMとは異なり、利用者は依然として最新のコンパイラバージョンを使用する必要があります。

ほとんどのプロジェクトでは、両方のオプションを同じバージョンに設定します。低いAPIバージョンは、主に古いバージョンのKotlin標準ライブラリとの互換性を維持する必要がある場合に役立ちます。

アクティブにメンテナンスされているコードベースでは、完全な非推奨サイクルの完了を待つことなく、バグ修正をできるだけ早く適用することが有益な場合があります。これらのプロジェクトでは、-progressive オプションを有効にすることで、これらの変更がデフォルトになる前にツーリングリリースの段階で適用できます。

これらのオプションは、コマンドライン、またはGradleやMavenビルドツールで設定できます。

バイナリフォーマットの進化 ​

最悪の場合でも手作業で修正できるソースコードとは異なり、バイナリの移行はずっと困難であるため、バイナリの場合は後方互換性が極めて重要になります。バイナリに対する非互換な変更はアップデートを非常に困難にする可能性があるため、ソース言語の構文に対する変更よりもさらに慎重に導入する必要があります。

完全に安定したコンパイラバージョンの場合、デフォルトのバイナリ互換性プロトコルは以下の通りです。

  • すべてのバイナリは後方互換性があります。つまり、新しいコンパイラは古いバイナリを読み取ることができます(例えば、1.3は1.0から1.2までを理解できます)。
  • 古いコンパイラは、新機能に依存するバイナリを拒否します(例えば、1.0コンパイラはコルーチンを使用するバイナリを拒否します)。
  • 望ましくは(ただし保証はできません)、バイナリフォーマットは次の言語リリースに対して概ね前方互換性がありますが、それ以降のリリースのものには対応しません(新機能が使用されていない場合。例えば、1.9は2.0のほとんどのバイナリを理解できますが、2.1のものは理解できません)。

このプロトコルは快適なアップデートのために設計されており、少し古いコンパイラを使用しているプロジェクトであっても、依存関係のアップデートが妨げられることはありません。

すべてのターゲットプラットフォームがこの安定性レベルに達しているわけではありませんが、Kotlin/JVMは達しています。

Kotlin klibバイナリ ​

Kotlin klibバイナリは、Kotlin 1.9.20でStableレベルに達しました。ただし、留意すべき互換性の詳細がいくつかあります。

  • klibバイナリはKotlin 1.9.20以降、後方互換性があります。例えば、2.0.xコンパイラは1.9.2xコンパイラによって生成されたバイナリを読み取ることができます。
  • 前方互換性は保証されて_いません_。例えば、2.0.xコンパイラが2.1.xコンパイラによって生成されたバイナリを読み取れることは保証_されません_。

Kotlin cinterop klibバイナリはまだBeta段階です。 現在、cinterop klibバイナリについては、異なるKotlinバージョン間での具体的な互換性の保証を提供することはできません。