libs: fix API export/import and 'inconsistent linkage' on MSVC
authorTim-Philipp Müller <tim@centricular.com>
Mon, 24 Sep 2018 10:52:22 +0000 (11:52 +0100)
committerTim-Philipp Müller <tim@centricular.com>
Mon, 24 Sep 2018 13:45:56 +0000 (14:45 +0100)
commitb6411ae74cc7319ef368f5b4a6a872231b49620a
treeda93ec9939dcb3dd38f34c0981ec65db01b58731
parentbe3edc6ad6a308ec4c01cce5355960c671e81519
libs: fix API export/import and 'inconsistent linkage' on MSVC

For each lib we build export its own API in headers when we're
building it, otherwise import the API from the headers.

This fixes linker warnings on Windows when building with MSVC.

The problem was that we had defined all GST_*_API decorators
unconditionally to GST_EXPORT. This was intentional and only
supposed to be temporary, but caused linker warnings because
we tell the linker that we want to export all symbols even
those from externall DLLs, and when the linker notices that
they were in external DLLS and not present locally it warns.

What we need to do when building each library is: export
the library's own symbols and import all other symbols. To
this end we define e.g. BUILDING_GST_FOO and then we define
the GST_FOO_API decorator either to export or to import
symbols depending on whether BUILDING_GST_FOO is set or not.
That way external users of each library API automatically
get the import.

While we're at it, add new GST_API_EXPORT in config.h and use
that for GST_*_API decorators instead of GST_EXPORT.

The right export define depends on the toolchain and whether
we're using -fvisibility=hidden or not, so it's better to set it
to the right thing directly than hard-coding a compiler whitelist
in the public header.

We put the export define into config.h instead of passing it via the
command line to the compiler because it might contain spaces and brackets
and in the autotools scenario we'd have to pass that through multiple
layers of plumbing and Makefile/shell escaping and we're just not going
to be *that* lucky.

The export define is only used if we're compiling our lib, not by external
users of the lib headers, so it's not a problem to put it into config.h

Also, this means all .c files of libs need to include config.h
to get the export marker defined, so fix up a few that didn't
include config.h.

This commit depends on a common submodule commit that makes gst-glib-gen.mak
add an #include "config.h" to generated enum/marshal .c files for the
autotools build.

https://bugzilla.gnome.org/show_bug.cgi?id=797185
67 files changed:
common
configure.ac
gst-libs/gst/adaptivedemux/Makefile.am
gst-libs/gst/adaptivedemux/adaptive-demux-prelude.h
gst-libs/gst/adaptivedemux/meson.build
gst-libs/gst/audio/Makefile.am
gst-libs/gst/audio/audio-bad-prelude.h
gst-libs/gst/audio/gstplanaraudioadapter.c
gst-libs/gst/audio/meson.build
gst-libs/gst/basecamerabinsrc/Makefile.am
gst-libs/gst/basecamerabinsrc/basecamerabinsrc-prelude.h
gst-libs/gst/basecamerabinsrc/gstcamerabin-enum.c
gst-libs/gst/basecamerabinsrc/gstcamerabinpreview.c
gst-libs/gst/basecamerabinsrc/meson.build
gst-libs/gst/codecparsers/Makefile.am
gst-libs/gst/codecparsers/codecparsers-prelude.h
gst-libs/gst/codecparsers/dboolhuff.c
gst-libs/gst/codecparsers/gstjpeg2000sampling.c
gst-libs/gst/codecparsers/gstjpegparser.c
gst-libs/gst/codecparsers/gstvp8rangedecoder.c
gst-libs/gst/codecparsers/meson.build
gst-libs/gst/codecparsers/parserutils.c
gst-libs/gst/codecparsers/vp8utils.c
gst-libs/gst/insertbin/Makefile.am
gst-libs/gst/insertbin/gstinsertbin.h
gst-libs/gst/insertbin/meson.build
gst-libs/gst/interfaces/Makefile.am
gst-libs/gst/interfaces/meson.build
gst-libs/gst/interfaces/photography-prelude.h
gst-libs/gst/isoff/Makefile.am
gst-libs/gst/isoff/gstisoff.c
gst-libs/gst/isoff/gstisoff.h
gst-libs/gst/isoff/meson.build
gst-libs/gst/mpegts/Makefile.am
gst-libs/gst/mpegts/gst-atsc-section.c
gst-libs/gst/mpegts/gst-dvb-descriptor.c
gst-libs/gst/mpegts/gst-dvb-section.c
gst-libs/gst/mpegts/gstmpegtsdescriptor.c
gst-libs/gst/mpegts/gstmpegtssection.c
gst-libs/gst/mpegts/meson.build
gst-libs/gst/mpegts/mpegts-prelude.h
gst-libs/gst/opencv/Makefile.am
gst-libs/gst/opencv/meson.build
gst-libs/gst/opencv/opencv-prelude.h
gst-libs/gst/player/Makefile.am
gst-libs/gst/player/meson.build
gst-libs/gst/player/player-prelude.h
gst-libs/gst/sctp/Makefile.am
gst-libs/gst/sctp/meson.build
gst-libs/gst/sctp/sctp-prelude.h
gst-libs/gst/sctp/sctpreceivemeta.c
gst-libs/gst/sctp/sctpsendmeta.c
gst-libs/gst/uridownloader/Makefile.am
gst-libs/gst/uridownloader/gstfragment.c
gst-libs/gst/uridownloader/gsturidownloader.c
gst-libs/gst/uridownloader/meson.build
gst-libs/gst/uridownloader/uridownloader-prelude.h
gst-libs/gst/video/Makefile.am
gst-libs/gst/video/meson.build
gst-libs/gst/video/video-bad-prelude.h
gst-libs/gst/wayland/Makefile.am
gst-libs/gst/wayland/meson.build
gst-libs/gst/wayland/wayland.h
gst-libs/gst/webrtc/Makefile.am
gst-libs/gst/webrtc/meson.build
gst-libs/gst/webrtc/webrtc_fwd.h
meson.build