エディタとファイル
プロジェクトを開く、ビューの切り替え、ファイルエクスプローラーとタブ、内蔵ワークスペース。
プロジェクトを開くとエディタが開きます。エディタは、エージェントのチャット、ファイルエクスプローラー、タブ付きのエディタ領域、ウィンドウ下部のツールバーで構成されます。
プロジェクトを開く
プロジェクトはホームページから始めます。
| ボタン | 動作 |
|---|---|
| Create Blank Project | Embedrのプロジェクトフォルダに新しいプロジェクトを作成します。 |
| Import KiCad | 既存のKiCadプロジェクトをEmbedrに取り込みます。ボードとKiCadを参照してください。 |
| Open Folder(デスクトップ)/ Import Folder(ブラウザ) | 既存のフォルダをプロジェクトとして開きます。デスクトップでは、フォルダはディスク上の元の場所に残ります。 |
| Clone Repository(デスクトップ) | Gitリポジトリをクローンして開きます。バージョン管理を参照してください。 |
ホームページ上部の入力欄にプロジェクトの説明を書いて送信することもできます。Embedrがプロジェクトを作成し、その説明をエージェントに渡します。
最近のプロジェクト
Recent Projects には、Embedrが把握しているすべてのプロジェクトが、件数と相対的な日時とともに一覧表示されます。
- Filter projects... で名前による絞り込みができます。
- 並べ替えメニューで Last opened と Recently created を切り替えます。
- 行にカーソルを合わせると、Rename project とゴミ箱アイコンの操作が表示されます。
ゴミ箱アイコンの動作は、プロジェクトの場所によって異なります。
| プロジェクト | ゴミ箱アイコン | 結果 |
|---|---|---|
| Embedr内で作成 | Delete project | プロジェクトフォルダが削除されます。元に戻せません。 |
| Open Folder で開いた、またはクローンした | Remove from Embedr | 一覧の項目だけが消えます。フォルダはディスク上の元の場所に残ります。 |
Open Folder で開いたフォルダは、一覧から名前を変更できません。ディスク上で名前を変更してください。
旧形式のArduinoスケッチ
ルートに .ino スケッチがあり embedr.yaml がないフォルダを開くと、ツールバーには Compile と Flash の代わりに Migrate Project が表示されます。移行すると src/main.ino と embedr.yaml が作成され、ルートの古い .ino は削除されます。移行が終わると、CompileとFlashが表示されます。プロジェクトの構造を参照してください。
エージェントビューとIDEビュー
Agent / IDE の切り替えはタイトルバーの中央にあります。選択は記憶されます。
| 領域 | エージェントビュー | IDEビュー |
|---|---|---|
| 左パネル | チャット履歴(スレッド) | ファイルエクスプローラー |
| 中央 | エージェントのチャット | エディタのタブ |
| 右パネル | エディタのタブ | エージェントのチャット |
タイトルバーの2つのボタンで、サイドパネルの表示と非表示を切り替えます。
- 左のボタン(エージェントビューでは Toggle Chat History、IDEビューでは Toggle File Explorer)。
- 右のボタン(エージェントビューでは Toggle Editor Panel、IDEビューでは Toggle Chat with Agent)。
同じタイトルバーに Keyboard shortcuts と Settings もあります。パネル間の区切りをドラッグすると、サイズを変えられます。
作業の大部分をエージェントに任せ、主にレビューする場合はエージェントビューを使います。自分でコードを編集しながらエージェントをそばに置きたい場合はIDEビューを使います。
下部ツールバー
エディタ下部のツールバーには、左から次のものがあります。
| コントロール | 用途 |
|---|---|
| 戻る矢印 | Back to Home。未保存の変更があるファイルがあれば、先に保存するか確認されます。 |
| ターゲット、デバイス、環境のピッカー | 何向けにビルドし、どこに書き込むか。ターゲットと環境を参照してください。 |
| Share | プロジェクトへのリンクを公開します。プロジェクトの共有を参照してください。 |
| ブランチボタン | Gitメニューを開きます。バージョン管理を参照してください。 |
| Compile と Flash | ファームウェアをビルドして書き込みます。ビルド、書き込み、シリアルを参照してください。 |
| 検索アイコン | プロジェクト検索を開きます(Cmd/Ctrl+Shift+F)。 |
エレクトロニクスのみのプロジェクトでは、ターゲット、デバイス、環境、Compile、Flashのコントロールは表示されません。
ファイルエクスプローラー
ファイルエクスプローラーには、プロジェクトフォルダがディスク上の状態のまま表示されます。ヘッダーには Toggle Search、New File、New Folder、Refresh、Collapse All の5つのボタンがあります。Toggle Search を押すと Search files... ボックスが表示され、名前でツリーを絞り込めます。
ファイルやフォルダを右クリックするとメニューが表示されます。
| 項目 | メモ |
|---|---|
| New File、New Folder | クリックしたフォルダの中に作成します。 |
| Copy、Cut、Paste | 1つの項目にも、複数選択した項目にも使えます。 |
| Rename | 1度に1つずつ。 |
| Delete | 確認を求められます。Embedrからは削除を元に戻せません。 |
| Reveal in Finder | システムのファイルマネージャーで項目を表示します(デスクトップ)。 |
選択とキーボード操作:
- Cmd/Ctrl+クリック で項目を選択に追加し、Shift+クリック で範囲を選択します。
- 矢印キーでツリー内を移動し、Right でフォルダを展開、Left で折りたたみ、Enter で項目を開きます。
- F2 で名前を変更し、Cmd/Ctrl+C、Cmd/Ctrl+X、Cmd/Ctrl+V でコピー、切り取り、貼り付けをします。
- Cmd+Backspace(macOS)または Ctrl+Delete(WindowsとLinux)で削除します。
デスクトップからファイルをエクスプローラーにドラッグすると、プロジェクトのルートにコピーされます。
エクスプローラーには、プロジェクトに追加したPDFを表示する Datasheets セクションもあります。データシートを参照してください。
エージェント、ターミナルのコマンド、Git、他のエディタなど、エディタの外で行われた変更は、自動的にツリーに反映されます。表示が古いと感じたら Refresh を使ってください。
タブ
開いている各ファイルやビューは、エディタ領域の上にタブとして表示されます。
- タブの琥珀色の点は、未保存の変更があることを示します。
- タブはドラッグで並べ替えられます。
- Cmd/Ctrl+W でアクティブなタブを閉じます。
- タブを右クリックすると、Save(未保存の変更がある場合)、Close、Close Others、Close Tabs to the Left、Close Tabs to the Right、Close All が使えます。
Add tabメニュー
タブバーの末尾にある + ボタン(タブがないときは Open Tab)で、ファイル以外のビューを開きます。
| グループ | ビュー |
|---|---|
| Workspaces | Schematics、Board、Mechanical |
| Tools | Terminal、Serial Monitor、Output、BOM、Manufacturing |
| (区切り線の下) | Review Changes、Settings |
それぞれの説明ページ:
- Schematics と Board:回路図とPCB、ボードとKiCad
- Mechanical:機構設計
- BOM と Manufacturing:製造と注文
- Terminal:ターミナルとセットアップ
- Serial Monitor と Output:ビルド、書き込み、シリアル
- Review Changes:バージョン管理
- Settings(Cmd/Ctrl+, でも開けます):設定とプライバシー
タブが1つも開いていないときは、エディタ領域に Search files、Terminal、Schematics、Board、Mechanical、Settings へのショートカットが表示されます。
共有プロジェクトの固定タブ
他の人が共有したプロジェクトをブラウザで開くと、READMEと、オーナーが Opens with で選んだビューがタブバーの先頭に固定されます。これらには閉じるボタンがなく、他のタブをその前にドラッグすることもできません。プロジェクトの共有を参照してください。
ファイルの開かれ方
Embedrはファイル名からエディタやプレビューを選びます。
| ファイル | 開き方 |
|---|---|
ソースと設定:.c、.h、.cpp、.hpp、.ino、.py、.ini、.json、.yaml、.toml、.s、.ld、CMake、Makefileなど |
シンタックスハイライト付きのコードエディタ |
embedr.yaml、platformio.ini |
専用のファイルアイコン付きのコードエディタ |
.zen(Zenerのハードウェアソース) |
Zenerのハイライト、補完、ホバーヘルプ、定義へ移動、インラインの問題マーカー付きのコードエディタ |
KiCadのテキストファイル:.kicad_sch、.kicad_pcb、.kicad_sym、.kicad_mod、.kicad_pro、.kicad_dru、fp-lib-table、sym-lib-table |
KiCadのハイライト付きのコードエディタ |
.md |
Markdownプレビュー(編集可能)とソース表示 |
.png、.jpg、.gif、.svg、.webp、.bmp |
画像プレビュー |
.pdf |
PDFビューア |
.step、.stp、.stl、.glb、.3mf などの3Dモデル、ファームウェアのバイナリ(.bin、.hex、.elf)、アーカイブ |
表示のみ |
KiCadのソースファイルはテキストとして開きます。基板や回路図を描画して見るには、Board タブや Schematics タブを開きます。3Dモデルを見るには Mechanical タブを使います。
コードエディタの下のバーにはカーソルの行と列が表示されます。クリックする(または Cmd/Ctrl+G を押す)と、指定した行に移動できます。
保存
- Cmd/Ctrl+S でアクティブなファイルを、Cmd/Ctrl+Shift+S ですべてのファイルを保存します。
- CompileとFlashは、先に開いているすべてのファイルを保存します。
- Settings → Editor → Auto Save on Focus Loss をオンにすると、エディタの外をクリックしたときに保存されます。
- 保存に失敗すると、エディタの下に Retry save リンクが表示されます。
Markdownプレビュー
Markdownファイルはプレビューで開きます。プレビューは編集可能で、直接入力でき、相対パスで参照した画像はプロジェクトから読み込まれます。Cmd/Ctrl+Shift+V でプレビューとソースエディタを切り替えます。
読み取り専用の共有プロジェクトでは、Markdownは常にプレビューで表示されます。
検索
- Cmd/Ctrl+P または Cmd/Ctrl+Shift+F で Search codebase... が開き、プロジェクト内のすべてのファイルのテキストを検索します。矢印キーと Enter で結果を開き、Esc で閉じます。
- Cmd/Ctrl+F で現在のファイル内を検索し、Cmd+Option+F(macOS)または Ctrl+H で置換します。
- Cmd/Ctrl+= と Cmd/Ctrl+- でエディタの文字サイズを変更します。
すべてのショートカットは、タイトルバーのキーボードアイコンとキーボードショートカットで確認できます。
選択範囲をチャットに追加する
テキストを選択すると、選択範囲の横に Add to Chat ボタンが表示されます。選択したテキストをそのまま、エージェントへの次のメッセージに追加します。次の場所で使えます。
- コードエディタ
- Output タブ
- Serial Monitor
- Terminal(右クリックメニューにもあります)
選択範囲は絞り込みましょう。ビルドログ全体ではなく失敗したコンパイラのエラーを、1時間分の出力ではなく不具合の前後10行のシリアル出力を選びます。
Add to Chat (Output tab):
src/main.cpp:42:5: error: 'dht' was not declared in this scope
Prompt:
Fix this build error. The sensor is a DHT22 on GPIO 4.
