解析相对路径

配置文件中使用的所有相对文件路径(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 解析为开发代理用户数据目录。 此文件夹独立于安装目录,不受升级的影响。 下载的配置 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~。