
# インストール

どの拡張機能もまだ Zed の拡張機能レジストリーにないので、Zed の Extensions ページでは見つかりません。それらは **開発用の拡張機能** としてインストールします。Zed は自分のコンピューターのフォルダーからそれらをビルドし、そこから読み込みます。それがコマンド `zed: install dev extension` が行うことであり、インストールスクリプトが代わりに行うことです。

| 拡張機能 | リポジトリ | フォルダー |
|---|---|---|
| [Flutter Tools](flutter-tools.md) | [farum-azula/zed_editor_extensions](https://github.com/farum-azula/zed_editor_extensions) | `flutter-extension` |
| [HTTP Client](http-client.md) | [farum-azula/zed_editor_extensions](https://github.com/farum-azula/zed_editor_extensions) | `http-client-extension` |
| [Farum Azula Themes](themes.md) | [farum-azula/zed_editor_extensions](https://github.com/farum-azula/zed_editor_extensions) | `theme-extension` |
| [Spring for Dart](spring-for-dart.md) | [farum-azula/spring_core_dart](https://github.com/farum-azula/spring_core_dart) | `extensions/zed/dart_spring` |

インストールスクリプトが対象にするのは、zed_editor_extensions リポジトリの三つの拡張機能です。Spring for Dart はフレームワークのリポジトリにあり、`zed: install dev extension` でインストールします ([Spring for Dart](#spring-for-dart) を参照)。

## 必要なもの

- [Zed](https://zed.dev)。タスク、ランナブル、デバッガーを持つ最近のバージョン。
- `rustup` でインストールした [Rust](https://rustup.rs)。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 の拡張機能を取り除きます。

1. Extensions ページを開きます。コマンドパレットで `zed: extensions` です。
2. インストール済みの拡張機能の中から **Dart** を見つけ、**Uninstall** を押します。
3. `settings.json` に `"auto_install_extensions": { "dart": true }` がある場合は、そのエントリーを取り除いてください。そうしないと Zed が Dart を再びインストールします。

Dart の言語サーバーの設定 (`"lsp": { "dart": ... }`) はそのまま残り、動き続けます。

## インストールスクリプトで

リポジトリをクローンし、そのルートからシステム用のスクリプトを実行します。スクリプトは、Zed がまだ持っていないリポジトリのすべての拡張機能をインストールします。

### macOS と Linux

```sh
git clone https://github.com/farum-azula/zed_editor_extensions.git
cd zed_editor_extensions
./install.sh
```

出力は、進むにつれて各拡張機能の名前を示します。

```text
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 で:

```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 リポジトリにあります。

```sh
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` に置きます。

```sh
cd spring_core_dart
dart run tool/install_language_server.dart   # dart_spring_lsp を ~/.pub-cache/bin にインストールする
```

その後、SpEL とプレースホルダーの色のためにセマンティックハイライトを有効にします。[設定](spring-for-dart.md#設定) を参照してください。

## インストールを確認する

- 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` で新しいバージョンになります。

```sh
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](https://rustup.rs) で 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 をインストールする前に](None#flutter-tools-をインストールする前に) を参照)。
