Resolver caminhos relativos

Todos os caminhos de arquivo relativos usados em arquivos de configuração (devproxyrc.json) são relativos ao local do arquivo de configuração. Caminhos que começam com ~/ a resolução para o diretório base.

No exemplo abaixo, o pluginPath é relativo ao arquivo de configuração. O arquivo de configuração de devproxyrc.json padrão está localizado no mesmo local em que a pasta plugins existe.

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

O token ~appFolder

Digamos que você inicie o proxy de um diretório diferente, como no local de um projeto em que você está trabalhando.

Se houver um arquivo de configuração devproxyrc.json no diretório atual, a resolução do caminho do arquivo será relativa a esse arquivo. Caso contrário, o proxy retornará ao arquivo de devproxyrc.json padrão.

O uso de um arquivo de configuração que não está localizado no diretório de instalação do proxy exige que você verifique se os caminhos do plug-in são resolvidos corretamente.

Use o token ~appFolder nos caminhos do arquivo para garantir que o caminho seja anexado com o caminho absoluto para o diretório de instalação do proxy.

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

O token ~appFolder pode ser usado em qualquer caminho usado pelo proxy.

O token ~dataFolder

O ~dataFolder token é resolvido para o diretório de dados do usuário do Proxy de Desenvolvimento. Essa pasta é separada do diretório de instalação e não é afetada por atualizações. As configurações baixadas com devproxy config get esta pasta são armazenadas.

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

Digamos que você queira carregar uma configuração predefinida, pode usar o token ~appFolder no caminho para fazer referência ao arquivo de configuração localizado no diretório de instalação do proxy.

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

O atalho do diretório base

Um caminho que começa com ~/ resolves para o diretório inicial em vez do local do arquivo de configuração. No Windows, você também pode usar ~\. Use esse atalho para referenciar arquivos que você mantém em seu diretório inicial, como arquivos fictícios compartilhados.

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

O atalho funciona em qualquer caminho usado pelo proxy, incluindo a opção --config-file :

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

O Proxy de Desenvolvimento expande apenas um leading ~/. Ele não se expande ~ por conta própria, ~ seguido por um nome como ~mocks/mocks.json, ou ~ no meio de um caminho como mocks/~/mocks.json.