Lösa relativa sökvägar

Alla relativa filsökvägar som används i konfigurationsfiler (devproxyrc.json) är relativa till platsen för konfigurationsfilen. Sökvägar som börjar med ~/ att matcha din hemkatalog.

I exemplet nedan är pluginPath relativt konfigurationsfilen. Standardkonfigurationsfilen devproxyrc.json finns på samma plats där mappen plugins finns.

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

~appFolder-token

Anta att du startar proxyn från en annan katalog, till exempel från platsen för ett projekt som du arbetar i.

Om det finns en devproxyrc.json konfigurationsfil i den aktuella katalogen är filsökvägsmatchningen relativ till den här filen. Annars återgår proxyn till standardfilen devproxyrc.json.

Om du använder en konfigurationsfil som inte finns i proxyinstallationskatalogen måste du se till att plugin-sökvägarna matchas korrekt.

Använd ~appFolder-token i filsökvägarna för att se till att sökvägen förbereds med den absoluta sökvägen till proxyinstallationskatalogen.

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

Den ~appFolder token kan användas i valfri sökväg som används av proxyn.

~dataFolder-token

Token ~dataFolder matchar användardatakatalogen för Dev Proxy. Den här mappen är separat från installationskatalogen och påverkas inte av uppgraderingar. Konfigurationer som laddas ned med devproxy config get lagras i den här mappen.

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

Anta att du vill läsa in en förinställd konfiguration. Du kan använda ~appFolder token i sökvägen för att referera till konfigurationsfilen som finns i proxyinstallationskatalogen.

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

Genvägen till hemkatalogen

En sökväg som börjar med ~/ matchar din hemkatalog i stället för platsen för konfigurationsfilen. På Windows kan du också använda ~\. Använd den här genvägen för att referera till filer som du har i din hemkatalog, till exempel delade mock-filer.

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

Genvägen fungerar i valfri sökväg som används av proxyn, inklusive alternativet --config-file :

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

Dev Proxy expanderar endast en ledande ~/. Den expanderar ~ inte på egen hand, ~ följt av ett namn som ~mocks/mocks.json, eller ~ mitt i en sökväg som mocks/~/mocks.json.