Блог

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

Это под Windows.

У меня есть статическая библиотека, которая реализует класс с использованием идиомы pimpl. Заголовок pimpl не только используется использующим кодом, но и ссылается на статическую библиотеку. Тем не менее, когда я компилирую потребляющий код (.exe), компоновщик жалуется на неразрешенные внешние элементы в классе реализации, которые предположительно скрывает заголовок pimpl.

Как это может быть возможно?

 // Foo.lib

// Foo.h

class FooImpl;

class Foo
{
    std::shared_ptr<FooImpl> pimpl_;    
public:
    Foo();
};

// Foo.cpp

#include "Foo.h"
#include "FooImpl.h"

Foo::Foo() : pimpl_(new FooImpl())
{
}

// This is how its used in Bar.exe
// Bar.exe links against Foo.lib

// Bar.h

#include "Foo.h"

class Bar
{
    Foo access_foo_;
};

// Bar.cpp

#include "Bar.h"
  

Когда я компилирую / связываю Bar.exe , компоновщик жалуется, что он не может разрешить FooImpl. Я забыл, что именно он сказал, поскольку сейчас у меня нет доступа к моему рабочему компьютеру, но в этом суть. Ошибка не имела для меня смысла, потому что цель перехода по маршруту pimpl заключалась в том, чтобы Bar.exe не нужно было беспокоиться о FooImpl.

Точная ошибка выглядит следующим образом:

1> Foo.lib(Foo.obj) : ошибка LNK2019: неразрешенный внешний символ «public: __thiscall FooImpl::FooImpl(void)» (??0FooImpl@@QAE @XZ), на который ссылается функция «public: __thiscall Foo::Foo(void)» (??0Foo@@QAE@XZ)

Когда вы создаете статическую библиотеку, компоновщик не пытается устранить все, чего не хватает; предполагается, что вы позже свяжете его с другой библиотекой или что сам исполняемый файл внесет некоторую недостающую функцию. Вы, должно быть, забыли включить какой-то важный файл реализации в проект библиотеки.

Другая возможность заключается в том, что класс реализации pimpl является шаблонным классом. Шаблоны не генерируют код немедленно, компилятор ждет, пока вы не попытаетесь использовать их с заполненными параметрами шаблона. Ваш файл реализации должен содержать экземпляр шаблона с параметрами, которые будут поддерживаться вашей библиотекой.

После просмотра вашего редактирования проблема заключается в том, что конструктору Foo::Foo требуется доступ к конструктору FooImpl::FooImpl, но компоновщик не знает, где его найти. Когда компоновщик собирает библиотеку, он не пытается разрешить все ссылки в это время, потому что у него могут быть зависимости от еще одной библиотеки. Единственный раз, когда все должно быть решено, — это когда он собирает исполняемый файл. Таким образом, хотя Bar не нужно знать о FooImpl напрямую, он все равно зависит от него.

Вы можете решить эту проблему одним из двух способов: либо экспортировать FooImpl из библиотеки вместе с Foo, либо убедиться, что Foo имеет доступ к FooImpl во время компиляции, поместив их оба в Foo.cpp с FooImpl, идущим перед Foo.

1> Foo.lib(Foo.obj) : ошибка LNK2019: неразрешенный внешний символ «public: __thiscall FooImpl::FooImpl(void)» (??0FooImpl@@QAE @XZ), на который ссылается функция «public: __thiscall Foo::Foo(void)» (??0Foo@@QAE@XZ)

Компоновщик жалуется вам, что он не может найти определение FooImpl::FooImpl() . Здесь вы вызываете конструктор —

 Foo::Foo() : pimpl_(new FooImpl())
                    // ^^^^^^^^^ Invoking the default constructor.
  

Вы только что предоставили объявление конструктора по умолчанию, но не его определение.