sim_command_race

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フォルダを表示します。