Troubleshooting¶
Configuration Summary Warnings¶
The catkin tool is capable of detecting some issues or inconsistencies with
the build configuration automatically. In these cases, it will often describe
the problem as well as how to resolve it. The catkin tool will detect the
following issues automatically.
Missing Workspace Components¶
- Uninitialized workspace (mising
.catkin_toolsdirectory) - Missing source space as specified by the configuration
Inconsistent Environment¶
- The
CMAKE_PREFIX_PATHenvironment variable is different than the cahcedCMAKE_PREFIX_PATH - The explicitly extended workspace path yeilds a different
CMAKE_PREFIX_PATHthan the cachedCMAKE_PREFIX_PATH - The build space or devel space was built with a different tool such as
catkin_makeorcatkin_make_isolated - The build space or devel space was built in a different isolation mode
Dependency Resolution¶
Packages Are Being Built Out of Order¶
- The
package.xmldependency tags are most likely incorrect. Note that dependencies are only used to order the packages, and there is no warning if a package can’t be found. - Run
catkin list --deps /path/to/ws/srcto list the dependencies of each package and look for errors.