# Dynamo コマンド ライン インタフェース `-o, -O, --OpenFilePath` コマンド ファイルを開いてこのパスに含まれているコマンドを実行するよう Dynamo に指示します。このオプションは、DynamoSandbox から実行する場合にのみ利用できます。 `-c, -C, --CommandFilePath` コマンド ファイルを開いてこのパスに含まれているコマンドを実行するよう Dynamo に指示します。このオプションは、DynamoSandbox から実行する場合にのみ利用できます。 `-v, -V, --Verbose` 実行したすべての評価を指定したパスの XML ファイルに出力するよう Dynamo に指示します。 `-g, -G, --Geometry` すべての評価のジオメトリをこのパスの JSON ファイルに出力するよう Dynamo に指示します。 `-h, -H, --help` ヘルプを表示します。 `-i, -I, --Import` アセンブリをノード ライブラリとして読み込むよう Dynamo に指示します。この引数は単一の `.dll` へのファイル パスである必要があります。複数の `.dlls` を読み込む場合は、`-i 'assembly1.dll' 'assembly2.dll'` のように、スペースで区切って並べます。 `--GeometryPath` ASM を含むフォルダへの相対パスまたは絶対パスです。指定した場合、ASM はハード ディスクで検索されるのではなく、このパスから直接ロードされます。 `-k, -K, --KeepAlive` キープアライブ モード。ロードされた拡張機能によってシャットダウンされるまで、Dynamo プロセスを実行したままにします。 `--HostName` ホストに関連付けられている Dynamo バリエーションを特定します。 `-s, -S, --SessionId` Dynamo ホスト解析セッション ID を特定します。 `-p, -P, --ParentId` Dynamo ホスト解析の親 ID を特定します。 `-x, -X, --ConvertFile` `-O` フラグと組み合わせて使用すると、指定したパスから `.dyn` ファイルを開いて `.json` に変換できます。ファイルには `.json` 拡張子がつけられ、元のファイルと同じフォルダに配置されます。 `-n, -N, --NoConsole` キープアライブ モードでの CLI の操作にコンソール ウィンドウを使用しないようにします。 `-u, -U, --UserData` PathResolver が CLI で使用するユーザー データ フォルダを指定します。 `--CommonData` PathResolver が CLI で使用する共通データ フォルダを指定します。 `--DisableAnalytics` プロセスの寿命の間、Dynamo での解析を無効にします。 `--CERLocation` ディスクにあるクラッシュ エラー レポート ツールを指定します。 `--ServiceMode` サービス モードの起動を指定します。 #### 使用する理由 次のようなさまざまな理由により、コマンド ラインから Dynamo をコントロールする場合があります。 * 多数の Dynamo の実行を自動化する * Dynamo グラフをテストする(DynamoSandbox を使用する場合は -c も参照する) * 一連の Dynamo グラフを特定の順序で実行する * 複数のコマンド ラインを実行するバッチ ファイルを作成する * Dynamo グラフの実行をコントロールおよび自動化する別のプログラムを記述し、その計算結果を使用してさまざまな処理を行う #### 何を行うか コマンド ライン インタフェース(DynamoCLI)は、DynamoSandbox を補完するものです。これは、Dynamo を実行するコマンド ライン引数の利便性を提供するように設計された、DOS/ターミナル コマンド ライン ユーティリティです。最初の実装では単独で実行できません。Sandbox と同じコア DLL に依存するため、Dynamo バイナリが存在するフォルダから実行する必要があります。Dynamo の他のビルドと相互運用することはできません。 CLI の実行方法は 4 つあります。まず DOS プロンプトから実行する、DOS バッチ ファイルから実行する、指定したコマンド ライン フラグを含むようにパスを変更した Windows デスクトップ ショートカットとして実行するという方法です。DOS ファイルの仕様は完全修飾か相対で記述できます。また、マッピングされたドライブと URL 構文もサポートされます。Mono でビルドし、ターミナルから Linux または Mac 上で実行するという方法もあります。 このユーティリティは Dynamo パッケージをサポートしていますが、カスタム ノード(dyf)をロードすることはできません。ロードできるのはスタンドアロンのグラフ(dyn)のみです。 予備テストでは、CLI ユーティリティはローカライズされたバージョンの Windows をサポートしており、filespec 引数を大文字の ASCII 文字で指定できます。 CLI は、DynamoCLI.exe アプリケーションからアクセスできます。このアプリケーションを使用すると、コマンド文字列を指定して DynamoCLI.exe を呼び出すことで、ユーザまたは別のアプリケーションが Dynamo 評価モデルとやりとりを行うことができます。結果は次のようになります。 `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn"` このコマンドは、Dynamo に対して、*"C:\someReallyCoolDynamoFile.Dyn"* にある指定ファイルを、UI を描画せずに開き、実行するように指示します。グラフの実行が完了すると、Dynamo は終了します。 **バージョン 2.1 で追加**: DynamoWPFCLI.exe アプリケーションを追加しました。このアプリケーションは、ジオメトリ(-g)オプションを追加して、DynamoCLI.exe アプリケーションがサポートするすべての対象をサポートします。DynamoWPFCLI.exe アプリケーションは Windows 専用です。 #### 重要な注意事項 * DynamoCLI の操作には、コマンド プロンプト インタフェースを使用する方法が推奨されます。 * この場合、\[Dynamo Version]フォルダ内のインストール場所から DynamoCLI を実行する必要があります。CLI は Dynamo と同じ .dll にアクセスする必要があるため、場所を移動しないでください。 * Dynamo で現在開いているグラフを実行することは可能ですが、これにより意図しない副作用が発生する可能性があります。 * すべてのファイル パスは完全に DOS に準拠しているため、相対パスと完全修飾パスは機能しますが、パスは引用符で囲んでください。例: *"C:path\to\file.dyn"* * DynamoCLI は新しい機能であり、仕様は現在流動的です。現時点では、CLI は標準 Dynamo ライブラリの**サブセットのみをロード**します。グラフが正しく実行されない場合は、この点にご注意ください。これらのライブラリは、[こちら](https://github.com/DynamoDS/Dynamo/blob/master/src/DynamoApplications/PathResolvers.cs#L28)で指定されています * 現在、エラーが発生しなかった場合は、標準出力が提供されず、CLI は実行完了後に終了します。 #### 使用方法 `-o` グラフを実行するヘッドレス モードで、.dyn を参照する Dynamo を開くことができます。 `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn"` `-v` このフラグは、Dynamo がヘッドレス モードで実行されている場合(`-o` を使用してファイルを開いた場合)に使用できます。このフラグは、グラフ内のすべてのノードを反復し、その出力値を単純な XML ファイルにダンプします。`--ServiceMode` フラグは Dynamo に複数のグラフ評価を実行するように強制できるため、出力ファイルには各評価の値が含まれます。 `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn" -p "C:\aFileWithPresetsInIt.dyn" --ServiceMode "all" -v "C:\output.xml"` XML 出力ファイルには、次の形式があります。 ```xml ``` `-g` Dynamo がヘッドレス モードで実行されている場合(`-o` を使用してファイルを開いた場合)に使用できます。このフラグはグラフを生成し、結果のジオメトリを JSON ファイルにダンプします。 `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoWPFCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn" -g "C:\geometry.json"` JSON ジオメトリ ファイルには、次のような形式があります。 未定 - 作業中 `-h` これを使用して、使用可能なオプションのリストを取得します `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -h` -i フラグを複数回使用して、開こうとしているグラフの実行に必要な複数のアセンブリを読み込むことができます。 `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn" -i"a.dll" -i"aSecond.dll"` -l フラグは、異なるロケール設定で Dynamo を実行するために使用できます。ただし通常は、ロケールの設定はグラフの結果に影響しません `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn" -l "de-DE"` \--GeometryPath フラグを使用すると、DynamoSandbox または CLI に ASM バイナリの特定のセットを指すことができます。次に使用例を示します。 `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoSandbox.exe --GeometryPath "\pathToGeometryBinaries\"` または `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoSandbox.exe --GeometryPath "\pathToGeometryBinaries\"` -k フラグを使用すると、ロードされた拡張機能によってシャットダウンされるまで、Dynamo プロセスを実行したままにすることができます。 `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -k` \--HostName フラグを使用すると、ホストに関連付けられている Dynamo バリエーションを識別できます。 `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe --HostName "DynamoFormIt"` または `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoSandbox.exe --HostName "DynamoFormIt"` -s フラグを使用すると、Dynamo ホスト解析セッション ID を識別できます `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -s [HostSessionId]` -p フラグを使用すると、Dynamo ホスト解析の親 ID を識別できます `C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -p "RVT&2022&MUI64&22.0.2.392"`