sim_command_race - ETrobocon/etrobo GitHub Wiki

raceコマンドの説明

書式

race [MODE] [CLASS] [COURCE] [＜/path/to/raceFolder＞] [＜projName＞]

説明

ETロボコンシミュレータ競技を制御するために用意されたコマンドです。
$ETROBO_HRP3_WORKSPACE/simdist/＜projName＞フォルダを圧縮する機能があります。

[MODE]

  • zip　・・・　“__race”フォルダに.zipファイルを生成します。

[CLASS]

  • (auto)　・・・　指定しない場合、格納したsettings.jsonファイルに従います。settings.jsonが無い場合は、”entry”になります。
  • advanced・・・　アドバンストクラス向け設定を出力します。（A_upload.zipを生成）
  • primary・・・　プライマリクラス向け設定を出力します。（P_upload.zipを生成）
  • entry　・・・　エントリークラス向け設定を出力します。（E_upload.zipを生成）

[COURCE]

  • (auto)　・・・　指定しない場合、格納したsettings.jsonファイルに従います。settings.jsonが無い場合は、”left”になります。
  • left　・・・　Lコース向け設定を出力します。
  • right　・・・　Rコース向け設定を出力します。

[＜/path/to/raceFolder＞]

  • 出力先である“__race”フォルダを絶対パスで指定が可能です。
  • Windows環境での初期位置 ：%USERPROFILE%\etrobosim\_race\
  • その他の環境での初期位置：$ETROBO_HRP3_WORKSPACE/simdist/_race/

[＜projName＞]

指定されたプロジェクトのフォルダを対象に処理を行います。 $ETROBO_HRP3_WORKSPACE/simdist/＜projName＞ 省略した場合、現在選択されているプロジェクトを対象とします。

【コマンド実行における注意事項・補足説明】

  1. zipファイルの生成には、”l_”プレフィックスで始まる.aspファイルと”r_”プレフィックスで始まる.aspファイル、両方が必要です。（プレフィックス無しの.aspファイルは対象外です。）
  2. settings.jsonファイルが存在しない場合、コマンドのオプション設定に従ったファイルをzipに同梱します。
  3. settings.jsonファイルが存在する場合も、コマンドオプションを設定した場合、該当箇所を変更したファイルをzipファイルに同梱します。(simdist/＜projName＞フォルダに格納されたファイルそのものではありません。)
  4. コマンドが正常に終了した場合、Windowsの場合はエクスプローラ、macOSの場合はFinderで__raceフォルダを表示します。