iarbuild - IARコマンドラインビルドユーティリティ

このセクションの内容:

IARコマンドラインビルドユーティリティ (iarbuild)はcommon\binディレクトリにあります。

入力としてプロジェクトファイルを使用し、以下の構文で呼び出します。

iarbuild project.ewp [opmode] config[,config2,...]|"*" [options]

以下のパラメータが使用できます。

パラメータ	説明
`project``.ewp`	IAR Embedded Workbenchプロジェクトファイル。
`opmode`	以下のいずれかの動作モード (表の下の説明を参照)： `-build` `-clean` `-compdb` `-cspybat_cmds` `-cstat_analyze` `-cstat_clean` `-cstat_cmds` `-cstat_report` `-jsondb` `-make` (デフォルト) `-ninja`
`config\|"*"`	`config`、ビルドする構成の名前（事前定義された構成のDebugまたはReleaseのいずれか、または自分で定義した名前）。詳細については、プロジェクトとビルド構成を参照してください。 `*`(ワイルドカード文字)、操作モードコマンドはプロジェクトで定義されているすべての構成を実行します。(引用符はMicrosoft Windowsでは省略できます。)
`options`	以下の追加オプションの中から1つ以上を指定可能 (表の下の説明を参照)： `-fail_fast` `-log type` `-output filename` `-output_type filetype` `-parallel number` `-tool type` `-varfile filename`

表4 iarbuildコマンドラインオプション

プロジェクトファイルを指定せずにコマンドシェルからアプリケーションを実行すると、使用可能なパラメータとその構文を説明するサインオンメッセージが表示されます。

ビルドプロセスが成功した場合、 IARコマンドラインビルドユーティリティは0を返します。そうでない場合は、ゼロ以外の数字と診断メッセージが返されます。

-jsondb

プロジェクトのJSON記述を生成します。フォーマットはコンパイラデータベースフォーマットに基づいていますが、ビルドのリンク、カスタム、変換ステップも含まれています。オプションで、-outputオプションを指定して出力ファイルに名前を付け、-toolオプションを指定してツールまたはツールセットを実行できます。デフォルトでは、出力は$PROJ_DIR$/config/project_jsondb.jsonファイルに生成されます。

データベースには、次のフォーマットでプロジェクトをビルドする方法に関するエントリが含まれています。

[
   {
      "arguments" : [ Comma-separated list of arguments],
      "directory" : "The directory in which to perform the 
                     action",
      "file" : "The input file",
      "output" : "The output file",
      "type" : "Name of the tool"
   }
]

複数の入力または複数の出力がある場合、"output"または"file"タグは、"outputs"または"files"に置き換えられ、その後にカンマ区切りのファイルリストが続きます。

[
   {
      "arguments" : [ Comma-separated list of arguments],
      "directory" : "The directory in which to perform the 
                     action",
      "files" : [Comma-separated list of files],
      "outputs" : [Comma-separated list of files],
      "type" : "Name of the tool"
   }
]

-log

ビルドメッセージログのレベルを指定します。以下から選択します：

`-log errors`	ビルドエラーメッセージをログに出力します。
`-log warnings`	ビルドのワーニングおよびエラーメッセージをログに出力します。
`-log info`	ビルドのワーニングメッセージ、エラーメッセージ、および `#pragma message`プリプロセッサディレクティブによって出力されるメッセージをログに出力します。
`-log all`	コンパイラのサインオン情報や完全なコマンドラインなど、ビルドから生成されたすべてのメッセージをログに出力します。

-output

-output filename

-jsondb操作モードコマンドとともに使用して、出力ファイルの名前と場所を指定します。

-output_type

-output_type filetype

-cspybat_cmds操作モードコマンドとともに使用して、コマンドラインファイルセットのファイルタイプを指定します。以下から選択します：

shell
bat
powershell

ファイルセットには、 *.driver.xcl、 *.general.xcl、および指定されたファイルタイプのマスターファイルが含まれます。ファイルには絶対パスが含まれているため、他のコンピュータに移動したり、バージョン管理システムに配置したりすることはできません。

-parallel

-parallel number

CPUのコアをより有効利用するため、コンパイラを実行する並列プロセスの数を指定します。

-tool

-tool type|list

- jsondbまたは -ninja操作モードコマンドと一緒に使用して、特定のツールセットを実行します。iarbuild -tool listを実行すると、使用可能なツールオプションが一覧表示されます。

たとえば、 iarbuild MyProject.ewp -ninja Debug -tool BuildToolsは、プロジェクト内のすべてのビルドツールノードを含むninjaファイルを生成します。

-varfile

-varfile filename

使用するファイルを指定することで、カスタム定義の引数変数がビルドエンジンで使用可能なワークスペーススコープで定義されるようにします。カスタム引数変数の設定ダイアログボックスを参照してください。

IAR Embedded Workbench for Arm 9.70.x

iarbuild - IARコマンドラインビルドユーティリティ

-build

-clean

-compdb

-cspybat_cmds

-cstat_analyze

-cstat_clean

-cstat_cmds

-cstat_report

-fail_fast