Visual Studio Codeの拡張機能ビューで「…」メニューから「VSIXからインストール」を選び、ダウンロードしたファイルを指定する
.ondファイルを開くと拡張が有効になる
Language Serverは拡張に同梱されているため、利用者がRustやNode.jsを別途インストールする必要はありません。
拡張の起動時に実行ファイルをダウンロードすることもありません。
主な機能
Ondファイルの構文色分け、コメント、括弧の入力支援
Language Serverによる診断、補完、型情報の表示
定義への移動(F12)と参照の検索(Shift+F12)
変数や関数などの名前変更(F2)とsemantic highlighting
「Ond Dark Theme」配色
名前変更はpackage名、import alias、組み込みsymbol、外部依存内の宣言には対応していません。
Ond 0.2.0のoperator宣言形式と型付きpointerのindex読み書きを含む言語機能に対応しています。
旧load32/store32呼び出しは、型付きpointerのindex読み書きへ移行してください。
開発
開発にはNode.js 22が必要です。
npm ci
npm run check
正式な配布物は、ロックされたOnd ReleaseからWindows x64またはLinux x64向けに作成します。 npm run package:releaseとnpm run package:vsixは正式配布用の処理です。
実際のVisual Studio Code上で統合確認する場合はnpm run test:integrationを使用します。
未公開Ond sourceの確認ではnpm run test:ond-source -- <Ond checkout> <commit SHA> <version>を使用できます。
この確認では指定sourceからLanguage Serverをbuildし、非公開の検証用VSIXへ同梱します。
正式配布用lockや公開経路には接続しません。
正式lockで採用したOnd 0.4.0とsource確認の両方で、asmの式補完、role文脈の補完、test名を含むfileの通常補完、importとinterfaceの互換性を検査します。
依存packageはond.tomlの[dependencies]へ登録し、importには依存先のproject名を使います。
Ond 0.3.0以降ではOND_PATH環境変数と--library-dir optionによる依存指定を使いません。
正式配布用lockはOnd 0.4.0のGitHub Release(commit a40d63fd79219e8a4eee1be88821b6ac8fdc9e6f)を固定しています。
公開前にWindows/Linux両hostで配布検証を完了する必要があります。
インストール済みVisual Studio Codeを使う場合は、実行前にOND_LOCAL_VSCODE_EXECUTABLEへCode.exeの絶対パス、OND_LOCAL_VSCODE_CLIへ同じインストール内のresources/app/out/cli.jsの絶対パスを設定します。
この指定は非公開source laneだけで有効です。
統合確認は一時的なuser-dataと拡張機能profileを使い、通常の利用者profileには触れません。