CMake开发的MQTT库被其他项目调用时链接失败求助

这个链接错误的核心原因是：你的库对外暴露的接口中直接使用了Paho MQTT C++的类型（比如mqtt::properties），但你把Paho设为了PRIVATE依赖，导致下游项目链接时无法获取到Paho的库符号。

解决步骤： #

• 检查公开头文件：打开你的库对外提供的头文件，确认是否包含了<mqtt/xxx.h>这类Paho的头文件，或者直接使用了mqtt::命名空间下的类型（比如mqtt::properties、mqtt::client等）。
• 调整CMake依赖属性：
  • 如果公开头文件确实用到了Paho的类型，必须把Paho的依赖从PRIVATE改成PUBLIC：

    target_link_libraries(你的库名
        PUBLIC nlohmann_json::nlohmann_json
        PUBLIC PahoMqttCpp::paho-mqttpp3
    )
    

    这样CMake会自动把Paho的依赖传递给下游项目，确保链接时能找到对应的符号。
  • 如果你想保持Paho为PRIVATE依赖，需要对Paho的实现做完全封装：
    1. 在公开头文件中只使用前向声明的内部类，不暴露任何Paho的类型：

       // 公开头文件 MyMQTTClient.h
       class MyMQTTClientImpl;
       class MyMQTTClient {
       private:
           MyMQTTClientImpl* impl;
       public:
           MyMQTTClient();
           ~MyMQTTClient();
           void connect(const std::string& broker);
           // 其他对外接口
       };
       

    2. 在库的内部实现文件中引入Paho的头文件并完成逻辑：

       // 内部实现文件 MyMQTTClient.cpp
       #include <mqtt/client.h>
       #include <mqtt/properties.h>
       
       class MyMQTTClientImpl {
       public:
           mqtt::client mqtt_client;
           // 这里可以自由使用Paho的所有类型
       };
       
       MyMQTTClient::MyMQTTClient() : impl(new MyMQTTClientImpl()) {}
       // 其他接口实现...
       

• 重新编译安装：修改CMake配置后，重新执行编译和安装命令，确保库的CMake配置文件（如你的库Config.cmake）更新了依赖信息。
• 下游项目重新构建：删除下游项目的build目录，重新执行cmake和编译，链接错误应该会消失。

内容的提问来源于stack exchange，提问作者Janne Schyffert