インストール

どの拡張機能もまだ 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 を参照)。

必要なもの

さらに、各拡張機能は扱うものを必要とします。

拡張機能 追加で必要なもの
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 の拡張機能を取り除きます。

  1. Extensions ページを開きます。コマンドパレットで zed: extensions です。
  2. インストール済みの拡張機能の中から Dart を見つけ、Uninstall を押します。
  3. 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)。そうでなければ次のことを行います。

  1. cargo build --release --target wasm32-wasip2 で、拡張機能の Rust のコードを extension.wasm にビルドします。
  2. extension.toml が固定するコミットで各 tree-sitter の文法を取得し、Zed がダウンロードするのと同じバージョンの wasi-sdk で、同じ場所に grammars/<name>.wasm としてコンパイルします。
  3. Zed が開発用の拡張機能に対して行うのと同じように、フォルダーを Zed の extensions/installed フォルダーにリンクします。macOS と Linux ではシンボリックリンク、Windows ではジャンクションです。

実行中の Zed は、再起動なしにすぐに拡張機能を拾います。二つの環境変数でデフォルトを変えられます。

変数 効果
ZED_EXTENSIONS_DIR 別の Zed の拡張機能のフォルダーにインストールする
WASI_SDK_PATH ダウンロードする代わりに既存の wasi-sdk を使う

一つずつ

どの拡張機能も、Zed から単独でインストールできます。

  1. リポジトリをクローンします。
  2. コマンドパレット (macOS では Cmd-Shift-P、Linux と Windows では Ctrl-Shift-P) を開き、zed: install dev extension を実行します。
  3. 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 とプレースホルダーの色のためにセマンティックハイライトを有効にします。設定 を参照してください。

インストールを確認する

更新

拡張機能はクローンから動くので、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 をインストールする前に を参照)。