# TEST\_LAUNCHER documentation

**URL:** <https://discourse.cmake.org/t/test-launcher-documentation/14410>\
**Category:** Code\
**Created:** [July 22, 2025, 7:55am UTC](https://discourse.cmake.org/t/test-launcher-documentation/14410 "2025-07-22T07:55:42Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Andor\_Rozsnyai](https://discourse.cmake.org/letter_avatar_proxy/v4/letter/a/5f8ce5/32.png) [@Andor\_Rozsnyai](https://discourse.cmake.org/u/Andor_Rozsnyai)\
**Post date:** [July 22, 2025, 7:55am UTC](https://discourse.cmake.org/t/test-launcher-documentation/14410/1 "2025-07-22T07:55:42Z")

</div>

Hi,

I wanted to use launcher for my test, however it was not working, though I checked and followed the documentation.  
Then in source code of cmake I found the reason, then the (CMAKE\_)TEST\_LAUNCHER only used for the not ‘old fashioned’  
tests which has CONFIGURATION added.  
Please add some word about this limitation to the documentation of the TEST\_LAUNCHER and CROSSCOMPILING\_EMULATOR.

Best wishes,  
Andor

---

<div class="post-metadata">

**Author:** ![craig.scott](https://discourse.cmake.org/user_avatar/discourse.cmake.org/craig.scott/32/20_2.png) [@craig.scott](https://discourse.cmake.org/u/craig.scott)\
**Post date:** [July 24, 2025, 8:14pm UTC](https://discourse.cmake.org/t/test-launcher-documentation/14410/2 "2025-07-24T20:14:18Z")

</div>

Thanks, I created [issue 27083](https://gitlab.kitware.com/cmake/cmake/-/issues/27083) for this in the CMake issue tracker. There’s already [an in-progress change](https://gitlab.kitware.com/cmake/cmake/-/merge_requests/10970) to update the docs. Please weigh in there if you think the proposed changes don’t address the situation from your perspective.