KasperskyOS Community Edition 1.2
Русский
Сборка решения на базе KasperskyOS > Библиотеки CMake в составе KasperskyOS Community Edition > Библиотека platform

Библиотека platform

Библиотека platform содержит следующие команды:

  • initialize_platform() – команда для инициализации библиотеки platform.

    Команда initialize_platform() может вызываться с параметром FORCE_STATIC, который включает принудительную статическую компоновку исполняемых файлов:

    • По умолчанию, если тулчейн в составе KasperskyOS SDK поддерживает динамическую компоновку, то команда initialize_platform() делает так, что для сборки всех исполняемых файлов, заданных через CMake-команды add_executable(), флаг -rdynamic используется автоматически.
    • При вызове initialize_platform (FORCE_STATIC) в корневом файле CMakeLists.txt тулчейн, поддерживающий динамическую компоновку, выполняет статическую компоновку исполняемых файлов.

    Команда initialize_platform() может вызываться с параметром NO_NEW_VERSION_CHECK, который отключает проверку наличия обновлений SDK и передачу версии SDK на сервер "Лаборатории Касперского".

    Чтобы отключить проверку наличия обновлений SDK и передачу данных версии SDK на сервер Kaspersky при сборке решения используйте следующий вызов: initialize_platform(NO_NEW_VERSION_CHECK). Подробнее о политике предоставления данных см. "Предоставление данных".

  • project_static_executable_header_default() – команда для включения принудительной статической компоновки исполняемых файлов, заданных через последующие CMake-команды add_executable() в одном файле CMakeLists.txt. Тулчейн, поддерживающий динамическую компоновку, выполняет статическую компоновку этих исполняемых файлов.
  • platform_target_force_static() – команда для включения принудительной статической компоновки исполняемого файла, заданного через CMake-команду add_executable(). Тулчейн, поддерживающий динамическую компоновку, выполняет статическую компоновку этого исполняемого файла. Например, если вызываются CMake-команды add_executable(client "src/client.c") и platform_target_force_static(client), то для программы client выполняется статическая компоновка.
  • project_header_default() – команда для указания флагов компиляции.

    Параметры команды задаются в виде пар, состоящих из флага компиляции и его значения: "FLAG_1:VALUE_1" "FLAG_2:VALUE_2" ... "FLAG_N:VALUE_N". CMake-библиотека platform преобразует эти пары в параметры компилятора. Часто используемые флаги компиляции для компиляторов С и С++ из набора GCC, а также значения этих флагов приведены в таблице ниже.

    Флаг компиляции

    Значение YES

    Значение NO

    Значение по умолчанию

    STANDARD_ANSI

    Используются стандарты ISO C90 и 1998 ISO C++.

    Для компиляторов C и C++ значение преобразуется в параметр: -ansi.

    Стандарты ISO C90 и 1998 ISO C++ не используются.

    STANDARD_ANSI:NO

    STANDARD_C99

    Используется стандарт ISO C99.

    Для компилятора C значение преобразуется в параметр: -std=c99.

    Стандарт ISO C99 не используется.

    STANDARD_C99:NO

    STANDARD_GNU_C99

    Используется стандарт ISO C99 с расширениями GNU.

    Для компилятора C значение преобразуется в параметр: -std=gnu99.

    Стандарт ISO C99 с расширениями GNU не используется.

    STANDARD_GNU_C99:NO

    STANDARD_11

    Используются стандарты ISO C11 и 2011 ISO C++.

    Для C-компилятора значение преобразуется в параметр -std=c11 или -std=c1x в зависимости от версии компилятора.

    Для компилятора C++ значение преобразуется в параметр -std=c++11 или -std=c++0x в зависимости от версии компилятора.

    Стандарты ISO C11 и 2011 ISO C++ не используются.

    STANDARD_11:NO

    STANDARD_GNU_11

    Используются стандарты ISO C11 и 2011 ISO C++ с расширениями GNU.

    Для C-компилятора значение преобразуется в параметр -std=gnu1x или -std=gnu11 в зависимости от версии компилятора.

    Для компилятора C++ значение преобразуется в параметр -std=gnu++0x или -std=gnu++11 в зависимости от версии компилятора.

    Стандарты ISO C11 и 2011 ISO C++ с расширениями GNU не используются.

    STANDARD_GNU_11:NO

    STANDARD_14

    Используется стандарт 2014 ISO C++.

    Для компилятора C++ значение преобразуется в параметр -std=c++14.

    Стандарт 2014 ISO C++ не используется.

    STANDARD_14:NO

    STANDARD_GNU_14

    Используется стандарт 2014 ISO C++ с расширениями GNU.

    Для компилятора C++ значение преобразуется в параметр -std=gnu++14.

    Стандарт 2014 ISO C++ с расширениями GNU не используется.

    STANDARD_GNU_14:NO

    STANDARD_17

    Используются стандарты ISO C17 и 2017 ISO C++.

    Для C-компилятора значение преобразуется в параметр -std=c17.

    Для компилятора C++ значение преобразуется в параметр -std=c++17.

    Стандарты ISO C17 и 2017 ISO C++ не используются.

    STANDARD_17:NO

    STANDARD_GNU_17

    Используются стандарты ISO C17 и 2017 ISO C++ с расширениями GNU.

    Для C-компилятора значение преобразуется в параметр -std=gnu17.

    Для компилятора C++ значение преобразуется в параметр -std=gnu++17.

    Стандарты ISO C17 и 2017 ISO C++ с расширениями GNU не используются.

    STANDARD_GNU_17:NO

    STRICT_WARNINGS

    Включены предупреждения для обнаружения потенциальных проблем и ошибок в коде на языках C и C++.

    Для компиляторов C и C++ значение преобразуется в следующие параметры: -Wcast-qual, -Wcast-align, -Wundef.

    Для компилятора C дополнительно используется параметр -Wmissing-prototypes.

    Предупреждения отключены.

    STRICT_WARNINGS:YES

    Если через параметры команды не заданы флаги компиляции вида STANDART_*, то по умолчанию используется параметр STANDARD_GNU_17:YES.

При использовании команд initialize_platform(FORCE_STATIC), project_static_executable_header_default() и platform_target_force_static() могут возникать ошибки компоновки, если статический вариант требуемых библиотек отсутствует (например, не собран или не поставлен в составе KasperskyOS SDK). Но даже при наличии статического варианта требуемых библиотек эти ошибки могут возникать из-за того, что при использовании команд initialize_platform(FORCE_STATIC), project_static_executable_header_default() и platform_target_force_static() система сборки по умолчанию может выполнять поиск динамического варианта требуемых библиотек, а не статического, как ожидается. Чтобы избежать ошибок, нужно, во-первых, обеспечить наличие статического варианта требуемых библиотек, во-вторых, настроить систему сборки на поиск статических библиотек (для некоторых библиотек этой возможности может не быть) либо явно задавать компоновку со статическими библиотеками.

Примеры настройки системы сборки на поиск статических библиотек:

set (fmt_USE_STATIC ON) find_package (fmt REQUIRED) set (fdn_USE_STATIC ON) find_package (fdn REQUIRED) set (sqlite_wrapper_USE_STATIC ON) find_package (sqlite_wrapper REQUIRED)

Пример, в котором явно задана компоновка со статической библиотекой:

target_link_libraries(${PROJECT_NAME} PUBLIC logger::logger-static)

Подробнее об использовании динамических библиотек см. "Использование динамических библиотек".

Эти команды используются в файлах CmakeLists.txt для программы Einit и прикладных программ.

Идентификатор статьи: cmake_platform_lib, Последнее изменение: 21 мая 2024 г.
В начало