Risolvere i percorsi relativi

Tutti i percorsi di file relativi usati nei file di configurazione (devproxyrc.json) sono relativi al percorso del file di configurazione. Percorsi che iniziano con ~/ la risoluzione nella home directory.

Nell'esempio seguente il pluginPath è relativo al file di configurazione. Il file di configurazione devproxyrc.json predefinito si trova nella stessa posizione in cui è presente la cartella plugins.

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

Token ~appFolder

Si supponga di avviare il proxy da una directory diversa, ad esempio dalla posizione di un progetto in cui si sta lavorando.

Se nella directory corrente è presente un file di configurazione devproxyrc.json, la risoluzione del percorso del file è relativa a questo file. In caso contrario, il proxy esegue il fallback al file di devproxyrc.json predefinito.

L'uso di un file di configurazione che non si trova nella directory di installazione del proxy richiede di assicurarsi che i percorsi del plug-in vengano risolti correttamente.

Usare il token ~appFolder nei percorsi dei file per assicurarsi che il percorso venga anteporto al percorso assoluto della directory di installazione del proxy.

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

Il token ~appFolder può essere usato in qualsiasi percorso usato dal proxy.

Token ~dataFolder

Il ~dataFolder token viene risolto nella directory dei dati utente del proxy di sviluppo. Questa cartella è separata dalla directory di installazione e non è interessata dagli aggiornamenti. Le configurazioni scaricate con devproxy config get vengono archiviate in questa cartella.

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

Si supponga di voler caricare una configurazione predefinita, è possibile usare il token ~appFolder nel percorso per fare riferimento al file di configurazione che si trova nella directory di installazione del proxy.

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

Collegamento alla home directory

Percorso che inizia con ~/ viene risolto nella home directory anziché nel percorso del file di configurazione. In Windows è anche possibile usare ~\. Usare questo collegamento per fare riferimento ai file che si mantengono nella home directory, ad esempio file fittizi condivisi.

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

Il collegamento funziona in qualsiasi percorso usato dal proxy, inclusa l'opzione --config-file :

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

Dev Proxy espande solo un elemento iniziale ~/. Non si espande ~ autonomamente, ~ seguito da un nome come ~mocks/mocks.json, o ~ al centro di un percorso, mocks/~/mocks.jsonad esempio .