Visual Studio Codeのドキュメントの和訳です。
原文
Extending Visual Studio Code(外部サイト)
訳文
あなたが、VS Codeを拡張することに興味を持っている場合、あなたは、適切な場所にいます。 下記は、VS Codeの拡張のドキュメンテーションとどのように、すばやく、あなたの最初のVS Codeの拡張を構築するかの概要です。 あなたが、VS Codeのための拡張性に、私達の設計アプローチを知りたい場合、あなたは、それについて、ここで、読むことができます。
ヒント:
拡張を記述することなく、VSコードをカスタマイズするための、いくつかの方法があることを忘れないでください。 これには、コードを1行も記述することのない、テーマの追加、基本的な言語のサポートとスニペットが含まれています。
すべてのVS Codeの拡張は、VS Code拡張APIへの、貢献(登録)、アクティブ化(読み込み)とアクセスの一般的なモデルを共有しています。 しかしながら、VS Code拡張の2つの独特の特色があります。 言語サーバとデバッガ、それは、それら独自の追加されたプロトコルを持ち、そして、ドキュメンテーションのそれら独自の項目を取り扱います。
- 拡張-基本構成単位
- 言語サーバ-高コストIOやCPU集約型のためのタスク
- デバッガ-外部デバッガを接続します。
拡張
Extensions
私たちが共有する拡張ホストプロセス内で、アクティブ化して起動するときのすべての拡張。 拡張のためのこの別々のプロセスは、VS Codeが、最初から最後まで、反応し続けることを確認します。 拡張は、以下のサポートが含まれています。:
- アクティベーション-特定のファイルタイプが検出されたとき、特定のファイルが存在するとき、 あるいは、コマンドが、Command Paletteやキーの組み合わせによって選択されるとき、拡張を読み込みます。
- エディタ-エディタの内容を操作します-テキストを読み込み、操作し、選択(複数可)を活用します
- 作業スペース-作業ファイル、ステータス・バー、情報メッセージなど、を呼び出します
- イベンティング-エディタに、開く、閉じる、変更するなどのような、ライフサイクル・イベントを結合します
- 進化した編集-IntelliSense、Peek、Hover、診断などを含む、高機能な言語サポートを提供します。
私たちは、あなたが、拡張の基礎を会得するための、2つの徹底的なチュートリアルを持っています。:
- Hello World-基本的な拡張を作成します。拡張のフォルダ構造、拡張マニフェストを理解します。 アクティブ化が、どのように動作するかについて学びます。あなたの拡張を実行し、デバッグし、そして、それをローカルにインストールします。
- ワード・カウント-特定のファイルタイプに基づいて起動します。ステータス・バーを更新し、テキストエディタで変化に対応します。 そして、ファイルを移動するとき、あなたの拡張を取り除きます。
言語サーバ
Language Servers
言語サーバは、あなたが、あなたの拡張のための専用のプロセスを作成できます。これは、あなたの拡張のための、役に立つデザインの選択です。 あなたの拡張が、高いコストCPUやIO集約型のタスクを実行するとき、これは、他の拡張機能を遅くすることになります。 これは、作業スペースのすべてのファイルに渡って作業するタスクで一般的です。例えば、リンターや静的解析スイート。
詳細については、言語サーバをご覧ください。
デバッガ
Debuggers
[どんな言語でも記述された]デバッガをVS Codeに結合することが、デバッグ・サービスを作成することで可能です。
詳細については、デバッガの統合をご覧ください。
VS Code拡張の動作を見るための最も簡単な方法は、Extension Galleryにあります。あなたは、役に立つ拡張を閲覧することができます。 それらを試し、あなたが、あなた独自の開発の筋書きのために、どのように、VS Codeを拡張するかもしれない発想を得るために、インストールします。
拡張を記述する
Writing an Extension
拡張は、TypeScriptやJavaScriptのどちらでも記述することができます。VS Codeは、最高級の拡張の開発経験を提供します。 すべてVS Codeそのもの内で、あなたが、開発、構築、実行、検証、そして、デバッグすることができます。
インストールと共有
Install and Share
あなたが、一旦、動作する拡張を取得すると、あなたは、それをインストール、あるいは、他の人と共有することができます。 私たちは、公開されたExtension Galleryに、ローカル・インストール、公開されない共有や公開をサポートしています。
テストの拡張
Testing Extensions
また、私たちは、あなたの拡張のための書き込みと実行テストするための素晴らしいサポートを持っています。 あなたは、VS CodeのAPIを呼び出す、統合テストを簡単に作成することができます。 そして、VS Codeのインスタンスを実行し、あなたのコードを検証します。
次の手順
Next Steps
- あなたの初めてのExtension-簡単なHello World拡張を作成してみてください。
- 拡張API-VS Codeの拡張APIについて学ぶ
- サンプル-あなたが、検討し、構築することができる拡張サンプルのリスト
一般的な質問
Common Questions
まだ、何もありません。