Résoudre les chemins relatifs

Tous les chemins d’accès relatifs aux fichiers de configuration (devproxyrc.json) sont relatifs à l’emplacement du fichier de configuration. Chemins d’accès qui commencent par ~/ résoudre votre répertoire de base.

Dans l’exemple ci-dessous, le pluginPath est relatif au fichier de configuration. Le fichier de configuration devproxyrc.json par défaut se trouve à l’emplacement où se trouve le dossier plugins.

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

Jeton ~appFolder

Supposons que vous démarrez le proxy à partir d’un autre répertoire, par exemple à partir de l’emplacement d’un projet dans lequel vous travaillez.

Si un fichier de configuration devproxyrc.json existe dans le répertoire actif, la résolution du chemin d’accès du fichier est relative à ce fichier. Si ce n’est pas le cas, le proxy revient au fichier devproxyrc.json par défaut.

L’utilisation d’un fichier de configuration qui n’est pas situé dans le répertoire d’installation du proxy nécessite que les chemins d’accès du plug-in soient résolus correctement.

Utilisez le jeton ~appFolder dans les chemins d’accès du fichier pour vous assurer que le chemin d’accès est précédé du chemin absolu du répertoire d’installation du proxy.

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

Le jeton ~appFolder peut être utilisé dans n’importe quel chemin d’accès utilisé par le proxy.

Jeton ~dataFolder

Le ~dataFolder jeton est résolu dans le répertoire de données utilisateur du proxy de développement. Ce dossier est distinct du répertoire d’installation et n’est pas affecté par les mises à niveau. Les configurations téléchargées avec devproxy config get sont stockées dans ce dossier.

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

Supposons que vous souhaitez charger une configuration prédéfinie, vous pouvez utiliser le jeton ~appFolder dans le chemin d’accès pour référencer le fichier de configuration situé dans le répertoire d’installation du proxy.

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

Raccourci du répertoire d’accueil

Chemin d’accès qui commence par ~/ se résoudre dans votre répertoire de base au lieu de l’emplacement du fichier de configuration. Sur Windows, vous pouvez également utiliser ~\. Utilisez ce raccourci pour référencer les fichiers que vous conservez dans votre répertoire de base, tels que les fichiers fictifs partagés.

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

Le raccourci fonctionne dans n’importe quel chemin utilisé par le proxy, y compris l’option --config-file :

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

Le proxy de développement développe uniquement un principal ~/. Elle ne s’étend ~ pas elle-même, ~ suivie d’un nom tel que ~mocks/mocks.json, ou ~ au milieu d’un chemin tel que mocks/~/mocks.json.