testtools/README.md

   1 # Testing Tools
   2
   3 ## How to Check Compatibility Between Compilers
   4
   5 Since the interfaces used in the cpp bridgetest are not changed often
   6 one can just build the `cppobj.uno.dll` and the `constructors.uno.dll`
   7 (`testtools/source/bridgetest`) in an
   8 old environment and then use them in the new environment. That is the files
   9 are copied into the `testtools/wntmsciXX.pro` folder which corresponds to the
  10 new environment.
  11
  12 On Windows this test will typically fail because the tests use the
  13 `cppu::getCaughtException` function, which only works when all libs are build
  14 using the same runtime.
  15
  16 This part of the test can switched off. To do this go into the
  17 `testtools/source/bridgetest` folder and call
  18
  19     dmake compcheck=1
  20
  21 This will add a new compiler define (`-DCOMPCHECK`) and will be used in the
  22 `bridgetest.cxx` to switch off the code which uses the `getCaughtException` function.
  23 However, there is still a test which causes the test component to throw
  24 and `IllegalArgumentException`. This still works.
  25
  26
  27 ## Using source / bridgetest for Stress Testing
  28
  29 Start a modified `bridgetest_server` (with the final `--singleaccept` argument
  30 removed from the uno executable call) or a modified `bridgetest_javaserver` (with
  31 the final `singleaccept` argument replaced with `multi` in the java executable
  32 call), then start a modified `bridgetest_client` (with a final `stress` argument
  33 added to the uno executable call).  The client will continuously establish
  34 connections to the server which are immediately destroyed again.  The test will
  35 run forever, unless an error occurs.