デバッグタスク

デバッグのためにプロジェクトを設定します。

Novaは、コードにブレークポイントを設定したり、デバッグのためにアプリケーションを実行したり、実行中に変数の値を検査したり、アプリケーションからのコンソール出力を表示したりするなど、さまざまなデバッグ機能をサポートしています。

Nova内でコードをデバッグするには、まずデバッグタスクを設定する必要があります。これは、Debug Adapter Protocol (github.io) を使用してNovaを外部ツールに接続する特別なタイプのタスクです。Novaには多数のデバッグタスクが標準で含まれていますが、機能拡張によって追加の言語やツールをサポートするために独自のタスクを追加することもできます。

Adding a Debug Task in Project Settings.

含まれるタスク

Novaは、標準で以下のデバッグタスクをサポートしています:

Chrome: Google Chromeやその他の互換性のあるChromiumベースのブラウザで実行されているWebアプリケーションをデバッグします。
Deno: Denoランタイムを使用してWebアプリケーションをデバッグします。
Node.js: Node.jsランタイムを使用してWebアプリケーションをデバッグします。
PHP: 既存のサーバで実行されているPHPアプリケーションをデバッグします。
PHP Local Web Server: ローカルPHPサーバを起動し、デバッグのためにアプリケーションを実行します。
Python: ローカルで実行されているPythonアプリケーションをデバッグします。
Python Remote: リモートサーバで実行されているPythonアプリケーションをデバッグします。

追加のデバッグタスクは、機能拡張経由でNovaに追加できます。

前提条件

これらのタスクを使用するには、まずお使いのMacに特定の依存関係がインストールされていることを確認する必要があります。

Chrome

お使いのMacにGoogle Chrome、またはChrome DevTools Protocol (github.io) と互換性のある別のブラウザがインストールされている必要があります。

Deno と Node.js

それぞれのフレームワークがMacにインストールされており、シェルの $PATH 環境変数で利用可能である必要があります。

PHP

MacにPHPがインストールされていることを確認してください。Homebrew (brew.sh) を使用してbrew install phpを実行することでPHPをインストールできます。
PHP環境にXdebugがインストールされていることを確認してください。PECL (php.net) を使用してpecl install xdebug を実行することでXdebugをインストールできます。
php.ini ファイルがXdebugを有効にするように設定されていることを確認してください。通常、これはXdebugのインストールプロセスによって自動的に行われます。必要に応じて、php.ini ファイルに以下を手動で追加できます:

[xdebug]
xdebug.mode = "debug"

より詳しい情報

Xdebug Documentation (xdebug.org)

Python

Python 3.xが、グローバルに、またはプロジェクトの環境にインストールされていることを確認してください。
Python環境に debugpy がインストールされていることを確認してください。pip install debugpyを使用してdebugpy (pypi.org) をインストールできます。

注: 技術的には debugpy でPython 2.xを使用することも可能ですが、これはNovaによって公式にサポートされていません。

タスクの設定

他の種類のタスクと同様に プロジェクト設定 > タスク からプロジェクトにデバッグタスクを追加できます。追加したら、プロジェクト設定からタスクを設定できます。利用可能な設定は、使用するデバッグタスクによって異なります。

Chromeデバッグタスクで利用可能な設定

複数のタスクで見られる一般的な設定には、以下のようなものがあります:

起動タイプ: デバッグ用にサイトまたはアプリケーションのインスタンスを起動するか、既存の実行中のインスタンスにアタッチするかを選択します。
スクリプトパス: Pythonなどのスクリプト言語で書かれたアプリケーションをデバッグする場合、起動するエントリスクリプトを選択します。
ソースルートとローカルルート: 公開機能と同様に、これらの設定はサーバのファイルパスを対応するローカルのファイルパスにマッピングするために使用されます。

特定のデバッグタスクに固有の設定については、設定自体の下にドキュメントが表示されるはずです。