Condividi tramite

Configurare il proxy di sviluppo

Dev Proxy è altamente configurabile. Usa i plugin per implementare le funzionalità. È possibile combinare uno dei plug-in standard e creare il proprio. Usando plug-in e configurazioni personalizzate, è possibile personalizzare Dev Proxy in base alle esigenze specifiche. Dev Proxy include un file di configurazione predefinito denominato devproxyrc.json. Il file si trova nella cartella di installazione di Dev Proxy.

Suggerimento

È consigliabile creare file di configurazione personalizzati. Usando file di configurazione personalizzati, è possibile passare facilmente da una configurazione all'altra e includerli nel sistema di controllo del codice sorgente insieme al codice del progetto. L'archiviazione della configurazione con il progetto semplifica anche la condivisione con il team.

Se si assegna un nome al file di configurazione devproxyrc.json o devproxyrc.jsonc, Dev Proxy lo carica automaticamente dalla directory corrente al momento dell'avvio. Per altri nomi, specificare il percorso del file nell'argomento --config-file all'avvio di Dev Proxy, ad esempio devproxy --config-file ./my-devproxy-config.json.

Struttura dei file di configurazione

Il frammento di codice seguente mostra il file di configurazione del proxy di sviluppo predefinito:

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/rc.schema.json",
  "plugins": [
    {
      "name": "RetryAfterPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll"
    },
    {
      "name": "GenericRandomErrorPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
      "configSection": "genericRandomErrorPlugin"
    }
  ],
  "urlsToWatch": [
    "https://jsonplaceholder.typicode.com/*"
  ],
  "genericRandomErrorPlugin": {
    "errorsFile": "devproxy-errors.json"
  },
  "rate": 50,
  "logLevel": "information",
  "newVersionNotification": "stable",
  "showSkipMessages": true,
  "showTimestamps": true
}

Il file di configurazione è costituito da tre sezioni:

  • Schema, definito nella proprietà $schema. Per assicurarsi che il file di configurazione sia valido, assicurarsi di usare la stessa versione dello schema della versione del proxy di sviluppo in uso.
  • Elenco dei plug-in usati da Dev Proxy, definiti nella matrice di plugins.
  • Le impostazioni di configurazione generali .

Importante

Dev Proxy applica i plug-in nell'ordine in cui sono elencati nel file di configurazione. Tenere presente l'ordine per ottenere il comportamento desiderato.

Alcuni plug-in sono configurabili ed espongono le proprie impostazioni. Ogni plug-in ha una propria sezione di configurazione nel file di configurazione, a cui fa riferimento la proprietà configSection nella definizione del plug-in. Per altre informazioni sulle opzioni di configurazione, vedere la documentazione di riferimento per ogni plug-in.

Consiglio

Il valore della proprietà configSection può essere qualsiasi stringa. Usando nomi diversi, è possibile includere più istanze dello stesso plug-in, ognuna con una configurazione diversa. Potrebbe essere necessario fare riferimento più volte allo stesso plug-in, ad esempio, quando si simulano più API con risposte e comportamenti di errore diversi.

Dev Proxy Toolkit

Dev Proxy Toolkit è un'estensione di Visual Studio Code che semplifica notevolmente la configurazione del proxy di sviluppo. Ecco alcune delle funzionalità che include:

  • frammenti di codice per scenari di configurazione comuni
  • linting esteso e IntelliSense per i file di configurazione del proxy di sviluppo
  • azioni personalizzate e comandi dell'editor per avviare e arrestare facilmente il proxy di sviluppo
  • notifiche sulle nuove versioni di Dev Proxy

Consiglio

Se usi Visual Studio Code, consigliamo vivamente di installare l'estensione Dev Proxy Toolkit.

Passaggio successivo

Per continuare a conoscere l'uso di Dev Proxy, prendere in considerazione le esercitazioni seguenti:

In caso contrario, consulta le guide come per imparare a usare il Dev Proxy per scenari specifici.

  • Last updated on