チュートリアル: Bazel 入門

Bazel プラグインをインストールする

1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

2. Marketplace タブを開き、 Bazel プラグインを見つけて、 インストール をクリックします。

3. プラグインを有効にするには、IDE を再起動します。

1. IntelliJ IDEA を起動してください。

   'ようこそ' 画面が開いたら、「新規プロジェクト 」をクリックします。

   それ以外の場合は、メインメニューの ファイル | 新規 プロジェクト に移動します。

2. プロジェクトに名前を付け、ビルドシステムとして Bazel を選択します。

   

3. (オプション) このプロジェクトをバージョン管理したり、後で GitHub に公開したりする場合は、 Git リポジトリの作成 をチェックします。

4. 作成(C) をクリックします。

1. 右側のサイドバーで、 Bazel アイコンをクリックします。 または、メインメニューから 表示 | ツールウィンドウ | Bazel を選択します。

   

   これにより、 Bazel ツールウィンドウが開き、 BUILD.BAZEL ファイルで定義されているターゲットが一覧表示されます。

2. Bazel ツールウィンドウで、 Main ターゲットを右クリックし、 実行 を選択します。

   

生成されたリポジトリの名前を変更する

1. MODULE.BAZEL の install() および use_repo() 呼び出しの name 属性を変更します。

   maven.install( # before # name = "maven", name = "third-party", # after artifacts = [ "junit:junit:4.13.2", ], repositories = [ "https://repo1.maven.org/maven2", ], ) # before # use_repo(maven, "maven") use_repo(maven, "third-party") # after

2. BUILD.BAZEL 内のテストパッケージのラベルを変更してください。 これはリポジトリ名が参照されている唯一のパッケージです。 そうでない場合は、他のすべての参照も変更する必要があります。

   java_test( name = "tests", srcs = glob(["**/*.java"]), test_class = "org.example.MainTest", deps = [ "//src/main/org/example:Main", # before # "@maven//:junit_junit", "@third-party//:junit_junit", # after ], )

プロジェクトを再同期する

• Bazel ツールウィンドウのツールバーで、 プロジェクトの再同期 ボタンをクリックします。

  

ソースを追加する

1. MODULE.BAZEL ファイルを開きます。

2. 次のように、 install() 呼び出しに fetch_sources パラメーターを追加します。

   maven.install( name = "third-party", artifacts = [ "junit:junit:4.13.2", ], repositories = [ "https://repo1.maven.org/maven2", ], fetch_sources = True )

プロジェクトを再同期する

• Bazel ツールウィンドウのツールバーで、 プロジェクトの再同期 ボタンをクリックします。

  

構築ルールを追加する

• MODULE.BAZEL ファイルで、Kotlin (rules_kotlin 2.1.8) のルールをインポートするためのステートメントをファイルの先頭に貼り付けます。

  module( name = "null", version = "0.1.0", ) bazel_dep(name = "rules_java", version = "8.10.0") bazel_dep(name = "rules_jvm_external", version = "6.7") bazel_dep(name = "rules_kotlin", version = "2.1.8") maven = use_extension("@rules_jvm_external//:extensions.bzl", "maven") maven.install( name = "third-party", artifacts = [ "junit:junit:4.13.2", ], repositories = [ "https://repo1.maven.org/maven2", ], fetch_sources = True ) use_repo(maven, "third-party")

Kotlin ソースを含むパッケージを追加する

1. プロジェクト ツールウィンドウに切り替えます。 ルートフォルダーを選択した状態で、 Alt+Insert を押すか、右クリックして 新規 | Bazel パッケージ を選択します。

2. パッケージに名前を付けます (例: kotlin_lib)。

   BUILD.BAZEL ファイルが入った新しいフォルダーが表示されます。

3. kotlin_lib フォルダーに、次のフォルダー構造を作成します: src/main/com/example/mylib 。

4. BUILD.BAZEL を新しく作成した src/main/com/example/mylib に移動し、次のコードを追加します。

   load("@rules_kotlin//kotlin:jvm.bzl", "kt_jvm_library") package(default_visibility = ["//visibility:public"]) kt_jvm_library( name = "MyLib", srcs = ["MyLib.kt"] )

   Java パッケージと同様に、このコードは次のようになります。

   • Kotlin Bazel ルール（rules_kotlin ）から kt_jvm_library ルールをインポートします。 これにより、この BUILD ファイルで Kotlin JVM ライブラリルールが使用できるようになります。

   • このパッケージ内のターゲットのデフォルトの可視性を public に設定します。これにより、プロジェクト内の他の Bazel パッケージから依存できるようになります。

   • Bazel 内に MyLib という名前の Kotlin JVM ライブラリターゲットを宣言します。 このターゲットは MyLib.kt を JAR ファイルにコンパイルします。

5. src/main/com/example/mylib で、次の内容を含む MyLib.kt という名前のファイルを作成します。

   package com.example.mylib fun hello() = println("Hello from Kotlin")

プロジェクトを再同期する

• Bazel ツールウィンドウのツールバーで、 プロジェクトの再同期 ボタンをクリックします。

  

Kotlin パッケージへの依存関係を追加する

1. プロジェクト ツールウィンドウ Alt+1 を開きます。

2. src/main/org/example/BUILD.bazel ファイルで、次のように java_binary 呼び出しに deps 引数を追加します。

   java_binary( name = "Main", main_class = "org.example.Main", srcs = glob(["**/*.java"]), deps = ["//kotlin_lib/src/main/com/example/mylib:MyLib"] )

Java コードを更新する

• src/main/org/example/Main.java ファイルに、次のように インポート ステートメントとライブラリ関数の呼び出しを追加します。

  package org.example; import com.example.mylib.MyLibKt; // import the library public class Main { public static void main(String[] args) { System.out.println("Hello World!"); MyLibKt.hello(); // call the library function } public static int constant4() { return 4; } }

プロジェクトを再同期する

• Bazel ツールウィンドウのツールバーで、 プロジェクトの再同期 ボタンをクリックします。

  

ビルドと実行

1. 右側のサイドバーで、 Bazel アイコンをクリックします。 または、メインメニューから 表示 | ツールウィンドウ | Bazel を選択します。

2. Bazel ツールウィンドウで、 Main ターゲットを右クリックし、 実行 を選択します。

   

1. プロジェクト ツールウィンドウ Alt+1 を開きます。

2. 除外ディレクトリ に移動し、 bazel-bin にある、プロジェクトのパッケージ構造を反映したディレクトリを見つけます。 そこに、Kotlin ライブラリとメインの Java アプリケーションパッケージの両方の JAR ファイルがあります。

   

.bazelproject ファイルを作成する

1. プロジェクト ツールウィンドウ Alt+1 を開きます。

2. .bazelbsp フォルダーにある .bazelproject ファイルを見つけます。

   

   その近くの 選択済み ラベルは、これが現在使用されているプロジェクトビューであることを示します。

3. .bazelbsp/.bazelproject ファイルをコピーし、プロジェクトルートに貼り付けます。

4. 新しく作成された .bazelproject ファイルで、次のように ディレクトリ プロパティを kotlin_lib フォルダーを指すように変更します。

   derive_targets_from_directories: true directories: kotlin_lib

5. プロジェクト ツールウィンドウで、このファイルを右クリックし、 プロジェクトビューを読み込む を選択します。

   

   プロジェクト ツールウィンドウには、 kotlin_lib パッケージのみが表示されるようになりました。