Aracılığıyla paylaş

Microsoft.Testing.Platform CLI seçenekleri referansı

Bu makale, Microsoft.Testing.Platform komut satırı seçenekleri için merkezi bir giriş noktası sağlar.

Platform seçenekleri

  • @

    Yanıt dosyasının adını belirtir. Yanıt dosyası adı, @ karakterinden hemen sonra gelmeli ve @ karakteri ile arasında boşluk olmamalıdır.

    Yanıt dosyasındaki seçenekler, komut satırında o konumdaymış gibi yorumlanır. Satırları birleştirmek için ters eğik çizgi karakterini \ kullanamazsınız. Yanıt dosyası kullanmak, terminal sınırlarını aşabilecek çok uzun komutlar için yardımcı olur. Yanıt dosyasını satır içi komut satırı argümanlarıyla birleştirebilirsiniz. Örneğin:

    ./TestExecutable.exe @"filter.rsp" --timeout 10s

    burada filter.rsp aşağıdaki içeriklere sahip olabilir:

    --filter "A very long filter"

    Ya da tek bir rsp dosyası hem zaman aşımını hem de filtreyi aşağıdaki gibi belirtmek için kullanılabilir:

    ./TestExecutable.exe @"arguments.rsp"

    --filter "A very long filter" --timeout 10s

    Uyarı

    kullanırken dotnet testSDK komut satırı ayrıştırıcısı, yanıt dosyasındaki her satırın tek bir belirteç olarak ele alındığı satır başına belirteç yaklaşımını kullanır. Bu durumda, her argüman ayrı bir satırda olmalıdır.

    --filter
A very long filter
--timeout
10s

  • --config-file

    bir testconfig.json dosyası belirtir.

  • --diagnostic

    Tanı günlük kaydı etkinleştirir. Varsayılan kayıt düzeyi Trace. Dosya çıktı dizininde aşağıdaki ad biçiminde yazılır log_[MMddHHssfff].diag.

  • --diagnostic-synchronous-write

    Yerleşik dosya günlükçüsüsünü zaman uyumlu bir şekilde günlükleri yazmaya zorlar. İşlemin çöktüğü durumlarda (yani günlük girdilerini kaybetmek istemediğiniz senaryolarda) kullanışlıdır. Bu, test yürütmeyi yavaşlatır.

  • --diagnostic-output-directory

    Tanılama günlüğünün çıkış dizini belirtilmezse, dosya varsayılan TestResults dizininde oluşturulur.

  • --diagnostic-file-prefix

    Günlük dosyası adının ön eki. Varsayılan olarak "log" değerini alır.

  • --diagnostic-verbosity

    --diagnostic anahtarı kullanıldığında ayrıntı seviyesini tanımlar. Kullanılabilir değerler Trace, Debug, Information, Warning, Errorveya Critical' dır.

  • --exit-on-process-exit

    Bağımlı süreç sona ererse test sürecinden çıkın. PID sağlanmalıdır.

  • --help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • --ignore-exit-code

    Sıfır olmayan bazı çıkış kodlarının yoksayılmasına ve bunun yerine 0olarak döndürülmesini sağlar. Daha fazla bilgi için bkz. Belirli Çıkış Kodlarını Yoksayma.

  • --info

    .NET Test Uygulaması hakkında aşağıdaki gibi gelişmiş bilgileri görüntüler:

    • Bu platform.
    • Ortam.
    • Her kayıtlı komut satırı sağlayıcısı, örneğin name, version, description ve options gibi.
    • Her kayıtlı araç, örneğin command, name, version, descriptionve tüm komut satırı sağlayıcıları gibi.

    Bu özellik, aynı komut satırı seçeneğini kaydeden uzantıları veya bir uzantının (veya platformun) birden çok sürümü arasındaki kullanılabilir seçeneklerdeki değişiklikleri anlamak için kullanılır.

  • --list-tests

    Kullanılabilir testleri listeleyin. Testler yürütülmeyecek.

  • --maximum-failed-tests

    Belirli bir sayıya ulaşıldığında test çalıştırmasını durduracak maksimum test hatası sayısını tanımlar. Bu anahtar desteği için çerçeve yazarlarının IGracefulStopTestExecutionCapability özelliğini uygulaması gerekir. Bu miktarda test hatasına ulaşıldığında çıkış kodu 13'tür. Daha fazla bilgi için bkz. microsoft.testing.platform çıkış kodları .

    Uyarı

    Bu özellik, 1.5 sürümünden itibaren Microsoft.Testing.Platform'da kullanılabilir.

  • --minimum-expected-tests

    Çalıştırılması beklenen en az test sayısını belirtir. Varsayılan olarak, en az bir testin çalıştırılması beklenir.

  • --results-directory

    Test sonuçlarının yerleştirileceği dizin. Belirtilen dizin yoksa oluşturulur. Varsayılan değer, test uygulamasını içeren dizinde TestResults.

  • --timeout

    Küresel test yürütme zaman aşımı. Bir bağımsız değişkeni, <value>[h|m|s] biçiminde bir dizge olarak alır ve burada <value> kayan sayıdır.

Senaryoya göre uzantı seçenekleri

Uzantı seçeneklerini hızla bulmak için aşağıdaki tabloyu kullanın.

Scenario Özellik belgeleri
Kod kapsamını topla Kod kapsamı
Çökme veya takılma dökümlerini toplama Çökme ve donma dökümleri
Test raporları oluşturma (örneğin TRX) Test raporları
Terminal çıkışını özelleştirme Terminal çıkışı
Barındırma düzeyi denetimleri uygulama Hot Reload
Başarısız testleri yeniden deneme Yeniden dene
Microsoft Fakes kullanan testleri çalıştırma Microsoft Fakes
OpenTelemetry izlemelerini ve ölçümlerini gönderme OpenTelemetry

Test uygulamanızdaki seçenekleri bulma

Geçerli uzantı kümeniz için mevcut seçenekleri listelemek amacıyla test yürütülebilir dosyanızı --help ile çalıştırın.

Kayıtlı sağlayıcıların ve seçeneklerin gelişmiş tanılamaları için ile --infokomutunu çalıştırın.

Ayrıca bakınız

  • Last updated on