インストール
どの拡張機能もまだ Zed の拡張機能レジストリーにないので、Zed の Extensions ページでは見つかりません。それらは 開発用の拡張機能 としてインストールします。Zed は自分のコンピューターのフォルダーからそれらをビルドし、そこから読み込みます。それがコマンド zed: install dev extension が行うことであり、インストールスクリプトが代わりに行うことです。
| 拡張機能 | リポジトリ | フォルダー |
|---|---|---|
| Flutter Tools | farum-azula/zed_editor_extensions | flutter-extension |
| HTTP Client | farum-azula/zed_editor_extensions | http-client-extension |
| Farum Azula Themes | farum-azula/zed_editor_extensions | theme-extension |
| Spring for Dart | farum-azula/spring_core_dart | extensions/zed/dart_spring |
インストールスクリプトが対象にするのは、zed_editor_extensions リポジトリの三つの拡張機能です。Spring for Dart はフレームワークのリポジトリにあり、zed: install dev extension でインストールします (Spring for Dart を参照)。
必要なもの
- Zed。タスク、ランナブル、デバッガーを持つ最近のバージョン。
rustupでインストールした Rust。Zed とスクリプトは、各拡張機能の Rust のコードを WebAssembly にコンパイルします。スクリプトはwasm32-wasip2ターゲットを自分で追加します。git。- 初回はインターネット接続。tree-sitter の文法のソースと、Zed が使う wasi-sdk のコンパイラーが、Zed 自身のキャッシュにダウンロードされます。
さらに、各拡張機能は扱うものを必要とします。
| 拡張機能 | 追加で必要なもの |
|---|---|
| Flutter Tools | PATH 上の Flutter、または fvm。Zed の Dart の拡張機能を先にアンインストールしなければならない |
| HTTP Client | なし: ランナーをダウンロードするか、cargo でビルドする |
| Farum Azula Themes | なし |
| Spring for Dart | Apple Silicon の Mac、Linux の x64 と arm64、Windows の x64 ではなし: 言語サーバーをダウンロードする。それ以外では、それをビルドするための Dart SDK |
Flutter Tools をインストールする前に
Flutter Tools は Dart の言語を定義し、二つの拡張機能が両方でそれを定義することはできません。まず Zed の Dart の拡張機能を取り除きます。
- Extensions ページを開きます。コマンドパレットで
zed: extensionsです。 - インストール済みの拡張機能の中から Dart を見つけ、Uninstall を押します。
settings.jsonに"auto_install_extensions": { "dart": true }がある場合は、そのエントリーを取り除いてください。そうしないと Zed が Dart を再びインストールします。
Dart の言語サーバーの設定 ("lsp": { "dart": ... }) はそのまま残り、動き続けます。
インストールスクリプトで
リポジトリをクローンし、そのルートからシステム用のスクリプトを実行します。スクリプトは、Zed がまだ持っていないリポジトリのすべての拡張機能をインストールします。
macOS と Linux
git clone https://github.com/farum-azula/zed_editor_extensions.git
cd zed_editor_extensions
./install.sh
出力は、進むにつれて各拡張機能の名前を示します。
flutter-tools: installing from flutter-extension
building extension.wasm
building grammars/dart.wasm
building grammars/dartdoc.wasm
flutter-tools: installed
http-client: installing from http-client-extension
building extension.wasm
building grammars/http.wasm
http-client: installed
farum-azula-theme: installing from theme-extension
farum-azula-theme: installed
拡張機能は Zed の拡張機能のフォルダーに入ります。macOS では ~/Library/Application Support/Zed/extensions、Linux では ~/.local/share/zed/extensions (または $XDG_DATA_HOME/zed/extensions) です。
Windows
PowerShell で:
git clone https://github.com/farum-azula/zed_editor_extensions.git
cd zed_editor_extensions
powershell -ExecutionPolicy Bypass -File install.ps1
拡張機能は %LOCALAPPDATA%\Zed\extensions に入ります。スクリプトは macOS と Linux の PowerShell 7 でも動きます。
スクリプトが行うこと
extension.toml を持つ最上位の各フォルダーについて、スクリプトは拡張機能の id を読み、Zed がすでにそれを持っていればスキップします (<id>: already installed)。そうでなければ次のことを行います。
cargo build --release --target wasm32-wasip2で、拡張機能の Rust のコードをextension.wasmにビルドします。extension.tomlが固定するコミットで各 tree-sitter の文法を取得し、Zed がダウンロードするのと同じバージョンの wasi-sdk で、同じ場所にgrammars/<name>.wasmとしてコンパイルします。- Zed が開発用の拡張機能に対して行うのと同じように、フォルダーを Zed の
extensions/installedフォルダーにリンクします。macOS と Linux ではシンボリックリンク、Windows ではジャンクションです。
実行中の Zed は、再起動なしにすぐに拡張機能を拾います。二つの環境変数でデフォルトを変えられます。
| 変数 | 効果 |
|---|---|
ZED_EXTENSIONS_DIR |
別の Zed の拡張機能のフォルダーにインストールする |
WASI_SDK_PATH |
ダウンロードする代わりに既存の wasi-sdk を使う |
一つずつ
どの拡張機能も、Zed から単独でインストールできます。
- リポジトリをクローンします。
- コマンドパレット (macOS では
Cmd-Shift-P、Linux と Windows ではCtrl-Shift-P) を開き、zed: install dev extensionを実行します。 zed_editor_extensions/http-client-extensionのような、拡張機能のフォルダーを選びます。
Zed は拡張機能とその文法をコンパイルし、Extensions ページにそれを列挙します。
Spring for Dart
Spring for Dart の拡張機能は spring_core_dart リポジトリにあります。
git clone https://github.com/farum-azula/spring_core_dart.git
次に Zed で zed: install dev extension を実行し、spring_core_dart/extensions/zed/dart_spring を選びます。Zed は Rust の部分を自分でビルドし (rustup の Rust が必要です)、Properties の文法をコンパイルします。
言語サーバーは、初めて Dart ファイルを開いたときにダウンロードされます。拡張機能のバージョンのネイティブのバイナリーで、spring_core_dart の GitHub リリース v<version> から取得されます。Zed はステータスバーにダウンロードを表示します。Intel の Mac のようにビルド済みのバイナリーがないプラットフォームでは、クローンからサーバーをビルドし、PATH に置きます。
cd spring_core_dart
dart run tool/install_language_server.dart # dart_spring_lsp を ~/.pub-cache/bin にインストールする
その後、SpEL とプレースホルダーの色のためにセマンティックハイライトを有効にします。設定 を参照してください。
インストールを確認する
- Extensions ページ (
zed: extensions) に、各拡張機能がインストール済みのものとして列挙されます。 .httpファイルを開くと、右下の言語が HTTP になり、各リクエストの横に ▶ が現れます。- Flutter プロジェクトで Dart ファイルを開くと、
task: spawnがFlutter: run on ...を列挙します。 theme selector: toggleを実行すると、Farum Azula Dark と Farum Azula Transparent がリストにあります。- Spring のプロジェクトで Dart ファイルを開き、コンストラクターのパラメーターの型にホバーすると、候補の Bean が列挙されます。
更新
拡張機能はクローンから動くので、git pull で新しいバージョンになります。
cd zed_editor_extensions
git pull
./install.sh
スクリプトを再び実行すると、前回以降に追加された拡張機能がインストールされ、インストール済みのものはそのままです。インストール済みのものについては、Zed が新しいバージョンを読み込むように、Extensions ページの各拡張機能の横にある Rebuild を押します。HTTP Client は、次の起動時に新しいバージョンのランナーをインストールします。
Spring for Dart も同じ方法で更新します。spring_core_dart のクローンで git pull を実行し、Rebuild を押します。新しいバージョンの言語サーバーは、次の起動時にダウンロードされます。
アンインストール
Extensions ページの拡張機能の横にある Uninstall を押します。Zed のフォルダーへのリンクが取り除かれ、クローンはそのまま残ります。Flutter Tools をアンインストールした後は、Dart のサポートを保つために Zed の Dart の拡張機能を再びインストールしてください。
トラブルシューティング
cargo: command not found。 rustup で Rust をインストールし、新しいターミナルを開いてください。
wasm ターゲットでビルドが失敗する。 rustup target add wasm32-wasip2 を実行してください。rustup のものでない Rust では、ターゲットを追加できません。rustup をインストールしてください。
wasi-sdk is not available for ...。 スクリプトは macOS (Apple Silicon と Intel) と Linux (x64 と arm64) 向けの wasi-sdk をダウンロードします。その他のシステムでは、WASI_SDK_PATH にインストール済みの wasi-sdk を設定してください。
スクリプトの実行後に拡張機能が現れない。 Zed のログ (zed: open log) で理由を確認してください。移動または削除されたクローンが残したリンクは、次の実行時にスクリプトが取り除きます。
Dart がすでに定義されているため Flutter Tools の読み込みに失敗する。 Zed の Dart の拡張機能をアンインストールしてください (Flutter Tools をインストールする前に を参照)。