如何使用cmake将预建库添加到项目中？

Question

我看过这里和互联网上的网站，甚至在 cmake.org 上都看过——但没有找到这个，但想把它贴在这里，以防万一。

这是一个示例 cmakelists.txt 文件：

idf_component_register(SRCS "main.c"
                INCLUDE_DIRS ".")

• 导入库，指定目标名称和库路径。

• 还指定了库的私有依赖项。

  add_prebuilt_library（预建“libprebuilt.a”PRIV_REQUIRES spi_flash app_update 日志）

• main从库中调用一个函数，所以将它链接到main

  target_link_libraries(${COMPONENT_LIB} PRIVATE prebuilt)

---

那个有效。 当然，在 PRIV_REQUIRES 中需要是静态预构建库使用的所有组件模块。

更多真实世界的例子 - 请看这里： https : //github.com/espressif/esp-idf/tree/release/v4.0/examples/build_system/cmake/import_prebuilt

归功于 espressif 的人 - 当我使用 cmake 编辑器时，即使自动完成也没有找到 add_prebuilt ...

希望有些人觉得这很有帮助，因为我很快就掉下了这个 cmake 语法兔子洞。

问候，约翰W。

Answer 1

这是特定于 ESP32 的东西 - 我错误地认为 add_prebuilt_library 是我发现非常方便的 cmake 标准功能。

这是来自乐鑫的文字：

使用带有组件的预构建库

.. 突出显示:: cmake

ESP-IDF 构建系统提供了一个实用函数add_prebuilt_library供用户轻松导入和使用预构建库：

add_prebuilt_library(target_name lib_path [REQUIRES req1 req2 ...] [PRIV_REQUIRES req1 req2 ...])

在哪里：

• target_name - 可用于引用导入库的名称，例如链接到其他目标时
• lib_path - 预建库的路径； 可以是组件目录的绝对或相对路径

可选参数REQUIRES和PRIV_REQUIRES指定对其他组件的依赖性。 这些与idf_component_register的参数具有相同的含义。

请注意，必须为与使用项目相同的目标编译预构建库。 与预构建库相关的配置也必须匹配。 如果不注意，这两个因素可能会导致应用程序中出现细微的错误。

例如，看看 :example: build_system/cmake/import_prebuilt 。

====

对于由此造成的任何混淆，我们深表歉意。

如果您正在新工具上为 ESP 平台进行开发，如果您像我一样在文档中遗漏了这一点，这可能会很方便。

问候，约翰W。