From f51501f772062f3c80002a7202e2deedb9a2fff5 Mon Sep 17 00:00:00 2001 From: alejandrojginerd <126397782+alejandrojginerd@users.noreply.github.com> Date: Fri, 6 Sep 2024 13:10:23 +0200 Subject: [PATCH] Additional note for ccache installation.rst When following the tutorial, I notice that the build times were taking a lot >25 mins every time (even after hello_moveit tutorial). I added a note for people to install ccache in their system to reduce subsequent build times --- doc/tutorials/getting_started/getting_started.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/tutorials/getting_started/getting_started.rst b/doc/tutorials/getting_started/getting_started.rst index 95a35b6f22..fd41a90505 100644 --- a/doc/tutorials/getting_started/getting_started.rst +++ b/doc/tutorials/getting_started/getting_started.rst @@ -95,6 +95,17 @@ This build command will likely take a long time (20+ minutes) depending on your If you are low on computer memory, or if the build is generally having trouble completing on your computer, you can try appending ``--executor sequential`` to the ``colcon`` command above to build only one package at a time, or ``--parallel-workers `` to limit the number of simultaneous builds. For even more limited machines, you can try running ``MAKEFLAGS="-j4 -l1" colcon build --executor sequential``. +.. note:: + + To greatly reduce the build time of subsecuent builds, make sure you have installed and properly configured ``ccache`` on your compiler. + + .. code-block:: bash + + sudo apt install -y ccache + sudo /usr/sbin/update-ccache-symlinks + echo 'export PATH="/usr/lib/ccache:$PATH"' | tee -a ~/.bashrc + source ~/.bashrc && echo $PATH + If everything goes well, you should see the message "Summary: X packages finished" where X might be 50. If you have problems, try re-checking your `ROS Installation `_. Setup Your Colcon Workspace