Bazel のインストール
Bazel、Windows、macOS に Bazel をインストールする場合は、Bazelisk を使用することをおすすめします。適切なバージョンの Bazel が自動的にダウンロードされてインストールされます。Bazel は、作業ディレクトリに応じて異なるバージョンの Bazel と切り替えたい場合、または常に Bazel を最新リリースに更新したい場合に使います。
詳細については、公式 README をご覧ください。
Bazel の更新
Bazel には下位互換性ポリシーがあります（作成者の場合は、互換性のない変更をロールアウトするためのガイダンスをご覧ください）。このページでは、互換性のない変更が予定されているプロジェクトをテストして移行する方法と、互換性のない変更作成者にフィードバックを提供する方法のベスト プラクティスをまとめています。
Bazelisk で Bazel のバージョンを管理する
Bazelisk は、Bazel のバージョンの管理に役立ちます。
Bazelisk では次のことができます。
- Bazel を最新の LTS またはローリング リリースに自動更新する。
- .bazelversion ファイルで指定された Bazel バージョンでプロジェクトをビルドします。このファイルをバージョン管理にチェックインし、ビルドの再現性を確認します。
- 互換性のない変更がないか、プロジェクトを移行するのに役立ちます（上記を参照）
- リリース候補版を簡単に試す
推奨される移行プロセス
LTS リリースのマイナー アップデート内であれば、現在のリリースとの互換性を損なうことなく、あらゆるプロジェクトを次のリリースに向けて準備できます。ただし、メジャー LTS バージョン間で下位互換性のない変更が行われる場合があります。
あるメジャー バージョンから別のメジャー バージョンに移行するには、次の手順を行います。
- リリースノートをご覧になり、次のバージョンに移行する方法についてのアドバイスをご活用ください。
- 互換性のない重大な変更には、関連する
--incompatible_*フラグと、対応する GitHub の問題が必要です。- 移行ガイダンスは、関連する GitHub の問題に記載されています。
- 互換性のない変更移行の一部でツールを使用できます。例: buildifier。
- 移行に関する問題を報告する際は、関連する GitHub の問題をコメントでお知らせください。
移行後も、次のメジャー リリースまで下位互換性を心配せずにプロジェクトを構築できます。