Microsoft.Testing.Platform (MTP) CLI seçenekleri referansı

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

Important

Platform seçenekleri MTP'nin kendisinden kullanılabilir. Uzantı seçenekleri yalnızca hedeflenen her test uygulaması bunları sağlayan uzantı paketini kaydettirdiğinde kullanılabilir. Paketi doğrudan ekleyin veya paketi içeren bir test SDK'sı yapılandırması veya profili kullanın. Bir test uygulaması uzantıyı kaydetmezse, seçenek tanınmadığından çalıştırma 5 çıkış koduyla başarısız olur.

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.

  • --debug

    Test işlemine hata ayıklayıcı ekleyebilmeniz için başlangıçta test yürütmeyi duraklatır. TESTINGPLATFORM_WAIT_ATTACH_DEBUGGER ortam değişkenini1 olarak ayarlamaya eşdeğerdir. Tarayıcı platformlarında desteklenmez.

    Uyarı

    Bu seçenek, 1.9.0 sürümünden itibaren MTP'de kullanılabilir. Önceki --debug-wait-attach seçeneğin (MTP 1.6.0'da kullanıma sunulmuştur) yerini alır; eski ad kaldırılmıştır ve artık kullanılmamalıdır.

  • --diagnostic

    Tanılama günlüğe kaydetmeyi etkinleştirir. Varsayılan kayıt düzeyi Trace. Her test kaynağı için MTP yazar <asm>_<tfm>_<arch>_<timestamp>.diag. Bir zaman damgası çakışırsa, MTP mevcut dosyanın üzerine yazmak yerine işlem kimliği ve sayaç son eki ekler.

  • --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.

    Uyarı

    2.0.0 sürümünden itibaren MTP'de kullanılabilir. MTP 2.0.0'da kaldırılan önceki --diagnostic-filelogger-synchronouswrite seçeneğin yerini alı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 değer: <asm>_<tfm>_<arch>.

    Uyarı

    2.0.0 sürümünden itibaren MTP'de kullanılabilir. MTP 2.0.0'da kaldırılan önceki --diagnostic-output-fileprefix seçeneğin yerini 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.

  • --enable-dynamic-extensions

    Test uygulamasının yanındaki *.testingplatformextensions.json manifest dosyalarında tanımlanan uzantıların yüklenmesini etkinleştirir. Dinamik uzantılar varsayılan olarak devre dışı bırakılır. Güvenlik gereksinimleri ve bildirim şeması için bkz . Uzantıları dinamik olarak yükleme.

    Uyarı

    Bu seçenek, 2.4.0 sürümünden itibaren MTP'de kullanılabilir.

  • --exit-on-process-exit

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

  • --filter-uid

    Çalıştırılacak testleri, test düğümü UID'lerine göre filtreler. Bir veya daha fazla UID kabul eder.

    Uyarı

    Bu seçenek, 1.8.0 sürümünden itibaren MTP'de kullanılabilir. MTP 2.3.0'dan itibaren, --filter-uid ile --treenode-filter birleştirilemez; her ikisini de belirtmek, komut satırı doğrulamasının InvalidCommandLine çıkış koduyla başarısız olmasına neden olur.

  • --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 çalıştırmadan listeler. İsteğe bağlı olarak çıkış biçimini denetleen bir bağımsız değişken alır: text (varsayılan, insan tarafından okunabilir) veya json.

    Uyarı

    Çıkış json biçimi, 2.3.0 sürümünden itibaren MTP'de kullanılabilir.

  • --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. MTP çıkış kodları.

    Uyarı

    Bu özellik, 1.5 sürümünden itibaren MTP'de kullanılabilir.

  • --minimum-expected-tests

    Çalışması gereken pozitif minimum test sayısını belirtir. Çalıştırma sırasında sıfır da dahil olmak üzere daha az test çalıştırılırsa, 9 koduyla çıkar. Açıkça belirtilmiş bir minimum, --zero-tests-policy değerini geçersiz kılar.

    ile dotnet test, bu seçenek önce --belirtildiğinde çalıştırmanın tamamına ve sonrasında --belirtildiğinde her test modülüne uygulanır. Daha fazla bilgi için bkz. Tam çalıştırma ve modül başına minimum değerler.

    Uyarı

    --minimum-expected-tests 0 geçersiz. Sıfır test çıkış kodunu bastırmak için kullanın --ignore-exit-code 8.

  • --no-banner

    Başlangıç başlığını, telif hakkı iletisini ve telemetri başlığını devre dışı bırakır. Aynı etki veya TESTINGPLATFORM_NOBANNERDOTNET_NOLOGO aracılığıyla da elde edilebilir.

  • --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.

  • --server

    Test uygulamasını düzenleyici, IDE veya araç tümleştirmesi için JSON-RPC sunucu modunda başlatır. değerini atla veya kullanın jsonrpc. Desteklenen salt kaynak istemcisi için bkz. MTP sunucu modu.

    Important

    dotnettestcli değeri ve taşıma bağımsız değişkenleri .NET SDK tümleştirmesine özgüdür. El ile geçirmeyin.

  • --show-slowest-tests

    Terminal özetinde istenen en yavaş test sayısını gösterir. Bir çalıştırma birden çok test modülü içerdiğinde, MTP her modül için en yavaş testleri raporlar.

    Uyarı

    Bu seçenek, 2.4.0 sürümünden itibaren MTP'de kullanılabilir.

  • --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.

  • --treenode-filter

    Çalıştırılacak testleri bir ağaç filtresi ifadesi kullanarak filtreler. Ağaç filtreleri, gelişmiş senaryolar için --filter öğesine kıyasla daha kapsamlı eşleştirme sunar.

    Uyarı

    MTP 2.3.0'dan itibaren, --treenode-filter ile --filter-uid birleştirilemez; her ikisini de belirtmek, komut satırı doğrulamasının InvalidCommandLine çıkış koduyla başarısız olmasına neden olur.

  • --zero-tests-policy

    Tüm testler atlandığı için hiç test yürütmeyen bir çalıştırmanın başarısızlık olarak değerlendirilip değerlendirilmediğini denetler. Geçerli değerler allow-skipped (varsayılan) ve strict'dir. allow-skipped ile, tamamı atlanmış bir çalıştırma başarıyla sonuçlanır. strict ile, 8 çıkış koduyla başarısız olur. Açık --minimum-expected-tests bir değer bu ilkenin yerini alır ve en düşük değer karşılanmadığında çıkış kodunu 9 kullanır.

    Uyarı

    Bu seçenek, 4.3.0 sürümünden itibaren MTP'de kullanılabilir. dotnet test ile, seçeneği her test modülüne iletmek için -- ifadesinden sonra geçirin. Genel bir minimum ayarlamadığınızda, .NET 11 SDK'sı tam çalıştırma sıfır testi kararını ayrı olarak belirler. Daha fazla bilgi için bkz. Tam çalıştırma ve modül başına minimum değerler.

Senaryoya göre uzantı seçenekleri

Her uzantının paketini ve seçeneklerini bulmak için aşağıdaki tabloyu kullanın. Bir test SDK profili, doğrudan bir paket başvurusu yerine bir paket sağlayabilir.

Scenario Gerekli bileşen Özellik belgeleri
Kod kapsamını topla Microsoft.Testing.Extensions.CodeCoverage veya coverlet.MTP Kod kapsamı
Çökme veya takılma dökümlerini toplama Microsoft.Testing.Extensions.CrashDump veya Microsoft.Testing.Extensions.HangDump Çökme ve donma dökümleri
Test raporları oluşturma Seçili biçim için uzantı paketi, örneğin Microsoft.Testing.Extensions.TrxReport Test raporları
Terminal çıkışını özelleştirme MTP çekirdeği (ek paket yok) Terminal çıkışı
Başarısız testleri yeniden deneme Microsoft.Testing.Extensions.Retry Yeniden dene

Test uygulamanızdaki seçenekleri bulma

Mevcut uzantı kümeniz için kullanılabilir seçenekleri listelemek üzere test yürütülebilir dosyanızı --help ile çalıştırın veya dotnet test --help öğesini MTP modunda ç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