Kwbazel

kwbazel ビルド統合コマンドを使用すると、ユーザーは Bazel ビルドシステムでビルドされたプロジェクトを分析することができます。kwbazel は、Bazel ビルドを実行し、トレースおよびビルド仕様ファイル (kwinject.trace および kwinject.out) を生成する実行可能シェルスクリプトです。

Kwbazel では、トレースファイルおよびビルドスペックファイルの生成に関して、2 通りの方法をサポートしています。デフォルトの aquery ベースの方法と、--aspect_build で有効化される実験的な aspect ベースの方法です。

実験的な aspect ベースのビルド方法を使用する場合、kwbazel はデフォルトで増分解析を実行してビルド時間を短縮します。出力ファイルを再生成したい場合は、-w (または --overwrite) を使用して既存の出力ファイルを上書きしてください。

前提条件

• kwbazel を使用するには、Bazel と Klocwork コマンドラインツールをインストールします。

• bazel build <target> を実行して、Bazel を使用したソースのコンパイルが正常に動作することを確認します。

• Bazel ワークスペースディレクトリ (ROOT ワークスペースファイルが存在するディレクトリ) から kwbazel を実行します。

• 実験的な --aspect_build オプションを使用するには、WORKSPACE ファイルに p4sa_bazel_tools のローカル Bazel リポジトリ宣言を追加し、Bazel が Klocwork の aspect ファイルにアクセスできるようにします。

  local_repository(
      name = "p4sa_bazel_tools",
      path = "<Klocwork_install>/config/kwbazel",
  )

• rules_foreign_cc を通じて make、CMake、または gmake にコンパイルを委譲する Bazel プロジェクトの場合は、Bazel 7.1 以降を使用します。

制限事項

• Kwbazel は Linux および Windows オペレーティングシステムとのみ互換性があります。

• kwbazel は、Linux と Windows の両方でデフォルトのニーモニックを使用した C/C++ および Java コードのビルドをサポートし、Linux では C# コードのビルドをサポートします。他のプログラミング言語はサポートしていません。

• Kwbazel はリモート実行をサポートせず、ローカルビルドのみを容易にします。

• 実験的な --aspect_build オプションは現在、C/C++ の aspect ベースのビルドスペック生成のみをサポートしています。他の言語を含めた場合、kwbazel はその言語を aspect ベースの処理の対象外とします。

• rules_foreign_cc を通じて make、CMake、または gmake にコンパイルを委譲する Bazel プロジェクトのビルドスペック生成には、--aspect_build オプションと Bazel 7.1 以降が必要です。デフォルトの aquery ベースの方法では、これらのプロジェクトはサポートされていません。

• カスタムニーモニックは、Kwbazel の明示的オプションによってサポートされます。

• Kwbazel は、Bazel によって呼び出される make や CMake などの他のビルドシステムを監視しません。このようなシナリオでは、ビルド統合に Kwinject の使用を検討してください。

• kwbazel は Android Bazel ビルド (Kleaf) では使用できません。Android Bazel ビルドの場合は、代わりに --bazel オプションを指定して kwandroid を使用します。

• Windows では、サポートされているネイティブ環境から Bazel を使用してください。Bazel のワークフローでは、Git Bash、MSYS、Cygwin、およびこれらに類似した Bash の派生版を使用しないでください。

使用方法

kwbazel --bazel_version <version> --target <bazel_target> --klocwork_path <path_directory> [--arguments <bazel_arguments>] [--lang <language>] [--skip_build] [--aspect_build [<aspect_targets>] [--output_groups <groups>]]

オプション

kwbazel -b bazel -o klocwork -t //... --aspect_build

kwbazel -b bazel -o klocwork -t //... --aspect_build //:my_aspect.bzl%my_aspect --output_groups my_aspect_output

kwbazel -b bazel -o klocwork -t //... --aspect_build //:my_aspect.bzl%my_aspect,//:my_other_aspect.bzl%my_other_aspect --output_groups my_aspect_output,my_other_aspect_output

kwbazel -b bazel -o klocwork -t //... --skip_build