相対パスを解決する

構成ファイル (devproxyrc.json) で使用されるすべての相対ファイル パスは、構成ファイルの場所に対して相対的です。 ~/で始まるパスは、ホーム ディレクトリに解決されます。

次の例では、pluginPath は構成ファイルを基準にしています。 既定の devproxyrc.json 構成ファイルは、plugins フォルダーが存在する場所と同じ場所にあります。

{
  "name": "GraphSelectGuidancePlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
  "urlsToWatch": [
    "https://graph.microsoft.com/v1.0/*",
    ...
  ]
}

~appFolder トークン

たとえば、作業中のプロジェクトの場所など、別のディレクトリからプロキシを起動するとします。

現在のディレクトリに devproxyrc.json 構成ファイルが存在する場合、ファイル パスの解決はこのファイルに対して相対的です。 そうでない場合、プロキシは既定の devproxyrc.json ファイルにフォールバックします。

プロキシ インストール ディレクトリに配置されていない構成ファイルを使用するには、プラグイン パスが正しく解決されていることを確認する必要があります。

ファイル パスの ~appFolder トークンを使用して、パスの先頭にプロキシ インストール ディレクトリへの絶対パスが付加されていることを確認します。

{
  "name": "GraphSelectGuidancePlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
  "urlsToWatch": [
    "https://graph.microsoft.com/v1.0/*",
    ...
  ]
}

~appFolder トークンは、プロキシによって使用される任意のパスで使用できます。

~dataFolder トークン

~dataFolder トークンは、Dev Proxy ユーザー データ ディレクトリに解決されます。 このフォルダーはインストール ディレクトリとは別であり、アップグレードの影響を受けません。 devproxy config getでダウンロードした構成は、このフォルダーに格納されます。

devproxy --config-file ~dataFolder/configs/my-preset/devproxyrc.json

たとえば、事前設定された構成を読み込む場合、パスの ~appFolder トークンを使用して、プロキシ インストール ディレクトリにある構成ファイルを参照できます。

devproxy --config-file ~appFolder/config/microsoft-graph.json

ホーム ディレクトリのショートカット

~/で始まるパスは、構成ファイルの場所ではなくホーム ディレクトリに解決されます。 Windowsでは、~\を使用することもできます。 共有モック ファイルなど、ホーム ディレクトリに保持されているファイルを参照するには、このショートカットを使用します。

{
  "mocksPlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/mockresponseplugin.schema.json",
    "mocksFile": "~/mocks/mocks.json"
  }
}

ショートカットは、 --config-file オプションを含め、プロキシで使用される任意のパスで機能します。

devproxy --config-file "~/devproxy/devproxyrc.json"

開発プロキシは、先頭の ~/のみを拡張します。 単独では~展開されません。~、~mocks/mocks.jsonなどの名前が続いたり、mocks/~/mocks.jsonなどのパスの途中で~されたりすることはありません。