エディターを開く
どちらかのパネルの +(新しいタブ)メニューからエディタータブを追加します。要件
エディターにはグローバルにインストールされた BRICKS CLI のバージョン 2.25.0 以降が必要です。
- 古い CLI — エディターは「設定エディターには BRICKS CLI 2.25.0 以降が必要です。更新してから続行してください。」を、現在のバージョンと BRICKS CLI を更新 ボタンとともに表示します。
- 廃止されたパッケージ — 廃止された bricks-ctor パッケージを使うプロジェクトでは、移行の案内と 移行 ボタンが表示されます。
- CLI がない — エディターは「BRICKS CLI が見つかりません。次のコマンドでインストールしてください:」とインストールコマンドを表示します。
ツールバー
エディターのツールバーには次のコントロールがあります:保存とコミット
保存をクリックすると、プレースホルダーchore: update config from CTOR editor があらかじめ入力されたコミットメッセージのポップオーバーが開きます。保存してコミットで確定して編集を書き込みます。
保存すると:
- 編集内容のソースファイル——
application.json、app.ts、root.ts、およびsubspaces/とautomation-tests/配下のファイル——を生成します。 - 生成したソースをコンパイルして型チェックします。
- Git コミットを作成します——件名はあなたのメッセージ(または既定のプレースホルダー)で、本文は変更の要約です。エディターが生成または削除したファイルのみがステージされ、無関係な変更がステージされることはありません。
保存状態
保存状態のドットは編集の状態を示します。ドットにカーソルを合わせると全文が表示されます。
未保存の編集がある状態でコンパイル済み設定がエディター外で変更された場合(たとえばエージェントがソースを編集した場合)、保存すると「コンパイル済み設定がエディター外で変更されました。保存する前に再読み込みするか外部変更を解決してください。」と表示されます。エディターは外部変更のマージと保存の再試行を自動的に試みます。できない場合は、まず再読み込みするか変更を解決してください。
再読み込みは未保存の編集を破棄し——「未保存の設定エディターの変更を破棄しますか?」と確認します——取り消し履歴をクリアします。
キーボードショートカット
テキストフィールドに入力しているあいだは、コピー・貼り付け・複製はスキップされます。項目を右クリックするとコンテキストメニューが開きます。
コピーした Brick と Canvas は、エディターと Web 版 Config Editor の間を双方向に移動できるため、一方でコピーしてもう一方に貼り付けられます。
コマンドパレット
エディタータブがアクティブなときに Cmd/Ctrl+K を押すと、エディターのコマンドパレット(タイトルは エディターコマンド)が開きます。次の項目が並びます:- New: Subspace / Canvas / Data / General Data Calculation / Script Data Calculation / Animation — その種類の新しい項目を作成します。
- New Brick: <name> と New Generator: <name> — 指定した種類の新しい Brick または Generator を作成します。
- 設定内の既存項目への移動ナビゲーション。
ライブシミュレーションとエージェント
未保存の編集はシミュレーターにライブでレンダリングされ、エージェントのスクリーンショットもそれを使うため、あなたが見るものとエージェントが見るものは一致します。 エディターを開いているあいだにエージェントが設定を変更すると、その変更はその場で適用され——影響を受ける Brick、Canvas フレーム、リスト行が短くパルスして、何が変わったかがわかります。 エージェントはあなたのエディター状態も把握できます。エディターが開いているか、未保存の編集があるか、現在の Subspace、選択内容、そして直近の編集履歴です。これにより、あなたのビジュアル編集と歩調を合わせて作業できます。未保存の編集の保護
未保存の編集がある状態でセッションやプロジェクトを切り替えたり、エディタータブを閉じたり、ウィンドウを閉じたりすると、まず「未保存の設定エディターの変更を破棄しますか?」と確認されるため、誤って作業を失うことはありません。項目ごとのヘルプ
多くの項目にはヘルプ(?)アイコンがあります。クリックすると、エディターの言語で表示されるドッキングされたリファレンスドロワーが開きます。次のステップ
シミュレーター
組み込みシミュレーターでプロジェクトを実行し、未保存のエディター編集をライブで確認できます。
Config Editor
Subspace、Canvas、Brick、Generator の背後にあるエンティティモデルを学びます。