CMake - набор костылей и говен
- Find*. каждый пишет как придется, нет унификации порождаемых переменных (INCLUDE_DIR/INCLUDE_DIRS/INCLUDE_DIRECTORY/INCLUDE_DIRECTORIES, LIB/LIBS/LIBRARY/LIBRARIES, капитализация имени, капитализация компнонтов пакета)
- Некоторые пакеты использую pkgconfig, некоторые ? нет
- Некоторые пакеты не знают, что такое variable cache
- Половина пакетов не использует find_package_handle_standard_args
- get_property/get_*_properties - GOD OH GOD WHY THEY HAVE DIFFERENT CALL CONVENTIONS?
- install(EXPORT) (ср. export()), find_filename_component(PROGRAM) (ср. find_program()) ? почему они здесь?
- end*() - в теории, надо писать то же, что и в открывающем выражении. На практике, это лишняя работа, проверяется через раз (содержимое statement'ов вполне может разъехаться) и в итоге лучший способ в современном CMake - забивать и писать пустые скобки
- if() - variable vs its value - if ( VAR STREQUAL VAR) # XXX check
- списки, разделяемые точками с запятыми. По аналогии с шеллом, его IFS и $@.
- В реальности можно собирать только С и кресты (скорее всего, еще фортран). God help you если возникнет желание собирать, например, java (впрочем в случае java, наполовину это обуславливается существующими способами сборки java, но имеющиеся в поставки модули для java ARE NOT HELPING).
- Костыли в основной поставке для fltk и qt, почему-то не завернутые в модули.
- case sensitive/insensitive в разных местах
- add_custom_command/add_custom_target: в add_custom_command есть синтаксис для добавления зависимостей некоторому таргету (add_custom_command(... APPEND)), у add_custom_target (где он, казалось бы, востребованней) его нет (при этом, зависимостями могут быть как файлы, так и phony-таргеты, естественно) (есть add_dependencies:). С другой стороны, add_custom_command нельзя добавить в ALL.
- COMPILE_DEFINITIONS/COMPILE_FLAGS - разный синтаксис добавления (первое - список, второе - строка)
Minor:
- Для сборки дистрибутива, использующего autotools, autotools не нужен. Для cmake это не так (более того, некоторые вещи без cmake -E унифицированно не сделаешь)
- Любимая всеми свистелка - прогресс сборки - кривая и код был написан явно очень давно. Как минимум, оно неправильно работает при частичной многопоточной сборке нескольких таргетов; плюс, точность его при частичной сборке отдельных таргетов в больших проектах сильно страдает. И никогда, никогда не следует смотреть на то, какой именно код задействован для вывода этих самых процентиков.
Best practices:
- В случае, если необходимо вернуть результат, обычно передают имя переменной. Все промежуточные операции над результатом лучше делать над некоей внутренней переменной с фиксированным именем (например, _res), и в конце сделать set("${_out}" "${_res}" PARENT_SCOPE) для избежания name clash между значением _out и одной из внутренних переменных.
- Пример обратного - CMakeParseArguments
- Еще в 2.8.9/2.8.12 не работал cmake(var "" PARENT_SCOPE)
- Опять же, поскольку окружение наследуется, важно делать set/unset перед проверкой переменных (например if (DEFINED ...), после cmake_parse_arguments())