Переменные, установленные с помощью PARENT_SCOPE, пусты в соответствующей дочерней области. Почему?

Контекст: мой проект состоит из нескольких исполняемых файлов и библиотек. Для библиотеки, например. bar, я хотел бы установить переменную bar_INCLUDE_DIR, которая добавляется к путям включения любого зависимого исполняемого файла.

Есть гораздо лучший способ сделать это, чем устанавливать переменные в родительской области. CMake позволяет цели указать включаемые каталоги, символы препроцессора и т. д., которые могут использовать определенные цели. В вашем случае вы можете использовать target_include_directories.

Например:

target_include_directories(my_target PUBLIC my_inc_dir)

Я не вижу ничего, что не соответствовало бы документация команды SET

Если присутствует PARENT_SCOPE, переменная будет установлена ​​в области над текущей областью. Каждый новый каталог или функция создает новую область. Эта команда установит значение переменной в родительский каталог или вызывающую функцию (в зависимости от того, что применимо к данному случаю).

./bar/CMakeLists.txt

set( BAR "This is bar." PARENT_SCOPE ) #<-- Variable is set only in the PARENT scope
message( STATUS "Variable BAR in ./bar/ = ${BAR}" ) #<--- Still undefined/empty

Вы всегда можете сделать:

set( BAR "This is bar." ) #<-- set in this scope
set( BAR ${BAR} PARENT_SCOPE ) #<-- set in the parent scope too

Grep для PARENT_SCOPE в поставляемых модулях в вашей установке, например FindGTK2

if(GTK2_${_var}_FOUND)
   set(GTK2_LIBRARIES ${GTK2_LIBRARIES} ${GTK2_${_var}_LIBRARY})
   set(GTK2_LIBRARIES ${GTK2_LIBRARIES} PARENT_SCOPE)
endif()

Питер хорошо объяснил причину такого поведения.

Обходной путь, который я обычно использую в этом случае, заключается в установке кэшированной переменной, которая будет видна везде:

set(BAR "Visible everywhere"
        CACHE INTERNAL ""
)

INTERNAL сделать его невидимым из cmake-gui. INTERNAL подразумевает FORCE, обеспечивая обновление, если вы что-то измените для пример в вашей структуре папок. Пустая строка — это строка описания, которую вы можете заполнить, если считаете это необходимым.

Обратите внимание, однако, что правильный подход – прикреплять свойства к целевым объектам, когда это возможно, например с помощью target_incude_directories и распространять их на другие цели, устанавливая зависимости.

Если вам нужно только установить переменную как в локальной, так и в родительской области, макрос может помочь уменьшить дублирование:

macro(set_local_and_parent NAME VALUE)
  set(${ARGV0} ${ARGV1})
  set(${ARGV0} ${ARGV1} PARENT_SCOPE)
endmacro()

Каждая переменная в cmake имеет свою собственную область видимости, поэтому опасно использовать случай, когда переменная автоматически распространяется в дочернем контексте, потому что она может мешать ей из родительской области!

Но вы можете установить еще одну переменную в дочерней области, чтобы проверить ее позже, вместо того, чтобы перечитывать родительскую:

./bar/CMakeLists.txt:

set( BAR "Exists in parent scope only." PARENT_SCOPE )
set( _somerandomid_BAR "Exists in child scope only.")
message( STATUS "Variable BAR in ./bar/ = ${_somerandomid_BAR}" )

Теперь, если в вашем коде есть циклы, вы можете протестировать обе переменные:

foreach(...)
  ...
  # read a variable token name and token value, for example, from a configuration file
  set(my_var_name_token ...)
  set(my_var_value_token ...)
  ...
  # parse a variable name and value tokens into a real name and value
  set(my_var_name ...)
  set(my_var_value ...)
  ...
  if (DEFINED ${my_var_name})
    if (DEFINED local_${my_var_name})
      message("has been defined before and was resetted");
    else()
      message("has been defined before and was not resetted");
    endif()
  else()
    if (DEFINED local_${my_var_name})
      message("has not been defined before and was setted");
    else()
      message("has not been defined before and was not touched");
    endif()
  endif()
  ...
  # sets parsed name and value into cmake context
  set(${my_var_name} "..." PARENT_SCOPE)

  # Do save all values has been setting from this function to differently compare and 
  # validate them versus already existed before:
  # 1. If has been set before, then must be set to the same value, otherwise - error
  # 2. If has not been set before, then should set only once, otherwise - ignore new 
  # value (a constant variable behaviour)
  set(local_${my_var_name} "...")
  ...
endforeach()