Microsoft. Risoluzione dei problemi di Testing.Platform (MTP)

Questo articolo contiene indicazioni per la risoluzione dei problemi per MTP.

Codici di uscita

MTP usa codici di uscita noti per comunicare errori di test o errori dell'app. I codici di uscita iniziano da 0 e non sono negativi.

Un valore esplicito --minimum-expected-tests sostituisce --zero-tests-policy. Senza l'opzione minima, la gestione strict zero test continua a usare il codice 8di uscita . I codici 8 di uscita e 9 rimangono distinti in modo che un minimo non soddisfatto non sia confuso con un modulo che non ha eseguito test.

Per abilitare la registrazione dettagliata e risolvere i problemi, vedere Registrazione diagnostica.

Nessun test in un'esecuzione multi-modulo

Quando dotnet test esegue diversi moduli di test, il codice di uscita 8 è un segnale per modulo, mentre il verdetto di zero test per l'intera esecuzione viene determinato una sola volta in base ai risultati aggregati. Un singolo modulo vuoto pertanto non causa il fallimento dell'intera esecuzione, anche se il modulo mantiene il proprio messaggio diagnostico Exit code: 8 nell'output. Quando non si imposta un valore minimo globale, un'esecuzione interamente saltata viene considerata come un'esecuzione con zero test, indipendentemente dal valore --zero-tests-policy per modulo. Per altre informazioni, vedere Valori minimi per l'intera esecuzione e per modulo.

Ignora codici di uscita specifici

MTP è progettato per essere rigoroso per impostazione predefinita, ma consente la configurabilità. Di conseguenza, è possibile che gli utenti decida quali codici di uscita devono essere ignorati (verrà restituito un codice di uscita di 0 anziché il codice di uscita originale).

Per ignorare codici di uscita specifici, usare l'opzione della --ignore-exit-code riga di comando o la TESTINGPLATFORM_EXITCODE_IGNORE variabile di ambiente. Il formato valido accettato è un elenco delimitato da punti e virgola di codici di uscita da ignorare (ad esempio, --ignore-exit-code 2;3;8). Uno scenario comune consiste nel considerare che gli errori di test non devono comportare un codice di uscita diverso da zero (che corrisponde all'ignorare il codice 2di uscita).

Registrazione diagnostica

La piattaforma offre la registrazione diagnostica predefinita che consente di risolvere i problemi di esecuzione dei test. È possibile abilitare la registrazione diagnostica tramite opzioni della riga di comando o variabili di ambiente.

Opzioni della riga di comando

Le opzioni della piattaforma seguenti forniscono informazioni utili per la risoluzione dei problemi delle app di test:

• --info
• --diagnostic
• --diagnostic-synchronous-write
• --diagnostic-verbosity
• --diagnostic-file-prefix
• --diagnostic-output-directory

Variabili di ambiente

È anche possibile abilitare i log di diagnostica usando le variabili di ambiente:

MTP scrive un file di diagnostica per ogni origine di test. Se due file ricevono lo stesso timestamp, MTP aggiunge un processo e un suffisso del contatore anziché sovrascrivere un file esistente.

Risolvere gli errori di configurazione

Microsoft.Testing.Platform.MSBuild

Di seguito sono riportati errori di configurazione comuni correlati a Microsoft.Testing.Platform.MSBuild.

errore CS8892: Il metodo 'TestingPlatformEntryPoint.Main(string[])' non verrà usato come punto di ingresso perché è stato trovato un punto di ingresso sincrono 'Program.Main(string[])'

Definire manualmente un punto di ingresso (Main) in un progetto di test o fare riferimento a un progetto di test da un'applicazione che ha già un punto di ingresso genera un conflitto con il punto di ingresso generato da MTP. Per evitare questo problema, eseguire una di queste operazioni:

• Rimuovere il punto di ingresso definito manualmente, in genere Main metodo in Program.cse consentire alla piattaforma di test di generarne uno automaticamente.

• Disabilitare la generazione del punto di ingresso impostando la proprietà <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint> MSBuild.

• Disabilitare completamente la dipendenza transitiva per Microsoft.Testing.Platform.MSBuild impostando la proprietà <IsTestingPlatformApplication>false</IsTestingPlatformApplication> MSBuild nel progetto che fa riferimento a un progetto di test. Questa operazione è necessaria quando si fa riferimento a un progetto di test da un progetto non di test, ad esempio un'app console che fa riferimento a un'applicazione di test.

Lo spazio dei nomi del codice generato è in conflitto con un tipo referenziato

Microsoft.Testing.Platform.MSBuild genera i tipi SelfRegisteredExtensions e TestingPlatformEntryPoint all'interno del $(RootNamespace) del progetto. Per impostazione predefinita, RootNamespace corrisponde al nome del progetto, che può essere in conflitto con un tipo dello stesso nome completo esposto da un assembly a cui si fa riferimento.

Ad esempio, un progetto chiamato System.Security.Cryptography.ProtectedData.Tests finisce per generare codice nel namespace System.Security.Cryptography.ProtectedData. Se il progetto fa riferimento anche al System.Security.Cryptography.ProtectedData pacchetto NuGet, che contiene un tipo pubblico ProtectedData nello System.Security.Cryptography spazio dei nomi, il compilatore non può più disambiguare tra lo spazio dei nomi generato e il tipo a cui viene fatto riferimento e genera errori come CS0118 ("ProtectedData" è uno spazio dei nomi ma viene usato come un tipo").

Per risolvere il conflitto, eseguire l'override RootNamespace nel progetto di test su un valore che non si scontra con alcun tipo a cui si fa riferimento:

<PropertyGroup>
  <RootNamespace>System.Security.Cryptography.ProtectedDataTests</RootNamespace>
</PropertyGroup>

È anche possibile lasciare RootNamespace interamente vuoto (<RootNamespace />); in tal caso, i tipi generati vengono emessi nello spazio dei nomi globale.

Microsoft.Testing.Extensions.Fakes

Errore di Fakes: Impossibile risolvere il percorso del profiler dalle variabili di ambiente COR_PROFILER_PATH e COR_PROFILER

Questo errore può verificarsi se non tutti gli assembly Fakes sono presenti nella cartella bin.

• Assicurarsi che il progetto usi il MSTest.SDK o faccia riferimento a Microsoft.Testing.Extensions.Fakes.
• Per i progetti di .NET Framework, evitare di impostare <PlatformTarget>AnyCPU</PlatformTarget> perché in questo modo NuGet non copia tutti i file nella cartella bin.

Opzione della riga di comando dell'estensione non riconosciuta

Un'opzione della riga di comando specifica per l'estensione può avere esito negativo con il codice di uscita 5 quando un'applicazione di test non registra il pacchetto che fornisce tale opzione. Ad esempio, --report-trx richiede Microsoft.Testing.Extensions.TrxReport, come riferimento diretto al pacchetto o tramite una configurazione o un profilo dell'SDK di test che include il pacchetto. Il core di MTP non comprende report, copertura del codice, dump, nuovi tentativi o altre opzioni di estensione.

Eseguire l'applicazione di test con --helpo eseguire dotnet test --help in modalità MTP per verificare che l'opzione sia disponibile. Se l'opzione manca, aggiungere il pacchetto di estensione o abilitare l'estensione tramite l'SDK di test. Per trovare il pacchetto necessario, vedere Opzioni di estensione per scenario .

Lo stesso errore si verifica quando una soluzione contiene progetti che usano framework di test diversi (ad esempio, MSTest e xUnit.net) o diversi set di estensioni (ad esempio, solo alcuni progetti fanno riferimento Microsoft.Testing.Extensions.HangDump). L'opzione è valida per un progetto ma non riconosciuta da un altro.

Per risolvere questo problema, usare la TestingPlatformCommandLineArguments proprietà MSBuild con condizioni per instradare gli argomenti ai progetti corretti. Per istruzioni dettagliate, vedere Soluzioni con framework di test misti o estensioni.