Rozwiązywanie problemów ze ścieżkami względnymi

Wszystkie względne ścieżki plików używane w plikach konfiguracji (devproxyrc.json) są powiązane z lokalizacją pliku konfiguracji. Ścieżki rozpoczynające się ~/ od rozpoznawania katalogu macierzystego.

W poniższym przykładzie pluginPath jest względem pliku konfiguracji. Domyślny plik konfiguracji devproxyrc.json znajduje się w tej samej lokalizacji, w której istnieje folder plugins.

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

Token ~appFolder

Załóżmy, że uruchamiasz serwer proxy z innego katalogu, na przykład z lokalizacji projektu, w którym pracujesz.

Jeśli plik konfiguracji devproxyrc.json istnieje w bieżącym katalogu, rozdzielczość ścieżki pliku jest względna względem tego pliku. Jeśli nie, serwer proxy powróci do domyślnego pliku devproxyrc.json.

Użycie pliku konfiguracji, który nie znajduje się w katalogu instalacyjnym serwera proxy, wymaga upewnienia się, że ścieżki wtyczek są poprawnie rozpoznawane.

Użyj tokenu ~appFolder w ścieżkach plików, aby upewnić się, że ścieżka jest poprzedzana ścieżką bezwzględną do katalogu instalacyjnego serwera proxy.

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

Token ~appFolder może być używany w dowolnej ścieżce używanej przez serwer proxy.

Token ~dataFolder

Token ~dataFolder jest rozpoznawany jako katalog danych użytkownika serwera proxy dewelopera. Ten folder jest oddzielony od katalogu instalacyjnego i nie ma to wpływu na uaktualnienia. Konfiguracje pobrane za pomocą devproxy config get są przechowywane w tym folderze.

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

Załóżmy, że chcesz załadować wstępnie ustawioną konfigurację, możesz użyć tokenu ~appFolder w ścieżce, aby odwołać się do pliku konfiguracji znajdującego się w katalogu instalacyjnym serwera proxy.

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

Skrót do katalogu głównego

Ścieżka rozpoczynająca się ~/ od rozpoznawanego katalogu macierzystego zamiast lokalizacji pliku konfiguracji. W Windows można również użyć polecenia ~\. Ten skrót służy do odwoływania się do plików, które są przechowywane w katalogu głównym, takich jak udostępnione pliki makiety.

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

Skrót działa w dowolnej ścieżce używanej przez serwer proxy, w tym w --config-file opcji:

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

Serwer proxy deweloperski rozszerza tylko wiodący element ~/. Nie rozwija ~ się samodzielnie, ~ po której następuje nazwa, taka jak ~mocks/mocks.json, lub ~ w środku ścieżki, takiej jak mocks/~/mocks.json.