Bagikan melalui

Opsi Perintah Te.exe

  • Artikel

Penggunaan

<te.exe test_binaries> [/appendWttLogging] [/breakOnCreate] [/breakOnError] [/breakOnInvoke] [/coloredConsoleOutput] [ /console:flushWrites] [/console:position=[x,y | current] [/console:size=<x,y>] [ /console:topmost ] [/defaultAppDomain] [/disableConsoleLogging] [/disableTimeouts] [/ dpiaware ] [/enableWttLogging] [/inproc] [/isolationLevel] [/labMode] [/list] [/listProperties] [/logFile:<name>] [/logOutput:<mode>] [/miniDumpOnCrash] [/miniDumpOnError] [/name:<testname>] [/outputFolder:<folderName>] [/p:<ParamName>=<ParamValue>] [/parallel] [/persistPictResults] [/pict:<OptionName>=<OptionValue>] [/rebootStateFile] [/reportLoadingIssue] [/runas:<RunAsType>] [/runIgnoredTests] [/runon:<MachineName>] [/screenCaptureOnError] [/select:<query>] [/sessionTimeout:<value>] [/ stackFrameCount:<value>] [/stackTraceOnError] [/terminateOnFirstFailure] [/testDependencies:<files>] [/testmode:Loop] [/testmode:Stress] [/testTimeout:<value>] [/unicodeOutput:<true/false>] [/version] [/wttDeviceString:<value>] [/wttDeviceStringSuffix:<nilai>]

Perintah Pilihan/Eksekusi

test_binaries

Tentukan satu atau beberapa file pengujian untuk dijalankan (dipisahkan oleh spasi). Karakter kartubebas didukung.

te.exe test1.dll

Interpretasi: Jalankan semua pengujian di test1.dll.

te.exe test1.dll test2.dll test3.dll

Interpretasi: Jalankan semua pengujian di test1.dll, test2.dll, dan test3.dll.

te.exe *.dll

Interpretasi: Jalankan semua pengujian di semua dll di direktori saat ini.

/coloredConsoleOutput:<true/false>

Menentukan apakah TAEF harus mengeluarkan teks konsol berwarna atau tidak. Defaultnya adalah true. Jika diatur ke false, TAEF akan menghasilkan semua teks dengan warna konsol default.

te.exe test1.dll /coloredConsoleOutput:false

/console:<optionName>=<value>

Menyediakan opsi untuk mengonfigurasi penggunaan konsol TE. Pilihan berikut tersedia:

/console:flushWrites

Menyebabkan output konsol dibersihkan setelah setiap baris ditulis - berguna ketika output TE.exe telah dialihkan.

/console:position=[x,y | current ]

Mengatur posisi (dalam piksel) jendela konsol relatif terhadap sudut monitor utama. Gunakan nilai saat ini untuk menentukan bahwa posisi konsol saat ini harus disimpan dan digunakan saat melanjutkan dari boot ulang.

/console:size=[ <x,y> | current ]

Mengatur ukuran jendela konsol (dalam dimensi karakter). Ukuran buffer layar akan ditingkatkan agar sesuai dengan ukuran jendela jika perlu. Gunakan nilai saat ini untuk menentukan bahwa ukuran konsol saat ini harus disimpan dan digunakan saat melanjutkan dari boot ulang.

/console:topmost

Menjaga konsol tetap berjalan te.exe 'paling atas' dalam urutan z desktop selama durasi eksekusi.

/dpiaware

Menjalankan pengujian dalam proses yang ditandai sebagai sadar DPI, lihat DPI Tinggi. Ini juga dapat diatur melalui metadata ("DpiAware").

/inproc

Jalankan semua pengujian dalam proses TE.exe itu sendiri daripada dalam TE. ProcessHost.exe.

te.exe test1.dll /inproc

Catatan

TE hanya mendukung eksekusi satu dll pengujian pada satu waktu saat menggunakan pengaturan /inproc .

/isolationLevel:<Level>

Menentukan tingkat isolasi minimum yang akan digunakan saat menjalankan pengujian TAEF. Jika nilai ini bertentangan dengan IsolationLevel yang ditentukan sebagai metadata, nilai menjadi tingkat isolasi dengan cakupan terketat. Lihat Isolasi Pengujian untuk detail selengkapnya.

te.exe test1.dll /isolationLevel:Class

/labMode

Menjalankan pengujian dan menghapus potensi pemblokiran UI (misalnya, Pelaporan Galat Windows dialog pada pengujian crash).

/list

Mencantumkan nama semua test_binaries dan kelas dan metode di dalamnya. Jika kriteria pilihan ditentukan, hanya mencantumkan nama yang memenuhi kriteria.

 te.exe test1.dll test2.dll /list

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example1
  WEX::UnitTests::Test1::Example2
  WEX::UnitTests::Test1::Example3

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example1
  WEX::UnitTests::Test2::Example2
  WEX::UnitTests::Test2::Example3

 te.exe test1.dll test2.dll /select:@name='*Example2*' /list

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example2

 WEX: :UnitTests::Test2
  WEX::UnitTests::Test2::Example2

/listProperties

Mencantumkan nama dan properti semua test_binaries dan kelas dan metode di dalamnya bersama dengan nama fungsi Penyiapan dan Teardown, jika tersedia. Jika kriteria pilihan ditentukan, hanya mencantumkan nama yang memenuhi kriteria.

 te.exe test1.dll test2.dll /listProperties

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example1
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = MTA
  WEX::UnitTests::Test1::Example2
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA
  WEX::UnitTests::Test1::Example3
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example1
   Property[ThreadingModel] = MTA
  WEX::UnitTests::Test2::Example2
   Property[ThreadingModel] = STA
  WEX::UnitTests::Test2::Example3
   Property[ThreadingModel] = MTA

 te.exe test1.dll test2.dll /select:@name='*Example2*' /listProperties

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example2
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example2
   Property[ThreadingModel] = STA

/name:<testname>

Pilihan berbasis nama pengujian adalah alternatif yang mudah untuk "/select:@Name='<testname>'". Nama <> uji masih dapat berisi karakter kartubebas ("*" dan "?"), tetapi tidak boleh dimuat dalam tanda kutip tunggal. Jika /select dan /name keduanya ditentukan pada prompt perintah, maka /select query lebih diutamakan dan /name diabaikan.

te.exe test1.dll /name:*TestToLower

Interpretasi: Jalankan semua pengujian di test1.dll di mana nama metode berakhir dengan 'TestToLower'. Hal yang sama dapat diwakili menggunakan kriteria pilihan sebagai /select:@Name='*TestToLower'.

te.exe test1.dll /name:*StringTest*

Interpretasi: Jalankan semua pengujian di test1.dll yang berisi frasa 'StringTest' di namespace layanan, kelas, atau nama metodenya.

/outputFolder:<folderName>

Menentukan folder untuk menempatkan semua file yang dihasilkan. Defaultnya adalah direktori saat ini. Anda dapat menggunakan variabel lingkungan, misalnya:

te.exe test1.dll /outputFolder:%TEMP%\\MyOutput

/p:<ParamName>=<ParamValue>

Menentukan parameter runtime dengan parameter name=ParamName dan parameter value=ParamValue. Parameter ini dapat diakses dari metode pengujian atau metode penyiapan/pembersihan.

te.exe test1.dll /p:x=5 /p:myParm=cool

Anda dapat mengambil x sebagai salah satu dari beberapa jenis yang didukung dalam kode pengujian Anda. Misalnya, di sini Anda dapat melihat kami mengambilnya sebagai int dan WEX::Common::String:

                int x = 0;
                String xString;
                RuntimeParameters::TryGetValue(L"x", x);
                RuntimeParameters::TryGetValue(L"x", xString);

Untuk informasi lebih lanjut, silakan kunjungi TAEF. Halaman bantuan Parameter Runtime.

/sejajar

Menjalankan pengujian secara paralel di beberapa prosesor. Pengujian harus ikut serta dalam eksekusi paralel dengan ditandai dengan metadata 'Paralel'.

te.exe test1.dll /parallel

Untuk informasi lebih lanjut, silakan kunjungi halaman Bantuan paralel .

/persistPictResults

Hasil cache yang dihasilkan oleh PICT.exe untuk pengujian menggunakan PICT DataSource dalam eksekusi saat ini. Eksekusi pengujian berikutnya akan mencoba menggunakan hasil cache sebagai terhadap menjalankan PICT.exe terhadap model dan file benih yang sama.

/pict:<OptionName>=<OptionValue>

Menyediakan opsi untuk mengontrol PICT.exe saat dipanggil untuk pengujian menggunakan SUMBER Data PICT. Mengatur salah satu opsi ini saat ini mengambil alih semua metadata terkait dalam kode. Pilihan berikut tersedia:

/Pict:Order=3
Mengatur urutan kombinasi dengan meneruskan nilai melalui opsi perintah /o untuk PICT.exe.

/Pict:ValueSeparator=;
Mengatur pemisah nilai dengan meneruskan nilai melalui opsi perintah /d untuk PICT.exe.

/Pict:AliasSeparator=+
Mengatur pemisah alias dengan meneruskan nilai melalui opsi perintah /a untuk PICT.exe.

Pict:NegativeValuePrefix=!
Mengatur awalan nilai negatif dengan meneruskan nilai melalui opsi perintah /n untuk PICT.exe.

/Pict:SeedingFile=test.seed
Mengatur jalur ke file seeding dengan meneruskan nilai melalui opsi perintah /e untuk PICT.exe.

/Pict:Random=true
Mengaktifkan atau menonaktifkan keacakan dalam hasil PICT dan membuat log sumber data PICT sebagai benih acak yang digunakan.

/Pict:RandomSeed=33
Mengatur seed acak dengan meneruskan nilai melalui opsi perintah /r untuk PICT.exe. Pengaturan ini akan mengaktifkan Pict:Random kecuali Pict:Random secara eksplisit diatur ke false.

/Pict:CaseSensitive=true
Ketika diatur ke true, mengaktifkan sensitivitas huruf besar/kecil dengan meneruskan opsi perintah /c ke PICT.exe.

/Pict:Timeout=00:01:30
Mengatur waktu untuk menunggu PICT.exe selesai sebelum menghentikan prosesnya. Nilainya dalam format [Hari.] Hour[:Minute[:Second[. FractionalSeconds]]].

/runas:<RunAsType>

Menjalankan pengujian di lingkungan tertentu. Silakan lihat dokumentasi RunAs untuk informasi penggunaan terperinci.

te.exe *.dll /runas:System

Interpretasi: Jalankan semua pengujian sebagai Sistem.

te.exe *.dll /runas:Elevated

Interpretasi: Jalankan semua pengujian sebagai pengguna yang ditingkatkan.

te.exe *.dll /runas:Restricted

Interpretasi: Jalankan semua pengujian sebagai pengguna yang tidak ditingkatkan.

te.exe *.dll /runas:LowIL

Interpretasi: Jalankan semua pengujian dalam proses Integritas Rendah.

/runIgnoredTests

Menjalankan atau mencantumkan (jika bersama dengan /list atau /listProperties) semua pengujian, termasuk kelas pengujian dan metode pengujian dengan metadata "Ignore" diatur ke "true". Secara default, kelas pengujian dan metode pengujian dengan metadata "Abaikan" yang diatur ke "true" dilewati selama eksekusi dan saat mencantumkan.

/runon:<MachineName>

Menjalankan pengujian dari jarak jauh, pada komputer yang ditentukan. TAEF mengautentikasi, mengotorisasi, dan menyebarkan biner yang diperlukan untuk menjalankan pengujian, dan mencatat semua informasi kembali ke konsol asal. Silakan merujuk ke dokumentasi Eksekusi Uji Mesin Silang untuk informasi penggunaan terperinci.

te.exe *.dll /runon:TestMachine1

Interpretasi: Jalankan semua pengujian dari jarak jauh pada "TestMachine1".

/select:<query>

Kriteria pilihan yang akan digunakan saat memilih pengujian dari setiap biner pengujian. Kriteria pilihan terdiri dari satu atau beberapa hal berikut ini:

@[nama properti] = [nilai sebagai string]

@[nama properti] >= [nilai sebagai float atau bilangan bulat]

@[nama properti] > [nilai sebagai float atau bilangan bulat]

@[nama properti] <= [nilai sebagai float atau bilangan bulat]

@[nama properti] < [nilai sebagai float atau bilangan bulat]

  • Nilai properti sebagai string harus berada dalam tanda kutip tunggal.
  • Anda dapat menentukan kriteria pemilihan komposit menggunakan "dan", "atau" dan "tidak" (tidak peka huruf besar/kecil).
  • Nilai string properti mendukung karakter kartubebas melalui karakter "*" dan "?" .
  • Untuk nilai float dan bilangan bulat, karakter "*" juga dapat digunakan sebagai 'ada', tetapi mungkin tidak digunakan untuk pencocokan parsial. Misalnya: /select:"@Priority=*" valid, tetapi /select:"@Priority=4*" tidak.

te.exe test1.dll /select:"(@Name='*TestToLower' atau @Owner='C2') dan not(@Priority < 3)"

Interpretasi: Jalankan semua pengujian di test1.dll di mana nama metode berakhir dengan 'TestToLower' atau di mana pemiliknya adalah 'C2'; dan di mana Prioritas tidak kurang dari 3.

te.exe test1.dll test2.dll /pilih:@Priority=\*

Interpretasi: Jalankan semua pengujian di test1.dll dan test2.dll di mana Prioritas telah ditentukan dalam metadata pengujiannya.

te.exe test1.dll /select:@Name='*StringTest*'

Interpretasi: Jalankan semua pengujian di test1.dll yang berisi frasa 'StringTest' di namespace layanan, kelas, atau nama metodenya.

/sessionTimeout:<value>

Mengatur batas waktu sesi untuk seluruh eksekusi Te.exe. Jika waktu habis berakhir, sesi pengujian akan dibatalkan dengan baik, dan kode keluar proses akan menandakan bahwa waktu habis terjadi.

Catatan

Nilai waktu habis harus ditentukan dalam format berikut:

[Day.]Hour[:Minute[:Second[.FractionalSeconds]]]

Catatan

Jika berjalan di bawah WTT, nilai ini dapat digunakan untuk memastikan bahwa file log Wtt tetap utuh bahkan jika waktu sesi TAEF habis.

te.exe test1.dll /sessionTimeout:0:0:0.5

Seluruh sesi pengujian akan kehabisan waktu setelah .5 detik.

te.exe test1.dll /sessionTimeout:0:0:45

Seluruh sesi pengujian akan kehabisan waktu setelah 45 detik.

te.exe test1.dll /sessionTimeout:0:20

Seluruh sesi pengujian akan kehabisan waktu setelah 20 menit.

te.exe test1.dll /sessionTimeout:5

Seluruh sesi pengujian akan kehabisan waktu setelah 5 jam.

te.exe test1.dll /sessionTimeout:1.2

Seluruh sesi pengujian akan kehabisan waktu setelah 1 hari dan 2 jam.

/terminateOnFirstFailure

Mengakhiri eksekusi pengujian saat pertama kali kegagalan pengujian ditemui. Semua operasi teardown untuk pengujian tersebut dipanggil, tetapi semua pengujian berikutnya ditandai sebagai diabaikan. Karena masalah yang diketahui, pengujian mungkin terus berjalan saat menggunakan mode pengujian.

te.exe test1.dll /terminateOnFirstFailure

/testDependencies:<files>

Menentukan dependensi pengujian tambahan untuk disebarkan saat menggunakan eksekusi pengujian lintas komputer. Kecuali jalur lengkap disediakan, TAEF akan mencari relatif terhadap direktori saat ini, bukan direktori pengujian.

te.exe *.dll /runon:TestMachine1 /TestDependencies:test*.jpg; file1.doc

Interpretasi: Jalankan semua pengujian dari jarak jauh pada "TestMachine1", dan salin 'test*.jpg' dan 'file1.doc' ke komputer jarak jauh sebelum menjalankan pengujian apa pun. Setiap spesifikasi file dapat berisi karakter kartubebas (test.txt; test*.dll; dll.) untuk mencocokkan satu atau beberapa file.

/testTimeout:<value>

Mengatur batas waktu pengujian global untuk seluruh eksekusi Te.exe. Nilai ini mengambil alih metadata batas waktu pengujian apa pun yang mungkin telah ditetapkan untuk pengujian tertentu yang dijalankan.

Catatan

Nilai waktu habis harus ditentukan dalam format berikut:

[Day.]Hour[:Minute[:Second[.FractionalSeconds]]]

Catatan

Akan diabaikan ketika digunakan bersama dengan /inproc.

te.exe test1.dll /testTimeout:0:0:0.5

Setiap metode pengujian dan penyiapan/pembersihan akan kehabisan waktu setelah .5 detik.

te.exe test1.dll /testTimeout:0:0:45

Setiap metode pengujian dan penyiapan/pembersihan akan kehabisan waktu setelah 45 detik.

te.exe test1.dll /testTimeout:0:20

Setiap metode pengujian dan penyiapan/pembersihan akan kehabisan waktu setelah 20 menit.

te.exe test1.dll /testTimeout:5

Setiap metode pengujian dan penyiapan/pembersihan akan kehabisan waktu setelah 5 jam.

te.exe test1.dll /testTimeout:1.2

Setiap metode pengujian dan penyiapan/pembersihan akan kehabisan waktu setelah 1 hari dan 2 jam.

/unicodeOutput:<true/false>

Saat TE disalurkan ke file teks, TE akan menghasilkan unicode secara default. Satu pengecualian untuk ini adalah jika Anda telah meminta untuk menambahkan ke file ANSII yang ada (melalui '>>').

Untuk mengambil alih perilaku ini, Anda dapat menentukan /unicodeOutput:false. Ini akan memaksa TE untuk selalu mengeluarkan ANSII ke file.

te.exe test1.dll /unicodeOutput:false > output.txt

Pengaturan Pencatat

/appendWttLogging

Ketika pengelogan WTT diaktifkan, tambahkan ke file log daripada menimpanya. Harus digunakan bersama dengan /enableWttLogging.

te.exe test1.dll /enableWttLogging /appendWttLogging

Akan membuat, atau menambahkan ke file log yang disebut TE.wtl setelah pengujian penyelesaian eksekusi.

/enableWttLogging

Mengaktifkan pengelogan WTT; Wttlog.dll harus tersedia di jalur Anda.

te.exe test1.dll /enableWttLogging

Akan menghasilkan file log yang disebut TE.wtl setelah penyelesaian eksekusi pengujian.

/defaultAppDomain

Menjalankan pengujian terkelola di domain aplikasi default.

te.exe managed.test1.dll /defaultAppDomain

/disableConsoleLogging

Menonaktifkan output log konsol; harus digunakan bersama dengan /enableWttLogging.

te.exe test1.dll /disableConsoleLogging /enableWttLogging

/logFile:<name>

Tentukan nama yang akan digunakan sebagai file log wtt; harus digunakan bersama dengan /enableWttLogging.

te.exe test1.dll /logFile:myCustomLogFile.xml /enableWttLogging

Akan menghasilkan file log yang disebut myCustomeLogFile.xml setelah penyelesaian eksekusi pengujian.

/logOutput:<mode>

Mengatur tingkat output pencatat. Nilai yang valid adalah:

  • Tinggi: Memungkinkan beberapa output konsol tambahan seperti mencetak stempel waktu di samping setiap jejak.
  • Rendah: Hanya memancarkan peristiwa inti (mulai, grup akhir, dll) dan kesalahan. File log mencakup detail prioritas yang lebih rendah yang mendahului kesalahan apa pun untuk memberikan konteks kegagalan.
  • LowWithConsoleBuffering: Sama seperti Rendah, tetapi menyertakan konteks kegagalan dalam file log dan output konsol.
  • Terendah: Sama seperti Rendah, tetapi output konsol hanya mencakup kesalahan, kegagalan pengujian, dan ringkasan eksekusi.

/versi

Menghasilkan informasi versi terperinci.

/wttDeviceString:<value>

Sepenuhnya mengambil alih WttDeviceString yang digunakan oleh WexLogger ketika menginisialisasi WttLogger.

te.exe test1.dll /wttDeviceString:$Console

/wttDeviceStringSuffix:<value>

Menambahkan nilai yang ditentukan ke WttDeviceString default yang digunakan oleh WexLogger saat menginisialisasi WttLogger. Diabaikan jika wttDeviceString juga ditentukan.

te.exe test1.dll /wttDeviceStringSuffix:$Console

Pengaturan Debug

/breakOnCreate

Masuk ke debugger sebelum membuat instans setiap kelas pengujian.

te.exe test1.dll /breakOnCreate

/breakOnError

Masuk ke debugger jika kesalahan atau kegagalan pengujian dicatat.

te.exe test1.dll /breakOnError

/breakOnInvoke

Masuk ke debugger sebelum memanggil setiap metode pengujian.

te.exe test1.dll /breakOnInvoke

/disableTimeouts

Menonaktifkan semua waktu habis selama eksekusi. Ini dapat berguna saat penelusuran kesalahan untuk mencegah waktu habis ketika TAEF menunggu di bagian program yang sedang di-debug.

te.exe test1.dll /disableTimeouts

/miniDumpOnError

Mengambil dan mencatat cadangan mini jika terjadi kesalahan atau kegagalan pengujian.

te.exe test1.dll /miniDumpOnError

/miniDumpOnCrash

Mengambil dan mencatat cadangan mini jika terjadi crash pengujian.

te.exe test1.dll /miniDumpOnCrash

/rebootStateFile

Secara eksplisit memungkinkan eksekusi pengujian Reboot .

te.exe test1.dll /rebootStateFile:myFile.xml

/reportLoadingIssue

Menampilkan dialog deskripsi kesalahan ketika TAEF gagal memuat dll pengujian. Hanya boleh digunakan untuk penyelidikan masalah pemuatan dll pengujian asli.

te.exe test1.dll /reportLoadingIssue

/screenCaptureOnError

Mengambil dan mencatat tangkapan layar jika terjadi kesalahan atau kegagalan pengujian.

te.exe test1.dll /screenCaptureOnError

/stackFrameCount:<value>

Menentukan jumlah bingkai tumpukan yang akan ditampilkan saat mendapatkan tumpukan panggilan. Nilai defaultnya adalah 50.

te.exe test1.dll /stackFrameCount:100

/stackTraceOnError

Mengambil dan mencatat jejak tumpukan jika terjadi kesalahan atau kegagalan pengujian.

te.exe test1.dll /stackTraceOnError

Mode Pengujian

/testmode:Loop

Memungkinkan pengontrol eksekusi menggunakan dua variabel Loop dan LoopTest.

  • Perulangan: Mengontrol berapa kali seluruh eksekusi dijalankan. Default 1.
  • LoopTest: Mengontrol berapa kali pengujian individu dijalankan. Default 10.

te.exe test1.dll /testmode:Loop

Interpretasi: Jalankan setiap pengujian dalam test1.dll 10 kali (nilai default untuk LoopTest). Seluruh eksekusi dijalankan sekali (nilai default untuk Loop).

te.exe test1.dll test2.dll /testmode:Loop /Loop:3 /LoopTest:1

Interpretasi: Jalankan setiap pengujian dalam test1.dll dan test2.dll sekali (ditentukan oleh LoopTest). Seluruh eksekusi (semua pengujian gabungan dalam test1.dll dan test2.dll) dijalankan 3 kali - seperti yang ditentukan oleh Loop.

/testmode:Stress

Dalam mode uji 'stres', TAEF akan menjalankan pengujian tanpa batas waktu, hingga Ctrl+C dimasukkan atau sampai pesan WM_CLOSE dikirim ke jendela tersembunyi TAEF. /testmode:stress harus dijalankan bersama dengan /inproc.

te.exe test1.dll /testmode:Stress /inproc

Untuk informasi terperinci dan parameter lain yang didukung dalam mode ini, lihat Mode Pengujian.